Co modul zobrazuje zákazníkovi
Tabulka dopravců
Seznam všech způsobů doručení, které mohou doručit prohlížený produkt do zóny návštěvníka. Tabulka má tři sloupce — Dopravce, Informace a Cena — a v každém řádku jsou:
- dopravce — jako logo nebo jako název, podle volby v konfiguraci;
- doba doručení — pole „zpoždění“ zadané u dopravce v PrestaShopu (v režimu loga se ve stejném sloupci zobrazuje také název dopravce);
- cena — vypočítaná pro tento produkt, tuto zónu a tuto skupinu zákazníků, nebo slovo „Zdarma“, pokud doručení nic nestojí.
Pokud pro produkt není ani jeden způsob doručení, modul místo prázdné tabulky vypíše krátkou větu „Pro tento produkt nejsou dostupné žádné způsoby doručení.“.
Pod tabulku modul doplní informaci o prahu dopravy zdarma ve formě „Při nákupu nad částka nebo hmotnost doprava zdarma!“ — pokud má obchod takový práh nastavený — a také libovolný vlastní text prodejce, zvlášť pro každý jazyk, zadávaný v editoru WYSIWYG.
Odznak nejlevnější dopravy
Jeden řádek ve formě „Doprava začíná od X“, s ikonou a volitelně s dobou doručení na druhém řádku. Odznak je řízen nezávisle na tabulce — lze zapnout jen odznak, jen tabulku nebo obojí zároveň, každé na jiném místě stránky.
Úplný seznam funkcí
Zobrazení a umístění
- Tabulka dopravců v záložkách produktové karty (
displayProductExtraContent), v patičce produktové karty (displayFooterProduct) nebo na libovolném místě šablony přes{hook h='displayCustomHookTable'}. - Odznak u tlačítek nákupu (
displayProductActions), v bloku doplňujících informací (displayProductAdditionalInfo) nebo kdekoli přes{hook h='displayCustomHookBadge'}. - Přepínač logo dopravce nebo jeho název v prvním sloupci tabulky.
- Možnost „nejlevnější, ale ne zdarma“ — odznak pak zobrazuje nejlevnější placené doručení místo bezplatného, pokud má obchod dopravce za 0 Kč.
- Přepínač doby doručení na odznaku.
- Vlastní text pod tabulkou v editoru WYSIWYG, zvlášť pro každý jazyk obchodu.
- Skrytí vybraných dopravců — označení v seznamu se nezobrazí ani v tabulce, ani v odznaku. Užitečné například při „osobním odběru“ za 0 Kč, který by jinak vždy vyhrál odznak a propagoval dopravu zdarma, která dopravou není.
Výpočet ceny
- Cena počítaná pro konkrétní produkt a konkrétního návštěvníka: hmotnost a cena produktu, doručovací zóna, skupina zákazníků, měna a jazyk.
- Varianty produktu vstupují do výpočtu: hmotnost a cena kombinace se připočítávají stejně, jako to dělá košík PrestaShopu.
- Obnovení bez načtení stránky — po výběru varianty se tabulka i odznak přepočítají přes AJAX.
- Zohledňují se dopravci přiřazení k produktu, hmotnostní a cenová pásma, manipulační poplatek a dodatečný náklad na odeslání produktu.
- Dopravci obsluhovaní moduly dopravy (kurýři s vlastním API) jsou dotazováni na cenu stejně jako v košíku; odmítnutí takového modulu znamená, že dopravce zmizí z tabulky, nikoli že je doprava zdarma.
- Daň podle nastavení skupiny zákazníků — s DPH nebo bez DPH, stejně jako cena produktu vedle.
- Práh dopravy zdarma porovnávaný podle volby: s celým košíkem navýšeným o prohlížený produkt (stejně jako to počítá objednávka) nebo jen se samotným produktem.
- Spolupráce s modulem Free Delivery Pro (
pdfreedeliverypro), pokud je nainstalovaný a aktivní — práh dopravy zdarma pod tabulkou se pak bere z jeho nastavení.
Doručovací zóna a databáze GeoIP
- Přihlášený zákazník s adresou — ceny pro zónu jeho doručovací adresy.
- Host bez adresy — země rozpoznaná podle IP adresy v databázi GeoIP a z ní zóna.
- Chybějící databáze nebo neznámá adresa — zóna výchozí země obchodu. Modul funguje i bez databáze GeoIP; tento krok se pak jednoduše přeskočí.
- Databáze DB-IP Lite (licence CC BY 4.0), stahovaná jedním tlačítkem ze záložky GeoIP v administraci, aktualizovaná u zdroje každý měsíc.
- Hlavička modulu upozorňuje, když je databáze starší než 60 dní — stáří se čte z data sestavení uloženého přímo v databázi, ne z data souboru.
- Stahování je odolné proti přerušení: nová databáze nahradí starou až po rozbalení a ověření, že ji lze otevřít.
- Adresář s databází je uzavřen proti přístupu ze sítě souborem
.htaccess; na serverech nginx je třeba přidat pravidlo na straně hostingu, což modul uvádí přímo v konfiguraci.
Výkon
- Vypočítaná cena se ukládá do vlastní tabulky modulu, s klíčem zahrnujícím produkt, variantu, zónu, zemi, skupiny zákazníků, nastavení daně, obchod, jazyk, měnu a stranu prahu dopravy zdarma.
- Doba uchování nastavitelná v hodinách, výchozí je jeden den; hodnota 0 ukládání zcela vypne.
- Tlačítko „Vyčistit nyní“ s počítadlem uložených výpočtů.
- Uložené výpočty jsou automaticky zneplatňovány při změně dopravce, produktu, kombinace, akční ceny a také při uložení nastavení samotného modulu.
- Výpočet závislý na modulu dopravy kurýra se neukládá — takové ceny jsou platné pro jednoho zákazníka a pro nikoho dalšího.
- Měřeno počítadlem dotazů relace MySQL, u placeného dopravce: předchozí verze modulu prováděla 23 + 5,00 × N dotazů na jeden výpočet (N = počet aktivních dopravců), verze 2.0.0 provádí 24 + 3,00 × N a opakovaný vstup na stejnou produktovou kartu — jeden dotaz. Na skutečné produktové kartě je mezní náklad ještě nižší, protože stránka už stejně načítá většinu dat, která výpočet potřebuje.
Administrace
- Čtyři záložky: Odznak, Tabulka dopravců, GeoIP a Návod.
- Každá záložka ukládá výhradně svá nastavení — uložení odznaku neovlivní tabulku a naopak.
- Hlavička průběžně zobrazuje stav obou funkcí, přítomnost a stáří databáze GeoIP a také rozsah, ve kterém pracujete (obchod, skupina obchodů nebo všechny obchody).
- Záložka Návod obsahuje hotové vložky
{hook}ke zkopírování a vysvětluje, pro jakou zónu se ceny počítají. - Upozornění, když zvolené umístění nic nevykresluje, dokud se vložka nedostane do šablony motivu.
- Zaměstnanec s oprávněním pouze pro čtení modulů obrazovku uvidí, ale nic neuloží.
Multistore a překlady
- Každé nastavení se ukládá zvlášť pro každý obchod.
- Uložení v kontextu „všechny obchody“ nastaví společnou hodnotu, kterou používají obchody bez vlastního nastavení; obchod, který si uložil vlastní, si je ponechá.
- Obrazovka jmenovitě uvádí obchody s vlastním nastavením a odkazuje na ně, aby se uložení „pro všechny“ neukázalo jako tichá absence změny.
- Rozhraní v angličtině a polštině; všechny texty viditelné pro zákazníka lze změnit v Mezinárodní → Překlady.
Jak modul určuje cenu dopravy
- Zkontroluje, zda je produkt dostupný k objednání a zda košík není celý virtuální.
- Určí doručovací zónu: adresa přihlášeného zákazníka → GeoIP → výchozí země obchodu.
- Načte dopravce dostupné pro tuto zónu a skupinu zákazníků, se zohledněním přiřazení dopravců k produktu.
- Pro každého spočítá cenu na základě hmotnosti a ceny produktu včetně varianty, cenových pásem, příplatků a daně.
- Vyřadí dopravce, kteří tuto hmotnost nebo cenu neobsluhují, a také ty skryté prodejcem.
- Seřadí je vzestupně podle ceny a vybere nejlevnějšího pro odznak.
Osobní údaje a GDPR
Modul čte IP adresu návštěvníka výhradně proto, aby určil jeho zemi. Čtení probíhá na vašem serveru, ze souboru v adresáři modulu — IP adresa se neukládá do databáze obchodu a nikam se neodesílá. Jediné odchozí spojení, které modul navazuje, je stažení databáze GeoIP, a to pouze tehdy, když stisknete tlačítko v administraci. Pokud databázi GeoIP používáte, zmiňte toto zpracování v zásadách ochrany osobních údajů obchodu.
Technické požadavky
| PrestaShop | 1.7.0 – 9.x |
|---|---|
| PHP | 7.0 – 8.5 |
| Databáze | MySQL 5.6+ / MariaDB 10.x+ |
| Závislosti | žádné — bez Composeru a bez externích PHP knihoven |
| Velikost balíčku | cca 410 kB (databáze GeoIP se stahuje zvlášť, cca 120 MB) |
| Multistore | ano, nastavení zvlášť pro každý obchod |
| Jazyky rozhraní | angličtina, polština |
| Verze modulu | 2.0.0 |
Co modul nedělá
- Nevytváří dopravce ani nemění jejich ceníky — zobrazuje to, co máte nastavené v PrestaShopu.
- Nemění cenu dopravy v košíku ani v objednávce — počítá ji výhradně pro potřeby produktové karty.
- Nic nevykresluje pro zcela virtuální košík (pouze soubory ke stažení) — v takovém případě není co oceňovat.
- Nevyžaduje databázi GeoIP — bez ní host vidí ceny pro výchozí zemi obchodu.
Instalace
- Nahrajte balíček v Moduly → Správce modulů → Nahrát modul.
- Nainstalujte a otevřete Konfigurovat.
- Vyberte, kde se má zobrazit tabulka a kde odznak.
- Volitelně na záložce GeoIP: stáhněte geolokační databázi.