DEV Community: Gofenice Technologies

Creating a Custom Module in PrestaShop: A Step-by-Step Guide for Developers

Gofenice Technologies — Thu, 12 Jun 2025 06:56:36 +0000

If you’re a developer working with PrestaShop, you’ve likely come across situations where default functionality just isn’t enough — and that’s where custom modules come in.

In this guide, we’ll walk through the process of building a basic PrestaShop module. You’ll learn how to:

Set up the folder structure

Display frontend content

Add configuration options in the admin panel

Whether you’re building something simple like a promotional banner or a complex integration, the same fundamentals apply.

Let’s dive in.

📁 Step 1: Create the Module Folder and File
Go to your PrestaShop root directory and navigate to:
/modules

Create a new folder, e.g., mymodule.

Inside that, create a PHP file with the same name:
mymodule.php

Folder Structure:
markdown
Copy
Edit
modules/
└── mymodule/
└── mymodule.php
🧱 Step 2: Define the Module Class
Your module class should extend Module. Here’s a basic setup:

php
Copy
Edit
<?php
if (!defined('PS_VERSION')) {
exit;
}

class MyModule extends Module
{
public function __construct()
{
$this->name = 'mymodule';
$this->tab = 'front_office_features';
$this->version = '1.0.0';
$this->author = 'Your Name';
$this->need_instance = 0;

    parent::__construct();

    $this->displayName = $this->l('My Custom Module');
    $this->description = $this->l('Displays a custom message on the homepage.');
}

public function install()
{
    return parent::install() && $this->registerHook('displayHome');
}

public function uninstall()
{
    return parent::uninstall();
}

public function hookDisplayHome($params)
{
    return '<p style="text-align:center;">Hello from My Custom Module 👋</p>';
}

}
🪝 Step 3: Register and Use a Hook
We’ve used hookDisplayHome in this example. It outputs HTML on the homepage.

Make sure you go to the Modules → Module Manager in the back office, install your module, and position it correctly via Positions.

🔧 You can explore other hooks like displayFooter, displayNav1, or admin-specific ones.

⚙️ Step 4: Add Configuration in the Back Office
Let’s make it configurable! Add the following methods to your class:

Add the config form:
php
Copy
Edit
public function getContent()
{
$output = '';
if (Tools::isSubmit('submit_mymodule')) {
$custom_message = Tools::getValue('MYMODULE_MESSAGE');
Configuration::updateValue('MYMODULE_MESSAGE', $custom_message);
$output .= $this->displayConfirmation($this->l('Settings updated'));
}

return $output.$this->renderForm();

}

protected function renderForm()
{
$default_lang = (int)Configuration::get('PS_LANG_DEFAULT');

$fields_form[0]['form'] = [
    'legend' => ['title' => $this->l('Settings')],
    'input' => [
        [
            'type' => 'text',
            'label' => $this->l('Custom Message'),
            'name' => 'MYMODULE_MESSAGE',
            'size' => 20,
            'required' => true
        ]
    ],
    'submit' => [
        'title' => $this->l('Save'),
        'class' => 'btn btn-default pull-right'
    ]
];

$helper = new HelperForm();
$helper->module = $this;
$helper->name_controller = $this->name;
$helper->default_form_language = $default_lang;
$helper->allow_employee_form_lang = $default_lang;
$helper->submit_action = 'submit_mymodule';
$helper->fields_value['MYMODULE_MESSAGE'] = Configuration::get('MYMODULE_MESSAGE');

return $helper->generateForm($fields_form);

}
Update the hook output:
php
Copy
Edit
public function hookDisplayHome($params)
{
$message = Configuration::get('MYMODULE_MESSAGE');
return '

' . htmlspecialchars($message) . '

';
}
Now, whatever message you set in the module settings will appear on your homepage!

🐞 Common Pitfalls to Avoid
Make sure your module folder name and main class name match (mymodule and mymodule.php).

Always check for Tools::getValue() vs. Configuration::get() usage.

Use htmlspecialchars() or PrestaShop sanitization functions to avoid XSS vulnerabilities.

Clear PrestaShop cache after making changes.

🧪 Bonus: Testing Your Module
Use a staging environment before pushing changes to a live site.

Enable debugging via config/defines.inc.php:

php
Copy
Edit
define('PS_MODE_DEV', true);
Check for errors in /var/logs or browser console if your output doesn’t render.

🚀 Final Thoughts
PrestaShop modules give you huge flexibility as a developer — from tiny UI tweaks to full-featured integrations. This example is basic, but once you understand the fundamentals, you can build almost anything.

If you found this useful or want more advanced tutorials (like admin controller creation, API integrations, or AJAX forms in modules), drop a comment below or follow me!

Why PrestaShop Performance Matters and How to Improve It

Gofenice Technologies — Wed, 11 Jun 2025 08:11:47 +0000

In the fast-paced world of e-commerce, every second counts. A slow-loading website can frustrate customers, hurt your Google rankings, and lead to lost sales. PrestaShop, while powerful, needs regular performance optimization to keep it running smoothly. 🚀

In this post, I’ll share:
✅ Why performance matters for your PrestaShop store
✅ Common performance issues and their impact
✅ Practical tips to speed up your PrestaShop site and boost conversions

Let’s dive in!

🔎 Why Performance Matters:

First impressions count: 40% of users abandon a site if it takes more than 3 seconds to load

SEO rankings: Google prioritizes faster sites in search results

Conversion rates: Every second of delay costs money—Amazon famously found a 1-second delay costs them millions

Common Performance Bottlenecks in PrestaShop

Large, uncompressed images
Too many modules or poorly coded modules
Inefficient database queries
Server configuration issues
Lack of caching

⚡️ How to Improve PrestaShop Performance:

1️⃣ Optimize Images:

Compress and resize images using tools like TinyPNG or ImageMagick

Use next-gen formats (WebP) if supported

2️⃣ Enable Caching:
PrestaShop’s built-in cache can be turned on in the back office

Use full-page caching with tools like Varnish or a CDN

3️⃣ Remove Unnecessary Modules:

Audit your installed modules and remove anything unused or outdated

4️⃣ Database Maintenance:

Regularly clean up your database using PrestaShop’s database optimization tools

Remove old logs, abandoned carts, and unused data

5️⃣ Choose a Fast Hosting Provider:

A reliable host with SSD storage, CDN support, and optimized PHP/MySQL settings makes a huge difference

6️⃣ Minify CSS & JS Files:

Use PrestaShop’s built-in settings or tools like Autoptimize to reduce file sizes

🛠️ Bonus Tips:

1.Implement lazy loading for images

2.Monitor performance with Google PageSpeed Insights or GTMetrix

3.Test regularly and iterate

💡 Final Thoughts:
Investing time in performance optimization doesn’t just make your site faster—it directly boosts your sales and keeps customers happy. Start small, test changes, and see how much faster (and more profitable) your PrestaShop store can be!

How to Build a Custom PrestaShop Module: A Step-by-Step Guide

Gofenice Technologies — Mon, 09 Jun 2025 04:05:26 +0000

PrestaShop’s modular architecture is one of its biggest strengths, allowing you to extend and customize your store to meet unique business needs. Whether you’re looking to add new features, integrate with external APIs, or simply enhance your shop’s functionality, building a custom module is the way to go.

In this in-depth tutorial, I’ll walk you through how to create a simple yet powerful custom PrestaShop module — step by step. By the end, you’ll have a solid foundation to build more complex modules tailored to your store’s requirements.

🔧 Step 1: Setting Up Your Module’s Directory
All PrestaShop modules reside in the /modules directory of your PrestaShop installation.

✅ Create a new folder for your module. For example:

bash
Copy
Edit
/modules/mycustommodule
✅ Inside this folder, create the main PHP file. Typically, it should have the same name as the folder:

bash
Copy
Edit
/modules/mycustommodule/mycustommodule.php
📦 Step 2: Defining the Module Class
The heart of your module is the PHP class extending PrestaShop’s Module class. Let’s start by defining basic metadata:

php
Copy
Edit
<?php
if (!defined('PS_VERSION')) {
exit;
}

class MyCustomModule extends Module
{
public function __construct()
{
$this->name = 'mycustommodule';
$this->tab = 'front_office_features';
$this->version = '1.0.0';
$this->author = 'Your Name';
$this->need_instance = 0;

    parent::__construct();

    $this->displayName = $this->l('My Custom Module');
    $this->description = $this->l('A custom module for PrestaShop.');
    $this->ps_versions_compliancy = ['min' => '1.7', 'max' => _PS_VERSION_];
}

}
Here’s what these properties do:

$name: The technical name (matches the folder name).

$tab: Module category in the back office.

$version, $author: Self-explanatory.

$need_instance: If the module needs to be loaded on every page.

$displayName, $description: Human-readable details.

$ps_versions_compliancy: PrestaShop version compatibility.

🛠️ Step 3: Installing and Uninstalling the Module
Next, add methods to handle installation and uninstallation logic:

php
Copy
Edit
public function install()
{
return parent::install() && $this->registerHook('displayHome');
}

public function uninstall()
{
return parent::uninstall();
}
install(): Called when installing the module. You can register hooks here (like displayHome) or create database tables.

uninstall(): Cleanup logic when uninstalling.

🎨 Step 4: Adding Functionality with Hooks
Hooks let you insert content at predefined points in your theme.

Here’s a basic example that displays “Hello from My Custom Module!” on the homepage:

php
Copy
Edit
public function hookDisplayHome($params)
{
return '

Hello from My Custom Module!

';
}
✅ Now, when the module is installed and hooked to displayHome, this message will appear on the homepage.

🖼️ Step 5: Adding a Configuration Form (Optional)
Most modules need a configuration page in the admin panel. PrestaShop’s HelperForm class makes this easier.

Add the following methods to your module:

php
Copy
Edit
public function getContent()
{
$output = '';
if (Tools::isSubmit('submit_'.$this->name)) {
$my_option = Tools::getValue('MY_OPTION');
Configuration::updateValue('MY_OPTION', $my_option);
$output .= $this->displayConfirmation($this->l('Settings updated'));
}
return $output.$this->renderForm();
}

protected function renderForm()
{
$default_lang = (int)Configuration::get('PS_LANG_DEFAULT');

$fields_form[0]['form'] = [
    'legend' => [
        'title' => $this->l('Settings'),
    ],
    'input' => [
        [
            'type' => 'text',
            'label' => $this->l('My Option'),
            'name' => 'MY_OPTION',
            'size' => 20,
            'required' => true
        ]
    ],
    'submit' => [
        'title' => $this->l('Save'),
        'class' => 'btn btn-default pull-right'
    ]
];

$helper = new HelperForm();

$helper->module = $this;
$helper->name_controller = $this->name;
$helper->token = Tools::getAdminTokenLite('AdminModules');
$helper->currentIndex = AdminController::$currentIndex.'&configure='.$this->name;

$helper->default_form_language = $default_lang;
$helper->allow_employee_form_lang = $default_lang;

$helper->fields_value['MY_OPTION'] = Configuration::get('MY_OPTION');

return $helper->generateForm($fields_form);

}
This form lets admins update a simple text field (MY_OPTION). You can expand it to include checkboxes, selects, or other input types.

🔗 Step 6: Final Steps and Testing
✅ Zip your module folder or upload it directly in the PrestaShop back office under “Modules.”
✅ Install it via the back office and see your “Hello” message on the homepage.
✅ Check that your configuration form saves data correctly.

🧩 Going Further
Your first module is just the beginning! Here’s what you can explore next:

Add translations for multilingual support (/translations folder).
Use templates (/views/templates/hook) to insert more advanced HTML.
Interact with the database to store and retrieve custom data.
Create admin controllers for more complex settings.
Extend it with JavaScript or CSS for dynamic functionality.

🚀 Conclusion
Building a custom PrestaShop module unlocks endless possibilities for tailoring your store to your unique needs. Start small, like we did here, then iterate and build more advanced features.

If you want to dive deeper or need help with a custom PrestaShop solution, let’s connect!

Boosting eCommerce SEO: 5 Practical Tips for PrestaShop Sites

Gofenice Technologies — Tue, 03 Jun 2025 05:04:50 +0000

At Gofenice Technologies, we’re passionate about building fast, functional, and SEO-friendly websites for our clients. Over the years, we’ve optimized countless PrestaShop stores, learning what works (and what doesn’t) along the way. Today, we’re sharing five practical tips to boost your PrestaShop site’s search rankings and help your store stand out.

💡 1️⃣ Optimize Your Product Descriptions
One of the most common mistakes we see in PrestaShop stores is generic product descriptions straight from the manufacturer. This might save time, but it hurts your SEO — and your ability to convert visitors into buyers.

Here’s what we recommend:
✅ Write unique, engaging product descriptions that resonate with your audience.
✅ Incorporate target keywords naturally, without overstuffing them.
✅ Focus on benefits and features that highlight what makes your product special.

For example, if you’re selling eco-friendly sneakers, don’t just say “Green Sneakers – Size 10.” Instead:

“Step into style with our eco-friendly sneakers, crafted from recycled materials. Lightweight and comfortable, these sneakers are perfect for daily adventures while reducing your carbon footprint.”

💡 2️⃣ Leverage PrestaShop’s Built-in SEO Settings
PrestaShop makes it easy to manage basic SEO settings — you just need to use them to their full potential.

👉 For each product, category, and CMS page, fill out the:
✅ Meta Title
✅ Meta Description
✅ Friendly URL

A few quick tips:

1.Keep titles under 60 characters.

2.Write meta descriptions that are clear and persuasive, around 150–160 characters.

3.Include your main keyword naturally in both.

This isn’t just about search rankings — it’s also about getting people to click your listing when they see it in Google results!

💡 3️⃣ Improve Site Speed and Performance
At Gofenice, we believe that a fast site is a happy site — for both your customers and for Google.

Here’s how you can boost your PrestaShop site’s speed:
✅ Enable the built-in CCC (Combine, Compress, Cache) options in your PrestaShop settings.
✅ Choose a reliable, high-performance hosting provider — it makes a huge difference.
✅ Use image compression tools and consider a Content Delivery Network (CDN) to serve images faster across the globe.

A faster site not only improves SEO but also reduces bounce rates and boosts conversions.

💡 4️⃣ Create a Clear, SEO-Friendly URL Structure
Your URLs matter — for both humans and search engines. PrestaShop lets you customize URLs for products, categories, and pages.

Aim for:
✅ Short, descriptive URLs that include your main keyword.
✅ No unnecessary parameters or numbers.

For example:
✅ Good: /summer-shoes
❌ Bad: /index.php?id_product=123

This helps search engines understand your content and improves your site’s overall SEO score.

💡 5️⃣ Leverage Rich Snippets and Structured Data
Want to stand out in Google search results? Rich snippets (like star ratings, prices, and availability) catch the eye and boost click-through rates.

Here’s what to do:
✅ Use modules or custom code to add schema.org structured data to your product pages.
✅ Focus on key details like Product Name, Price, Availability, and Reviews.

Adding structured data can make your listing more informative and more attractive in search results.

🎯 Final Thoughts: Keep Improving
SEO isn’t a one-time fix — it’s an ongoing process. At Gofenice Technologies, we’re always testing new ways to improve site performance and rankings for our clients. By following these five practical tips, you’ll lay the foundation for better search visibility, more traffic, and ultimately, more sales.

If you’re ready to take your PrestaShop store’s SEO to the next level, or if you have questions about how to implement these tips, feel free to reach out or comment below. We’d love to share more insights from our experience in making eCommerce sites not just functional, but truly successful.

How to Optimize Your PrestaShop Store’s Performance: 5 Quick Tips

Gofenice Technologies — Wed, 28 May 2025 06:58:02 +0000

Running a successful PrestaShop store means delivering a smooth, fast shopping experience. But if your store loads slowly or lags, you risk losing customers and hurting SEO.

Here are 5 practical tips to boost your PrestaShop store performance — easy to implement and proven to help.

Use Caching Wisely
PrestaShop has built-in caching options that can drastically reduce load times.

Enable Smarty caching in your Back Office under Advanced Parameters > Performance.

Use Memcached or Redis if your hosting supports it for faster data retrieval.

Optimize Images and Media
Large images slow down pages — optimize them before uploading.

Use tools like TinyPNG to compress images without losing quality.

Use the WebP format if your theme supports it.

Lazy load images so they load only when users scroll.

** Minify CSS and JavaScript Files**
Reducing the size of your CSS and JS files cuts load times.

In PrestaShop’s Performance settings, enable CSS and JavaScript compression and merging.

Remove unused modules or scripts that aren’t needed.

Choose a Fast Hosting Provider
Hosting makes a big difference.

Avoid shared hosting if possible; choose VPS or dedicated servers.

Look for hosting with good uptime and server response times.

Regularly Clean Your Database
PrestaShop’s database can get cluttered with old carts, logs, and sessions.

Use database optimization tools or modules to clean unnecessary data.

Schedule regular maintenance.

Bonus: Monitor Your Store’s Speed
Use tools like Google PageSpeed Insights or GTmetrix to get detailed reports and track improvements.

If you want expert help optimizing your PrestaShop store or custom modules, check out what we do at Gofenice Technologies — we specialize in ecommerce solutions built for performance.