Child pages
  • Managing Modules and Themes

Versions Compared

Key

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

...

The "Modules" page under the "Modules" tab menu gives you access to the list of modules. On this page you can install, uninstall, and configure each module.

...

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.

...

  1. Unzip (decompress) the module archive file (.zip or tar.gz). This should result in a new folder.
  2. Using your FTP client, connect to PrestaShop web server, and place the unpacked module folder in PrestaShop's /modules folder.
    Pay attention NOT to upload that folder in another module's folder (which can happen when drag-and-dropping items). Upload both the folder and the files it contains, not just the files.
  3. Go to your back-office, in the "Modules" tabmenu.
  4. 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.
  5. In the row for the new module, click the "Install" button.
  6. Your module is now installed and should be activated too. If necessary, click on the module's "Configure" link. Also, pay attention to any warning message that might be displayed by PrestaShop.

...

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.

...

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" tabmenu. In effect, this enables you to attach a module to one of the many available hooks in the current theme, without writing any code.

...

Info

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" tabmenu.

The transplanting process has its own interface:

  1. Go to the "Modules" tabmenu, 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.

...

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

...

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

...

Find the "Cash on delivery (COD)" module in the list (third rowsorted 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.

...

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" tabmenu, 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" tabmenu, enabled the currencies you just imported.

...

  • Buyster: the only option is you your own country.
  • Hipay: the only options are the set of countries supported by the service: Austria, Belgium, France, etc.
  • All the others work with all countries.

...