Documentatie

Aan de slag

Wat je kiest

• PrestaShop-versies — 8.x, 9.x of allebei, in de balk onder het invoervak. Allebei is de standaard. Allebei ondersteunen kost soms iets, omdat sommige back-office-hooks en controllerpatronen verschillen, en de agent zegt het wanneer dat bij jouw idee speelt; 1.7 staat wel in de keuzelijst maar is niet te kiezen.
• Talen — welke vertalingen de module zelf meekrijgt: Engels, Frans, Duits, Spaans, Italiaans, Nederlands, Pools en Portugees, in elke combinatie, met Engels, Frans, Spaans en Duits standaard aan. Elke extra taal is echte bouwtijd, want er wordt vertaald en er worden schermafbeeldingen gemaakt. Dit is iets anders dan de taal waarin je deze site ziet, die je in de voettekst of in je account wijzigt.
• Multistore — aanzetten als je shop in PrestaShops multistore-modus draait. Het bepaalt of instellingen per shop of globaal zijn en of eigen tabellen een shopkolom krijgen: vooraf goedkoop te regelen, achteraf duur.
• Referentieschermafbeelding — hang er een PNG, JPEG of WebP van maximaal 5 MB aan als een plaatje sneller is dan een alinea, bijvoorbeeld precies de pagina waarop de module moet verschijnen. Hij hoort bij het gesprek dat je opent; beschrijf ook wat erop staat, want de bouw gaat af op de tekst van het plan.
• Thema — de agent vraagt of het klassieke thema genoeg is of dat de module een eigen thema moet overleven. Dat antwoord bepaalt hoe voorzichtig de front-officetemplates zich inhaken, dus denk er even over na.

Buildtegoed

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.

Brainstormen kost niets, hoe lang het gesprek ook duurt. Het tegoed gaat eraf op het moment dat je vrijgeeft — en als de overdracht aan de bouwpijplijn precies dan misgaat, staat het meteen weer op je saldo. Wat je over hebt zie je op je accountpagina.

Elke vrijgave kost er één, of het nu een tweede module is of een gewijzigde versie van een bestaande. Bij nul wordt de bouwknop uitgeschakeld; mail ons op het adres in de voettekst om bij te vullen.

De geleverde module installeren

Wat je downloadt is een gewone PrestaShop-modulezip, genoemd naar de module en zijn versie. Je hebt een shop nodig op PrestaShop 8.x of 9.x met PHP 8.1 of nieuwer — de versies die je koos toen je de module beschreef. Niemand van module.monster komt aan je shop; je installeert zelf, langs de route die je gewend bent:

• Ga in de back office naar Modules en dan Modulebeheer, en gebruik “Een module uploaden” om de zip erin te zetten. PrestaShop pakt hem uit en installeert hem in één keer. Het scherm zit op dezelfde plek in 8.x en 9.x.
• Of pak de zip uit en kopieer de map die eruit komt via FTP of SSH naar de map /modules van je shop, met precies dezelfde mapnaam. De module staat dan in Modulebeheer, waar je op Installeren klikt.
• Hoe dan ook eindig je in Modulebeheer: “Configureren” opent de instellingenpagina van de module zelf in de back office. Verwijderen vanaf datzelfde scherm haalt de tabellen, tabbladen en instellingen weer weg die hij had aangemaakt.

Zet hem eerst op een testkopie van je shop en klik hem daar door. Het is gewone PHP die van jou is — lees hem, pas hem aan, geef hem aan je ontwikkelaar — maar het is code die je shop nog nooit heeft gedraaid, en een live shop is een slechte plek om daarachter te komen.

Grenzen en verwachtingen

• Eén module tegelijk, ongeveer zo groot als wat een goede ontwikkelaar op een dag bouwt. Een groter idee wordt in het gesprek teruggebracht tot de kleinste versie die op zichzelf nuttig is; de rest komt als voorstel voor een volgende module.
• Alleen PrestaShop 8.x en 9.x, met PHP 8.1 of nieuwer. Ouder wordt niet ondersteund, 1.7 inbegrepen.
• De module wordt gebouwd en getest op een standaardinstallatie van PrestaShop. Een sterk aangepast thema, of een andere module die om dezelfde hook vecht, kan op jouw shop alsnog aanpassing vragen.
• Een module mag met een externe dienst praten, maar het account en de inloggegevens zijn van jou, en dat deel kan tijdens het testen niet worden uitgeprobeerd. Ga ervan uit dat je zo'n koppeling zelf op je testshop nakijkt.
• Vrijgeven sluit het plan af. Daarna volgt het gesprek de bouw in plaats van wijzigingen aan te nemen: een herziening is een nieuwe build en nog een tegoed. Lees de samenvatting voor je op de knop drukt.
• Wat je downloadt is de modulezip. De geïllustreerde handleiding die tijdens de bouw geschreven wordt zit er niet in — mail ons als je er een kopie van wilt.
• Geen toegang in beide richtingen: er wordt niets voor je op je shop geïnstalleerd, en de module belt nooit naar huis. Dat betekent ook geen automatische updates — wat je hebt gedownload blijft zoals het is tot je iets nieuws bouwt.
• Builds mislukken soms. Een stap die fout blijft terugkomen wordt tot drie keer opnieuw geprobeerd, en daarna wordt de module gemarkeerd als iets dat aandacht nodig heeft, in plaats van dat er iets kapots wordt geleverd. Je ziet dat op de pagina van de module, en wij kijken er zelf naar.