Child pages
  • Managing Modules and Themes

Versions Compared

Key

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

...

This is the default view. It enables you to quickly find the module you want to install or edit the settings of.

Image Added

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.

...

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.

Image Added

This view gives an alphabetical list of all your modules, both installed or not, their categories in plain text and two drop-down menus:

...

PrestaShop comes bundled with a host of modules, but even that number might seem limiting, or you could want to explore other directions.

Image Added

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!

...

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, in the "Modules" page. A new section will slide open.

Image Added

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!

...

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).

Image Added

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.

...

  • 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 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 current position for the module is saved.

Image Added

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.

...

  1. Go to the "Modules" menu, and its "Positions" page.
  2. Click the "Transplant a module" button at the top right. The transplanting interface appears.
  3. In the "Module" drop-down list, select the module you want to transplant.
  4. In the "Hook into" drop-down list, select where you want to transplant the module to. There are many available hooks. You can change your setting later if needed.
  5. In the "Exceptions" field, type the name of the file(s) of the pages in which you do not want the module to appear.
    Since PrestaShop 1.5, instead of typing the file-names, you can simply select a file-name and click the "Add" button: it will add the file-name to the list.
    Likewise, you can remove a file-name from the existing list by selecting that name in the drop-down list and clicking the "Remove" button.
  6. Do not forget to save your changes.

Image Added

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.

...

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 grayed 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.

Image Added

If you want to move a module to another hook, you must use the transplanting interface:

...

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.

Image Added

When clicked, PrestaShop opens the homepage in a new browser windows/tab, with the Live Edit script on top:

  • All module 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:
    1. A "move" icon: click on it to start moving the module around.
    2. A "trash" icon: click it to remove the block from the home.

Image Added

At the top of the Live Edit mode, a toolbar presents you with two buttons: "Close Live Edit" and "Save".

...

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" menu, 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.

Image Added

Tip

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 (sorted alphabetically). 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.

Image Added

Payment Module Restrictions on Currencies

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.

Image Added

Tip
tileAdding a new currency

By default, only your shop's default currency is available. If you need more, follow this process:

  • In the "Localization" page under the "Localization" menu, import the localization pack for the country which has the currency in which you are interested. For instance, USA for US Dollars, United Kingdom for UK Pound, etc.
  • In the "Currencies" page under the "Localization" menu, enabled the currencies you just imported.

...

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.

Image Added

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.

Image Added

The table lists all the known countries. If one is missing, you can add it using the "Countries" page, under the "Localization" menu.

...