Table of content
PrestaShop 1.5 comes bundled with over 117 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 didn't 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 you. 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.
- Search field. Modules are displayed while you type their name, which makes it even more intuitive and fast.
- 'Sort by' selectors. The list automatically reloads when you make a select, and displays modules according to all the current settings.
- All modules.
- Native modules. The ones that were in the default distribution of PrestaShop, i.e. not modules that you added afterwards.
- Partner modules. Modules that were created for PrestaShop partners. Most of the time, they enable your shop to work with the partner's third-party service.
- Author. You filter the modules by author. Be default, only "PrestaShop" is available, but as add more modules, this selector will prove very useful.
- Other modules. Modules that are neither native, native made for PrestaShop partners. They are often written by independent developers, but can also be written by the PrestaShop team.
- Installed & Not Installed. Most of the time, you will want to perform an action on an installed module, or install a new one. This filter is the most commonly used.
- Enabled & Disabled. Installed module are the only ones that can be configured, hence the importance of this selector.
- All countries. Some modules are country-specific. This selector enables you to only see the ones that are tailor-made for your shop's country.
- All modules.
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 category 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:
- Non installed: orange.
- Installed but disabled: gray.
- Installed and enabled: green.
- Installed and enabled, but with warnings: red.
Most of the time, warnings are a reminder that you haven't properly configured the module. Click their "Configure" link and go through the various needed steps.
Difference between disabling and uninstalling
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.
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:
- Interest. If set to "No", the module will not appear in your module list at all. If set to "Yes" or "--", it will.
- Favorite. If set to "Yes", the module will appear in the "Favorites" category. If set to "No" or "--", it won't.
Since these can be two contradictory settings, mixing them can result in unexpected results. They remain quiet logical: in short, "Interest" surpasses "Favorites".
Appears in module list?
Appears in "Favorites" category?
You cannot perform any other action on the available modules using this view: no installing, configuring, etc.
Performing Actions On Modules
All actions are performed in the normal view.
- Uninstalled modules:
- Install. This will trigger the installation of the module on your installation of PrestaShop. The module will be automatically enabled. It might add new options to your back-office.
- Delete. This will remove the module from the modules list, and delete its files and folders from your server.
- Installed modules:
- Disable. When installed a module is enabled by default. You can disable, which will remove its options from your back-office, but will keep its settings for a later re-enabling.
- Reset. This will restore the module's settings to their defaults.
- Delete. This will remove the module from the modules list, and delete its files and folders from your server.
- Configure. Some modules need their own configuration page. In that case, they offer a "Configure" link to access a new interface where the user will be able to adjust all its settings.
Configuring The Native Modules
All the native modules are explained in depth in their own chapter, "Making The Native Modules Work".
Modules And Themes Catalog
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. Some are free, others are for-pay, and you're 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" gives you a quick and easy access to the Addons database of modules and themes. 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.
Once you have downloaded a module from the Addons online store, it's 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.
Installing using the dedicated form
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. This will reveal a new section.
Two options are presented in the "Add a new module" section:
- Add a module from a web server: simply put the URL to its online zip file, and validate.
- Add a module from your computer: browse to the module's Zip file that you downloaded, and validate.
In both cases, you must point to the module's Zip archive, and not its folder or any of its unpacked files.
Once validated, PrestaShop will load the module (either from the Web or from your computer), unpack it, place the files in the correct location, and update the page, all this in a handful of seconds.
Installing using an FTP client
To install a new PrestaShop module manually:
- Unzip (decompress) the module archive file (
.zip). This should result in a new folder.
- Using your FTP client, place the folder in your PrestaShop
/modulesfolder. Pay attention NOT to upload that folder in another module's folder (which can happen when drag-and-dropping items). Upload the whole folder, not just the files it contains.
- Go to your back-office, in the "Modules" tab.
- Locate the new module in the modules list. You might have to scroll down; you can also use the list's search engine, which should give you a dynamically updated list of matching module names.
- In the row for the new module, click the "Install" button.
- Your module is now installed and should be activated too (green tick). If necessary, click on the module's "Configure" link. Pay also attention to any warning message that might be displayed by PrestaShop.
Once configuration is complete, be sure to test the module immediately to confirm that it works as planned.
Uninstalling a module
If you only need to temporarily not use the module, but still wish to keep its configuration, you can simply disable it: just click on the green tick, which should then turn into a red cross, meaning that the module is still installed, but disabled.
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 more impact on your shop.
If you changed your theme to take the module into account, make sure that the disabling or removal of the module does not break the theme.
PrestaShop also enables you to access your Addons account right from the back-office.
Log-in using the form on the "My Account" sub-tab, and get access to all your Addons details.
The order in which modules' front-office interface are displayed can be customized – because you might want one module to be place much higher (or lower) in the page that others. In PrestaShop's jargon, this is called "transplanting", and is done using the tool available under the "Positions" sub-tab for 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" home-page displays all the available hooks, and their attached modules.
Each hook's table displays the hook's name, its technical name, its number of attached modules, and finally lists the attached modules themselves.
For each module, you have access to its position relative to this hook.
Moving a module
You have two ways of moving a module within a hook:
- Click the up or down arrow. The page will reload and display the new order.
- Drag and drop the module's row itself:
- Place the mouse cursor between the moving arrows and the module's name to have it change into a "move item" cursor.
- Click and hold: the row turns orange
- Move the cursor over the row/position where you want the module to be: the module's row changes position accordingly.
- Release the mouse button: the now position for the module is saved.
For most modules, transplantation can easily be done directly via the Back Office. Certain modules require altering the code in order to transplant the module.
Transplanting a module via the back-office
- Go to the "Modules" tab, and its "Positions" sub-tab.
- Click the "Transplant a module" link.
- In the "Module" drop-down menu, select the module you want to transplant.
- In the "Hook Into" drop-down menu, select where you want to transplant the module to.
- In the "Exceptions" field, type the name of the file(s) of the pages in which you do not want the module to appear.
- Click the "Save" button.
The "Hook Into" drop-down menu gives you a good idea where module can be placed.
Transplanting a module by modifying its code
Some modules cannot be transplanted into other page sections because they lack the necessary code. For example, the Quick Search block contains templates for both column display and header display, while the Currencies block only has one template file which only pertains to the header section. Likewise, the default Featured Products block can only be placed in the center content section of the main page. If you want to move it to a column, you'll have to do the customization yourself.
If you want to display simpler modules such as the Currencies block or the Featured block in a position for which it wasn't built, you'll have to edit its template files.
To customize the transplantation of a module on a hook, you must give it the PHP function for the hook. For example, the Currency block has this function exists:
In order for instance to transplant the Currency block into the right column, you need to create:
...and edit its PHP, HTML and CSS code accordingly.
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 graphically decide where to place your modules. You can access it from the "Position" sub-tab, by clicking the "Run LiveEdit" button.
Once clicked, PrestaShop opens the homepage in a new browser windows/tab, with the Live Edit script on top:
- All blocks have a dotted red border, enabling you to see which blocks you can move.
- At their top left side, a block-specific icon appears, along with the block's name, enabling you to always find your way among blocks.
- At their top right side, they have two icons:
- A "move" icon: click on it to start moving the module around.
- A "trash" icon: click it to remove the block from the home.
At the bottom of the Live Edit mode, a row presents you with two buttons: "Save" and "Close Live Edit".
The first one is quite self-explanatory; the second one cancels all changes you might have made to your modules during this live-editing session. Note that once you have clicked after having removed a module, you'll have to go to the "Positions" sub-tab and use the "Transplant a module" form in order to bring it back.
Where to move modules
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.
With PrestaShop, you can accept your customer's transactions through several different payment methods, such as checks, bank wire, cash on delivery, Google Checkout, and some partner modules such as Hipay, Moneybookers, and PayPal. They are already included in your store and are ready to be used. However, it is necessary to configure them.
Installing a payment module
Let's install the "Cash on delivery" module. You first need to access the list of payment modules. It is of course accessible via the "Modules" tab, under the "Payments and Gateways" section, but you also have a shortcut from within the "Payment" tab: just click on the appropriate button at the top of the page!
This button will send you directly to the correct module section. Here is the full list of payments modules included in the default PrestaShop install.
Find the "Cash on delivery (COD)" module in the list (third row). To install it, you just need to click on the "Install" button.
Payment Module Restrictions on Currencies
When in the "Payment" tab, you can see the following section:
As you can see, depending upon the payment, the customer's choice of currency will differ:
- Authorize.net, Bank wire, Cash-Ticket, Check, DIBS, Moneybookers, Ogone, and Paysafecard: click on the boxes corresponding with the currencies that you authorize. If you accept several of them, the customer will be able to choose among them at checkout.
- Cash on delivery: The customer will be able to pay only in the currency that he has selected in the store.
- Google Checkout, Hipay, and Paypal: You can choose one accepted currency (among those installed in your store), and allow each customer to pay with the currency that they will have chosen in the store.
Another option is that you can only accept payment with the store's default currency (which you can set in the "Payment" tab, "Currencies" sub-tab, "Currency options" setting).
Payment Module Restrictions on Groups
You can limit the choice of payment method depending on the group of customers.
For instance, let's say you would prefer that individuals pay with PayPal, Moneybookers and Hipay, while professionals only pay by bank wire. Depending on the type of customer and on your choices, customers will only pay using the methods that match with your decisions.
Payment Module Restrictions on Countries
You can limit the choice of payment methods according to your customer's country of origin. For instance, in France, Spain, and Germany, you can accept all payment methods, while customers in Italy, the United Kingdom or Switzerland can only pay by bank wire.
The choice of payment modules according to country is found under the "Payment" tab, in the "Countries restrictions" section.
Find the country in the alphabetical list, and check the boxes to select or deselect 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.