Kde hledat pomoc s PrestaShopem
PrestaShop je open source platforma pro e-shopy – software s otevřeným kódem, který si stáhnete zdarma a nainstalujete na svůj hosting. E-shop je tím pádem opravdu váš: máte přístup ke kódu, k databázi i ke všem datům a nikdo vám neurčuje, co s nimi smíte dělat. Druhá strana téže mince je, že za obsah a chování e-shopu už neodpovídá nikdo jiný než vy.
Dřív nebo později proto přijde otázka, na kterou vám hostingová podpora odpovědět nemůže. Jak upravit poslední krok objednávky, proč po aktualizaci přestal fungovat modul na dopravu (modul je rozšíření, které do e-shopu přidá funkci navíc) nebo kde se mění text v e-mailu, který zákazníkovi chodí po nákupu. Takové věci se odehrávají uvnitř e-shopu, ne na serveru pod ním.
Tenhle článek je rozcestník pro provozovatele e-shopu na PrestaShopu – ať už jste si ho právě spustili, nebo jste ho po někom převzali. Najdete v něm, kudy vede hranice mezi hostingem a e-shopem, s čím se máte obrátit na nás a jaké zdroje o PrestaShopu stojí za to znát. Nenajdete tu návod na ovládání samotného PrestaShopu – od toho je oficiální dokumentace, na kterou dále odkazujeme.
Co článek předpokládá: Stačí, že máte e-shop na PrestaShopu a chcete se v jeho světě zorientovat. Programovat nemusíte umět. Pokud vás cestou zaskočí neznámý výraz, otevřete si vedle Slovníček pojmů – většina termínů je tam vysvětlená.
Rychlý přehled pro pokročilé
Tato část slouží pouze pro ověření pro velmi zkušené uživatele, kteří si chtějí pouze ověřit postup a nepotřebují číst celý článek. Pro všechny ostatní doporučujeme pokračovat další sekcí.
- Hosting a server – verze a limity PHP, SSL certifikát, e-maily, DNS, zálohy, výkon serveru: řeší podpora Váš Hosting.
- Ovládání e-shopu – produkty, objednávky, doprava, platby, překlady: uživatelská dokumentace PrestaShopu.
- Úpravy kódu, moduly a šablony – vývojářská dokumentace PrestaShopu.
- Konkrétní problém, na který nikde není návod – oficiální fórum, hlavní provoz je v angličtině.
- Chyba přímo v PrestaShopu a přehled novinek ve vydáních – projekt na GitHubu.
- Hotové rozšíření nebo šablona – oficiální nabídka Addons.
- Dotaz v češtině a hledání vývojáře – facebooková skupina PrestaShop CZ/SK poradna.
Co je dobré vědět předem
Počítejte s tím, že většina zdrojů o PrestaShopu je v angličtině. Je to celosvětový projekt a české materiály tvoří jen malý zlomek toho, co je k dispozici. Česky se dnes o PrestaShopu diskutuje hlavně na Facebooku – odkaz na skupinu najdete v sekci Česká a slovenská komunita.
Druhá věc, kterou si zjistěte dřív, než se do hledání pustíte, je větev PrestaShopu, kterou provozujete – tedy hlavní řada verzí, do které vaše instalace patří. Mezi větvemi se mění umístění i názvy sekcí v administraci, takže návod psaný pro jinou větev vám sedět nebude. Kde údaj o verzi najdete, popisujeme v sekci Jak zjistíte verzi PrestaShopu.
Co budete potřebovat
- Přístup do administrace PrestaShopu (povinné) – bez něj nezjistíte verzi e-shopu ani se nedostanete k jeho logu.
- Přístup do Zákaznického portálu nebo VPS Centra (podmíněné) – jen pokud budete PrestaShop instalovat, zakládat testovací kopii e-shopu nebo měnit verzi PHP.
- Záloha souborů webu a databáze (podmíněné) – jen před nasazením nového rozšíření nebo před změnou verze PHP. Postup najdete v článcích Jak zazálohovat a obnovit web a Jak zazálohovat, obnovit a přenést databázi.
Jak zjistíte, jakou verzi VPS Centra máte
Rozlišení se v tomto článku projeví na dvou místech – u instalace PrestaShopu a u vytvoření testovací kopie e-shopu. Pokud máte webhosting, VPS Centrum nepoužíváte a řídíte se řádky pro webhosting. Na virtuálním serveru verzi poznáte podle vzhledu rozhraní.
VPS Centrum V3 má svislé menu vlevo (Domény, Databáze, Zabezpečení a další) a číslo verze vpravo dole.
VPS Centrum V2 má vodorovné menu nahoře (Domény, Správa serveru, Přehledy a další), per-doménové menu v pravém zeleně orámovaném panelu a číslo verze v patičce.
Co řeší podpora Váš Hosting a co je na vás
Hranice vede takto: staráme se o prostředí, ve kterém e-shop běží. Samotný e-shop – jeho kód, moduly, šablona, texty a data – je váš.
S čím se obraťte na nás:
- verze PHP pro doménu, na které e-shop běží – Jak nastavit verzi PHP pro doménu a subdoménu
- hodnoty PHP konfigurace, na které narazí import produktů nebo náročnější modul, typicky memory_limit, max_execution_time a upload_max_filesize – Jak upravit hodnoty PHP konfigurace pro doménu
- SSL certifikát a přepnutí e-shopu na HTTPS – Jak aktivovat SSL certifikát a zapnout HTTPS
- doména, DNS záznamy a nasměrování e-shopu – Jak nasměrovat doménu na server nebo webhosting
- e-mailové schránky na doméně a doručování zpráv, které e-shop odesílá
- zálohy souborů webu a databáze e-shopu
- pravidelné spouštění skriptů přes cron – Co je to cron a jak ho správně nastavit
- přesun e-shopu od jiného poskytovatele – Jak migrovat web: Přesun webových stránek na nový hosting
- dostupnost serveru, jeho výkon a parametry tarifu
Co se odehrává uvnitř e-shopu:
- nastavení dopravy, plateb, DPH a textů na fakturách
- instalace, konfigurace a aktualizace modulů a šablon, tedy rozšíření a vzhledu e-shopu
- aktualizace samotného PrestaShopu na novější verzi, do které patří i bezpečnostní opravy
- překlady, popisky a obsah stránek
- úpravy vzhledu a zásahy do kódu
- napojení na srovnávače zboží, účetní nebo skladový systém
I tam, kde problém spadá na stranu e-shopu, vám pomůžeme se zorientovat. Pokud si nejste jistí, kde chyba vzniká, napište nám – podíváme se do serverového logu a řekneme vám, co v něm o vašem e-shopu stojí. Jak si totéž ověřit sami, popisujeme v sekci Nevíme, kam se s problémem obrátit.
Kde najdete instalátor PrestaShopu
Pokud PrestaShop teprve zvažujete nebo ho ještě nemáte nainstalovaný, začněte tady. Instalace na jeden klik je připravená ve všech třech rozhraních – jen se sekce v každém z nich jmenuje jinak:
- Webhosting: v Zákaznickém portálu Domény → Přehled domén → Detail u konkrétní domény → Instalátor CMS
- VPS Centrum V3: Přehled domén → Detail u konkrétní domény → Instalátor
- VPS Centrum V2: v pravém zeleně orámovaném panelu vyberte doménu a otevřete Instalace CMS
Oficiální zdroje PrestaShopu
Oficiální zdroje mají jednu velkou výhodu: udržuje je samotný projekt, takže odpovídají aktuálním verzím. Vyplatí se je znát dřív, než začnete hledat ve vyhledávači.
Uživatelská dokumentace pro ovládání e-shopu
Adresa: docs.prestashop-project.org
Popisuje administraci e-shopu z pohledu obchodníka – katalog produktů, objednávky, zákazníky, dopravu, platební metody, slevy, lokalizaci i statistiky. Je to první místo, kam se podívat, když hledáte, kde se co v administraci nastavuje.
Dokumentace je vedená zvlášť pro jednotlivé větve PrestaShopu. Vyberte si tu, kterou skutečně provozujete – mezi větvemi se mění nejen umístění, ale i názvy sekcí.
Vývojářská dokumentace pro úpravy a moduly
Adresa: devdocs.prestashop-project.org
Technická dokumentace pro ty, kdo do PrestaShopu zasahují: architektura, hooky (místa v kódu, kam se dá napojit vlastní funkce), vývoj vlastních modulů a šablon, testování i nástroje pro příkazovou řádku.
Pokud si na úpravu někoho najímáte, tohle je odkaz, který mu pošlete. Vám samotným poslouží hlavně tehdy, pokud si e-shop upravujete sami.
Oficiální fórum PrestaShopu
Adresa: forum.prestashop.com
Největší archiv už vyřešených problémů, který k PrestaShopu existuje. Než založíte nové téma, zkuste do vyhledávání zadat přesné znění chybové hlášky – u běžných potíží je slušná šance, že odpověď už někdo napsal.
Hlavní provoz je v angličtině. Česká jazyková sekce sice existuje, ale prakticky se v ní nediskutuje, takže dotaz vložený do ní se odpovědi nedočká. Ptejte se raději v anglických sekcích, případně v české facebookové skupině. Jak dotaz napsat, aby na něj někdo reagoval, shrnuje sekce Jak položit dotaz a dostat odpověď.
GitHub pro hlášení chyb a přehled vydání
Adresa: github.com/PrestaShop/PrestaShop
Tady vzniká samotný PrestaShop. Pro provozovatele e-shopu se hodí ve dvou situacích. První: našli jste chybu přímo v PrestaShopu a chcete ji nahlásit – nejdřív ověřte, jestli ji už někdo nenahlásil před vámi. Druhá: chystáte se aktualizovat a chcete si přečíst, co nová verze mění, než do toho půjdete.
Addons jako oficiální nabídka modulů a šablon
Adresa: addons.prestashop.com
Oficiální nabídka rozšíření a šablon. U každé položky je uvedená kompatibilita s verzemi PrestaShopu – to je první údaj, který si před pořízením ověřte, protože modul pro starší větev vám na novější instalaci fungovat nemusí.
Moduly se dají pořídit i mimo Addons, přímo od autorů. V takovém případě si o autorovi zjistěte, jak dlouho modul udržuje a jak řeší podporu, protože rozšíření, které nikdo neaktualizuje, se při příštím přechodu na novější PrestaShop často stane přítěží.
Česká a slovenská komunita
Česky a slovensky se o PrestaShopu diskutuje především ve facebookové skupině PrestaShop CZ/SK poradna. Zeptáte se v ní na konkrétní problém česky, najdete vývojáře na jednorázovou úpravu nebo zjistíte, s jakým modulem mají ostatní zkušenost v českém prostředí – u dopravců, platebních bran nebo srovnávačů zboží se to hodí nejvíc, protože oficiální zdroje na české specifikum odpověď nemají. Skupina je uzavřená, takže do ní nejprve požádáte o vstup.
Jak položit dotaz a dostat odpověď
Na fóru i ve facebookové skupině platí totéž: čím konkrétnější dotaz, tím rychlejší odpověď. Do dotazu patří:
- verze PrestaShopu, kterou provozujete
- verze PHP, na které e-shop běží
- přesné znění chybové hlášky, zkopírované, ne převyprávěné vlastními slovy
- co se dělo těsně předtím, než se problém objevil – aktualizace, instalace modulu, změna šablony
- co jste už zkusili
- jak má výsledek vypadat
Jak zjistíte verzi PrestaShopu
Verzi najdete v administraci e-shopu v sekci Rozšířené parametry → Informace, kde je uvedená spolu s dalšími údaji o instalaci. U starších větví bývá vypsaná také v patičce administrace.
Kde najdete chybovou hlášku
PrestaShop si vede vlastní log – tedy záznam, do kterého systém průběžně zapisuje, co se stalo, včetně chyb. Najdete ho přímo v administraci Prestashopu v sekci Rozšířené parametry → Logy. Chyby, které vzniknou dřív, než se PrestaShop vůbec spustí, se do něj ale nedostanou – ty hledejte v serverovém logu PHP. Kde ho najít a jak si chyby nechat zobrazit, popisuje článek Jak zobrazit chyby v PHP.
Kdy stačí modul a kdy potřebujete vývojáře
Většina úprav, které si e-shop časem vyžádá, spadá do jedné ze dvou kategorií.
Modul se vyplatí u funkcí, které řeší spousta e-shopů stejným způsobem: napojení na dopravce, platební brána, export do srovnávačů zboží, hromadné úpravy produktů, generování dokladů. Někdo to už vyřešil, udržuje to a vy dostanete hotovou věc.
Vývojáře potřebujete tam, kde má váš e-shop vlastní proces: napojení na skladový nebo účetní systém, netypický průběh objednávky, úprava chování, kterou žádné existující rozšíření neumí. Vývojáře seženete přes facebookovou skupinu nebo přes sekci s nabídkami práce na oficiálním fóru.
Než rozšíření nasadíte do běžícího e-shopu
Ať už zvolíte modul, nebo vlastní úpravu, projděte si předem tenhle seznam:
- ověřte kompatibilitu s vaší verzí PrestaShopu i s verzí PHP
- podívejte se, kdy autor rozšíření naposledy aktualizoval
- zjistěte, jak funguje podpora a co se s rozšířením stane při přechodu na novější PrestaShop
- udělejte zálohu souborů webu i databáze
- vyzkoušejte změnu nejdřív na kopii e-shopu, ne na tom, který právě prodává
Nástroj pro vytvoření kopie máte v každém rozhraní, jen se liší:
- Webhosting: v Zákaznickém portálu Domény → Přehled domén → Detail u konkrétní domény → Instalátor CMS → Klonování subdomény
- VPS Centrum V3: staging, tedy testovací kopie webu, kterou po odladění nasadíte zpátky do produkce – postup popisuje článek Jak vytvořit kopii webu pro vývoj a testování (staging)
- VPS Centrum V2: v pravém zeleně orámovaném panelu vyberte doménu, otevřete FTP a klikněte na Klonovat ftp; na stránce Klonovat web zvolíte cílovou subdoménu a volbou Klonovat db s ftp zkopírujete i databázi
Pokud vám kopie z rozhraní nestačí nebo si ji chcete postavit jinak, založte ji na subdoméně ručně: nahrajte soubory a naimportujte databázi podle článku Jak nahrát web na hosting nebo VPS.
Řešení problémů
Nevíme, kam se s problémem obrátit
Symptom: E-shop hlásí chybu nebo se vůbec nenačte a nevíme, jestli to máme řešit s hostingovou podporou, nebo uvnitř e-shopu.
Příčina: Bílá stránka i chyba 500 vypadají navenek stejně bez ohledu na to, jestli je způsobil kód e-shopu, nebo limit na serveru. Rozliší je až konkrétní hláška v logu.
Řešení: Podívejte se do serverového logu PHP podle článku Jak zobrazit chyby v PHP. Pokud hláška ukazuje na soubor v adresáři modulu nebo šablony, jde o e-shop a míří to na autora rozšíření nebo na vývojáře. Pokud jde o vyčerpanou paměť nebo překročenou maximální dobu běhu skriptu, upravte hodnoty podle článku Jak upravit hodnoty PHP konfigurace pro doménu – na webhostingu je na požádání nastavíme my, na VPS si je změníte sami. A pokud nefunguje ani nic dalšího na vašem účtu – další weby, e-maily, přihlášení – jde o hosting a ozvěte se rovnou nám.
Návod, který jsme našli, u nás nefunguje
Symptom: Postupujeme podle nalezeného návodu, ale v administraci nevidíme sekci, o které mluví, nebo se položky jmenují jinak.
Příčina: Návod se váže k jiné větvi PrestaShopu. Umístění i názvy sekcí se mezi větvemi mění.
Řešení: Zjistěte si svoji verzi podle sekce Jak zjistíte verzi PrestaShopu a v oficiální dokumentaci přepněte na odpovídající větev. U návodů mimo oficiální dokumentaci hledejte datum vydání a údaj o verzi – pokud u textu ani jedno není, počítejte s tím, že může být zastaralý.
Napsali jsme na fórum a nikdo neodpovídá
Symptom: Dotaz jsme na oficiálním fóru položili před několika dny a nikdo na něj nereagoval.
Příčina: Buď je dotaz položený v jazykové sekci, kde už se nediskutuje, nebo neobsahuje dost údajů na to, aby na něj šlo odpovědět.
Řešení: Doplňte verzi PrestaShopu, verzi PHP a přesné znění chyby a dotaz položte v anglické sekci fóra. Souběžně se zeptejte v české facebookové skupině – u problémů spojených s českým prostředím je odezva rychlejší.
Po instalaci modulu se e-shop rozbil
Symptom: Po instalaci nebo aktualizaci modulu se e-shop nenačte, rozpadl se vzhled nebo se nedostaneme ani do administrace.
Příčina: Modul není kompatibilní s verzí PrestaShopu nebo PHP, případně koliduje s jiným už nainstalovaným rozšířením.
Řešení: Pokud se do administrace dostanete, modul v ní vypněte. Pokud ne, přejmenujte složku modulu v adresáři modules přes FTP nebo přes Správce souborů – PrestaShop ji pak přestane načítat a vy se k modulu můžete kdykoli vrátit tím, že jí vrátíte původní název. Mazat složku doporučujeme až ve chvíli, kdy máte zálohu a víte, že se modul vracet nebude. Potom vymažte mezipaměť podle článku Vymazání mezipaměti, jinak se může e-shop tvářit dál rozbitě. Když to nepomůže, vraťte se k záloze podle článků Jak zazálohovat a obnovit web a Jak zazálohovat, obnovit a přenést databázi a napište autorovi modulu, ať s tím počítá.
Modul vyžaduje jinou verzi PHP, než na které běžíme
Symptom: Při instalaci rozšíření jsme dostali hlášku, že vyžaduje jinou verzi PHP, než na které e-shop běží.
Příčina: Verze PHP se nastavuje na straně hostingu pro každou doménu zvlášť a nemusí odpovídat tomu, co rozšíření očekává.
Řešení: Verzi PHP si přepnete sami podle článku Jak nastavit verzi PHP pro doménu a subdoménu. Než to uděláte, ověřte v oficiální dokumentaci, že s danou verzí PHP počítá i vaše větev PrestaShopu – jinak byste kvůli jednomu rozšíření mohli rozbít celý e-shop. Před přepnutím si udělejte zálohu a hned po něm projděte e-shop od výpisu produktů až po dokončení objednávky.
Pokud problém přetrvává, kontaktujte naši podporu – s hostingovou částí poradíme a pomůžeme zjistit, na kterou stranu hranice problém patří.
