Our theme (and any other custom theme) isn't compatible with all third-party extensions by default. You often (not always) need to customize the extension to make it work properly with your theme. It's impossible for theme author to make the theme compatible with all existing extensions. Only default Magento theme is compatible with all third-party extensions, because all extensions are designed to work with default Magento theme.

Most common case is a conflict, when extension and theme override the same Magento template file. In such cases you need to customize conflict template and merge extension into theme template

Extensions Installation

You need to check if an extension use base/default theme - in doing so you are utilising the fallback hierarchy Magento provides, allowing your theme to be portable and easy to extend by clients wishing to do so.

If it use default/default theme - you will need to copy extension layout files and templates into athlete/default theme.

PHP & JS Errors

ERRORS DURING INSTALLATION

Please double check that all files were uploaded
Check system requirements: http://www.magentocommerce.com/knowledge-base/entry/how-do-i-know-if-my-server-is-compatible-with-magento
Most common problem is low memory limit. To fix it, you need to increase memory limit in .htaccess or php.ini. If your hosting does not allow that, please, contact your hosting support
```
memory_limit = 32M # php.ini
ini_set('memory_limit', '32M'); # in php script
php_value memory_limit 32M # htaccess
```
Another common problem is lack of time limit. To fix it, you need to edit index.php. Insert set_time_limit(0); in the beginnig of index.php
```
<?php
set_time_limit(0);
```

I AM GETTING FATAL PHP ERROR

Usually php fatal error is not theme related issue. Best solution is to search on magento forums or google with exact error string.

I GET JS ERROR. AJAX NOT WORKING ETC

The problem is that some ( or several ) of plugins installed in your system include another version of jquery library after all our libraries were loaded. It override jQuery object with all jquery libraries that was loaded by our theme.

Check plugin files and comment out jquery. It should be loaded via layout xml. Usually layout files located in app/design/frontend/base/default/layout/ or app/design/frontend/default/default/layout

magento basics

STORE VIEWS AND DIFFERENT CONFIGURATION SCOPES

Current Configuration Scope list, at the top of the left Configuration panel, defines the range in which the configuration settings are applied. Some configuration settings apply globally to everything in the site, while others are more limited in scope. If you have multiple stores on your website, you can change the scope and make different configurations settings for each store.

Scope of the configuration is shown in [square brackets] to the right of the setting.
To set current configuration scope:

From the Admin panel, select System > Configuration.
In the upper-left Current Configuration Scope list, choose scope of the settings you want to make.
To see current store configuration, click Manage Stores.

Scope Settings

Default Configuration - Configuration at the Default level applies to all websites if a website or store specific value is not set.
Main Website - Configuration at Main Website scope, like Default, applies across all stores and store views. Certain settings, like Table Rates, can be made only with a Main Website scope.
Main Store - Configuration at Store scope applies only to the specific store
Storeview (English, Spanish, etc) - Store views are used to configure language or country specific settings.

For more information, see Understanding Store Scopes.

empty navigation

The first level of categories are used for the STORE ROOTS only, and are NOT shown in the top navigation.

Categories from the 2nd level and downward are shown in that store's top navigation. If your categories do not show up in your store, they are most likely NOT correctly assigned to the root category for the store.

You just need to define root category for your store. If you do not create any store, place all categories under default category

Please, check these links:

Do not forget to clean cache, magento use cache heavily

HOW TO TURN ON LAYERED NAVIGATION FOR CATEGORIES

Please check this article - http://www.magentocommerce.com/knowledge-base/entry/how-does-layered-navigation-work
To turn on layered navigation for categories do following steps for all categories:

- select category to edit
- switch to "Display Settings" tab
- set "Is Anchor" - Yes

Do not forget to reindex data and clear cache.

HOW TO INCLUDE LINKS TO CMS PAGES IN THE TOP NAVIGATION?

Please check this article - http://www.magentocommerce.com/knowledge-base/entry/adding-page-links-in-the-navigation-bar

MOVING FROM DEVELOPMENT SITE TO LIVE SITE

If you want to move your installation from development directory or domain, you need to follow this steps.

copy magento files to new location
clear var/cache, var/session folders
update db credentials in app/etc/local.xml ( if needed )
make dump of mysql database and import it to new database

open your mysql client ( e.g. phpmyadmin, heidi ) and run this query in live database

UPDATE core_config_data SET value = 'http://your_domain.com/' WHERE path LIKE 'web/%/base_url';

You're done.

custom subtheme

How to create custom subtheme?

Create new folder in app/design/frontend/athlete/. For example: app/design/frontend/athlete/custom

Copy files you want to update from app/design/frontend/athlete/default to appropriate folder in new theme

For example if you want to override header template:

copy app/design/frontend/athlete/default/template/page/html/header.phtml to app/design/frontend/athlete/custom/template/page/html/header.phtml

apply your changes to template in your custom theme.
If you plan to update css and/or images:
Create new folder in skin/frontend/athlete/. For example: skin/frontend/athlete/custom

Copy files you want to update from app/design/frontend/athlete/custom to appropriate folder in new theme

How to switch to your custom subtheme?

Login to admin
Go to System > Configuration > Design. Open "Themes" section
In most cases, if the "package" is set in the Current Package field above, all these fields can remain blank. Magento will go to the default directory in the "package" directory to find the customized files.
If you want a theme variant of your "package" to be the default theme, the easiest way to change your theme is to enter your theme variant name in the “Default” field in this section, leaving all other options in this section blank. For example, if you want your “custom” theme to be the default theme for the website, enter “custom” in the default field here.
Magento looks for files like this: Current package’s "custom" theme > Current package’s default theme > Magento Base folder.

You can also mix and match components from various themes using the other fields in this section. For example, if you want to use the CSS from the “custom_2” theme with your custom theme, enter “custom_2” in the “Skin (images/css)” option box and leave the default box set to “custom”.

translation

HOW CAN I CHANGE LANGUAGE?

To change store language please do following steps:

- install original translation from magento connect. All available translations can be found here http://www.magentocommerce.com/translations
- create app/design/frontend/athete/default/locale/[your_locale]/
- copy app/design/frontend/athete/default/locale/en_US/translate.csv to new locale folder and translate it
- switch store locale to your new language in System > Configuration > General
- refresh cache ( System > Cache management )

HOW DO I Change Newsletter "SIGN UP & GET 10% OFF0" or ANY TEXT IN THEME )?

To change any text in theme you need to use translate file.

Default Translate file is located in app/design/frontend/athete/default/locale/en_US/translate.csv.

Please note that translate file located in en_US folder. This means that translations contained in file applied only if store used English ( United States ) locale, which is corresponding to en_US

In order for translation to work, you need to edit it with your favorite text editor.
but DO NOT use EXCEL
File contain strings in following format:

 "Shopping cart","Bag"

where
- Shopping cart - original text string
- Bag - updated text

Sidebars

how to turn off twitter or any other block on the sidebar

You need to edit local.xml to edit blocks in sidebar.

It is different for each language/store view. Default path is app\design\frontend\athlete\default\layout

To remove twitter, find and replace/comment following code:

<block type="athlete/social_twitter" name="athlete.sidebar.twitter" as="athlete_twitter" template="olegnax/social/twitter/left.phtml" />

how to change the order of blocks on the left side bar

http://www.magentocommerce.com/knowledge-base/entry/controlling-block-order

how to add new block to the side bar

By adding reference in local.xml, but the code is depends on type of block:

http://get-blognotes.blogspot.com/2012/03/magento-how-to-add-static-cms-block-to.html
http://go.magento.com/support/kb/entry/name/placing-a-block-in-a-cms-page-sidebar/

how to add sidebar to a product page

1. For single product

You can change layout for specific product page from admin panel: http://www.magentocommerce.com/knowledge-base/entry/changing-the-page-layout

2. For all products

But if you want to change it for all product pages, you'll have to edit ..app\design\frontend\athlete\default\layout\local.xml file.

Find following code:

<catalog_product_view translate="label">
<reference name="root">
<action method="setTemplate">
<template>page/1column.phtml</template>
</action>
</reference>

and change

<template>page/1column.phtml</template>

<template>page/2columns-left.phtml</template>

Please note, that local.xml file can be different for each store view. So tha path will be like this: app\design\frontend\athlete\YOUR LANGUAGE\layout\local.xml

how to add categories list to sidebar on product page

You'll have to edit ..app\design\frontend\athlete\default\layout\local.xml file.

Search for this tag:

catalog_product_view

and add following code:

<reference name="left">
<block type="olegnaxmegamenu/megamenu" name="olegnaxmegamenu.megamenu.left" as="megamenuLeft" template="olegnax/megamenu/left.phtml" before="-" />
</reference>

So the result will be like this:

<reference name="root">
<action method="setTemplate">
<template>page/2columns-left.phtml</template>
</action>
</reference>
<reference name="left">
<block type="olegnaxmegamenu/megamenu" name="olegnaxmegamenu.megamenu.left" as="megamenuLeft" template="olegnax/megamenu/left.phtml" before="-" />
</reference>

Please note, that local.xml file can be different for each store view. So tha path will be like this: app\design\frontend\athlete\YOUR LANGUAGE\layout\local.xml

how to change blocks in blog sidebar

Blog sidebar block can be edited in \app\design\frontend\athlete\default\layout\aw_blog.xml

I.E. to remove twitter block, you need to comment out following line in this file:

<block type="athlete/social_twitter" name="athlete.sidebar.twitter.right" as="athlete_twitter_right" template="olegnax/social/twitter/left.phtml" />

Other

Custom Options/Attributes position on product page

Layout for the product comes in two variations below and right to the image.

Go your Catalog -> Manage Products
select your product
switch to"Design" tab
and choose "Product Info Column" in "Display Product Options In" drop down.

How can I edit / remove Custom Tab 1 and Custom Tab 2 for Products?

Simply find static blocks with following identifiers "athlete_custom_tab1", "athlete_custom_tab2" in CMS->Static blocks and disable/edit them.

These custom tabs are same for all products. You can learn how to add specific tab for each product here.

Thumbnail Images in blog are not displayed

Athlete theme versions up to 1.4.2 comes with support of ahead works blog version 1.3.2 only.

You can choose what version of blog to install in "Release notes" tab on extension install page.

Retina images in CMS blocks

Our theme supports high resolution images for retina screens. Lets take athlete_logo block as an example.

Select block with Identifier = athlete_logo. In content text area you will see a code similar to this one

<img class="retina" width="153" height="43" src="{{media url="olegnax/athlete/logo.png"}}" alt="Athlete Premium magento theme" />

There are 3 important parameters to support retina screens.
1. Width & Height
2. class="retina"
It is very important for an image to have these 3 parameters. Width and height should be equal to dimensions of an image for regular screens. Class="retina" define that this image should be reloaded for retina
When you upload a new logo you will need to upload 2 images:
your_logo.png - normal size image for regular screens
your_logo_2x.png - double size image for retina screens
Please note that a retina image has a different file name - your_logo_2x - you should add this to original image name

You need to select an image for regular screen and insert the content textarea

HOW TO MARK PRODUCT AS "NEW" OR "SALE" ?

To mark product as "New" do following steps:

1. Go to Catalog > Manage Products and select product.
2. In General tab you will find two fields: Set Product as New from Date and Set Product as New to Date. Fill them and press save.
3. If you use caching go to System > Index management and reindex data.
After that go to System > Cache management.
Select all items, select disable in actions and click submit.

To mark product as "Sale" do following steps:

1. Go to Catalog > Manage Products and select product.
2. In Price tab fill following fields: Special price, Special price from Date and Special price to Date
3. If you use caching go to System > Index management and reindex data.
After that go to System > Cache management.
Select all items, select disable in actions and click submit.

Where can I edit contacts page?

1. You can edit contact page content in two statick blocks: athlete_contacts_block1 and athlete_contacts_block2 (CMS -> Static Blocks)

2. Map code located in athlete_google_map static block.

3. If you want to edit form you'll have to edit form.phtml in \app\design\frontend\athlete\default\template\contacts

Minor customizations

theme skins

Our theme comes with quickstart package. It is exact copy of our preview and contain 9 theme styles with all of the static blocks and pages. So you can install it as a guide i.e. on your localhost. But if, for some reason, you can't do it and want to make you're clean installation looks like one of our theme previews, here is the screenshots of specific theme preview settings:

Support Policy

We understand that there is a fine line between what is considered support & modifications. We will try help you with any type of query, but we can't provide extensive help in terms of modifications.

If you're not familar with magento and having troubles with installation, or want to make changes that go beyond our basic support, you can order customization services.

If you have found any bugs or have some other problems with this theme, please post your topic on our help forum and our staff will put its best to help you

Frequently asked questions

Useful links

Magento Installation

Magento Configuration

How to optimize Magento performance

Athlete Theme installation

3rd-party Extensions

Will my extension work with your theme?