This documentation is currently being worked on. Until the stable version of PrestaShop 1.5 is released, it should not be seen as definitive. |
Table of content
PrestaShop 1.5 comes bundled with over 120 modules that can be installed/uninstalled and configured as desired, in order to customize and complete your shop.
The range of actions is virtually unlimited: the extensibility of PrestaShop makes it possible to turn your shop into exactly what you intend it to do, instead of you having to comply with constraints that you did not choose – provided you can find the module that does exactly what you need.
The "Modules" page under the "Modules" tab gives you access to the list of modules. On this page you can install, uninstall, and configure each module.
Above and below the page title, you will at times get notifications from installed modules. Most of the time, the notification help you complete the configuration of modules that are installed but not yet ready to be used: updating their setting should make the notification disappear... and your module work properly.
Above the table of modules are two buttons, titled "Normal view" and "Favorite view". They radically change the way modules are listed.
This is the default view. It enables you to quickly find the module you want to install or edit the settings of.
The first section is where you can search for a specific module, or filter down module until you find the one you are looking for.
On the left is a list of all the categories, with the number of modules in brackets. Click on a module category in order to filter the displayed module.
One of the categories is named "Favorites" and is empty by default. This serves as a quick way to access the modules you most often need to access to. You can set your favorite modules using the "Favorites" view.
Modules can have one of 4 statuses, each with specific color:
Most of the time, warnings are a reminder that you have not properly configured the module. Click their "Configure" link and go through the various needed steps.
When you do not have a use for a module anymore, you can either disable or uninstall it. The result of both actions is the same: the module is not available anymore, its options do not appear in your back-office and any element it would add to your front-end disappears. The difference is that disabling a module keeps its configuration safe for a later re-enabling, while uninstalling removes all configuration and database data. Therefore, only uninstall a module if you do not care about its data or if you are certain that you would not need it. If you are really sure you do not want that module on your shop, you can even click on its "Delete" link. |
Some modules have "(Addons)" at the end of their name – mostly the payment modules. This means the modules will not be installed from files on your server, but downloaded from the Addons website. It helps ensure that you always have the latest version of a module. Still, installing a module from files that are downloaded from the Addons server is no different for PrestaShop from installing it from files that are already on your server. |
This view gives a whole different presentation of your modules: gone is the list of category selectors, the install/uninstall buttons and the action links. This view gives an alphabetical list of all your modules, both installed or not, their categories in plain text and two drop-down menus:
Since these can be two contradictory settings, mixing them can result in unexpected results. They remain quiet logical: in short, "Interest" surpasses "Favorites".
Interest |
Favorite |
Appears in module list? |
Appears in "Favorites" category? |
---|---|---|---|
Yes |
Yes |
Yes |
Yes |
No |
Yes |
No |
No |
Yes |
No |
Yes |
No |
No |
No |
No |
No |
You cannot perform any other action on the available modules using this view: installing, configuring, etc.
All actions are performed in the normal view.
Top ranking modules from Addons can be promoted to your module list, depending on your country settings. They appear among regular modules, but their action buttons are not labeled "Install" but instead "Buy - 30 €", for instance. Clicking on the button takes you to the module's Addons page, from which you can log in, buy and download the module. From there on, you can installation on your PrestaShop installation. |
All the native modules are explained in depth in their own chapter, "Making The Native Modules Work".
PrestaShop comes bundled with a host of modules, but even that number might seem limiting, or you could want to explore other directions.
There are many more modules available on the PrestaShop Addons website (http://addons.prestashop.com/). Some are free, others are for-pay, and you are sure to find something that suits your needs! Once you are a seasoned module developer/theme designer, you can even submit your own creations, and sell them on Addons!
The "Modules & Themes Catalog" page gives you a quick and easy access to the online Addons database of modules and themes. Its interface is pretty straightforward:
A search query will return the 5 first results from Addons, with more available if you click on the "View all results on addons.prestashop.com" link at top of the results.
Clicking on an item will open its Addons page in a new browser tab.
Addons is the official marketplace for PrestaShop Modules and Themes. This is where shop owners can get all the necessary items to customize their shop, and where authors can share their creations with the community. Modules and themes can either be free or for-sale: the price is set by the author. Take the time to browse the available modules and themes, because expensive does not always mean better. You must be logged-in before you can download or rate anything. Creating an account is free. |
Once you have downloaded a module from the Addons online shop to your computer, it is up to you have it installed on your PrestaShop site.
There are two ways to install a module: either using the dedicated form, or using your FTP client.
To install a new PrestaShop module automatically, click on the "Add a module from my computer" link at the top of the list of modules. A new section will slide open.
The form in this section enables you to upload the archive file of the module, as downloaded from Addons. You can either upload a zip
file, or a tar.gz
one (tarball). The form is straightforward: simply browse to the module's file that you downloaded, and click the "Upload this module" button. Do not point to the module's folder or any of its unpacked files!
In previous version, you could upload the module's zip file on your FTP server and point the form to that file's URL. |
Once you have clicked the button, PrestaShop will upload the module from your computer to its server, unpack it, place the files in the correct location, and update the page, all this in a handful of seconds. PrestaShop will then display "Module downloaded successfully".
Modules are not installed by default: you still have to click the module's "Install" button, and then possibly configure its settings.
Once configuration is complete, be sure to test the module immediately to confirm that it works as planned.
To install a new PrestaShop module manually:
.zip
or tar.gz
). This should result in a new folder./modules
folder.Once configuration is complete, be sure to test the module immediately to confirm that it works as planned.
Your PrestaShop installation regularly checks with the Addons server if there is any update for your modules. If so, PrestaShop displays a "Update" link for the affected modules. Simply click, and PrestaShop will take care of downloading and updating the module.
Do not ever delete a module by directly trashing its folder using your FTP client! You must let PrestaShop take charge of it; |
When you need to temporarily stop using a module, but still wish to keep its configuration, you can simply disable it: just click on the "Disable" link. The actions will turn into "Enable" and "Delete", but the "Uninstall" button can still be seen.
If you do not care about the module's configuration, click on the "Uninstall" button: your module's folder will still be in the /modules
folder, but the module will not have any impact on your shop anymore.
If you wish to entirely remove the module from your server, click the "Delete" link: PrestaShop will get rid of its folder and all its files.
Make sure that the disabling or removal of the module does not break the theme. |
A modules can have to aspects: one on the back-office (its options, or even a configuration screen), and one on the front-office. The front-office view is how and where the module is displayed within your shop's theme.
The position of a module in your theme can be changed, because you might want one module to be placed much higher (or lower) in the page that others. In PrestaShop's parlance, this is called "transplanting", and is done using the tool available in the "Positions" page, under the "Modules" tab. In effect, this enables you to attach a module to one of the many available hooks in the current theme, without writing any code.
The "Positions" page displays all the available hooks, and their attached modules. Many are empty by default, but some of the most useful ones have a dozen of modules (the Header hook has 27 by default).
At the top of the page, a drop-down menu enables you to only display the hook in which you are interested.
By default, this page only displays the hooks on which you can position functions. Checking the "Display non-positionable hooks" box below displays all the hooks, even those where you cannot position something.
The header of the table for each hook displays the hook's name, its technical name (and for some, a quick description), and its number of attached modules. The table lists the modules that are attached to that hook.
The modules are displayed in the order in which they appear in the hook.
You have two ways of changing a module's position within a hook:
For most modules, transplantation can easily be done directly via the back-office. Some modules require you to alter their code in order to transplant them.
In PrestaShop, "transplanting" is the action of attaching a module to a hook. You can add a module to more than one hook.
Two things to know before transplanting a module:
Therefore, be aware that you cannot always transplant any module to any hook.
Make sure to disable the cache when testing the effect of a new hook on the front-end. You can do this in the "Preferences" page, under the "Advanced parameters" tab. |
The transplanting process has its own interface:
The "Hook into" drop-down menu gives you a good idea where module can be placed.
Even though the "Hook into" drop-down list gives a comprehensive overview of the available hooks, it might not always be clear which is the one to which you want to attach your module. Do not hesitate to try another hook if the result of your selection if not what you expect.
Since PrestaShop 1.5, the list gives more detail: both the hook name and a quick description of what it does, for instance "Before carrier list" known as "displayBeforeCarrier"
. Peruse them all in order to choose your hook correctly.
Each module has two icons on the right side of its row: one to edit its settings, the other to delete the icon.
Editing a module's setting uses the same interface as the one created for the transplanting a module. The major difference is that you cannot change the "Module" and "Hook into" settings, as they are disabled, and thus greyed out. You can only edit the exception setting, which works just as described in the "Attaching a module to a hook" method above.
While you cannot edit the "Module" and "Hook into" settings, they can serve as a handy reminder of their current position, should you want to put them back there later on.
If you want to move a module to another hook, you must use the transplanting interface:
Always check your front-office to make sure the module is indeed where you intended it to be.
There are two ways to remove a module from a hook:
Another way to move modules around on the shop's homepage is the Live Edit mode, which embeds said homepage into a tool that lets you visually decide where to place your modules. You can access it from the "Position" page, by clicking the "Run LiveEdit" button.
When clicked, PrestaShop opens the homepage in a new browser windows/tab, with the Live Edit script on top:
At the top of the Live Edit mode, a toolbar presents you with two buttons: "Close Live Edit" and "Save".
The first one is quite self-explanatory; the second one cancels all changes you might have made to your modules' position during this live-editing session.
Once you have save your changes after having removed a module, if you want to bring it back, you will have to go to the "Positions" page and use the "Transplant a module" tool. |
Modules cannot be moved just about anywhere: it depends on both the theme's hooks, and each module's hook support (as seen in the above section). Therefore, you mostly can only move modules within their understood context: column modules can be moved within a column as well as from one column to the other (right to left, for instance), while regular homepage modules (the ones at the center) can only be moved within their specific column.
In order to give you a visual hint about where a given module can be moved, it will display an empty green block if the location is correct, and an empty red block if not.
This is for experts only: you must have a good knowledge of PHP and HTML before attempting anything with the code of a module. |
Some modules cannot be transplanted into other sections of the front-office simply because they lack the necessary code.
For example, the "Quick Search" block (/blocksearch
) contains templates for both column display and header display, whereas the "Currencies" block (/blockcurrencies
) only has one template file which only works with the header section. Likewise, the default "Featured Products" block (/homefeatured
) can only be placed in the center content section of the main page.
If you want to display simple modules such as the "Currencies" block in a position for which it was not built, you will have to edit its template files.
More complex module, such as the "Featured" block, can also be made to display in other sections of the page, but they might have to be partly rewritten in order to have their design work with that new location.
To customize the transplantation ability of a module, you must give it the correct PHP function for the new target hook. For example, the "Currency" block has this function:
function hookTop($params) { ... } |
In order to transplant the "Currency" block into the right column, for instance, you need to add the hookRightColumn()
function:
function hookRightColumn($params) { ... } |
Afterwards, you must write the code that displays the content on the front page. At best, that means copy/pasting the content of the hookTop()
function; at worst, you need to rework the content of hookTop()
function into something that will work for the new location.
With PrestaShop, you can accept your customer's transactions using several different payment methods, such as checks, bank wire, cash on delivery, and through several partner modules such as PayPal, Moneybookers, Hipay, etc.
When in the "Payment" page, you can see the following sections:
Installing a payment module is fundamentally no different from installing a regular module: simply click the "Install" button, and you are done.
You should simply pay a lot of attention to the settings, and make sure they do point to your address or bank account. Configuring payment modules often means you must first be known by the payment service provider, meaning having an account on their service.
Let's install the "Cash on delivery (COD)" module. You first need to access the list of payment modules. It is of course accessible via the "Modules" tab, in the "Payments and Gateways" category; but you also have a shortcut from within the "Payments" page: just click on the "Click to see the list of payment modules" button to be taken you to the specific part of the "Modules" page where only "Payment & Gateways" modules are displayed.
As you can see, many payment modules have "(Addons)" at the end of their name. This means the modules will not be installed from files on your server, but downloaded from the Addons website. The files for the partner modules are not part of the default PrestaShop archive anymore since version 1.5. It helps ensure that you always have the latest version of a module. |
Find the "Cash on delivery (COD)" module in the list (third row). To install it, you just need to click on the "Install" button. PrestaShop will take care of everything, and notify you of the result. For instance, if a module needs to be configured before it can work, PrestaShop will display a notification box at the top of the page. In the case of the "Cash on delivery" module, there is nothing to configure.
Depending upon the payment, the customer's choice of currency can differ
You can limit the choice of available payment methods depending on the available currencies: you may want customers to be able to pay with any currency when using PayPal, but those paying Moneybookers should only pay using dollars, for instance.
By default, only your shop's default currency is available. If you need more, follow this process:
|
If you need to restrict payment module usage according to the user's currency, simply check the boxes that apply and click on the "Save restrictions".
Note that currency restrictions work in different ways depending on the payment module. For instance, with the native payment modules:
The customer can set his or her currency using the drop-down menu at the top of each front-office page.
You can set the shop's default currency in the "Localization" page, under the "Localization" menu.
If you change the default currency after having configured some first products, you will have to reset the price of all these products. You should set the default price once and for all before adding any product. |
You can limit the choice of available payment methods depending on the group of customers: you can have a set number of customer groups where people can have access to more payment methods then regular customers.
For instance, you could choose to have regular customers pay with PayPal, Moneybookers and Hipay, while professionals would only be able to pay by bank wire. Depending on the type of customers and on your choices, customers will only pay using the methods that match with your decisions.
You can limit the choice of payment methods according to your customer's country of origin. For instance, you could choose to accept all payment methods for customers from France, Spain and Germany, while customers from Italy, the United Kingdom and Switzerland would only be able to pay by bank wire.
The table lists all the known countries. If one is missing, you can add it using the "Countries" page, under the "Localization" menu.
Here again, just as with currency limitations, the available option vary depending on the payment module:
Find the country you are looking for in the alphabetical list, and check the boxes to select or unselect the payment methods you want to make available to customers from that country. Once all of your settings have been configured, click on the "Save restrictions" button, found at the bottom of the table.
By default, all installed payment methods are enabled for the shop's country.