Instalace modulu v PrestaShopu ze souboru ZIP: krok za krokem a co dělat, když selže
Instalace modulu v PrestaShopu ze souboru ZIP zabere tři kliknutí v Moduly → Správce modulů: tlačítko pro nahrání, výběr souboru a konfigurace. Když se objeví chyba, příčinou je obvykle stavba balíčku, limit velikosti souboru na serveru, nebo verze modulu, která neodpovídá vašemu e-shopu. Před instalací e-shop zálohujte a ověřte, odkud balíček pochází.
Autor: Tým TellMyShop. Průvodce pro majitele obchodů na PrestaShopu: příčina, ruční oprava a stejná práce v rozhovoru v chatu.
Naposledy aktualizováno: · 5 min čtení
Co zkontrolovat před instalací modulu
Modul je kód, který běží na vašem serveru a má přístup k databázi e-shopu. Pět minut kontroly před instalací je levnějších než opravy potom.
- Zdroj. Stáhněte modul od jeho autora, z Addons nebo z vydání autora na GitHubu. Bezplatné kopie placených modulů z náhodných webů jsou častou cestou, jak se do e-shopu dostane škodlivý kód.
- Kompatibilita s verzí e-shopu. Popis modulu uvádí verze PrestaShopu a PHP, na kterých běží. Verzi svého e-shopu uvidíte v Rozšířené parametry → Informace.
- Zda už nemáte modul, který dělá totéž. Dva moduly recenzí nebo dva moduly doručení jsou častou příčinou konfliktů.
- Záloha. Záloha souborů a databáze od hostingu nebo modulem pro zálohy. Bez ní je každá chyba drahá.
- Načasování. Instalujte, když je v e-shopu klid. Moduly plateb a doručení nejdřív vyzkoušejte na testovací kopii.
Jak nainstalovat modul ze souboru ZIP
Administrace PrestaShopu 8 a 9 má na to formulář ve Správci modulů. Obrazovku modulů obecně popisuje příručka PrestaShopu k modulům.
- Přejděte do Moduly → Správce modulů.
- Nahoře na stránce klikněte na tlačítko pro nahrání modulu.
- Přetáhněte soubor ZIP do pole, nebo ho vyberte z počítače. Předem ho nerozbalujte.
- Počkejte na hlášku o instalaci. U větších modulů to trvá několik desítek sekund.
- Klikněte na Konfigurovat a nastavte modul podle pokynů autora.
- Otevřete e-shop v anonymním okně. Zkontrolujte úvodní stránku, stránku produktu a košík.
- Podívejte se do Rozšířené parametry → Záznamy, zda se po instalaci neobjevily nové chyby.
Aktualizace ze ZIPu funguje stejně: nahrajete novější verzi stejného modulu. PrestaShop pozná, že modul už tam je, nahradí soubory a spustí aktualizační skripty.
Na co si dát pozor při aktualizaci modulu
Aktualizace je víc než výměna souborů. Nová verze může měnit tabulky v databázi, přidávat nová místa na stránce nebo měnit výchozí nastavení.
- Přečtěte si seznam změn od autora. Hledejte věty o požadované verzi PHP, nových nastaveních a změnách šablon.
- Zkontrolujte, zda vaše šablona nemá kopii šablony modulu. Pokud ano, nová verze modulu může vypadat jinak, než popisuje autor, nebo nové prvky vůbec neukázat.
- Moduly plateb a doručení aktualizujte mimo nákupní špičku. Po aktualizaci zadejte testovací objednávku.
- Nepřeskakujte několik verzí najednou bez zálohy. Aktualizační skripty bývají psané s ohledem na předchozí verzi.
Nejčastější chyby při instalaci modulu
| Hláška nebo příznak | Příčina | Co udělat |
|---|---|---|
| modul je neplatný, nebo soubor nevypadá jako platný zip modulu | ZIP nemá složku modulu se souborem stejného jména | rozbalte v počítači; uvnitř má být jedna složka, např. mymodule/mymodule.php |
| stejná chyba u balíčku z Addons | stažený ZIP obsahuje modul, dokumentaci a licenci v jednom archivu | rozbalte ho a nahrajte jen vnitřní ZIP modulu |
| nahrávání skončí chybou bez popisu | soubor je větší než limit pro nahrávání na serveru | zvyšte limit u hostingu, nebo modul nahrajte přes FTP |
| modul není kompatibilní s verzí e-shopu | autor nastavil v modulu rozsah verzí PrestaShopu | stáhněte verzi modulu pro váš PrestaShop |
| prázdná stránka nebo chyba 500 po instalaci | modul potřebuje jinou verzi PHP nebo je v konfliktu s jiným modulem | vypněte modul, přečtěte protokol chyb |
| chybí oprávnění k zápisu | server nedovolí zápis do složky modules | požádejte hosting o nastavení správných oprávnění složky |
Dokumentace PrestaShopu ke struktuře modulu popisuje, jak je postavený správný balíček: složka modulu má stejný název jako modul a modul v ZIPu musí být v podsložce. Problém příliš velkých balíčků popsali vývojáři PrestaShopu ve specifikaci upozornění Správce modulů, spolu s nastaveními PHP, která za ním stojí.
Pokud se e-shop po instalaci nezobrazí, začněte článkem o chybě 500 v PrestaShopu. Pokud modul funguje, ale něco rozbíjí, vypněte ho místo odinstalace, jak popisujeme v článku o vypnutí modulu.
Jak nainstalovat nebo aktualizovat modul přes chat
Dáte svému chatu (Claude nebo ChatGPT) přímý odkaz https na soubor ZIP, například na vydání na GitHubu nebo na soubor od autora. Chat nejdřív balíček stáhne do náhledu a zkontroluje ho dřív, než se cokoli dostane do e-shopu: název a verzi modulu, zdroj, kontrolní součet SHA-256 a strukturu balíčku. Soubor z počítače tímto způsobem nahrát nejde; je potřeba odkaz.
Vy: Aktualizuj platební modul na 2.4.1 z tohoto odkazu na vydání na GitHubu. Zkontroluj e-shop před a po.
Váš chat: Náhled balíčku: platební modul, nainstalovaná verze 2.3.0, verze balíčku 2.4.1. Zdroj: vydání autora na GitHubu. Struktura správná, jedna složka modulu. Kontrolní součet SHA-256 je v náhledu, takže ho můžete porovnat s tím, který autor zveřejnil.
Před aktualizací zazálohuji soubory modulu. Změny v databázi provedené aktualizačním skriptem z historie vrátit neumím; na to je dnešní záloha databáze. Teď nejsou v záznamech od tohoto modulu žádné chyby. Aktualizovat?
Vy: Ano.
Váš chat: Aktualizováno na 2.4.1. Košík i stránka objednávky odpovídají správně a v záznamech nejsou nové chyby.
Stav karty: čeká na vaše „ano“stará verze: verze 2.3.0
nová verze: verze 2.4.1
Čísla verzí v příkladu jsou ilustrační. Ukázkový požadavek najdete v případu použití instalace nebo aktualizace modulu z balíčku ZIP, a pokud po změně něco přestane fungovat, v případu použití vypnutí modulu, který rozbíjí košík.
TellMyShop Pro instaluje a aktualizuje moduly, jakmile je v panelu modulu zapnutý přepínač Moduly. Přepínač platí 24 hodin a vyžaduje zálohu databáze ze stejného dne. Chat nic neinstaluje bez náhledu a vašeho souhlasu a od modulu z nejistého zdroje vás odradí. Odinstalaci modulu nejde vrátit, takže chat navrhne nejdřív vypnutí. V bezplatné verzi TellMyShop Free vidíte seznam modulů s jejich verzemi a místy, kde se zobrazují. Srovnání verzí najdete v ceníku a úklidu starých modulů se věnujeme v článku o nepoužívaných modulech.
Otázky a odpovědi
Kde v PrestaShopu nainstaluji modul ze souboru ZIP?
V menu Moduly, ve Správci modulů. Nahoře na stránce je tlačítko pro nahrání modulu, kam soubor ZIP přetáhnete nebo ho vyberete z počítače. Po nahrání PrestaShop modul nainstaluje a nabídne jeho konfiguraci.
Co znamená hláška, že modul je neplatný?
Nejčastěji PrestaShop v balíčku nenašel složku modulu se souborem stejného jména. Možná jste stáhli balíček s dokumentací místo modulu, archiv s několika moduly uvnitř, nebo ZIP zabalený v dalším ZIPu. Rozbalte balíček v počítači a zkontrolujte, co je uvnitř.
Odstraní aktualizace modulu ze ZIPu jeho nastavení?
Obvykle ne. Když nahrajete novější verzi stejného modulu, PrestaShop nahradí soubory a spustí aktualizační skripty modulu. Nastavení zůstane, ale skripty můžou měnit databázi. Proto před aktualizací e-shop zálohujte a ideálně ji vyzkoušejte na testovací kopii.
Jde instalaci modulu vrátit?
Nový modul můžete vypnout nebo odinstalovat. Odinstalace obvykle smaže jeho data a nastavení, takže ji vrátit nejde. U aktualizace jde soubory obnovit ze zálohy, ale změny v databázi provedené aktualizačním skriptem bez zálohy databáze nevrátíte.
Umí TellMyShop Free nainstalovat modul?
Ne. Bezplatná verze TellMyShop Free čte jen přehledy e-shopu, včetně seznamu modulů s jejich verzemi. TellMyShop Pro instaluje a aktualizuje moduly z balíčku ZIP, jakmile je přepínač Moduly zapnutý na 24 hodin.
PrestaShop je registrovaná ochranná známka společnosti PrestaShop SA. Claude je ochranná známka společnosti Anthropic PBC. ChatGPT a OpenAI jsou ochranné známky společnosti OpenAI. TellMyShop s těmito společnostmi není propojen.