Dokumentation
Wie module.monster in der Praxis funktioniert: was Sie in jedem Schritt tun, was Sie unterwegs auswählen, was ein Build-Guthaben kauft, wie Sie das Ergebnis installieren – und wo die Pipeline aufhört.
Erste Schritte
Beschreiben Sie Ihr Modul
Melden Sie sich an und schreiben Sie in das Feld auf Ihrer Übersicht, was Ihr Shop können soll – in normaler Sprache, bis zu 2000 Zeichen, ohne technische Details. Stellen Sie in der Leiste darunter die PrestaShop-Versionen, die Sprachen des Moduls und den Multistore-Schalter ein und schicken Sie es ab.
Das Konzept klären
Ein Agent, der PrestaShop kennt, antwortet und arbeitet die Idee mit Ihnen durch – eine Frage nach der anderen. Er nennt zuerst seine beste Annahme, sagt Ihnen, wenn etwas bereits Standardverhalten von PrestaShop ist oder in Wahrheit drei Module sind, und klärt Hooks, Einstellungen, gespeicherte Daten und das, was das Modul bewusst nicht tun wird. Während des Gesprächs wird nichts gebaut, und das Gespräch ist kostenlos.
Den Build freigeben
Sobald das Konzept vollständig ist, sagt der Agent Bescheid und unter dem Gespräch erscheint ein Button zum Bauen. Ein Klick schreibt das Konzept aus, verbraucht ein Build-Guthaben und übergibt das Modul an die Build-Pipeline. Solange Sie nicht klicken, steht nichts in der Warteschlange.
Beim Bauen zusehen
Dieselbe Seite wird zum Fortschrittsbalken: Der Code wird geschrieben, auf einem echten PrestaShop installiert und durchgespielt, übersetzt, per Screenshot festgehalten, dokumentiert und verpackt – neun Schritte insgesamt, der aktuelle jeweils benannt. Alles läuft unbeaufsichtigt, Sie können den Tab also schließen und später wiederkommen.
Die ZIP herunterladen
Wenn der letzte Schritt durchläuft, gilt das Modul als geliefert und auf seiner Seite erscheint ein Download-Button. Die ZIP gehört Ihnen, und dieselbe Seite gibt sie Ihnen jederzeit wieder heraus.
Ihre Auswahl
- PrestaShop-Versionen – 8.x, 9.x oder beide, in der Leiste unter dem Eingabefeld. Voreingestellt sind beide. Beide zu unterstützen kostet gelegentlich etwas, weil sich einige Back-Office-Hooks und Controller-Muster unterscheiden; der Agent sagt Ihnen, wenn das bei Ihrer Idee der Fall ist. 1.7 steht zwar in der Auswahl, ist aber nicht wählbar.
- Sprachen – welche Übersetzungen im Modul selbst mitgeliefert werden: Englisch, Französisch, Deutsch, Spanisch, Italienisch, Niederländisch, Polnisch und Portugiesisch, in beliebiger Kombination, standardmäßig Englisch, Französisch, Spanisch und Deutsch. Jede zusätzliche Sprache ist echte Bauzeit, denn sie wird übersetzt und mit Screenshots belegt. Das ist nicht dieselbe Einstellung wie die Sprache dieser Website, die Sie im Fußbereich oder in Ihrem Konto ändern.
- Multistore – einschalten, wenn Ihr Shop im Multistore-Modus läuft. Davon hängt ab, ob Einstellungen pro Shop oder global gelten und ob eigene Tabellen eine Shop-Spalte führen: vor dem Build billig zu klären, danach teuer nachzurüsten.
- Referenz-Screenshot – hängen Sie ein PNG, JPEG oder WebP mit bis zu 5 MB an, wenn ein Bild schneller ist als ein Absatz, etwa die genaue Seite, auf der das Modul erscheinen soll. Es hängt an dem Gespräch, das Sie eröffnen; beschreiben Sie zusätzlich, was darauf zu sehen ist, denn gebaut wird nach dem Wortlaut des Konzepts.
- Theme – der Agent fragt, ob das klassische Theme genügt oder ob das Modul ein eigenes Theme überstehen muss. Diese Antwort entscheidet, wie defensiv sich die Templates im Front Office einklinken, also überlegen Sie kurz.
Build-Guthaben
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.
Das Gespräch kostet nichts, egal wie lange es dauert. Das Guthaben wird in dem Moment verbraucht, in dem Sie freigeben – und wenn die Übergabe an die Build-Pipeline genau dann scheitert, geht es sofort auf Ihr Konto zurück. Wie viel übrig ist, steht auf Ihrer Kontoseite.
Jede Freigabe kostet eins, ob es ein zweites Modul ist oder eine geänderte Fassung eines vorhandenen. Bei null wird der Button zum Bauen deaktiviert; schreiben Sie uns an die Adresse im Fußbereich, um aufzuladen.
Das gelieferte Modul installieren
Der Download ist eine ganz normale PrestaShop-Modul-ZIP, benannt nach Modul und Version. Sie braucht einen Shop mit PrestaShop 8.x oder 9.x und PHP 8.1 oder neuer – die Versionen, die Sie bei der Beschreibung gewählt haben. Niemand von module.monster fasst Ihren Shop an; Sie installieren selbst, auf dem Weg, den Sie ohnehin nutzen:
- Im Back Office unter Module und dann Modul-Manager auf „Modul hochladen“ gehen und die ZIP dort ablegen. PrestaShop entpackt und installiert sie in einem Schritt. Der Bildschirm liegt in 8.x und 9.x an derselben Stelle.
- Oder die ZIP entpacken und den enthaltenen Ordner per FTP oder SSH in das Verzeichnis /modules Ihres Shops kopieren, mit genau dem Ordnernamen aus der ZIP. Das Modul taucht dann im Modul-Manager auf, wo Sie auf Installieren klicken.
- So oder so endet es im Modul-Manager: „Konfigurieren“ öffnet die Einstellungsseite des Moduls im Back Office. Die Deinstallation über denselben Bildschirm entfernt die Tabellen, Tabs und Einstellungen wieder, die es angelegt hat.
Installieren Sie es zuerst auf einer Staging-Kopie Ihres Shops und klicken Sie sich dort durch. Es ist gewöhnliches PHP, das Ihnen gehört – lesen, ändern, an Ihre Entwickler geben – aber es ist Code, den Ihr Shop noch nie ausgeführt hat, und ein Live-Shop ist ein schlechter Ort, das herauszufinden.
Grenzen und Erwartungen
- Ein Modul auf einmal, im Umfang von etwa einem Entwicklertag. Eine größere Idee wird im Gespräch auf die kleinste Fassung zurückgeschnitten, die für sich allein nützlich ist; der Rest wird als späteres Modul vorgeschlagen.
- Nur PrestaShop 8.x und 9.x, mit PHP 8.1 oder neuer. Ältere Versionen werden nicht unterstützt, 1.7 eingeschlossen.
- Gebaut und getestet wird gegen eine Standardinstallation von PrestaShop. Ein stark angepasstes Theme oder ein anderes Modul, das um denselben Hook konkurriert, kann in Ihrem Shop trotzdem Nacharbeit verlangen.
- Ein Modul kann mit einem fremden Dienst sprechen, aber Konto und Zugangsdaten gehören Ihnen, und dieser Teil lässt sich im Test nicht durchspielen. Rechnen Sie damit, eine solche Anbindung selbst auf Ihrem Staging-Shop zu prüfen.
- Die Freigabe schließt das Konzept ab. Das Gespräch begleitet danach den Build, statt Änderungen anzunehmen: Eine Überarbeitung ist ein neuer Build und ein weiteres Guthaben. Lesen Sie die Zusammenfassung, bevor Sie klicken.
- Heruntergeladen wird die Modul-ZIP. Die bebilderte Anleitung, die während des Builds entsteht, liegt nicht darin – schreiben Sie uns, wenn Sie eine Kopie möchten.
- Kein Zugriff in beide Richtungen: Es wird nichts für Sie in Ihrem Shop installiert, und das Modul funkt nichts nach Hause. Das heißt auch: keine automatischen Updates – was Sie heruntergeladen haben, bleibt so, bis Sie etwas Neues bauen.
- Builds scheitern manchmal. Ein Schritt, der immer wieder falsch zurückkommt, wird bis zu dreimal wiederholt; danach wird das Modul als klärungsbedürftig markiert, statt etwas Kaputtes auszuliefern. Sie sehen das auf der Seite des Moduls, und wir schauen uns solche Fälle selbst an.
Das ist der ganze Ablauf. Der nächste Schritt ist ein Satz darüber, was Ihr Shop können soll.
Loslegen