Nastavenia administrácie

Prístup k nastaveniam

Všetky nastavenia pluginu sa nachádzajú v WP-Admin > Slovenská pošta. Prístup vyžaduje oprávnenie manage_woocommerce (rola Správca obchodu alebo Administrátor).

Karty nastavení

Panel nastavení je rozdelený do siedmich kariet:

Všetky nastavenia sa ukladajú v WordPress ako jediná serializovaná možnosť pod kľúčom wcsp_settings.

Kľúč uloženia nastavení

Všetky nastavenia sa ukladajú v jednej WordPress možnosti:

Option name: wcsp_settings

Jednotlivé nastavenia sa pristupujú ako kľúče poľa v rámci tejto možnosti, napríklad:

• wcsp_settings['replace_shipping_address']
• wcsp_settings['map_start_zoom']
• wcsp_settings['pickup_points_db_update_frequency']

Pri používaní filtrov alebo vlastného kódu na čítanie týchto nastavení použite get_option('wcsp_settings') a pristupujte k príslušnému kľúču.

Odberné miesta

Karta Odberné miesta

Prejdite na WP-Admin > Slovenská pošta > Pickup Points pre prístup k týmto nastaveniam.

---

Spracovanie adresy

Tieto nastavenia ovládajú, ako adresa vybraného odberného miesta interaguje s objednávkou WooCommerce.

Nahradiť doručovaciu adresu adresou odberného miesta

Kľúč: replace_shipping_address

Keď je zapnuté, doručovacia adresa objednávky sa po vytvorení objednávky automaticky nahradí adresou odberného miesta. Názov odberného miesta sa uloží ako názov prepravnej spoločnosti v objednávke.

Odporúča sa pre obchody, ktoré používajú doručovaciu adresu na tlač štítkov alebo odosielanie do fulfillment systému, pretože zaisťuje, že balík je adresovaný na odberné miesto, nie domov zákazníka.

Skryť polia doručovacej adresy pri pokladni

Kľúč: hide_shipping_address_fields Predvolené: Zapnuté

Keď je zapnuté, polia formulára doručovacej adresy sú skryté na stránke pokladne vždy, keď je vybraná metóda dopravy Slovenskej pošty. Zákazníci potrebujú iba vybrať odberné miesto — nemusia vypĺňať doručovaciu adresu.

Vypnutie tohto nastavenia zobrazí štandardný formulár doručovacej adresy aj pri výbere metódy vyzdvihnutia.

---

Nastavenia zobrazenia

Ovláda, kde sa informácie o odbernom mieste zobrazujú po vytvorení objednávky.

Zobraziť v e-mailoch objednávky

Kľúč: display_in_email Predvolené: Áno

Keď je zapnuté, súhrn odberného miesta (názov, adresa a otváracie hodiny) je zahrnutý v potvrdzovacom e-maile objednávky WooCommerce odoslanom zákazníkovi.

Zobraziť na stránke Ďakujeme

Kľúč: display_in_thank_you Predvolené: Áno

Keď je zapnuté, podrobnosti odberného miesta sa zobrazia na stránke potvrdenia objednávky (stránka Ďakujeme) ihneď po pokladni.

Zobraziť v Môj účet — Zobraziť objednávku

Kľúč: display_in_view_order Predvolené: Áno

Keď je zapnuté, podrobnosti odberného miesta sa zobrazia, keď prihlásený zákazník zobrazí svoju objednávku v Môj účet > Objednávky > Zobraziť objednávku.

---

Nastavenia hmotnosti

Tieto nastavenia ovplyvňujú výpočet hmotnosti košíka pri validácii hmotnostného limitu odberného miesta (určenie, či odberné miesto môže prijať balík). Neovplyvňujú výpočet nákladov na dopravu — pre to pozrite nastavenie Packing Material Weight na každej inštancii metódy dopravy.

Hmotnosť obalu

Kľúč: packaging_weight Jednotka: kg

Dodatočná hmotnosť pridaná k celkovej hmotnosti košíka nad rámec hmotností produktov. Použite pre zohľadnenie hmotnosti obalových materiálov (škatule, výplň atď.).

Zapnúť predvolenú hmotnosť pre produkty bez hmotnosti

Kľúč: enable_default_weight

Keď je zapnuté, produkty, ktoré nemajú definovanú hmotnosť vo WooCommerce, použijú hodnotu Predvolená hmotnosť uvedenú nižšie. Keď je vypnuté, produkty bez hmotnosti sa považujú za bez hmotnosti (0 kg).

Predvolená hmotnosť

Kľúč: default_weight Jednotka: kg

Náhradná hmotnosť používaná pre produkty bez nastavenej hmotnosti, keď je aktívna možnosť Zapnúť predvolenú hmotnosť.

Povoliť výber napriek upozorneniu na hmotnosť

Kľúč: bypass_weight_limit

Keď je zapnuté, zákazníci môžu stále vybrať odberné miesto aj keď hmotnosť košíka presahuje maximálnu prijateľnú hmotnosť daného odberného miesta. Zákazníkovi sa zobrazí upozornenie, ale výber nie je zablokovaný.

Keď je vypnuté (predvolene), odberné miesta, ktoré nemôžu prijať hmotnosť košíka, sú vizuálne sivé a nedajú sa vybrať.

---

Nastavenia rozmerov

Tieto nastavenia poskytujú náhradné rozmery pre produkty, ktoré nemajú nastavené rozmery vo WooCommerce, používané pre validáciu balíka.

Zapnúť predvolené rozmery pre produkty bez rozmerov

Kľúč: enable_default_dimensions

Keď je zapnuté, produkty bez rozmerov použijú predvolené hodnoty uvedené nižšie pre validáciu veľkosti balíka.

Predvolená dĺžka / šírka / výška

Kľúče: default_length, default_width, default_height Jednotka: cm

Náhradné rozmery aplikované na produkty bez nastavených rozmerov, keď je aktívna možnosť Zapnúť predvolené rozmery.

---

Nastavenia rozmerov BalikoBOX

Tieto nastavenia definujú maximálne rozmery balíka akceptované boxmi BalikoBOX.

Maximálne rozmery BalikoBOX

Kľúče: bbox_max_length, bbox_max_width, bbox_max_height Predvolené: 50 cm × 60 cm × 45 cm

Tieto hodnoty definujú maximálnu veľkosť balíka, ktorá sa zmestí do boxu BalikoBOX. Ak košík obsahuje produkty, ktorých kombinované rozmery presahujú tieto hodnoty a je zapnutá kontrola balenia, zobrazí sa upozornenie na veľkosť.

Povoliť výber napriek upozorneniu na veľkosť BalikoBOX

Kľúč: bypass_size_validation_bbox

Keď je zapnuté, zákazníci môžu vybrať odberné miesto BalikoBOX aj keď veľkosť balíka presahuje maximálne rozmery. Zobrazí sa upozornenie, ale výber nie je zablokovaný.

Zapnúť kontrolu balenia pre BalikoBOX

Kľúč: enable_box_packing_bbox Predvolené: Áno

Keď je zapnuté, plugin spustí algoritmus bin-packing pre kontrolu, či sa všetky položky košíka fyzicky zmestia spolu do rozmerov BalikoBOX. Ak nie, zobrazí sa upozornenie.

Keď je vypnuté, kontrolujú sa iba rozmery jednotlivých produktov voči maximu — nie to, či sa všetky položky dohromady zmestia.

---

Nastavenia rozmerov Balík na poštu

Povoliť výber napriek upozorneniu na veľkosť Balíka na poštu

Kľúč: bypass_size_validation_bnp

Rovnaké správanie ako ekvivalent pre BalikoBOX — ovláda, či zákazníci môžu pokračovať napriek upozorneniu na veľkosť.

Zapnúť kontrolu balenia pre Balík na poštu

Kľúč: enable_box_packing_bnp Predvolené: Áno

Keď je zapnuté, kontrola bin-packing sa aplikuje na konfigurovateľné rozmery škatule Balíka na poštu uvedené nižšie.

Rozmery škatule Balík na poštu

Kľúče: bnp_box_length, bnp_box_width, bnp_box_height Predvolené: 100 cm × 50 cm × 50 cm

Rozmery prepravnej škatule používané pri kontrole balenia Balíka na poštu. Tieto by mali predstavovať najväčšiu škatuľu, ktorú váš obchod používa pre zásielky Balíka na poštu.

Poznámka: Toto sú rozmery škatule vášho obchodu, nie limity Slovenskej pošty. Tvrdé limity rozmerov Slovenskej pošty pre Balík na poštu (min. strana 14×9 cm, max. jedna strana 150 cm, max. obvod 300 cm) sa vynucujú samostatne a nedajú sa vypnúť.

---

Správanie objednávok

Automatické dokončenie objednávok

Kľúč: auto_complete_orders

Keď je zapnuté, objednávky WooCommerce vytvorené s metódou dopravy Slovenskej pošty sa automaticky nastavia na stav Dokončená po platbe. Je to užitočné pre obchody, ktoré nevyžadujú manuálne spracovanie objednávok.

Skryť platbu na dobierku pri výbere metódy vyzdvihnutia

Kľúč: hide_cod_for_pickup

Keď je zapnuté, platobná metóda Dobierka vo WooCommerce je skrytá z možností platby pri pokladni vždy, keď je vybraná metóda dopravy Slovenskej pošty. Použite toto nastavenie, ak neponúkate dobierku pre zásielky na odberné miesta.

Nastavenia mapy

Karta Nastavenia mapy

Prejdite na WP-Admin > Slovenská pošta > Map Settings pre prístup k týmto nastaveniam.

Tieto nastavenia ovládajú vzhľad a správanie mapy OpenLayers v dialógu Výber odberného miesta zobrazenom zákazníkom pri pokladni.

---

Predvolené zobrazenie mapy

Počiatočná úroveň priblíženia

Kľúč: map_start_zoom Predvolené: 7 Rozsah: 1 (pohľad na svet) — 19 (úroveň ulice)

Úroveň priblíženia pri prvom otvorení dialógu výberu odberného miesta, pred akýmkoľvek vyhľadávaním alebo geolokáciou. Predvolená hodnota 7 zobrazuje väčšinu Slovenska v mape.

Počiatočná zemepisná šírka

Kľúč: map_start_lat Predvolené: 48.6690

Súradnica zemepisnej šírky pre stred mapy pri počiatočnom načítaní.

Počiatočná zemepisná dĺžka

Kľúč: map_start_lng Predvolené: 19.6990

Súradnica zemepisnej dĺžky pre stred mapy pri počiatočnom načítaní.

Tip: Predvolené súradnice (48,669°N, 19,699°E) predstavujú približný geografický stred Slovenska. Ak je vaša zákaznícka základňa sústredená v konkrétnom regióne, upravte tieto hodnoty tak, aby mapa centrovala na daný región.

---

Správanie pri výbere

Úroveň priblíženia pri výbere odberného miesta

Kľúč: map_selection_zoom Predvolené: 14

Keď zákazník vyberie odberné miesto zo zoznamu výsledkov, mapa sa animáciou vycentruje na daný bod. Toto nastavenie určuje, ako ďaleko sa mapa priblíži. Úroveň 14 zobrazuje detail na úrovni ulice.

Rýchlosť animácie

Kľúč: map_animation_speed Predvolené: 500 Jednotka: milisekundy

Trvanie animácie posunu a priblíženia pri pohybe mapy na vybrané odberné miesto. Nastavte na 0 pre úplné vypnutie animácie.

Vypnúť animáciu priblíženia

Kľúč: map_disable_zoom_animation Predvolené: Nie

Keď je zapnuté, výber odberného miesta okamžite skočí na dané miesto na mape namiesto plynulej animácie priblíženia/posunu. Toto nastavenie prepíše nastavenie Rýchlosť animácie — mapa sa presunie na vybrané miesto bez prechodu.

---

Geolokácia

Automaticky požiadať o geolokáciu pri otvorení dialógu

Kľúč: auto_geolocation Predvolené: Áno

Keď je zapnuté, dialóg výberu odberného miesta automaticky požiada o polohu zákazníka v prehliadači (cez Geolocation API) hneď po otvorení dialógu. Ak zákazník udelí povolenie, mapa sa vycentruje na jeho polohu a v zozname výsledkov sa zobrazia najbližšie odberné miesta.

Keď je vypnuté, zákazníci musia kliknúť na tlačidlo „Moja poloha" pre použitie geolokácie.

Správanie prehliadača: Prehliadač vyzve zákazníka na udelenie povolenia polohy pri prvom použití. Ak zákazník povolenie predtým odmietol, automatická požiadavka zlyhá bez oznámenia a mapa zobrazí predvolenú polohu.

---

Vlastné ikony mapy

Predvolené ikony špendlíkov mapy môžete nahradiť vlastnými obrázkami. Každý typ ikony má tri nastavenia: URL obrázka a kotviaci bod (x a y, vyjadrené ako desatinné čísla od 0 do 1), ktorý určuje, ktorá časť obrázka sa umiestni na súradnicu mapy.

Kotviaci bod 0.5, 1.0 umiestni spodný stred obrázka na bod mapy — vhodné pre štandardný tvar špendlíka mapy.

Ikona zhluku

Kľúče: map_icon_cluster, map_icon_cluster_anchor_x, map_icon_cluster_anchor_y

Ikona zobrazená keď je viac odberných miest zoskupených do zhluku (zobrazuje sa pri oddialení mapy).

Ikona bežného odberného miesta

Kľúče: map_icon_regular, map_icon_regular_anchor_x, map_icon_regular_anchor_y

Predvolený špendlík mapy zobrazený pre jednotlivé, nevybrané odberné miesta.

Ikona vybraného odberného miesta

Kľúče: map_icon_selected, map_icon_selected_anchor_x, map_icon_selected_anchor_y

Špendlík mapy zobrazený pre momentálne vybrané odberné miesto.

Formát obrázka: Najlepšie fungujú obrázky PNG alebo SVG. Obrázky by mali byť hostované na vašej vlastnej doméne alebo spoľahlivej CDN. Súradnice kotviaceho bodu sú desatinné hodnoty medzi 0 a 1 (napr. 0.5 = 50 % od ľavého/horného okraja).

Databáza odberných miest

Karta Pickup Points DB

Prejdite na WP-Admin > Slovenská pošta > Pickup Points DB pre prístup k týmto nastaveniam.

Táto karta poskytuje nástroje na naplnenie a obnovenie lokálnej databázy odberných miest Slovenskej pošty. Plugin ukladá všetky dáta odberných miest lokálne — počas pokladne sa nevykonávajú žiadne živé volania API. Na tejto karte udržiavate tieto dáta aktuálne.

Poznámka: Pošta Widget nepoužíva lokálnu databázu odberných miest. Tieto nastavenia ovplyvňujú iba režim vstavanej mapy, ktorý sa používa, keď je Use Pošta Widget vypnuté.

---

Stav databázy

V hornej časti karty sa zobrazujú aktuálne štatistiky:

• Balík na poštu odberné miesta: Celkový počet miest BNP v databáze.
• BalikoBOX miesta: Celkový počet miest s boxmi BalikoBOX.
• Posledná aktualizácia: Časová pečiatka poslednej úspešnej aktualizácie databázy.

---

Manuálna aktualizácia

Kliknite na Update Now pre okamžité stiahnutie a import najnovších dát odberných miest z XML feedu Slovenskej pošty.

Poznámka: Aktualizácia tejto databázy nemení dáta používané v Pošta Widgete. Widget načítava odberné miesta priamo zo serverov Slovenskej pošty.

Proces aktualizácie:

1. Stiahne XML súbor z nakonfigurovanej URL (predvolene: https://www.posta.sk/public/forms/zoznam_post.xml).
2. Spracuje XML a validuje záznamy.
3. Bezpečnostná kontrola: Ak sa nájde menej ako 100 platných záznamov, aktualizácia sa preruší, aby sa zabránilo náhodnému nahradeniu databázy neúplnými dátami.
4. Vymaže a nahradí existujúce dáta odberných miest.
5. Aktualizuje časovú pečiatku „poslednej aktualizácie".

Proces prebieha cez AJAX na pozadí — stránka zobrazuje indikátor priebehu a po dokončení zobrazí správu o úspechu alebo chybe.

---

Automatické aktualizácie

Zapnúť automatické aktualizácie

Kľúč: auto_update_enabled

Keď je zapnuté, plugin používa WP-Cron na automatickú aktualizáciu databázy odberných miest podľa plánu, bez potreby manuálneho zásahu.

Poznámka: Automatické aktualizácie databázy sa týkajú iba režimu vstavanej mapy. Pošta Widget ich nepoužíva.

Frekvencia aktualizácií

Kľúč: auto_update_frequency Predvolené: weekly

Ako často sa spúšťa automatická aktualizácia. Dostupné možnosti:

Odporúčanie: Týždenné aktualizácie sú pre väčšinu obchodov dostatočné. Slovenská pošta nemení dáta odberných miest často a denné aktualizácie sú väčšinou zbytočné.

Závislosť od WP-Cron: Automatické aktualizácie sa spoliehajú na WP-Cron, ktorý sa spúšťa návštevnosťou stránky. Na stránkach s nízkou návštevnosťou sa naplánované udalosti nemusia spustiť presne v naplánovanom čase. Pre garantované spúšťanie na stránkach s nízkou návštevnosťou zvážte použitie skutočného cron jobu na spúšťanie wp-cron.php.

---

Vlastná URL XML feedu

Predvolene sa dáta odberných miest sťahujú z:

https://www.posta.sk/public/forms/zoznam_post.xml

Ak chcete použiť inú URL (napr. lokálne zrkadlo alebo vlastný feed), definujte nasledujúcu konštantu vo svojom wp-config.php:

define( 'WCSP_PICKUP_POINTS_XML_URL', 'https://your-custom-url.com/feed.xml' );

Sledovanie zásielok

Karta Sledovanie zásielok

Prejdite na WP-Admin > Slovenská pošta > Tracking pre prístup k týmto nastaveniam.

Funkcia sledovania umožňuje pripojiť sledovacie číslo Slovenskej pošty ku každej objednávke a zobrazovať stav zásielky zákazníkom v administrácii, e-mailoch a na stránkach objednávok.

Nie je potrebný API kľúč. Plugin generuje priamy odkaz na verejnú stránku sledovania Slovenskej pošty pre každú objednávku. Synchronizácia udalostí na pozadí tiež používa verejný API endpoint — nie sú potrebné žiadne prihlasovacie údaje.

---

Nastavenia zobrazenia

Zapnúť sledovanie

Kľúč: tracking_enabled Predvolené: Áno

Hlavný prepínač pre celú funkciu sledovania. Keď je vypnuté, žiadne informácie o sledovaní sa nikde nezobrazujú a synchronizácia na pozadí sa nespúšťa.

Zobraziť v e-mailoch objednávky

Kľúč: tracking_in_email Predvolené: Áno

Keď je zapnuté, sekcia sledovania sa pridá k transakčným e-mailom pre zákazníkov (objednávky v stave spracováva sa, dokončená a pozastavená). Sekcia obsahuje sledovacie číslo ako klikateľný odkaz a odkaz „Sledujte svoju zásielku na Slovenskej pošte".

Pozrite si E-maily objednávok pre podrobnosti o výstupe e-mailu.

Zobraziť na stránke Ďakujeme

Kľúč: tracking_in_thank_you Predvolené: Áno

Keď je zapnuté, 5-krokový ukazovateľ priebehu a časová os udalostí sa zobrazí pod tabuľkou objednávky na stránke potvrdenia objednávky (stránka Ďakujeme) — ale iba po nastavení sledovacieho čísla na objednávku.

Zobraziť v Môj účet

Kľúč: tracking_in_my_account Predvolené: Áno

Keď je zapnuté, riadok Sledovacie číslo sa pridá do tabuľky súhrnov objednávky na stránke Môj účet → Zobraziť objednávku. Sledovacie číslo sa zobrazí ako klikateľný odkaz.

Zobraziť stĺpec sledovania v zozname objednávok administrácie

Kľúč: tracking_list_column Predvolené: Áno

Keď je zapnuté, stĺpec Tracking sa pridá do zoznamu objednávok WP-Admin, zobrazený za stĺpcom Celková suma objednávky. Stĺpec zobrazuje sledovacie číslo ako farebne kódovaný stavový odznak s odkazom na verejnú stránku sledovania spolu s ikonou pre otvorenie modálneho okna s detailmi sledovania.

---

Nastavenia synchronizácie na pozadí

Synchronizácia na pozadí udržiava uložené sledovacie udalosti automaticky aktuálne. Udalosti sa sťahujú z verejného API Slovenskej pošty a ukladajú na objednávku, takže stránky sa načítajú bez živého volania API pri každom zobrazení stránky.

Interval synchronizácie (hodiny)

Kľúč: tracking_sync_interval Predvolené: 2 Rozsah: 1–24

Minimálny počet hodín medzi pokusmi o synchronizáciu na pozadí pre tú istú objednávku. Objednávka, ktorá bola synchronizovaná v tomto intervale, bude pri nasledujúcom spustení cron preskočená.

Okno synchronizácie (dni)

Kľúč: tracking_sync_days Predvolené: 30 Rozsah: 1–90

Do synchronizácie na pozadí sa zahŕňajú iba objednávky vytvorené v rámci tohto počtu dní. Staršie objednávky sa preskakujú.

---

Ako funguje synchronizácia na pozadí

WP-Cron job sa spúšťa každé dve hodiny a spracúva všetky oprávnené objednávky — objednávky so sledovacím číslom, vytvorené v rámci okna synchronizácie a ešte neoznačené ako konečné.

Ochrana nočných hodín: Synchronizácia sa preskakuje, ak je aktuálny čas servera medzi 22:00 a 05:00, aby sa predišlo zbytočným volaniam API mimo pracovného času.

Konečný stav: Keď objednávka dosiahne stav delivered alebo returned, je označená ako konečná (_wcsp_tracking_final = 1) a vylúčená zo všetkých budúcich synchronizácií.

Manuálne obnovenie: Na stránke úpravy objednávky v administrácii má metabox Slovenská pošta – Tracking tlačidlo Refresh, ktoré vynutí okamžitú synchronizáciu pre danú objednávku bez ohľadu na interval synchronizácie alebo ochranu nočných hodín.

Licencia

Karta Licencia

Prejdite na WP-Admin > Slovenská pošta > Licencia pre správu licencie pluginu.

Úplné podrobnosti o fungovaní licencovania vrátane ochrannej lehoty a správania pri validácii nájdete v Aktivácia licencie.

---

Pole licenčného kľúča

Zadajte svoj licenčný kľúč do tohto poľa a kliknite na Activate License pre aktiváciu pluginu na vašej doméne.

Stav licencie

Táto sekcia zobrazuje aktuálny stav licencie:

• Status: Aktívna, Neaktívna, Vypršaná, Zrušená alebo Ochranná lehota.
• Domain: Doména, na ktorej je licencia momentálne aktivovaná.
• Expiration: Dátum vypršania licencie (ak sa vzťahuje).
• Last Validated: Časová pečiatka poslednej kontroly licencie.

Aktivácia a deaktivácia

• Aktivácia: Zadajte licenčný kľúč a kliknite na Activate License. Plugin sa spojí s licenčným serverom na webdevelop.hu pre overenie kľúča.
• Deaktivácia: Kliknite na Deactivate License pre uvoľnenie licencie z tejto domény. Urobte to pred migrovaním stránky na novú doménu.

Pozrite si Aktivácia licencie pre kompletný postup a vysvetlenie správania pri validácii.