PrestaShop Documentation, PrestaShop Tutorials

Prestashop how to add a new module, uninstall module & change position

Sure 🙂 Here’s a clear, step-by-step PrestaShop guide covering adding a new module, uninstalling a module, and changing a module’s position (works for PrestaShop 1.7 & 8.x).


🔹 1. How to Add / Install a New Module

âś… Method 1: From PrestaShop Back Office (Recommended)

  1. Go to Back Office → Modules → Module Manager
  2. Click “Upload a module”
  3. Upload the module .zip file
  4. PrestaShop will:
    • Upload
    • Install
    • Enable the module automatically

👉 Done 🎉


âś… Method 2: Manual Upload (FTP)

  1. Extract the module ZIP
  2. Upload the folder to:
    /modules/
    
  3. Go to Back Office → Modules → Module Manager
  4. Find the module → Click Install

⚠️ Folder name must match the module’s internal name.


🔹 2. How to Uninstall a Module

âś… Normal Uninstall (Keeps files)

  1. Go to Modules → Module Manager
  2. Find the module
  3. Click Disable (optional)
  4. Click Uninstall

📌 This removes:

  • Database tables (if module is well-coded)
  • Configurations

But files stay in /modules/


🔥 Complete Removal (Clean uninstall)

After uninstalling:

  1. Delete module folder via FTP:
    /modules/module_name/
    
  2. Clear cache:
    • Advanced Parameters → Performance
    • Clear cache

🔹 3. How to Change Module Position (Hooks)

âś… Method 1: Using Positions (Classic Way)

  1. Go to Design → Positions
  2. Search for the module name
  3. Click “Transplant a module”
  4. Choose:
    • Module
    • Hook (e.g. displayHome, displayHeader)
  5. Save

📌 You can also:

  • Drag & drop modules inside the same hook
  • Change display order

âś… Method 2: From Module Configuration

  1. Go to Modules → Module Manager
  2. Click Configure on the module
  3. Some modules allow selecting hooks directly

đź§  Common Useful Hooks

HookLocation
displayHeaderPage header
displayTopTop bar
displayHomeHomepage
displayFooterFooter
displayLeftColumnLeft sidebar
displayRightColumnRight sidebar
displayProductExtraContentProduct page

🔹 4. Disable Module Without Uninstalling

If you just want to temporarily stop it:

  • Modules → Module Manager → Disable

No data loss 👍


🔹 5. Troubleshooting Tips

  • Module not visible? 👉 Clear cache
  • Layout broken after uninstall? 👉 Regenerate theme cache
  • Module not showing? 👉 Check hook compatibility with your theme

 

About zohaibk

We develop useful addons for #E-Commerce and #CRM software to provide extra features.#PrestaShop,#Magento,#SugarCRM,#Vtiger & #Android #apps
View all posts by zohaibk →