Documentation
Changelog
 
 

Getting Started

We would like to thank you for purchasing Athlete2 Theme! Before you get started, please be sure to always check out this documentation. Athlete2 theme can only be used with Magento 2 so we assume that you already have Magento 2 installed and ready to go. If you are unable to find answer for your questions in our documentation, feel free to contact us via form on our themeforest profile page. We'll be happy to help! Thank you, we hope you'll enjoy using Athlete2 Theme!

 

Requirements

Athlete2 Theme is compatible with Magento Community Edition version 2.3.x To install this theme, we assume that you have an installed Magento version 2.3.x already. If you need help installing Magento 2.x, follow the instructions on Magento official website. Below are useful links:

Very detailed installation instructions of Magento 2.3 with video by digitalstartup How to install Magento 2.3 and build a web server

 

Theme Installation

1. Backup your Magento files and database. We are not responsible for any data loss.

Creating a backup is very imporant before installing theme, especially when you are working on a live site. Do not ignore this stage!

2. Disable all cache on your Magento site

Go to System -> Cache management. Select all, choose refresh action and submit. Additionally disable any other cache on your server, for instance PHP cache engines, APC, etc

cache

Alternatively you can use command line: php bin/magento cache:clean to refresh cache

3. Download theme package from themeforest, unzip it (Theme Package > Theme Files > Athlet2.zip) and upload app and pub folders to the root of your Magento folder. So content of the app goes to app and pub goes to pub. You can use some FTP software like FileZilla. Make sure that all theme folders and files has been uploaded successfully.

4. Login to your server using SSH client (Putty, MobaXterm, etc) navigate to the root of your magento folder and set correct file and folders permissions and ownership. Especially for pub and var folders. Most of the problems are because of ownership, you can set it like this:

sudo chown -R <owner>:<group> <magento root directory path>
i.e.
sudo chown -R magento:www-data /var/www/html

If you are in your magento folder you can simply add dot instead of the path like this:

sudo chown -R magento:www-data .

5. When you ensure that permissions are correct, switch user to Magento file system owner and run following commads:

Run all Magento CLI commands as the Magento file system owner.

6. Login to Magento admin panel and switch to Athlete2 theme in Content > Design : Configuration choose where you want to apply theme, to all stores or a specific store view and click Edit. Then choose theme in Applied Theme select field.

That's it your theme is installed. You can start customizing it or import sample data.

 

Demo Import

Our theme comes with one click sample data import. You can import theme and olegnax plugins settings, pages, static blocks and banner sliders for each of the demos. Please note that you existing pages and static blocks will be overriden if they has same identifiers.

You can import settings, content(pages and static block) and banner slider separately.

Also you can import theme settings to specific store view. To do this choose desired store view on import page and then click import.

 

Nwdthemes Revolution sliders are not included in theme import, you will need to import them manually using Revoluton Slider import.

 

After Import

Sample data will import content and settings but import won't make your website look exactly like on preview. You may need to do following adjustments:

Important by default we disable wysiwyg editor when you import options because it wraps everything in p tag resulting in lots of undesired spaces and also removes empty tags. So keep in mind that content may be corrupted when you switch to visual editor (Show/Hide Editor button)

1. Categories. We do not import categories and that is why we can't import mega menu option. Check Olegnax Mega Menu section of this documentation. You will find sample menu content used in preview there.

2. Categories content. We import static blocks used in our categories but you will need to assign them to specific category after you create it. You can learn how to do this in Categories section of this documentation.

3. Brands. Sample brands images are imported but you need to apply them to your brands attribute. You can check Olegnax Brands sections for details.

4. Product and banner sliders. They are imported but you may need to adjust their id on pages and static blocks.

Navigate to Olegnax > Banners > Groups and check banner group id of the group that you need. If it is your first import on a clean content then most likely it will be 1, same as id in content. In this case you don't need to do anything.

Then open your home page Content > Pages or static block Content > Blocks where the banner slider is located and change banner slider widget slide_group value

For Product sliders widget you need to change category_ids value to the id of your category. You can check category id in Catalog > Categories then choose category and you will see its id in page title next to the name.

 

Theme Update

Basically theme update is the same as installation.

1. Backup your Magento files and database. We are not responsible for any data loss.

Creating a backup is very imporant, especially when you are working on a live site. Do not ignore this stage!

2. Download theme package from themeforest, unzip it (Theme Package > Theme Files > Athlet2.zip) and upload app and pub folders to the root of your Magento folder. So content of the app goes to app and pub goes to pub. You can use some FTP software like FileZilla. Make sure that all theme folders and files has been uploaded successfully.

2.1. If you run magento 2.3.1 or 2.3.0 you also need to apply patch. Patch can be found in the same folder as main archive Theme Package > Theme Files > Patch-2.3.1.zip. Upload is to server and unzip it same as you did with the main archive.

3. Login to your server using SSH client (Putty, MobaXterm, etc) navigate to the root of your magento folder and set correct file and folders permissions and ownership.

4. When you ensure that permissions are correct, switch user to Magento file system owner and run following commads:

Run all Magento CLI commands as the Magento file system owner.

php bin/magento setup:upgrade
rm -rf ./pub/static/*
rm -rf ./var/*
php bin/magento cache:clean
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f

5.Additionally

5.1. You may need to update Revolution slider. It is 3rd party extension and not a part off the theme so it has to be updated manually. You can find its files inside of the main archive Revolution Slider folder. Upload the files and run CLI commands. For more datails check extension official website

5.2. If you run magento version below 2.3.2 then you need to apply patch. Patch archive can be found in the same folder as main archive Theme Package > Theme Files > Patch-2.3.1.zip. If you applied patch after theme update then you need run CLI commands provided above again.