Aller au contenu principal
English (US) Español Italiano
Liens utiles

Guide : validation technique

  • Mise à jour

Avant de vendre votre module sur la PrestaShop Marketplace, celui-ci doit passer une validation technique. Cette étape garantit la qualité, la compatibilité et la sécurité de votre produit pour les marchands.

Ce guide vous accompagne de la préparation à la soumission, pour mettre toutes les chances de votre côté.


Outils pour bien commencer


1- Le Validator

Le Validator est un outil incontournable pour vérifier la conformité technique de votre module. Il vous permet de :

  • Téléverser une archive ZIP

  • Fournir l’URL de votre dépôt GitHub

Le Validator analyse automatiquement votre module et génère un rapport détaillé indiquant les points à corriger. Suivez ces recommandations pour proposer un module sans erreur.

💡 À savoir : depuis la version 1.6.1.0, PrestaShop suit la norme PSR-2. Son respect est recommandé mais non obligatoire, et son absence ne constitue pas un motif de refus.

 

2- Moteur de recherche intégré

Un moteur de recherche intégré vous permet de vérifier quelles méthodes sont disponibles selon les versions de PrestaShop. Gagnez du temps en ciblant précisément vos développements.

 

Étapes pour réussir la validation technique

1- Créez un environnement de développement local

Testez votre module en local avec un outil comme WampServer (Windows), pour bénéficier de tous les messages d’erreur et alertes PHP.

Pour activer le Mode Dev :

  1. Ouvrez le fichier /config/defines.inc.php

  2. Modifiez la ligne suivante :

    define('_PS_MODE_DEV_', false);

    par :

    define('_PS_MODE_DEV_', true);

⚠️ Important : Le Mode Dev ne doit jamais être activé sur une boutique en production.

 

2- Respectez les bonnes pratiques

 À éviter :

  • Liens externes dans le code ou la documentation

  • Coordonnées personnelles

  • Plateformes de support externes

  • Fichiers AJAX externes

  • Parcours de répertoires non sécurisés

  • Modification des tables natives de PrestaShop

À faire :

  • Inclure la documentation et le lien de support Addons dans votre ZIP

  • Respecter PSR-2 pour les modules 1.6.1.0+

  • Créer vos propres tables

  • Utiliser _PS_CONFIG_DIR_ pour accéder à config.inc.php

  • Développer en anglais, puis traduire via le système de traduction

  • Séparer l’affichage avec Smarty, utiliser les helpers et PrestUI

  • Préfixer vos noms de modules, paramètres de config, tables, classes CSS

  • Supprimer vos entités (configurations, tables…) lors de la désinstallation

  • Afficher des messages de confirmation ou d’erreur après un formulaire

  • Valider les champs saisis par l’utilisateur (voir la classe Validate)

  • Sécuriser vos fichiers (notamment les crons), utilisez des tokens

  • Limiter les overrides à 2 ou 3 maximum

  • Utiliser les bonnes pratiques pour injecter JS dans le back-office 

    if (Tools::getValue('configure') == $this->name) {
    // Votre JS ici
}

Sécurité : Utilisez pSQL/bqSQL dans vos requêtes SQL, protégez les types de fichiers uploadés (mime_content_type()), évitez les injections.

 

3- Optimisez votre module avec le Validator

Le Validator identifie :

  • Les erreurs techniques

  • Les fonctionnalités interdites

  • Les problèmes de structure

Corrigez ces points pour accélérer la validation.
 

Soumettre votre module 

1- Renseignements techniques

Ajoutez le module_key dans votre constructeur :

public function __construct() {
    $this->module_key = 'votre_module_key_ici';
}

Décrivez les changements lors des mises à jour et indiquez les versions compatibles de PrestaShop.

2- Nom et archive de votre module

Respectez les règles suivantes :

  • Fichier principal : nom_module.php

  • Dossier : /nom_module

  • Archive ZIP : nom_module.zip (même nom, sans numéro de version)

Pensez à un nom clair, unique et sans “PrestaShop” ou “module”. Ajoutez-y votre marque ou vos initiales si besoin.

Et ensuite ?

Une fois soumis, votre module sera vérifié par l’équipe technique.

  • Vous recevrez un e-mail de validation ou de refus

  • En cas de refus, les points à corriger seront détaillés

  • Utilisez le lien dans l’e-mail pour contacter l’équipe

  • Apportez les corrections et soumettez à nouveau

 

Bonus : recommandations pour thèmes et emails

Thèmes :

  • Tous les modules présents dans vos thèmes doivent être validés via le Validator

  • Ne supprimez aucun hook natif

  • Pas de HTML dans le code PHP

  • Ne proposez pas de “thèmes recolorés” du thème de base

  • Gardez le logo par défaut dans l’en-tête/pied de page

Templates d’emails :

Prêt à démarrer ?

Grâce à ces bonnes pratiques et aux outils PrestaShop, vous maximisez vos chances de réussir la validation et de vendre rapidement sur Addons.

Une question ? Contactez-nous à partners-support@prestashop.com ! Nous sommes là pour vous accompagner.

 

Articles associés