Table of contentcontents

...

Troubleshooting

How to modify a page's display?

...

Once created, you can use your selectors in the .tpl page you want to modify.

How to create your own page/template?

You can also create your own .tpl file (located in your theme directory), where you can insert your own HTML tags, and create a .php page (at the root of your shop) which will call the .tpl file.

Here is an example:

First, your_page.php:

<?php
include(dirname(FILE).’'/config/config.inc.php’php');
include(dirname(FILE).’'/header.php’php');

$smarty->display(PS_THEME_DIR.‘your'your_page.tpl’tpl');

include(dirname(FILE).’'/footer.php’php');
?>

With that, your_page.tpl contains your HTML code.

How to generate the .htaccess file with PrestaShop's back office, in order to get Friendly URL?

The .htaccess file, located at your shop root, enables you to set some environment variables (like the PHP version). You can also use to customize the URL-rewriting rules, and control the access to some directories and some other actions.

...

First thing to do: make a backup of your existing .htaccess file if any, locally or online.

...

Once Apache is configured, if there is no .htaccess file in your shop's root directory yet, create an empty one:

1. Create an empty file on your desktop with a simple text-editor, such as Windows's Notepad (not Word!) or OS X's TextEdit.
2. Save the file as htaccess.txt, in a folder where you can easily find it. If possible, save it as an purely ASCII or ANSI file.
3. Upload it to your server using an FTP client, such as FileZilla. Put the file at the root of your shop's directory.
4. Change its permissions to read and write everyone (CHMOD 666 in Unix), with your FTP client for instance).
5. Go to the PrestaShop back-office, and under the Preferences tab and "SEO & URLs" sub-tab, enable "Friendly URL" (bottom of the page).
6. Go to the "Tools" tab, then the "Generators" sub-tab, and click the "Generate the .htaccess file" button.

Warning: it will overwrite the existing one. If it was an empty file, that's okay, but if you have specific instructions in this existing, you should first move them over to the text-field in the "Generators" sub-tab, so that they are still found in the .htaccess file. If you forget to move your existing .htaccess instructions over, you risk putting your shop offline.

...

This is done in your PrestaShop install's /config/config.inc.php file. You should edit it in order to add the following lines:

@ini_set('display_errors', 'on');
define('PS_DEBUG_SQL', true);

...

Note that it could also be a .htaccess issue. Read the previous entry, "ow how to generate the .htaccess file".

...

If you make a CSV Import with accentuated texts, beware to select UTF-8 or iso-8859-1 in the "Import" sub-tab of the "Tools" tab, and be sure that the .csv file has been saved with the same encoding.

...

To change the maximum size of the uploaded files in your server, you have to edit the php.ini file for your PHP install. This can only be done if you do have access to your server's PHP configuration files. If not, ask your host.

If you do have access to php.ini, open it and edit the following lines:

post_max_size = [anything]
upload_max_filesize = [anything]

If you want to set the maximum to 200 megabytes, change their values to

post_max_size = 200M
upload_max_filesize = 200M

...

How to add a link or an image to customize the mails sent to your customers?

Prestashop PrestaShop enables you to automatically send a large number of mails to your customers (order confirmations, site subscriptions, out of stock notifications, etc.). It might be useful to customize these mails: adding images, links to survey forms or information pages (blogs, news, etc.).

...

1. Go to the /mails/en directory from your shop root.
2. Edit the HTML template relative to the mail you want to modify: for instance, order_conf.html is the e-mail sent for new orders.

3. Insert the link to the survey right in the HTML code (static):

   Code Block
   html html
   <a href="http://www.myshop.com/survey.php">Click here if you want to participate to our survey !</a>

   or a dynamic link with your logo:

   Code Block
   html html
   <a href="{shop_url}" title="{shop_name}"><img alt="{shop_name}" src="{shop_logo}" style="border:none;"></a>

4. (Optional) To change the default color (which is pink: #DB3484), change the hexadecimal value to your preferred color value.
5. Save the file.

...

1. Go to phpMyAdmin. If you can access it, ask your host to perform these actions.
2. Select your shop's database, and select the ps_lang table.
3. Click "Insert", and create a new entry with these values
   • id_lang -> 1
   • name -> English
   • active -> 1
   • iso_code -> fr
4. Execute the query.
   You should be able to log in again.

How to create a new translation

Follow these steps:

1. Go to your PrestaShop back-office, in the "Tools" tab, and its "Languages" subtab.
2. Add a new language.
3. Note: You can download the flags used in PrestaShop. Don’t forget to activate the language.
4. Go to the "Translations" tab.
5. In the "Copy" section: select "English, prestashop" to "Your language, prestashop", then click "Copy".
6. In the "Modify translations" section: choose "Front Office Translations" in the drop-down list, then click the flag of the new language. Begin to translate the fields. Click "Save the modifications" once it all seems correct to you.
7. Repeat the last step for each type of translation ("Back Office", "Modules", etc.).
8. Your version of PrestaShop is now totally translated! Test, test, test! Have your friends test it too!
9. If you want to contribute it to the PrestaShop project, you can propose your new translation to the PrestaShop Team. In the "Export a language" section, select the new language; in the following fields select "prestashop" then click "Export". Save this file and send it to [email protected] with as subject "New translation: XX" with "XX" being ISO code of the language.
10. You have contributed to the PrestaShop project! Thank you so much!