Theme Installation

To install the theme you have two options:

Installation of ZooExtension’s Magento demo store

To install demo store with all the sample data (similar to live demo of MT Soul), please follow this guide Installation of ZooExtension’s Magento theme demo store .

If you already have a working Magento store and database – go to Installation for live Magento store.

Installation for your live Magento store

If you already have a Magento store and want to apply the theme, follow the instruction below. To install the theme you only need to upload all the theme files to your server and then enable the theme in the admin panel. But to avoid unexpected problems after installation, you should first prepare your Magento. Please strictly follow the steps described in this guide:

Prepare your Magento

Step 1. It is recommended to install the theme on a test server before you install it in a live store.

Step 2. Backup Magento files and the store database.

Important: creating backup before installation of any themes or extensions in Magento is extremely important, especially when you are working on a live store.

Step 3. Disable compilation mode in System > Tools > Compilation.

Step 4. Disable every cache you have in your Magento:

  • Magento cache (refer to 4.1.2 Disable cache for details)
  • full page cache and caching modules for Magento (such as Speedster)
  • any additional cache on your server, PHP cache engines, APC, etc.

Important: when developing your Magento store, in order to be able to see changes immediately, you should completely enable the cache.

Step 5. Remove all possible custom modifications of the Magento's “base” theme. MT Soul (same as any other Magento theme) relies on “base” theme, so any modifications of the “base” theme can change the default behavior of Yoming and break some functionality. You should never edit “base” theme's files.

Step 6. Log out from Magento admin panel. Do not just close the browser window: you need to click Log Out link to refresh the access control system.


Before you install the theme you need to prepare your Magento, so please do not omit the previous step: 3.1 Prepare your Magento.

Step 7. Extract the theme package on your computer and navigate inside Theme Files directory.

Step 8. Using your FTP client upload file to your Magento’s root directory (Magento’s root directory is where you can find Magento’s basic files, such as: index.php and get.php).

Note: Before uploading file to Magento’s root folder, we recommend you to disable the cache management. See more chapter Disable Cache.

Step 9. Unzip file – it contains five directories: app, js, media, skin and lib. Magento already contains the same directories so unzipping here will merge theme’s and Magento’s directories.

Folder Description
App Contain all layout and templates files
Js Contain all Js files of template and other features
Media Contain all image files in the static blocks, icons…
Skin Contain all skin files
lib locate Magento core code

Note: this will not overwrite any Magento core files, this will only add the theme to your Magento. So if you see a message that those four directories already exist on the server, you can confirm that you want to merge directories.

In case you can’t unzip files on your server:

Alternatively, you can unzip file on your computer, and upload its content (four directories which can be found inside: app, js, media, skin) to your Magento’s root directory. Note that files can be broken if you send them in large numbers via FTP without zipping. So it is highly recommended to upload zipped files.


Note: After uploading completely, In your Administration Panel, please nagative to Magento Themes > MT Soul > Theme Design and click the Save Config button at the upper-right corner of the panel to create less and css file for each store.

Step 10. Set correct file permissions for all the theme files which you uploaded to your server.

Note: theme files should have the same permissions as other Magento files. Otherwise Magento will not have access to the theme files, images etc. In case of any doubts about the permissions, please contact your hosting provider.

Step 11. Enable the theme. To do this, go to System >Configuration > Design section. In the Current Package Name field enter the name of the design package: mtsoul. Click Save Config button:


Note: If you have more than one store view (by default there’s only one) in your Magento and you want to enable the theme for the entire site, make sure that you select Default Config under Current Configuration Scope. In the top right corner of this section. Otherwise, set the scope according to your needs.

Step 13. Flush Magento cache (refer to Flush cache and any other cache you have in your Magento installation.

Step 14. Go to the next chapter to import sample content.

Import sample blocks, pages and widget

After the theme was installed and enabled, you can import sample static blocks and pages provided with the theme.

Step 16 . Go to MagentoThemes > MT Soul > Theme Settings > Theme Installation to import static blocks and pages. Refer to 6.1 Import Static Blocks for more details about the import.

Note: if you get 404 not found message when trying to open theme configuration pages in the admin panel after installation, you need to log out and log in again to refresh the access control system.

Now you can open up your web browser to see the new look of the store. Clear your web browser’s cache and cookies for your store domain (this will eliminate potential problems with unrefreshed cache).

All the theme settings in the admin panel can be found in two tabs:

  • System > Configuration > MT Soul
  • System > Configuration > MT Extensions.

Important: it is a good idea to disable Magento cache before you start to configure your store. Otherwise you will need to flush the cache in order to see any changes you have made in the configuration.

In case of any problems after installation, please refer to next chapter.

Problems after installation

If you encounter any problems after installation: flush Magento cache, log out from the admin panel, and log in again. Check again the installation steps and make sure you didn’t omit any step. What can cause problems:

  1. Magento cache (or external cache) was not flushed after installation of the theme.
  2. Compilation mode was not disabled before installation.
  3. Some of the theme files werenot uploaded.
  4. File permissions issue.
  5. You have some third-party extensions which change/break theme’s default behavior or cause some conflicts.
  6. You edited theme files and accidentally removed or changed something in the files.
  7. You have customized the theme by creating custom sub-theme and your modifications change/break the default behavior of the theme.
  8. You have some elements that left from your previous theme (e.g. in Magento’s “base” theme in app/design/frontend/base/) and that changes/breaks the default behavior of the theme.

Also check your log files in var/log/ (log settings should be enabled in the admin panel: System > Config > Developer) for more information about possible errors.

Please refer to the following chapter: 19. FAQs for more information about the most common problems in Magento.