Dokumentace

Začínáme

Volby

• Verze PrestaShopu — 8.x, 9.x nebo obě, na liště pod psacím polem. Výchozí jsou obě. Podpora obou občas něco stojí, protože některé hooky v administraci a vzory kontrolerů se mezi nimi liší, a agent to řekne, když nastane; 1.7 je v přepínači vidět, ale vybrat se nedá.
• Jazyky — do kterých se modul sám přeloží: angličtina, francouzština, němčina, španělština, italština, nizozemština, polština a portugalština, v libovolné kombinaci, přičemž angličtina, francouzština, španělština a němčina jsou ve výchozím stavu zapnuté. Každý jazyk navíc je skutečný čas sestavení, protože se překládá i snímá. Není to totéž nastavení jako jazyk, ve kterém se zobrazuje tenhle web a který měníte v patičce nebo na stránce svého účtu.
• Multistore — zapněte, pokud váš obchod běží v režimu multistore v PrestaShopu. Rozhoduje, jestli je nastavení pro každý obchod zvlášť, nebo společné, a jestli vlastní tabulky nesou sloupec obchodu; před sestavením je to levné rozhodnutí, po něm drahá přestavba.
• Referenční snímek obrazovky — přiložte PNG, JPEG nebo WebP do 5 MB, když je obrázek rychlejší než odstavec, třeba přesně tu stránku, na které se má modul objevit. Připojí se ke konverzaci, kterou otevíráte; popište i to, co je na něm vidět, protože sestavení vychází ze znění zadání.
• Šablona — agent se zeptá, jestli stačí klasická šablona, nebo modul musí přežít i vlastní. Ta odpověď rozhoduje, jak obezřetně se šablony v obchodě napojují, takže stojí za chvíli přemýšlení.

Kredity na sestavení

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.

Promýšlení nic nestojí, ať konverzace trvá jakkoli dlouho. Kredit se strhne ve chvíli, kdy schválíte — a když předání sestavovací lince právě tehdy selže, vrátí se rovnou na váš zůstatek. Kolik vám zbývá, najdete na stránce svého účtu.

Každé schválení stojí jeden, ať jde o druhý modul, nebo o změněnou verzi toho, který už máte. Když zůstatek klesne na nulu, tlačítko sestavení se vypne; napište nám na adresu v patičce a doplníme ho.

Instalace modulu, který dostanete

Ke stažení je obyčejný zip modulu pro PrestaShop, pojmenovaný podle modulu a jeho verze. Potřebuje obchod na PrestaShopu 8.x nebo 9.x s PHP 8.1 nebo novějším — přesně ty verze, které jste zvolili při popisu. Nikdo z module.monster se vašeho obchodu nedotkne; nainstalujete si ho sami, tou cestou, kterou obvykle používáte:

• V administraci jděte do Moduly, pak Správce modulů, a přes „Nahrát modul“ tam zip vložte. PrestaShop ho rozbalí a nainstaluje v jednom kroku. Na 8.x i 9.x je ta obrazovka na stejném místě.
• Nebo zip rozbalte a složku, která z něj vypadne, nakopírujte přes FTP nebo SSH do adresáře /modules svého obchodu, přesně pod tím názvem, jaký ze zipu vyšel. Modul se pak objeví ve Správci modulů, kde stisknete Instalovat.
• Tak jako tak skončíte ve Správci modulů: „Konfigurovat“ otevře vlastní stránku nastavení modulu v administraci. Odinstalace ze stejné obrazovky odstraní tabulky, záložky a nastavení, které vytvořil.

Nejdřív ho nainstalujte na testovací kopii svého obchodu a proklikejte ho tam. Je to obyčejné PHP, které patří vám — přečtěte si ho, změňte ho, předejte ho svému vývojáři — ale je to kód, který váš obchod ještě nikdy nespustil, a živý obchod je špatné místo, kde to zjišťovat.

Meze a očekávání

• Jeden modul naráz, velikostí zhruba to, co dobrý vývojář postaví za den. Větší nápad se v konverzaci ořeže na nejmenší verzi, která obstojí sama o sobě, a zbytek se navrhne jako samostatný modul později.
• Jen PrestaShop 8.x a 9.x, na PHP 8.1 nebo novějším. Nic staršího podporované není, 1.7 včetně.
• Modul se staví a testuje proti standardní instalaci PrestaShopu. Silně upravená šablona nebo jiný modul, který soupeří o stejný hook, si po nasazení na váš obchod pořád můžou vyžádat úpravy.
• Modul může mluvit s vnější službou, ale účet a přihlašovací údaje jsou vaše a tuhle část nejde při testování prověřit. Berte každé takové napojení jako něco, co si musíte ověřit na vlastním testovacím obchodu.
• Schválením se zadání uzavírá. Konverzace pak sleduje sestavení, místo aby přijímala změny, takže revize znamená nové sestavení a další kredit. Než tlačítko stisknete, přečtěte si shrnutí.
• Stahujete zip modulu. Ilustrovaná uživatelská příručka, která během sestavení vzniká, není součástí toho stažení — napište nám, pokud o ni stojíte.
• Žádný přístup ani jedním směrem: nic se vám na obchod neinstaluje a modul si nikdy nevolá domů. To také znamená žádné automatické aktualizace — co jste si stáhli, zůstane, jak je, dokud si nepostavíte něco nového.
• Sestavení občas selžou. Krok, který se opakovaně vrací špatně, se zkusí až třikrát, a pak se modul označí jako vyžadující pozornost, místo aby se odeslalo něco rozbitého. Uvidíte to na stránce modulu a my se na to sami podíváme.