Návod na nastavení modulu X-Shipping Pro (Nastavení dopravy)

1. Co je X-Shipping Pro

X-Shipping Pro je rozšíření OpenCartu, které umožňuje vytvořit více vlastních způsobů dopravy. Každý může mít jiný název, cenu, dostupnost a kombinaci pravidel. Lze tak nastavit dopravu podle země, hmotnosti, počtu kusů, hodnoty objednávky, produktů nebo dalších vlastností košíku.

2. Instalace

OpenCart 3.x

  1. Rozbalte distribuční archiv a vyhledejte soubor xshippingpro.ocmod.zip.
  2. V administraci otevřete Rozšíření → Instalátor rozšíření a balíček nahrajte.
  3. Přejděte na Rozšíření → Rozšíření → Doprava (konkrétní cesta se může lišit podle lokalizace) a X-Shipping Pro nainstalujte.
  4. Otevřete konfiguraci modulu.

OpenCart 2.x

Postup je podobný; po instalaci navíc obnovte modifikace v Rozšíření → Modifikace → Obnovit.

OpenCart 1.x

Soubory z adresáře upload distribučního balíčku přeneste do kořenového adresáře instalace OpenCartu. Postup ověřte pro konkrétní verzi modulu.

Před instalací vytvořte zálohu souborů a databáze. U OpenCartu 3 může výrobce pro některé varianty umožňovat i ruční nahrání souborů přes FTP.
Seznam dopravních rozšíření v administrácii OpenCart
Seznam dopravních rozšíření v administrácii OpenCart · Zdroj: OpenCartMart

3. Vytvoření prvního způsobu dopravy

  1. Otevřete X-Shipping Pro v sekci dopravních rozšíření.
  2. V globálním nastavení modul povolte (Enabled).
  3. Tlačítkem + přidejte nový způsob dopravy.
  4. Vyplňte interní název (Display Name) a název viditelný zákazníkovi (Method Name).
  5. Na záložce Price Setting vyberte pevnou cenu (Flat) a zadejte například 100.
  6. Nastavení uložte a vyzkoušejte v pokladně.

Interní název usnadňuje správu; zákazník v pokladně vidí název metody.

Globální nastavení a přidání nové metody
Globální nastavení a přidání nové metody · Zdroj: OpenCartMart
Název a základní nastavení dopravní metody
Název a základní nastavení dopravní metody · Zdroj: OpenCartMart
Nastavení ceny první dopravní metody
Nastavení ceny první dopravní metody · Zdroj: OpenCartMart

4. Jak se kombinují pravidla

Pravidla připojená k jedné metodě se obecně vyhodnocují jako logické AND (A zároveň B). Jestliže nastavíte zemi Slovensko a minimální hodnotu košíku, musí být splněny obě podmínky. Nenastavená pravidla nechte ve výchozím stavu. U produktových pravidel lze samostatně volit režim AND nebo OR.

5. Obecná nastavení metody

Položka Význam
Include Weight in the Name Zobrazení hmotnosti košíku u názvu dopravy.
Tax Class Daňová třída použitá pro cenu dopravy.
Logo URL Adresa loga dopravy; může vyžadovat OCMOD a kompatibilní pokladnu.
Sort Order Pořadí metod, případně podklad pro seskupování.
Status Povolení nebo zakázání metody.
Select Group Zařazení metody do skupiny podle režimu seskupování.

6. Obecné podmínky dostupnosti

Metodu můžete omezit na konkrétní obchod (Store), geografickou zónu (Geo Zone), stát (Country), zákaznickou skupinu (Customer Group), platební metodu, výrobce, PSČ, kupón, den v týdnu nebo časový interval.

Pozor: omezení podle platební metody závisí na použitém checkout modulu. Ověřte kompatibilitu s pokladnou svého e-shopu.

7. Produktová pravidla

Na záložce produktových podmínek lze pracovat s kategoriemi, konkrétními produkty, výrobci, atributy, variantami produktů a umístěním zboží.

Product-Rules Mode

AND vyžaduje splnění všech zadaných produktových pravidel; OR stačí splnění alespoň jednoho z nich.

Ignore Product Rules

Za běžných okolností produktová pravidla ovlivňují jak dostupnost metody, tak výběr položek pro výpočet ceny. Volba Ignore Product Rules vypne jejich vliv na dostupnost, ale ponechá jejich využití při výpočtu. Pro běžné scénáře ji nechte vypnutou.

8. Nastavení ceny dopravy

Shipping By – základ výpočtu

Režim Podle čeho se počítá
Flat Amount Pevná částka nebo procento.
Quantity Počet kusů.
Weight Hmotnost.
Volume Objem.
Dimensional Weight (objem / faktor) × hmotnost – podle implementace modulu.
Volumetric Weight Objem / faktor.
SubTotal Mezisoučet zboží.
SubTotal + Tax Mezisoučet včetně daně.
SubTotal + Tax − Coupon/Reward Částka po odečtení kupónu či odměny.
Summed Total Before Shipping Celková částka před dopravou.
Grand Total Celková hodnota objednávky bez dopravy.
No. of Categories / Manufacturers / Locations Počet různých kategorií, výrobců nebo umístění.
Equation Value Hodnota získaná vlastním vzorcem.
Per Product Samostatná cena pro jednotlivé produkty.
Distance Vzdálenost od obchodu k zákazníkovi.

Cenová pásma

Tabulka pásem používá sloupce Start, End, Cost, Per Unit Block a Partial Block. První dva určují interval, třetí cenu. Per Unit Block určuje velikost zpoplatňovaného bloku; 0 znamená bez blokového násobení. Partial Block určuje zaokrouhlení: Ceiling nahoru, Flooring dolů, Fraction poměrnou část.

Additional Price: doplatek po překročení nastaveného rozsahu, například 10 € do 5 kg a dále 2 € za další kilogram. Final Cost: Single použije cenu odpovídajícího pásma; Cumulative sčítá ceny relevantních pásem. Percentage Related to: určuje základ procentního výpočtu. Price Adjustment: umožňuje nastavit minimum, maximum nebo modifikátor (+5, -5, *5, /5, 5%).

Respect Product Rules: při výpočtu se započítají pouze položky odpovídající produktovým pravidlům.

Jednotky hmotnosti se při výpočtu řídí výchozí jednotkou obchodu. Při použití objemové hmotnosti ověřte faktor a rozměrové jednotky na testovací objednávce.

9. Vlastní výpočtové vzorce

V poli Final Equation lze určit výslednou cenu aritmetickým výrazem. Například {quantity}*10 znamená 10 jednotek měny za kus. Názvy proměnných se nepřekládají.

Proměnná Význam
{subTotal} Mezisoučet zboží
{subTotalWithTax} Mezisoučet s daní
{weight} Celková hmotnost
{quantity} Celkový počet kusů
{volume} Celkový objem
{subTotalAsPerProductRule} Mezisoučet vybraných produktů
{subTotalWithTaxAsPerProductRule} Mezisoučet vybraných produktů s daní
{weightAsPerProductRule} Hmotnost vybraných produktů
{quantityAsPerProductRule} Počet vybraných produktů
{volumeAsPerProductRule} Objem vybraných produktů
{shipping} Dosavadní vypočtená cena dopravy
{modifier} Modifikátor ceny
{noOfCategory} Počet kategorií
{noOfLocation} Počet umístění
{noOfManufacturer} Počet výrobců
{couponValue} Hodnota kupónu
{rewardValue} Hodnota odměny
{minHeight}, {maxHeight}, {sumHeight} Minimální, maximální a souhrnná výška
{minWidth}, {maxWidth}, {sumWidth} Minimální, maximální a souhrnná šířka
{minLength}, {maxLength}, {sumLength} Minimální, maximální a souhrnná délka

Odkaz na cenu jiné metody lze vytvořit přes její ID, například {shipping1} pro metodu číslo 1.

10. Události a viditelnost jiných metod

Disable Store Shipping může deaktivovat standardní dopravu obchodu, pokud se aktivuje daná metoda. Hide Others On Show skryje ostatní metody při zobrazení této metody. Hide Others On Hide je může skrýt při jejím nezobrazení. Nastavení testujte s ostatními dopravními moduly.

11. Podvolby dopravy (Sub-Options)

Jedna dopravní metoda může obsahovat výběrové podvolby zobrazené v pokladně. U každé podvolby lze cenu přičíst (+10), odečíst (-10) nebo nahradit (samotné 10).

Víceúrovňové podvolby

Číselné prefixy určují hierarchii položek:

1 USA
2 Canada
1.1 California
1.2 Georgia
2.1 Alberta
2.2 Manitoba

Vlastní výchozí text lze uvést za znakem |:

1 USA|-Country-
2 Canada
1.1 California|-State-
1.2 Georgia
2.1 Alberta

Pokud import rozsáhlého CSV selže, zkontrolujte limit PHP max_input_vars. Výrobce doporučuje například hodnotu 5000.

Nastavení dopravních podvoleb
Nastavení dopravních podvoleb · Zdroj: OpenCartMart
Zobrazení dopravních podvoleb v pokladně
Zobrazení dopravních podvoleb v pokladně · Zdroj: OpenCartMart
Víceúrovňové dopravní podvolby
Víceúrovňové dopravní podvolby · Zdroj: OpenCartMart

12. Doprava podle vzdálenosti

  1. V globálním nastavení modulu zadejte klíč Google Maps Distance Matrix API podle požadavků používané verze.
  2. V nastavení obchodu doplňte Geocode výchozího místa.
  3. U konkrétní dopravní metody nastavte Shipping By → Distance a příslušné cenové intervaly.
  4. Ověřte fungování API, fakturaci a dostupnost služby u Google.
Podpora a názvy mapových API se mohou měnit; řiďte se také aktuální dokumentací Google Maps Platform.
Nastavení klíče Google Maps API
Nastavení klíče Google Maps API · Zdroj: OpenCartMart
Nastavení Geocode obchodu
Nastavení Geocode obchodu · Zdroj: OpenCartMart

13. Dynamický obsah popisu dopravy

Datum doručení – [date]

Shortcode umožňuje zobrazit odhadované datum. Číselný obsah znamená počet dnů; volba format používá formát data PHP. Parametr offday vynechá určené dny týdne (0 = neděle, 6 = sobota), mode určuje směr next/prev, same_day zahrnutí dneška, same_day_limit časový limit 0–23 hodin a offset posun v hodinách u textových dat.

[date format="d M Y" offday="6,0"]3[/date]
[date format="d M Y"]next monday[/date]
[date format="d M Y"]first sunday of * month[/date]
[date format="d M Y" offset="24"]next wednesday[/date]

Formulář – [xform]

Máte-li rozšíření X-Form, lze do popisu vložit formulář podle jeho ID:

[xform]1[/xform]

14. Praktické příklady

A. Doprava zdarma od hodnoty 500

Založte metodu, vyberte výpočet podle hodnoty objednávky a nastavte pásmo:

Start End Cost Per Unit Block Partial Block
500 999999 0 0 Ceiling

B. Doprava zdarma pouze pro kategorie A a B

Navíc zapněte pravidlo kategorie pro libovolnou z vybraných kategorií A nebo B. Cenové pásmo zůstane jako v příkladu A. U smíšených košíků prověřte, jak se kombinuje hodnota objednávky s produktovými pravidly.

C. Cena 10 za každý kus

Nastavte Shipping By → Quantity, rozsah 0–9999, cenu 10, Per Unit Block 1 a Partial Block Ceiling.

D. Cena 10 za kus jen u kategorií A a B

Vyberte požadované kategorie a režim výpočtu pouze pro odpovídající produkty (Quantity – Method Specific, je-li v dané verzi dostupný). Použijte stejné pásmo jako v příkladu C.

E. Doprava ve výši 10 % z objednávky

Vyberte Flat, do ceny zadejte 10% a jako procentní základ nastavte Total.

15. Diagnostika a ladění

  1. V globálním nastavení modulu zapněte ladicí režim.
  2. Otevřete Global Setting → Help → Live Debug a ponechte okno otevřené.
  3. V druhém okně projděte košík a výběr dopravy.
  4. Ve výpisu ladění sledujte, které podmínky daná metoda nesplnila.
  5. Po testování ladicí režim vypněte.
Zapnutí režimu ladění
Zapnutí režimu ladění · Zdroj: OpenCartMart
Ukázka výpisu Live Debug
Ukázka výpisu Live Debug · Zdroj: OpenCartMart

16. Časté dotazy

Modul není v seznamu dopravních rozšíření

Prověřte, zda byly soubory nahrány do správného kořene OpenCartu. U starších verzí OpenCartu zkontrolujte nastavení FTP a případně instalaci opakujte.

Instalátor v OpenCartu 2.x nefunguje

Ověřte přístupové údaje FTP a cestu k adresáři obchodu. Alternativou může být ruční instalace podle postupu výrobce.

Nezobrazuje se popis nebo logo dopravy

Příčinou může být nekompatibilita šablony nebo checkout modulu. Ověřte podporu těchto prvků u konkrétní pokladny.

Produkty mají hmotnost v gramech, obchod používá kilogramy

Produkty není nutné hromadně přepisovat. Cenová pásma zadávejte v jednotce, která je v OpenCartu nastavena jako výchozí pro obchod.

Kde získám vzorové CSV pro ceny a podvolby?

Na záložce Price Setting použijte tlačítko Export. Obdobně lze získat vzor pro podvolby.

17. Originální zdroje a obrazová dokumentace

Tento průvodce je nezávisle formulovaný český návod. Původní snímky administračního rozhraní, které nebylo možné bezpečně převzít do samostatného souboru, najdete přímo v dokumentaci výrobce X-Shipping Pro. V dokumentaci jsou ukázky instalace, vytvoření metody, podvoleb, nastavení vzdálenosti a ladění. Technické názvy polí se mohou lišit podle verze modulu.

Autor rozšíření uvádí podporu na opencartmart@gmail.com.

Český praktický průvodce X-Shipping Pro · HTML fragment kompatibilní s Bootstrap 4.4.1 · Obsah je možné vložit přímo do těla stránky redakčního systému.