Skip to content
Développement PrestaShop

Préparer ses modules pour la validation sur la marketplace

25 février 2026
Alexandre
8 min. de lecture
Préparer ses modules pour la validation sur la marketplace

Mettre un module en vente sur une marketplace n’est pas qu’une formalité : c’est un parcours de validation où la technique (qualité, compatibilité, sécurité) compte autant que la présentation commerciale. Sur PrestaShop Addons, cette réalité est clairement posée : avant de vendre, la validation technique est obligatoire, avec des points bloquants très concrets (structure du ZIP, règles de nommage, sécurité SQL, gestion des uploads, etc.).

Et cette exigence se renforce dans le temps. Les guidelines Marketplace indiquent qu’il faut anticiper les exigences de compatibilité avec la dernière version majeure (par exemple PrestaShop 9, lancée en juin 2025) sous peine de rejet automatique. Préparer ses modules “pour la validation” signifie donc mettre en place une routine de pré-contrôle, une organisation de release et une discipline de packaging/documentation qui tiennent la route.

1) Comprendre le “pourquoi” de la validation : rigueur, sécurité, confiance

La validation marketplace vise à protéger trois parties : les marchands (qui installent), les clients finaux (qui utilisent), et l’écosystème (qui doit rester stable). PrestaShop DevDocs décrit une posture de validation « very strict and meticulous » pour les nouveaux modules, et précise que les mises à jour majeures subissent des vérifications équivalentes.

Cette rigueur s’explique aussi par l’historique des incidents : lorsqu’une alerte sécurité survient, la conformité devient un sujet public, avec des correctifs et des versions recommandées. L’exemple d’un module nécessitant une mise à jour vers une version corrigée illustre à quel point les équipes Marketplace cherchent à réduire les risques en amont via des scans et des contrôles renforcés.

Enfin, le dispositif est aussi financé et industrialisé. PrestaShop a introduit un frais annuel (99€ par module ou thème) pour soutenir des contrôles qualité/sécurité plus poussés (vulnérabilités, compatibilité PHP, tests code et fonctionnels, overrides). Autrement dit : la validation est un système, pas un simple “coup d’œil”.

2) Anticiper la compatibilité : PrestaShop v9 et la logique “dernière majeure”

Le point le plus facile à sous-estimer (et le plus coûteux) est la compatibilité. Les guidelines Marketplace indiquent que tous les nouveaux produits doivent être compatibles avec la dernière version majeure disponible (ex. PrestaShop 9.0.0, juin 2025), sinon la soumission peut être rejetée automatiquement.

Cette règle n’est pas seulement pour les nouveaux modules : à partir du 1er février 2026, les soumissions de mises à jour sont également rejetées si le produit n’est pas compatible avec la dernière version. Concrètement, un module “bon” mais resté en compatibilité v8 risque de vous bloquer même pour une simple mise à jour corrective.

La bonne pratique consiste à intégrer cette contrainte dans votre cycle de développement : matrice de tests (versions PrestaShop/PHP), CI qui exécute vos checks sur la dernière majeure, et release notes qui explicitent clairement le support. Le but est d’arriver en validation avec une compatibilité prouvable, pas supposée.

3) Maîtriser le workflow de validation : Validator, scans, revue, rapports

Sur PrestaShop Addons, le workflow typique commence par une étape automatisée de type “Stage 1 Automated Technical Analysis”. Elle s’appuie notamment sur le Validator, qui peut analyser un fichier ZIP ou une URL de dépôt GitHub et produire un rapport détaillé.

Ensuite, une phase de “Deep Technical Scan” peut intervenir : analyse interne de vulnérabilités, compatibilité PHP, overrides, erreurs en mode debug, etc. Cette étape peut s’accompagner d’un document de synthèse, de type Compliance PDF Report, utile pour comprendre précisément les corrections attendues.

En termes de délais, la documentation “Submitting Your Module” donne des ordres de grandeur : après l’automatique, la revue technique peut prendre typiquement 5 à 10 jours ouvrés, puis la validation marketing environ 10 jours ouvrés (selon les langues). À côté, le dispositif de frais annuel annonce une promesse d’amélioration avec une première revue technique sous 7 jours. Dans tous les cas, prévoyez du temps et évitez les soumissions “au dernier moment”.

4) Mettre en place une routine “pré-soumission” (sécurité & robustesse)

Les recommandations “Final Verification Steps” avant soumission sont très opérationnelles. Un exemple simple mais fréquent : protéger le contexte PrestaShop dans tous les fichiers PHP (empêcher l’accès direct) afin de limiter des comportements inattendus et certains vecteurs d’attaque.

La sanitation SQL est un autre point explicitement cité : utiliser les fonctions adaptées comme pSQL / bqSQL et, plus généralement, prévenir les injections (requêtes construites proprement, paramètres contrôlés). Les validateurs et scans techniques cherchent ce type de faiblesse, y compris dans des zones “secondaires” (helpers, controllers, ajax endpoints).

Enfin, les contrôles sur les fichiers et uploads sont incontournables : vérification stricte des types, contrôle serveur (par exemple via mime_content_type), limitation des extensions autorisées, et protection des répertoires via .htaccess et/ou index.php. Ajoutez à cela un passage en mode debug : les guidelines recommandent explicitement de tester sans générer d’erreurs en debug mode.

5) Respecter les exigences de structure et de nommage (ZIP, dossier, fichier principal)

Une part significative des rejets vient de détails de packaging. PrestaShop demande une cohérence stricte : un fichier principal nom_module.php, un dossier /nom_module, et une archive nom_module.zip contenant tous les fichiers nécessaires. Le nom de l’archive doit correspondre au nom du module.

Autre exigence importante : ne pas inclure de numéro de version dans le nom du ZIP. Et il est indiqué d’éviter certains termes dans le nom (par exemple “PrestaShop” ou “module”). Ces règles facilitent l’automatisation côté marketplace et réduisent les ambiguïtés lors des analyses.

Attention aussi aux pièges environnementaux : la documentation mentionne un “Issue 1” courant sur macOS, où la création du ZIP peut ajouter des fichiers indésirables. La recommandation est d’éviter de zipper “naïvement” sur Mac ou d’utiliser un outil de nettoyage (“Mac cleaner”) pour retirer ces artefacts avant soumission.

6) Ajouter les métadonnées techniques attendues : module_key et contraintes sur $this->name

Le guide de validation technique PrestaShop explicite l’ajout de module_key dans le constructeur du module, avec exemple de code. Cette information est utilisée par l’écosystème (identification, distribution, conformité) et peut être considérée comme un prérequis dans le cadre des exigences de validation.

Le champ $this->name est également encadré : uniquement des minuscules alphanumériques et des underscores. Ce détail paraît anodin, mais il impacte la cohérence des chemins, des identifiants, et la capacité des outils (Validator, scanners, scripts) à traiter votre module de manière fiable.

Côté style de code, PrestaShop mentionne PSR-2 comme recommandation (adoptée depuis 1.6.1.0) mais précise que ce n’est pas obligatoire et que ce n’est pas, en soi, un motif de refus. En revanche, un code cohérent améliore la lisibilité lors des revues et réduit les risques d’erreurs cachées.

7) Soigner la soumission “marketing” : champs obligatoires, assets, règles de contenu

La validation ne s’arrête pas à la technique. La page “Submitting Your Module” liste des exigences minimales sur la fiche produit : une icône au format requis (par exemple 57×57), des informations de pays, des descriptions structurées, et l’explication des bénéfices pour les marchands et/ou leurs clients.

Des éléments précis sont imposés : au moins 5 mots-clés (keywords) et au moins 3 captures d’écran/images. Ces éléments ne sont pas du “bonus” : ils font partie des champs obligatoires et conditionnent l’acceptation de la fiche, mais aussi la performance commerciale (référencement interne, compréhension rapide de la valeur).

Il faut également respecter les règles éditoriales : les guidelines de soumission indiquent l’interdiction d’afficher une adresse email et une URL de site dans la page Marketplace et dans la documentation. Si votre documentation ou vos visuels contiennent ce type d’informations, anticipez une réécriture (FAQ interne, support via les canaux autorisés, mentions dans le back-office hors listing public si applicable).

8) Planifier comme un éditeur : délais, capacité de review, contraintes multi-marketplaces

Préparer un module pour validation, c’est aussi gérer un calendrier. Entre l’analyse automatique, les scans approfondis et les revues (technique puis marketing), vous devez prévoir des marges. Même si certains engagements évoquent une première revue technique sous 7 jours, la documentation mentionne des fenêtres de 5 à 10 jours ouvrés pour la technique et environ 10 jours ouvrés pour le marketing.

Si vous publiez sur plusieurs marketplaces, sachez que les contraintes varient mais se ressemblent sur le fond : cohérence des noms, assets requis, descriptions structurées, délais de revue potentiellement longs. Par exemple, côté Microsoft marketplace, la checklist évoque que le review peut prendre jusqu’à 4 semaines et impose des exigences de listing (assets, description longue, cohérence avec le manifest). Cela pousse à standardiser votre “kit de soumission”.

Enfin, certaines plateformes limitent la cadence de soumission. HubSpot Template Marketplace a, par exemple, instauré une règle “un item à la fois” en review (par type : thème et/ou module), avec rejet automatique si vous dépassez. Même si PrestaShop n’applique pas cette règle telle quelle, c’est un rappel utile : la validation est un goulot, donc votre pipeline doit être maîtrisé (priorisation, branches de maintenance, releases progressives).

Préparer ses modules pour la validation sur la marketplace revient à traiter la publication comme un produit : packaging propre, conformité technique, sécurité défensive, compatibilité à jour, et contenu marketing complet. La plupart des rejets sont évitables si vous intégrez tôt les exigences (Validator, structure ZIP, règles de nommage, champs obligatoires) plutôt que de les découvrir au moment de soumettre.

Le levier le plus “rentable” est d’industrialiser : un checklist pré-soumission, des tests en debug mode, une CI qui cible la dernière version majeure (notamment PrestaShop v9), et un kit de fiche produit (icônes, captures, keywords, descriptions) prêt à l’emploi. Avec cette discipline, la validation cesse d’être une loterie et devient une étape prévisible de votre cycle de release.

Partager cet article