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

Hook Location
displayHeader Page header
displayTop Top bar
displayHome Homepage
displayFooter Footer
displayLeftColumn Left sidebar
displayRightColumn Right sidebar
displayProductExtraContent Product 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 →