Začíname

Inštalácia

Systémové požiadavky

Pred inštaláciou pluginu sa uistite, že vaše prostredie spĺňa nasledujúce požiadavky:

• PHP 8.1 alebo novšie — plugin je testovaný a kompatibilný s PHP 8.1, 8.2 a 8.3.
• WordPress 6.4 alebo novší — kompatibilný s WordPress 6.4 a všetkými novšími verziami.
• WooCommerce 8.0 alebo novší — plugin vyžaduje nainštalované a aktívne WooCommerce.
• MySQL 5.7+ alebo MariaDB 10.3+ — potrebné pre vlastné databázové tabuľky odberných miest.

Počas behu sa nevykonávajú žiadne externé API volania pre údaje odberných miest — všetky vyhľadávania prebiehajú lokálne voči vašej WordPress databáze.

Poznámka: Toto platí pre režim vstavanej mapy. Pošta Widget načítava odberné miesta zo serverov Slovenskej pošty a lokálnu databázu odberných miest nepoužíva.

Spôsoby inštalácie

Nahratie cez WP-Admin

1. Stiahnite archív woocommerce-slovenska-posta.zip.
2. V administrácii WordPress prejdite na Pluginy > Pridať nový.
3. Kliknite na Nahrať plugin v hornej časti stránky.
4. Vyberte .zip súbor a kliknite na Inštalovať.
5. Po nahraní kliknite na Aktivovať plugin.

Manuálne nahratie cez FTP / SFTP

1. Rozbaľte .zip archív na svojom počítači.
2. Pripojte sa na server pomocou FTP alebo SFTP klienta.
3. Nahrajte rozbalený priečinok woocommerce-slovenska-posta do wp-content/plugins/.
4. V administrácii WordPress prejdite na Pluginy, nájdite plugin v zozname a kliknite na Aktivovať.

Čo sa stane pri aktivácii

Pri prvej aktivácii plugin automaticky vykoná nasledujúce kroky:

• Databázové tabuľky — vytvorí tri vlastné databázové tabuľky na ukladanie odberných miest, kódov služieb (BNP/BBOX) a vzťahu many-to-many medzi nimi.
• Počiatočný import — importuje pribalený súbor feed/zoznam_post.xml, čím okamžite naplní databázu. Tento krok nevyžaduje pripojenie na internet.
• Plán Cron — zaregistruje WP-Cron udalosť pre automatické periodické aktualizácie databázy odberných miest.
• Presmerovanie na licenciu — presmeruje vás na kartu Nastavenia > Licencia, ak nie je zadaný licenčný kľúč. Podrobnosti nájdete v Aktivácia licencie.

Poznámka: Importovaná databáza aj plánované aktualizácie sa používajú iba pre režim vstavanej mapy. Pošta Widget nimi nie je ovplyvnený.

Deaktivácia

Pri deaktivácii pluginu nastane nasledovné:

• Tri vlastné databázové tabuľky sa odstránia a všetky údaje odberných miest sa vymažú.
• WP-Cron plány (automatická aktualizácia a overenie licencie) sa zrušia.
• Nastavenia pluginu a licenčné údaje zostanú v wp_options.
• Inštancie spôsobov dopravy zostanú v doručovacích zónach WooCommerce.

Upozornenie: Deaktivácia pluginu trvalo vymaže všetky údaje odberných miest. Po opätovnej aktivácii sa pribalený XML automaticky znovu importuje a môžete potom spustiť čerstvú aktualizáciu na karte Databáza odberných miest v nastaveniach.

Aktivácia licencie

Plugin vyžaduje aktívny licenčný kľúč na fungovanie. Bez platnej licencie sú spôsoby dopravy skryté pri pokladni a zákazníkom sa neposkytujú údaje o odberných miestach. Administrátorské nastavenia zostávajú dostupné, aby ste mohli spravovať nastavenia a riešiť problémy aj pri neaktívnej licencii.

Aktivácia licencie

1. Prejdite na WP-Admin > Slovenská Pošta > Licencia.
2. Zadajte licenčný kľúč do poľa License Key.
3. Kliknite na Activate License.
4. Plugin kontaktuje licenčný server na webdevelop.hu a overí kľúč voči vašej doméne.
5. Po úspešnom overení sa stav licencie zmení na Active a zobrazí sa potvrdzujúce hlásenie.

Tip: Váš licenčný kľúč nájdete v potvrdzovacom e-maile o nákupe alebo vo vašom zákazníckom účte na webdevelop.hu.

Deaktivácia licencie

Ak chcete preniesť licenciu na inú doménu:

1. Prejdite na WP-Admin > Slovenská Pošta > Licencia.
2. Kliknite na Deactivate License.
3. Plugin odošle požiadavku na deaktiváciu licenčnému serveru, čím uvoľní licenciu na použitie na inej doméne.

Dôležité: Pred migráciou stránky na novú doménu vždy deaktivujte licenciu. Ak nemôžete deaktivovať (napr. stránka nie je dostupná), kontaktujte podporu na webdevelop.hu.

Ako funguje validácia licencie

Licencia sa overuje voči licenčnému serveru pri každej kontrole, pričom výsledky sa ukladajú do cache na 24 hodín vo WordPress transiente. To znamená, že plugin nekontaktuje server pri každom načítaní stránky.

Ochranné obdobie: Ak je licenčný server dočasne nedostupný (chyby siete, výpadok servera), plugin vstúpi do 7-dňového ochranného obdobia a naďalej funguje normálne. Tým sa predchádza výpadkom v dôsledku dočasných problémov s pripojením.

Explicitné zamietnutia: Ak licenčný server odpovie explicitným zamietnutím — napríklad expirovanou alebo odvolanou licenciou — plugin okamžite vypne spôsoby dopravy. Ochranné obdobie sa na explicitné zamietnutia nevzťahuje.

Výsledky validácie:

Dôsledky neplatnej licencie

Keď licencia nie je aktívna:

• Oba spôsoby dopravy (wcsp_bnp a wcsp_bbox) sa odstránia z dostupných sadzieb WooCommerce pri pokladni.
• Výber odberného miesta sa pri pokladni nezobrazí.
• Všetky administrátorské nastavenia zostávajú dostupné, aby ste mohli aktualizovať licenčný kľúč a znovu aktivovať.

Prvé kroky

Kontrolný zoznam prvotného nastavenia

Po inštalácii pluginu a aktivácii licencie postupujte podľa týchto krokov.

---

1. Aktualizujte databázu odberných miest

Plugin sa dodáva s preddefinovaným snímkom databázy odberných miest Slovenskej Pošty, takže výber funguje hneď po inštalácii bez manuálneho importu. Pribalené údaje však môžu byť v čase inštalácie zastarané, preto sa odporúča okamžitá aktualizácia, aby zákazníci videli aktuálny zoznam miest.

Poznámka: Táto aktualizácia je potrebná iba pre režim vstavanej mapy. Ak používate Pošta Widget, odberné miesta sa načítavajú priamo zo serverov Slovenskej pošty namiesto lokálnej databázy.

1. Prejdite na WP-Admin > Slovenská Pošta > Pickup Points DB.
2. Kliknite na Update Now a stiahnite najnovšie údaje odberných miest od Slovenskej Pošty.
3. Počkajte na dokončenie aktualizácie. Stránka zobrazí celkový počet importovaných odberných miest pre každú službu (BNP a BBOX).

Prečo je to dôležité: Plugin ukladá údaje odberných miest lokálne pre rýchle vyhľadávanie na strane servera. Pribalený snímok zaručuje funkčnú inštaláciu od prvého dňa, ale čerstvá aktualizácia zabezpečí, že otváracie hodiny, adresy a nové miesta sú aktuálne.

Podrobnosti o plánovaní automatických aktualizácií nájdete v Aktualizácia odberných miest.

---

2. Pridajte spôsoby dopravy do doručovacích zón

1. Prejdite na WP-Admin > WooCommerce > Nastavenia > Doprava.
2. Vytvorte novú doručovaciu zónu (napr. „Slovensko") alebo upravte existujúcu.
3. Kliknite na Pridať spôsob dopravy.
4. Zo zoznamu vyberte Balík na Poštu alebo BalikoBOX (alebo oboje).
5. Kliknite na Pridať spôsob dopravy pre potvrdenie.
6. Kliknite na názov metódy pre otvorenie nastavení a nakonfigurujte názov a cenu. Podrobnosti nájdete v Balík na Poštu a BalikoBOX.

---

3. Nakonfigurujte všeobecné nastavenia

Prejdite na WP-Admin > Slovenská Pošta a skontrolujte kľúčové nastavenia:

Karta Odberné miesta:

• Nastavte predvolenú hmotnosť produktu a predvolené rozmery produktu, ak váš obchod obsahuje produkty bez týchto hodnôt. Tým zabezpečíte, že plugin dokáže správne vypočítať hmotnostné limity a overiť rozmery.
• Rozhodnite, či chcete nahradiť doručovaciu adresu adresou odberného miesta v objednávkach. Pre väčšinu obchodov sa to odporúča.
• Rozhodnite, či chcete skryť polia doručovacej adresy pri pokladni, keď je vybraná metóda odberného miesta.

Karta Nastavenia mapy:

• Overte predvolené súradnice stredu mapy. Predvolené hodnoty sú nastavené na geografický stred Slovenska (48,669°N, 19,699°E). V prípade potreby upravte.
• Zapnite Automatickú geolokáciu, aby sa pri otvorení dialógu výberu automaticky požiadalo o polohu zákazníka v prehliadači, pre lepší používateľský zážitok.

---

4. Nastavte automatické aktualizácie databázy

Aby boli údaje odberných miest aktuálne bez manuálneho zásahu:

Poznámka: Automatické aktualizácie databázy sú dôležité iba pri použití vstavanej mapy. Pošta Widget nečíta z lokálnej databázy odberných miest.

1. Prejdite na WP-Admin > Slovenská Pošta > Pickup Points DB.
2. Zapnite Automatické aktualizácie.
3. Vyberte frekvenciu aktualizácií (denne, dvakrát denne, týždenne, dvakrát mesačne alebo mesačne).
4. Uložte nastavenia.

Pre väčšinu obchodov sa odporúča týždenná frekvencia. Viac podrobností nájdete v Aktualizácia odberných miest.

---

5. Otestujte priebeh pokladne

1. Pridajte produkt do košíka a prejdite na pokladňu.
2. Vyberte spôsob dopravy Slovenskej Pošty (Balík na Poštu alebo BalikoBOX).
3. Overte, že sa pod spôsobom dopravy zobrazí tlačidlo „Vyberte odberné miesto".
4. Kliknutím na tlačidlo otvorte dialóg výberu odberného miesta.
5. Otestujte funkciu vyhľadávania a mapy.
6. Vyberte odberné miesto a potvrďte.
7. Dokončite objednávku a overte, že odberné miesto sa zobrazí v potvrdzujúcom e-maile objednávky a v detaile objednávky vo WP-Admin.

---

Rýchla orientácia: kde čo nájsť