Child pages
  • Managing Modules and Themes

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning

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

Table of Contents
maxLevel3
styledisc
printablefalse

...

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 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:

  • Non-installed: orange.
  • Installed but disabled: gray.
  • Installed and enabled: green.
  • Installed and enabled, but with warnings: red.

...

You cannot perform any other action on the available modules using this view: no installing, configuring, etc.

...

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.

Uninstalling a module

...

Warning

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 changed your theme to take the module into account, make wish to entirely remove the module from your server, click the "Delete" link: PrestaShop will get rid of its folder and all its files.

Tip

Make sure that the disabling or removal of the module does not break the theme.

Positions

A modules may 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.

This The position of a module in your theme can be customizedchanged, because you might want one module to be place 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).

Each

hook's table 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 hoobs 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, and finally . The table lists the attached modules themselves.
For each module, you have access to its position relative to this modules that are attached to that hook.

The modules are displayed in the order in which they appear in the 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:
    1. Place the mouse cursor between the moving arrows and the module's name to have it change into a "move item" cursor.
    2. Click and hold : the row turns orangeMove the while moving the cursor over the row/position where you want the module to be: the module's row changes position accordingly.
    3. Release the mouse button: the now current position for the module is saved.

For most modules, transplantation can easily be done directly via the Back Officeback-office. Certain modules require altering the code in order to transplant the module.

Removing a module from a hook

Transplanting a module via the back-office

...