Dokumentácia
Ako module.monster funguje v praxi: čo v ktorej fáze robíte, čo si cestou vyberáte, čo kredit na zostavenie kúpi, ako si výsledok nainštalovať — a kde linka končí.
Začíname
Opíšte svoj modul
Prihláste sa a napíšte do poľa na svojom prehľade, čo má váš obchod vedieť — bežnou rečou, až 2000 znakov, technické detaily netreba. Na lište pod ním nastavte verzie PrestaShopu, jazyky modulu a prepínač multistore a odošlite.
Premyslite zadanie
Agent, ktorý pozná PrestaShop, odpovedá a preberá nápad s vami, jednu otázku za druhou. Začne svojím najlepším odhadom, povie, keď je niečo už základným správaním PrestaShopu alebo keď sú to v skutočnosti tri moduly v jednom, a vyrieši hooky, nastavenia, ukladané údaje aj to, čo modul zámerne robiť nebude. Počas rozhovoru sa nič nezostavuje a rozhovor je zadarmo.
Schváľte zostavenie
Len čo je zadanie hotové, agent to povie a pod konverzáciou sa objaví tlačidlo. Stlačenie zadanie spíše, strhne jeden kredit na zostavenie a odovzdá modul zostavovacej linke. Kým ho nestlačíte, do poradia sa nič nedostane.
Sledujte, ako vzniká
Tá istá stránka sa zmení na ukazovateľ priebehu: kód sa napíše, nainštaluje a preverí na živom PrestaShope, preloží, nasníma, zdokumentuje a zabalí — deväť krokov spolu, pričom ten práve bežiaci je pomenovaný. Beží to bez dozoru, takže môžete zavrieť kartu a vrátiť sa neskôr.
Stiahnite si zip
Keď prejde posledný krok, modul sa označí ako odovzdaný a na jeho stránke sa objaví tlačidlo na stiahnutie. Zip je váš a tá istá stránka vám ho vydá vždy, keď ho budete znova potrebovať.
Voľby
- Verzie PrestaShopu — 8.x, 9.x alebo obe, na lište pod písacím poľom. Predvolené sú obe. Podpora oboch občas niečo stojí, pretože niektoré hooky v administrácii a vzory kontrolérov sa medzi nimi líšia, a agent to povie, keď taký prípad nastane; 1.7 je v prepínači vidieť, ale vybrať sa nedá.
- Jazyky — do ktorých je modul sám preložený: angličtina, francúzština, nemčina, španielčina, taliančina, holandčina, poľština a portugalčina, v ľubovoľnej kombinácii, pričom angličtina, francúzština, španielčina a nemčina sú predvolene zapnuté. Každý jazyk navyše je skutočný čas zostavovania, lebo sa prekladá aj sníma. Nie je to to isté nastavenie ako jazyk, v ktorom sa zobrazuje táto stránka a ktorý meníte v päte alebo na stránke svojho účtu.
- Multistore — zapnite, ak váš obchod beží v režime multistore v PrestaShope. Rozhoduje o tom, či sú nastavenia pre každý obchod zvlášť alebo spoločné a či vlastné tabuľky nesú stĺpec obchodu; pred zostavením je to lacné rozhodnutie, po ňom drahá prestavba.
- Referenčná snímka obrazovky — priložte PNG, JPEG alebo WebP do 5 MB, keď je obrázok rýchlejší než odsek, napríklad presne tú stránku, na ktorej sa má modul objaviť. Pripojí sa ku konverzácii, ktorú otvárate; opíšte aj to, čo je na nej vidieť, lebo zostavenie vychádza zo znenia zadania.
- Šablóna — agent sa opýta, či stačí klasická šablóna, alebo modul musí prežiť aj vlastnú. Táto odpoveď rozhoduje o tom, ako opatrne sa šablóny v obchode napájajú, takže stojí za chvíľu premýšľania.
Kredity na zostavenie
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.
Premýšľanie nič nestojí, nech konverzácia trvá akokoľvek dlho. Kredit sa strhne vo chvíli, keď schválite — a ak odovzdanie zostavovacej linke práve vtedy zlyhá, vráti sa rovno na váš zostatok. Koľko vám ostáva, nájdete na stránke svojho účtu.
Každé schválenie stojí jeden, či ide o druhý modul, alebo o zmenenú verziu toho, ktorý už máte. Keď zostatok klesne na nulu, tlačidlo zostavenia sa vypne; napíšte nám na adresu v päte a doplníme ho.
Inštalácia modulu, ktorý dostanete
Na stiahnutie je obyčajný zip modulu pre PrestaShop, pomenovaný podľa modulu a jeho verzie. Potrebuje obchod na PrestaShope 8.x alebo 9.x s PHP 8.1 alebo novším — presne tie verzie, ktoré ste zvolili pri opise. Nikto z module.monster sa vášho obchodu nedotkne; nainštalujete si ho sami, tou cestou, ktorú bežne používate:
- V administrácii choďte do Moduly, potom Správca modulov, a cez „Nahrať modul“ tam zip vložte. PrestaShop ho rozbalí a nainštaluje v jednom kroku. Na 8.x aj 9.x je táto obrazovka na rovnakom mieste.
- Alebo zip rozbaľte a priečinok, ktorý z neho vypadne, skopírujte cez FTP alebo SSH do adresára /modules svojho obchodu, presne pod tým názvom, aký zo zipu vyšiel. Modul sa potom objaví v Správcovi modulov, kde stlačíte Inštalovať.
- Tak či onak skončíte v Správcovi modulov: „Konfigurovať“ otvorí vlastnú stránku nastavení modulu v administrácii. Odinštalovanie z tej istej obrazovky odstráni tabuľky, záložky a nastavenia, ktoré vytvoril.
Najprv ho nainštalujte na skúšobnú kópiu svojho obchodu a preklikajte ho tam. Je to obyčajné PHP, ktoré patrí vám — prečítajte si ho, zmeňte ho, odovzdajte ho svojmu vývojárovi — ale je to kód, ktorý váš obchod ešte nikdy nespustil, a živý obchod je zlé miesto na to, aby ste to zisťovali.
Hranice a očakávania
- Jeden modul naraz, veľkosťou zhruba to, čo dobrý vývojár postaví za deň. Väčší nápad sa v rozhovore oreže na najmenšiu verziu, ktorá obstojí sama osebe, a zvyšok sa navrhne ako samostatný modul neskôr.
- Len PrestaShop 8.x a 9.x, na PHP 8.1 alebo novšom. Nič staršie podporované nie je, vrátane 1.7.
- Modul sa zostavuje a testuje proti štandardnej inštalácii PrestaShopu. Silno upravená šablóna alebo iný modul, ktorý súperí o ten istý hook, si po nasadení do vášho obchodu stále môžu vyžiadať úpravy.
- Modul môže hovoriť s vonkajšou službou, ale účet a prihlasovacie údaje sú vaše a túto časť sa pri testovaní preveriť nedá. Berte každé takéto napojenie ako niečo, čo si musíte overiť na vlastnom skúšobnom obchode.
- Schválením sa zadanie uzatvára. Konverzácia potom sleduje zostavenie, namiesto toho aby prijímala zmeny, takže revízia znamená nové zostavenie a ďalší kredit. Skôr než tlačidlo stlačíte, prečítajte si zhrnutie.
- Sťahujete zip modulu. Ilustrovaná používateľská príručka, ktorá počas zostavovania vzniká, nie je súčasťou tohto stiahnutia — napíšte nám, ak o ňu stojíte.
- Žiadny prístup ani jedným smerom: nič sa vám do obchodu neinštaluje a modul si nikdy nevolá domov. Znamená to aj žiadne automatické aktualizácie — čo ste si stiahli, ostane tak, ako je, kým si nevytvoríte niečo nové.
- Zostavenia občas zlyhajú. Krok, ktorý sa opakovane vracia zle, sa skúsi až trikrát, a potom sa modul označí ako vyžadujúci pozornosť, namiesto toho aby sa odoslalo niečo pokazené. Uvidíte to na stránke modulu a my sa na to sami pozrieme.
To je celý postup. Ďalším krokom je jedna veta o tom, čo má váš obchod vedieť.
Začať