- Install via the Admin Panel
- Install via FTP
- Features of using Themler Themes on PrestaShop
- Permissions
Install via the Admin Panel (packed template)
To install the downloaded template (.zip) via the PrestaShop administration panel, please follow the next steps:
Download the Themler theme archive.
Go to the PrestaShop back office >> Improve >> Design >> Theme & Logo.
Click "Add New Theme".
Import theme from your computer.
Go back to Improve >> Design >> Theme & Logo and activate the newly installed theme with "Use this theme" option.
NOTE: Themler theme for PrestaShop 1.7 contains a module which is required for theme editing in Themler. The module will be installed and activated once you activate Themler theme. Then the Themler tab will appear on the PrestaShop back office ribbon.Go to Improve >> Themler menu and click "Customize with Themler".
Install via FTP (unpacked template)
To install the theme via FTP you need to download the theme archive to your computer and unpack it.
Access Prestashop directory on your server and open
/public/prestashop/themes
folder.Create new folder named the same as the theme name specified in the
config.xml
file of the theme:
theme name:<theme_key>untitled</theme_key>
folder name:/public/prestashop/themes/untitled
Copy the content of the unpacked theme archive into the newly created folder.
Copy the folder
dependencies/modules/themler
into the/public/prestashop/modules
folder.Activate newly installed theme under the PrestaShop back office >> Improve >> Design >> Theme & Logo.
Features of using Themler Themes on PrestaShop
In order to avoid issues with applying changes to the theme, please make sure that one of the marked options below is enabled under the PrestaShop back office >> Configure >> Advanced Parameters >> Performance:
Themler theme uses overrides. Therefore overrides should be enabled under the PrestaShop back office >> Configure >> Advanced Parameters >> Performance:
To avoid caching issue it's better to disable "Smart cache for CSS" under PrestaShop back office >> Configure >> Advanced Parameters >> Performance >> CCC:
Permissions
In order to edit the template in Themler and save changes to the template, please make sure that the user and group running on the web server are granted the appropriate read, write and execute (linux only) permissions on the following folders, as well as read and write permission on the files in these folders:
/download/
/override/
/modules/
/themes/
/upload/
How to do this for MacOS or Linux systems:
- Login via ssh/terminal under privileged user, get sufficient access rights if necessary using sudo or su to make next changes
- cd your_web_site_root
For example:cd /var/www/prestashop
- chmod -R u=rwX,g=rX folder_name
For example:chmod -R u=rwX,g=rX app/code/local
- chown -R
: folder_name
For example:chown --R apache:apache app/code/local
NOTE: This is a general approach. We would recommend that you ask your hosting administrator to grant access permissions for the listed folders and files.
- [Install via the Admin Panel](#bo-install) - [Install via FTP](#ftp-install) - [Features of using Themler Themes on PrestaShop](#freatures) - [Permissions](#permissions) <a id="bo-install"></a> ### Install via the Admin Panel (packed template) To install the downloaded template (.zip) via the PrestaShop administration panel, please follow the next steps: 0. Download the Themler theme archive. 1. Go to the **PrestaShop back office** >> **Improve** >> **Design** >> **Theme & Logo**. 2. Click *"Add New Theme"*. 3. Import theme from your computer. !ps17-install.png! 4. Go back to **Improve** >> **Design** >> **Theme & Logo** and activate the newly installed theme with *"Use this theme"* option. **NOTE:** Themler theme for PrestaShop 1.7 contains a **module** which is **required** for theme editing in Themler. The module will be installed and activated once you activate Themler theme. Then the Themler tab will appear on the PrestaShop back office ribbon. 5. Go to **Improve** >> **Themler** menu and click *"Customize with Themler"*. !ps17-edit.png! <a id="ftp-install"></a> ### Install via FTP (unpacked template) To install the theme via FTP you need to download the theme archive to your computer and unpack it. 1. Access Prestashop directory on your server and open `/public/prestashop/themes` folder. 2. Create new folder named the same as the theme name specified in the `config.xml` file of the theme: theme name: `<theme_key>untitled</theme_key>` folder name: `/public/prestashop/themes/untitled` 3. Copy the content of the unpacked theme archive into the newly created folder. 4. Copy the folder `dependencies/modules/themler` into the `/public/prestashop/modules` folder. 4. Activate newly installed theme under the **PrestaShop back office** >> **Improve** >> **Design** >> **Theme & Logo**. <a id="freatures"></a> ### Features of using Themler Themes on PrestaShop 1. In order to avoid issues with applying changes to the theme, please make sure that one of the marked options below is enabled under the **PrestaShop back office** >> **Configure** >> **Advanced Parameters** >> **Performance**: !ps17-compillation.png! 2. Themler theme uses overrides. Therefore overrides should be enabled under the **PrestaShop back office** >> **Configure** >> **Advanced Parameters** >> **Performance**: !ps17-overrides.png! 3. To avoid caching issue it's better to disable *"Smart cache for CSS"* under **PrestaShop back office** >> **Configure** >> **Advanced Parameters** >> **Performance** >> *CCC*: !ps17-cache.png! <a id="permissions"></a> ###Permissions In order to edit the template in Themler and save changes to the template, please make sure that the user and group running on the web server are granted the appropriate read, write and execute (linux only) permissions on the following folders, as well as read and write permission on the files in these folders: /download/ /override/ /modules/ /themes/ /upload/ ####How to do this for MacOS or Linux systems: 1. Login via ssh/terminal under privileged user, get sufficient access rights if necessary using sudo or su to make next changes 2. **cd your_web_site_root** For example: `cd /var/www/prestashop` 3. **chmod -R u=rwX,g=rX folder_name** For example: `chmod -R u=rwX,g=rX app/code/local` 4. **chown -R <user>:<group> folder_name** For example: `chown --R apache:apache app/code/local` **NOTE:** This is a general approach. We would recommend that you ask your hosting administrator to grant access permissions for the listed folders and files.