Návod na nastavenie modulu X-Shipping Pro (Nastavenie dopravy)

1. Čo je X-Shipping Pro

X-Shipping Pro je rozšírenie OpenCartu, ktoré umožňuje vytvoriť viacero vlastných spôsobov dopravy. Každý môže mať iný názov, cenu, dostupnosť a kombináciu pravidiel. Dopravu tak možno nastaviť podľa krajiny, hmotnosti, počtu kusov, hodnoty objednávky, produktov alebo ďalších vlastností košíka.

2. Inštalácia

OpenCart 3.x

  1. Rozbaľte distribučný archív a vyhľadajte súbor xshippingpro.ocmod.zip.
  2. V administrácii otvorte Rozšírenia → Inštalátor rozšírení a balík nahrajte.
  3. Prejdite na Rozšírenia → Rozšírenia → Doprava (konkrétna cesta sa môže líšiť podľa lokalizácie) a nainštalujte X-Shipping Pro.
  4. Otvorte konfiguráciu modulu.

OpenCart 2.x

Postup je podobný; po inštalácii navyše obnovte modifikácie v Rozšírenia → Modifikácie → Obnoviť.

OpenCart 1.x

Súbory z adresára upload distribučného balíka preneste do koreňového adresára inštalácie OpenCartu. Postup overte pre konkrétnu verziu modulu.

Pred inštaláciou vytvorte zálohu súborov a databázy. Pri OpenCarte 3 môže výrobca pri niektorých variantoch umožňovať aj ručné nahratie súborov cez FTP.
Zoznam dopravných rozšírení v administrácii OpenCart
Zoznam dopravných rozšírení v administrácii OpenCart · Zdroj: OpenCartMart

3. Vytvorenie prvého spôsobu dopravy

  1. Otvorte X-Shipping Pro v sekcii rozšírení dopravy.
  2. V globálnych nastaveniach modul povoľte (Enabled).
  3. Tlačidlom + pridajte nový spôsob dopravy.
  4. Vyplňte interný názov (Display Name) a názov viditeľný zákazníkovi (Method Name).
  5. Na karte Price Setting vyberte pevnú cenu (Flat) a zadajte napríklad 100.
  6. Nastavenia uložte a vyskúšajte v pokladni.

Interný názov uľahčuje správu; zákazník v pokladni vidí názov metódy.

Globálne nastavenia a pridanie novej metódy
Globálne nastavenia a pridanie novej metódy · Zdroj: OpenCartMart
Názov a základné nastavenia dopravnej metódy
Názov a základné nastavenia dopravnej metódy · Zdroj: OpenCartMart
Nastavenie ceny prvej dopravnej metódy
Nastavenie ceny prvej dopravnej metódy · Zdroj: OpenCartMart

4. Ako sa kombinujú pravidlá

Pravidlá priradené k jednej metóde sa vo všeobecnosti vyhodnocujú ako logické AND (A súčasne B). Ak nastavíte krajinu Slovensko a minimálnu hodnotu košíka, musia byť splnené obe podmienky. Nenastavené pravidlá ponechajte v predvolenom stave. Pri produktových pravidlách možno samostatne zvoliť režim AND alebo OR.

5. Všeobecné nastavenia metódy

Položka Význam
Include Weight in the Name Zobrazenie hmotnosti košíka pri názve dopravy.
Tax Class Daňová trieda použitá pre cenu dopravy.
Logo URL Adresa loga dopravy; môže vyžadovať OCMOD a kompatibilnú pokladňu.
Sort Order Poradie metód, prípadne podklad pre zoskupovanie.
Status Povolenie alebo zakázanie metódy.
Select Group Zaradenie metódy do skupiny podľa režimu zoskupovania.

6. Všeobecné podmienky dostupnosti

Metódu môžete obmedziť na konkrétny obchod (Store), geografickú zónu (Geo Zone), štát (Country), zákaznícku skupinu (Customer Group), platobnú metódu, výrobcu, PSČ, kupón, deň v týždni alebo časový interval.

Pozor: obmedzenie podľa platobnej metódy závisí od použitého checkout modulu. Overte kompatibilitu s pokladňou svojho e-shopu.

7. Produktové pravidlá

Na karte produktových podmienok možno pracovať s kategóriami, konkrétnymi produktmi, výrobcami, atribútmi, variantmi produktov a umiestnením tovaru.

Product-Rules Mode

AND vyžaduje splnenie všetkých zadaných produktových pravidiel; OR stačí splnenie aspoň jedného z nich.

Ignore Product Rules

Za bežných okolností produktové pravidlá ovplyvňujú dostupnosť metódy aj výber položiek na výpočet ceny. Voľba Ignore Product Rules vypne ich vplyv na dostupnosť, ale ponechá ich využitie pri výpočte. Pri bežných scenároch ju nechajte vypnutú.

8. Nastavenie ceny dopravy

Shipping By – základ výpočtu

Režim Podľa čoho sa počíta
Flat Amount Pevná suma alebo percento.
Quantity Počet kusov.
Weight Hmotnosť.
Volume Objem.
Dimensional Weight (objem / faktor) × hmotnosť – podľa implementácie modulu.
Volumetric Weight Objem / faktor.
SubTotal Medzisúčet tovaru.
SubTotal + Tax Medzisúčet vrátane dane.
SubTotal + Tax − Coupon/Reward Suma po odpočítaní kupónu alebo odmeny.
Summed Total Before Shipping Celková suma pred dopravou.
Grand Total Celková hodnota objednávky bez dopravy.
No. of Categories / Manufacturers / Locations Počet rôznych kategórií, výrobcov alebo umiestnení.
Equation Value Hodnota získaná vlastným vzorcom.
Per Product Samostatná cena pre jednotlivé produkty.
Distance Vzdialenosť od obchodu k zákazníkovi.

Cenové pásma

Tabuľka pásiem používa stĺpce Start, End, Cost, Per Unit Block a Partial Block. Prvé dva určujú interval, tretí cenu. Per Unit Block určuje veľkosť spoplatňovaného bloku; 0 znamená bez blokového násobenia. Partial Block určuje zaokrúhľovanie: Ceiling nahor, Flooring nadol, Fraction pomernú časť.

Additional Price: doplatok po prekročení nastaveného rozsahu, napríklad 10 € do 5 kg a potom 2 € za každý ďalší kilogram. Final Cost: Single použije cenu zodpovedajúceho pásma; Cumulative sčítava ceny príslušných pásiem. Percentage Related to: určuje základ percentuálneho výpočtu. Price Adjustment: umožňuje nastaviť minimum, maximum alebo modifikátor (+5, -5, *5, /5, 5%).

Respect Product Rules: pri výpočte sa započítajú iba položky zodpovedajúce produktovým pravidlám.

Jednotky hmotnosti sa pri výpočte riadia predvolenou jednotkou obchodu. Pri použití objemovej hmotnosti overte faktor a rozmerové jednotky na testovacej objednávke.

9. Vlastné výpočtové vzorce

V poli Final Equation možno určiť výslednú cenu aritmetickým výrazom. Napríklad {quantity}*10 znamená 10 jednotiek meny za kus. Názvy premenných sa neprekladajú.

Premenná Význam
{subTotal} Medzisúčet tovaru
{subTotalWithTax} Medzisúčet s daňou
{weight} Celková hmotnosť
{quantity} Celkový počet kusov
{volume} Celkový objem
{subTotalAsPerProductRule} Medzisúčet vybraných produktov
{subTotalWithTaxAsPerProductRule} Medzisúčet vybraných produktov s daňou
{weightAsPerProductRule} Hmotnosť vybraných produktov
{quantityAsPerProductRule} Počet vybraných produktov
{volumeAsPerProductRule} Objem vybraných produktov
{shipping} Doteraz vypočítaná cena dopravy
{modifier} Modifikátor ceny
{noOfCategory} Počet kategórií
{noOfLocation} Počet umiestnení
{noOfManufacturer} Počet výrobcov
{couponValue} Hodnota kupónu
{rewardValue} Hodnota odmeny
{minHeight}, {maxHeight}, {sumHeight} Minimálna, maximálna a súhrnná výška
{minWidth}, {maxWidth}, {sumWidth} Minimálna, maximálna a súhrnná šírka
{minLength}, {maxLength}, {sumLength} Minimálna, maximálna a súhrnná dĺžka

Odkaz na cenu inej metódy možno vytvoriť pomocou jej ID, napríklad {shipping1} pre metódu číslo 1.

10. Udalosti a viditeľnosť iných metód

Disable Store Shipping môže deaktivovať štandardnú dopravu obchodu, ak sa aktivuje daná metóda. Hide Others On Show skryje ostatné metódy pri zobrazení tejto metódy. Hide Others On Hide ich môže skryť pri jej nezobrazení. Nastavenia otestujte s ostatnými dopravnými modulmi.

11. Podvoľby dopravy (Sub-Options)

Jedna dopravná metóda môže obsahovať výberové podvoľby zobrazené v pokladni. Pri každej podvoľbe možno cenu pripočítať (+10), odpočítať (-10) alebo nahradiť (samotné 10).

Viacúrovňové podvoľby

Číselné prefixy určujú hierarchiu položiek:

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

Vlastný predvolený text možno uviesť za znakom |:

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

Ak import rozsiahleho CSV zlyhá, skontrolujte limit PHP max_input_vars. Výrobca odporúča napríklad hodnotu 5000.

Nastavenie dopravných podvolieb
Nastavenie dopravných podvolieb · Zdroj: OpenCartMart
Zobrazenie dopravných podvolieb v pokladni
Zobrazenie dopravných podvolieb v pokladni · Zdroj: OpenCartMart
Viacúrovňové dopravné podvoľby
Viacúrovňové dopravné podvoľby · Zdroj: OpenCartMart

12. Doprava podľa vzdialenosti

  1. V globálnych nastaveniach modulu zadajte kľúč Google Maps Distance Matrix API podľa požiadaviek používanej verzie.
  2. V nastaveniach obchodu doplňte Geocode východiskového miesta.
  3. Pri konkrétnej dopravnej metóde nastavte Shipping By → Distance a príslušné cenové intervaly.
  4. Overte fungovanie API, fakturáciu a dostupnosť služby Google.
Podpora a názvy mapových API sa môžu meniť; riaďte sa aj aktuálnou dokumentáciou Google Maps Platform.
Nastavenie Google Maps API kľúča
Nastavenie Google Maps API kľúča · Zdroj: OpenCartMart
Nastavenie Geocode obchodu
Nastavenie Geocode obchodu · Zdroj: OpenCartMart

13. Dynamický obsah popisu dopravy

Dátum doručenia – [date]

Shortcode umožňuje zobraziť odhadovaný dátum. Číselný obsah znamená počet dní; voľba format používa formát dátumu PHP. Parameter offday vynechá určené dni v týždni (0 = nedeľa, 6 = sobota), mode určuje smer next/prev, same_day zahrnutie dnešného dňa, same_day_limit časový limit 0–23 hodín a offset posun v hodinách pri textových dátumoch.

[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ár – [xform]

Ak máte rozšírenie X-Form, do popisu možno vložiť formulár podľa jeho ID:

[xform]1[/xform]

14. Praktické príklady

A. Doprava zadarmo od hodnoty 500

Vytvorte metódu, vyberte výpočet podľa hodnoty objednávky a nastavte pásmo:

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

B. Doprava zadarmo iba pre kategórie A a B

Navyše zapnite pravidlo kategórie pre ktorúkoľvek z vybraných kategórií A alebo B. Cenové pásmo zostane ako v príklade A. Pri zmiešaných košíkoch overte, ako sa kombinuje hodnota objednávky s produktovými pravidlami.

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 iba pri kategóriách A a B

Vyberte požadované kategórie a režim výpočtu iba pre zodpovedajúce produkty (Quantity – Method Specific, ak je v danej verzii dostupný). Použite rovnaké pásmo ako v príklade C.

E. Doprava vo výške 10 % z objednávky

Vyberte Flat, do ceny zadajte 10% a ako percentuálny základ nastavte Total.

15. Diagnostika a ladenie

  1. V globálnych nastaveniach modulu zapnite ladiaci režim.
  2. Otvorte Global Setting → Help → Live Debug a nechajte okno otvorené.
  3. V druhom okne prejdite košík a výber dopravy.
  4. Vo výpise ladenia sledujte, ktoré podmienky daná metóda nesplnila.
  5. Po testovaní ladiaci režim vypnite.
Zapnutie režimu ladenia
Zapnutie režimu ladenia · Zdroj: OpenCartMart
Ukážka výpisu Live Debug
Ukážka výpisu Live Debug · Zdroj: OpenCartMart

16. Časté otázky

Modul nie je v zozname rozšírení dopravy

Overte, či boli súbory nahraté do správneho koreňového adresára OpenCartu. Pri starších verziách OpenCartu skontrolujte nastavenia FTP a prípadne inštaláciu zopakujte.

Inštalátor v OpenCarte 2.x nefunguje

Overte prihlasovacie údaje FTP a cestu k adresáru obchodu. Alternatívou môže byť ručná inštalácia podľa postupu výrobcu.

Nezobrazuje sa popis alebo logo dopravy

Príčinou môže byť nekompatibilita šablóny alebo checkout modulu. Overte podporu týchto prvkov v konkrétnej pokladni.

Produkty majú hmotnosť v gramoch, obchod používa kilogramy

Produkty nie je potrebné hromadne prepisovať. Cenové pásma zadávajte v jednotke, ktorá je v OpenCarte nastavená ako predvolená pre obchod.

Kde získam vzorové CSV pre ceny a podvoľby?

Na karte Price Setting použite tlačidlo Export. Podobne možno získať vzor pre podvoľby.

17. Originálne zdroje a obrazová dokumentácia

Tento sprievodca je nezávisle spracovaný slovenský návod. Pôvodné snímky administračného rozhrania, ktoré nebolo možné bezpečne prevziať do samostatného súboru, nájdete priamo v dokumentácii výrobcu X-Shipping Pro. V dokumentácii sú ukážky inštalácie, vytvorenia metódy, podvolieb, nastavenia vzdialenosti a ladenia. Technické názvy polí sa môžu líšiť podľa verzie modulu.

Autor rozšírenia uvádza podporu na opencartmart@gmail.com.

Slovenský praktický sprievodca X-Shipping Pro.