Documentation
Comment module.monster fonctionne concrètement : ce que vous faites à chaque étape, ce que vous choisissez en chemin, ce qu'achète un crédit de build, comment installer ce que vous recevez — et où le pipeline s'arrête.
Premiers pas
Décrivez votre module
Connectez-vous et écrivez dans le champ de votre tableau de bord ce que votre boutique doit faire : en langage courant, jusqu'à 2000 caractères, sans détail technique. Réglez les versions de PrestaShop, les langues du module et l'interrupteur multiboutique sur la barre juste en dessous, puis envoyez.
Cadrez le cahier des charges
Un agent qui connaît PrestaShop vous répond et creuse l'idée avec vous, une question à la fois. Il avance sa meilleure hypothèse, vous dit quand une idée relève déjà du cœur de PrestaShop ou cache en réalité trois modules, et tranche les hooks, les réglages, les données stockées et ce que le module ne fera délibérément pas. Rien n'est construit pendant la discussion, et discuter est gratuit.
Approuvez le build
Quand le cahier des charges est complet, l'agent le signale et un bouton de construction apparaît sous la conversation. L'appuyer rédige la spécification, consomme un crédit de build et confie le module au pipeline. Tant que vous ne l'appuyez pas, rien n'est mis en file d'attente.
Suivez la construction
La même page devient une barre de progression : le code est écrit, installé et éprouvé sur une vraie boutique PrestaShop, traduit, capturé en images, documenté, puis empaqueté — neuf étapes en tout, celle en cours étant nommée au fur et à mesure. Tout tourne sans surveillance : vous pouvez fermer l'onglet et revenir plus tard.
Téléchargez le .zip
Quand la dernière étape passe, le module est marqué comme livré et un bouton de téléchargement apparaît sur sa page. Le .zip est à vous, et la même page vous le redonne chaque fois que vous en avez besoin.
Vos choix
- Versions de PrestaShop — 8.x, 9.x ou les deux, sur la barre sous le champ de saisie. Les deux par défaut. Prendre en charge les deux coûte parfois quelque chose, car certains hooks du back-office et certains schémas de contrôleurs diffèrent, et l'agent vous le dira le cas échéant ; la 1.7 figure dans le sélecteur mais n'est pas sélectionnable.
- Langues — les traductions livrées dans le module lui-même : anglais, français, allemand, espagnol, italien, néerlandais, polonais et portugais, dans n'importe quelle combinaison, avec l'anglais, le français, l'espagnol et l'allemand activés par défaut. Chaque langue supplémentaire est du temps de build réel, puisqu'elle est traduite et capturée en images. À ne pas confondre avec la langue d'affichage de ce site, que vous changez dans le pied de page ou sur votre compte.
- Multiboutique — activez-le si votre boutique utilise le mode multiboutique de PrestaShop. Cela détermine si les réglages sont par boutique ou globaux et si les tables du module portent une colonne de boutique : peu coûteux à trancher avant le build, cher à rattraper après.
- Capture d'écran de référence — joignez un PNG, un JPEG ou un WebP de 5 Mo au maximum quand une image va plus vite qu'un paragraphe, par exemple la page exacte où le module doit apparaître. Elle est rattachée à la conversation que vous ouvrez ; décrivez aussi ce qu'elle montre, car c'est le texte du cahier des charges qui guide la construction.
- Thème — l'agent vous demande si le thème classique suffit ou si le module doit survivre à un thème sur mesure. Cette réponse détermine la prudence avec laquelle les templates du front-office s'accrochent : elle mérite une minute de réflexion.
Crédits de build
One credit is one module, taken all the way: written, tested, translated, documented and packaged. Accounts start with none; we add credits when you request them. There is no card and no payment page.
Le brainstorming ne coûte rien, quelle que soit la longueur de la conversation. Le crédit est débité au moment où vous approuvez — et si la remise au pipeline échoue à cet instant précis, il revient aussitôt sur votre solde. Ce qu'il vous reste est indiqué sur votre page de compte.
Chaque approbation consomme un crédit, qu'il s'agisse d'un deuxième module ou d'une nouvelle version de l'un des vôtres. Quand le solde tombe à zéro, le bouton de construction est désactivé ; écrivez-nous à l'adresse du pied de page pour le recharger.
Installer le module livré
Le téléchargement est un .zip de module PrestaShop tout ce qu'il y a de plus ordinaire, nommé d'après le module et sa version. Il lui faut une boutique sous PrestaShop 8.x ou 9.x avec PHP 8.1 ou plus récent — les versions que vous avez choisies en décrivant le module. Personne chez module.monster ne touche à votre boutique : vous l'installez vous-même, par la voie qui vous est habituelle.
- Dans le back-office, allez dans Modules, puis Gestionnaire de modules, et utilisez « Ajouter un module » pour y déposer le .zip. PrestaShop le décompresse et l'installe en une fois. L'écran se trouve au même endroit en 8.x et en 9.x.
- Ou bien décompressez le .zip et copiez le dossier obtenu dans le répertoire /modules de votre boutique, par FTP ou SSH, en conservant exactement le nom du dossier. Le module apparaît alors dans le Gestionnaire de modules, où vous appuyez sur Installer.
- Dans les deux cas, terminez dans le Gestionnaire de modules : « Configurer » ouvre la page de réglages du module dans le back-office. La désinstallation, depuis le même écran, supprime les tables, les onglets et les réglages qu'il avait créés.
Installez-le d'abord sur une copie de préproduction de votre boutique et parcourez-le là. C'est du PHP ordinaire qui vous appartient — lisez-le, modifiez-le, confiez-le à votre développeur — mais c'est du code que votre boutique n'a jamais exécuté, et une boutique en production est un mauvais endroit pour s'en apercevoir.
Limites et attentes
- Un module à la fois, de la taille de ce qu'un bon développeur construirait en une journée. Une idée plus vaste est ramenée, pendant la conversation, à la plus petite version qui tienne debout toute seule, le reste étant proposé comme un module ultérieur.
- PrestaShop 8.x et 9.x uniquement, avec PHP 8.1 ou plus récent. Rien de plus ancien n'est pris en charge, 1.7 comprise.
- Le module est construit et testé sur une installation PrestaShop standard. Un thème fortement personnalisé, ou un autre module qui se dispute le même hook, peut malgré tout demander des ajustements une fois sur votre boutique.
- Un module peut dialoguer avec un service externe, mais le compte et les identifiants sont les vôtres, et cette partie ne peut pas être éprouvée pendant les tests. Considérez ce type d'intégration comme à vérifier sur votre propre préproduction.
- Approuver fige le cahier des charges. La conversation suit ensuite la construction au lieu d'accepter des changements : une révision, c'est un nouveau build et un crédit de plus. Relisez le résumé avant d'appuyer.
- Ce que vous téléchargez, c'est le .zip du module. Le guide illustré rédigé pendant la construction n'en fait pas partie — écrivez-nous si vous en voulez une copie.
- Aucun accès, dans un sens comme dans l'autre : rien n'est installé à votre place sur votre boutique, et le module ne téléphone jamais à la maison. Cela veut dire aussi qu'il n'y a pas de mise à jour automatique — ce que vous avez téléchargé reste tel quel jusqu'à ce que vous construisiez autre chose.
- Des builds échouent. Une étape qui revient fausse est retentée jusqu'à trois fois, puis le module est signalé comme nécessitant une intervention plutôt que de livrer quelque chose de cassé. Vous le voyez sur la page du module, et nous allons y regarder nous-mêmes.
Voilà tout le processus. L'étape suivante, c'est une phrase sur ce que votre boutique doit faire.
Commencer