Table of content
See the "Getting Started" guide.
Here is the answer in English and in French.
PrestaShop is released under the Open Software License (OSL) v. 3.0. Its modules are released under the Academic Free License 3.0.
See the Designer Guide.
See the documentation on the Import tool.
In previous version of PrestaShop, you had to manually generate a new .htaccess
file after having enabled friendly URLs. This is no longer the case since version 1.5: the .htaccess
file is now silently managed by PrestaShop, and you do not have to worry about it.
See the documentation on the "SEO & URLs" preferences page.
This is done in the "Translations" page of the "Localization" menu.
See the documentation on the "Localization" menu.
You can obtain all payments modules on PrestaShop's Add-Ons site.
Many payments modules for several banks and payments process are available. You will be able to accept credit card payments and payments in several times.
This is done in the "Currency" page of the "Localization" menu.
See the documentation on the "Localization" menu.
Here is the standard Windows instructions are:
php.ini
file.extension=php_gd2.dll
line (about half-way through the file, in the middle of a long list of extensions) by deleting the ;
at the start of the line.If you cannot edit the server settings, contact your host.
Go to the "Modules" page, and install the Paypal module. Do not forget to configure it!
See the documentation for the "Modules" menu, mostly the "Installing a payment module" section.
You need to associate the product to the homepage category. For each product you want displayed on the front-page, open the "Association" tab and select the "Home" category, in addition to the already-checked category.
See the documentation for the "Associations" tab of the "Catalog" page.
Go to the "Taxes" and "Tax rules" pages of the "Localization" menu.
See the documentation for the "Localization" menu.
See the page on updating your version of PrestaShop.
See the "Making the native modules work" chapter of the documentation, for the "Modules" page.
Install the "RSS products feed" module, from the "Modules" page.
Everything happens in the "Merchandise returns" of the "Orders" menu.
See the documentation for the "Orders" menu.
In the back-office, navigate to "Preferences" > "CMS", and select the pages you want to edit.
The default theme features 5 icons with a bit of text:
These are all "reassurance" text: text that is only present to reassure your potential customers, let them know that your store is trustworthy.
While it is important to reassure your client, not all of this applies to your store: you might not have stores to retrieve products from, or your might not offer free shipping. Therefore, you need to change this. Here is how:
The default theme for PrestaShop features an image slider. You can edit that slider by configuring the "Image slider for your homepage" module, which can be found in the "Modules" page of the back-office.
The default theme also features a block containing featured products. The products displayed are the ones which are associated with the home-page along with their default category (see the question above). This slider is managed using the "Featured Products on the homepage" module, which can be found in the "Modules" page of the back-office. You can remove the slider from the homepage by uninstalling the module, or you can set the number of products to be displayed by configuring the module (click the "Configure" button for the module in the "Modules" page).
Some themes feature a default text on the homepage. This text is often managed by the "Home text editor" module, which can be found in the "Modules" page of the back-office. You can remove the text from the homepage by uninstalling the module, or you can set the content of the text (including its static image) by configuring the module (click the "Configure" button for the module in the "Modules" page).
Those blank pages are a HTTP 500 error. You can see that more properly by viewing the shop in the Chrome browser. Read more about it here:
This is a server error, which means that either the server has an issue, or the website's programming (ie., PrestaShop itself) has had something wrong happen.
HTTP 500 being a very general error, you will need more information in order to pinpoint where the problem is. You can do so by enabling the debug messages. Follow these instructions:
using your FTP client, go to your web server’s FTP, and open the file defines.inc.php
, which is in the /config
folder. There's a bunch of text, then this appears:
/* Debug only */ define('_PS_MODE_DEV_', false); if (_PS_MODE_DEV_) |
change that second line: replace "false" with "true" (without quotes). It should now read:
/* Debug only */ define('_PS_MODE_DEV_', true); if (_PS_MODE_DEV_) |
The "dev" mode is now enabled, and more detailed error messages should display. Use that to find where the problem lies – it could be a module, a section of the theme, or maybe even PrestaShop itself.
Once you have fixed the issue and error messages do not appear anymore, change the edited line back to "false".
CMS pages are built using a WYSIWYG system, which is based on the popular TinyMCE (http://www.tinymce.com/). When creating or editing a page, the editor presents a series of button, used to format and improve the text.
The "Upload" button is located int the bottom row of the interface:
In many countries, professionals are used to see prices displayed without the tax (even if the tax is indeed included in the final invoice).
This is not set up by default, but you you can easily put that in place for some select users. Regular users will still see the prices including taxes.
Now go to the "Customers" page, and for each professional customer:
This way, the clients marked as professionals will see prices without taxes as soon as they connect to their account. Visitors, guest and regular clients will still see tax-included prices.
The maintenance page is actually a regular template file, located in your theme's folder.
You should therefore be able to find it in the name of maintenance.tpl
, in the /themes/your_theme
folder.
Open the maintenance.tpl
file with a text editor, and edit at will. Be careful not to break the Smarty tags (marked {tag}
or {/tag}
) ; make sure to keep a backup in the folder, for instance under the name maintenance-originalFile.tpl
.
You have to add your own selectors in your theme's CSS file. This file is usually found in /themes/YOUR_THEME/css/global.css
.
Once created, you can use your selectors in the .tpl
page you want to modify.
You can also create your own .tpl
file (located in your theme directory), in which 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'); include(dirname(__FILE__).'/header.php'); $smarty->display(_PS_THEME_DIR_.'your_page.tpl'); include(dirname(__FILE__).'/footer.php'); ?> |
In this example, the your_page.tpl
file contains your HTML code (which can use Smarty calls).
If you make a CSV import with accentuated texts, be sure that the .csv
file has been saved eith with the UTF-8 or iso-8859-1 encoding. If it is using iso-8859-1, make sure to indicate that in the "Import" page of the "Advanced parameters" menu. PrestaShop's default encoding is UTF-8.
If the CSV file does not use any of these encodings, open it in a text-editor (such as Notepad++), and save it using the UTF-8 encoding.
To change the maximum size of the uploaded files in your server, you have to edit the php.ini
file for your PHP installation. 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 |
Finally, restart the server to take your changes into account.
PrestaShop enables you to automatically send a great variety 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.).
Let's say your company wants to customize the e-mail sent automatically to customers after a purchase, in order to redirect them to a survey form.
To add a link in the mails sent to your English-speaking customers, you have to:
/mails/en
directory from your shop root.order_conf.html
is the e-mail sent for new orders.Insert the link to the survey right in the HTML code (static):
<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:
<a href="{shop_url}" title="{shop_name}"><img alt="{shop_name}" src="{shop_logo}" style="border:none;"></a> |
Save the file.
Now the link will be added in every new mail sent after a purchase.
Follow these steps:
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 the ISO code of the language (http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
You have contributed to the PrestaShop project! Thank you so much!
While you can change the translation for all the strings within the PrestaShop administration, you cannot edit the names of the administration menus (Catalog, Orders, Customers, etc.) and their submenus (Products, Categories, Monitoring, etc.).
This is because these strings are not part of the translation files, but are stored directly within the database. In order to change it, you must go to the "Menus" page of the "Administration" menu.
This page displays a list of all the top-level menus in your administration, and you can also display their submenus by clicking on the "+" icon in the "Action" column.
From there, you can click on the "edit" icon for the menu or submenu you wish the change the name of. In the page that displays, click the flag next to the "Name" field in order to choose the languages for wish you want to translate the menu (you must have the target language already installed!), or directly change the name in the current language.
Save your changes: the administration is immediately updated with your new translation.
Note that this means you cannot send your menu translation to another shop. The manager of that other shop must perform these steps himself.