Nový PPL widget 2.0 pro e-shopy: co přináší přechod a na co si dát při implementaci pozor

Společnost PPL v roce 2026 představila novou generaci mapového widgetu pro výběr výdejních míst. Provozovatelé e-shopů využívající PPL ParcelShopy, PPL ParcelBoxy nebo další podporovaná výdejní místa tak musí počítat se změnou způsobu integrace mapy do nákupního košíku.

Nejde přitom pouze o kosmetickou změnu vzhledu. PPL Widget 2.0 používá odlišný způsob integrace a komunikace s e-shopem, a zejména u individuálně vytvořených e-shopů proto nemusí být přechod pouhou výměnou adresy JavaScriptového souboru.

Proč PPL přešlo na nový widget?

Původní mapový widget PPL byl založen na starší architektuře, která mohla v některých případech kolidovat s CSS nebo JavaScriptem samotného e-shopu.

Nový PPL Widget 2.0 používá modernější řešení založené mimo jiné na Web Components a Shadow DOM. Díky tomu je samotná komponenta lépe oddělena od zbytku stránky a styly e-shopu by neměly tak snadno ovlivňovat vzhled mapy.

Mezi hlavní změny patří:

• nový způsob načítání widgetu,
• použití vlastního HTML elementu,
• autentizace pomocí API klíče,
• izolace komponenty pomocí Shadow DOM,
• nový způsob předávání informací o vybraném výdejním místě,
• podpora modálního i inline zobrazení,
• události pro výběr, zavření, chybu nebo inicializaci widgetu.

Pro zákazníka zůstává princip podobný – v košíku otevře mapu a vybere požadované výdejní místo. Pro vývojáře e-shopu se však způsob implementace poměrně výrazně změnil.

Přechod ze starého PPL widgetu není vždy pouze výměna skriptu

U jednoduché implementace může být nasazení nového widgetu poměrně snadné. Situace je ale jiná u e-shopů, které mají vlastní nákupní proces nebo původní PPL widget nějakým způsobem upravený.

Typickým příkladem jsou e-shopy, kde výběr výdejního místa ovlivňuje další části objednávky.

Po výběru ParcelShopu nebo ParcelBoxu může být například potřeba:

• uložit ID výdejního místa k objednávce,
• uložit jeho název a adresu,
• zachovat výběr při přechodu mezi jednotlivými kroky košíku,
• zobrazit vybrané místo zákazníkovi,
• předat údaje do administrační části e-shopu,
• následně data použít při vytvoření zásilky u dopravce.

Právě zde už je potřeba upravit logiku konkrétního e-shopu.

Nový způsob získání vybraného PPL výdejního místa

Nový widget komunikuje s e-shopem prostřednictvím JavaScriptových událostí.

Po výběru výdejního místa je vyvolána událost ppl-accesspointwidget-select, ze které může e-shop získat informace o vybraném místě.

K dispozici jsou také další události, například pro zavření widgetu, jeho inicializaci nebo vznik chyby.

To znamená, že původní JavaScript napojený na starší verzi mapy nemusí být s novým widgetem kompatibilní a je nutné upravit zpracování výsledku výběru.

Pozor na Content Security Policy (CSP)

U e-shopů s přísnějším bezpečnostním nastavením může po nasazení nového widgetu nastat další problém – Content Security Policy.

Pokud server omezuje zdroje, ze kterých může prohlížeč načítat JavaScript, obrázky, API komunikaci nebo další obsah, může být nový widget bezpečnostní politikou částečně nebo úplně zablokován.

Výsledkem může být například situace, kdy:

• se widget vůbec neotevře,
• otevře se jeho okno, ale nezobrazí se mapa,
• nejsou načtena některá data,
• prohlížeč vypisuje chyby CSP do konzole.

Při implementaci je proto vhodné zkontrolovat nejen samotný JavaScript e-shopu, ale také HTTP hlavičku Content-Security-Policy a případná další bezpečnostní omezení serveru.

Problémy mohou způsobovat také starší JavaScriptové komponenty

V praxi je důležité testovat nový widget společně se všemi ostatními komponentami nákupního košíku.

E-shop může například současně používat:

• widget PPL,
• mapu Zásilkovny,
• vlastní modální okna,
• našeptávač adres,
• cookie lištu,
• různé JavaScriptové knihovny,
• případně Service Worker.

Každá z těchto komponent může zasahovat do chování stránky.

Proto doporučujeme po implementaci otestovat nejen samotné otevření mapy, ale celý proces vytvoření objednávky.

Mobilní zařízení jsou při testování zásadní

Funkční widget na desktopu ještě automaticky neznamená, že bude celý nákupní proces správně fungovat také na mobilním telefonu.

Zvláštní pozornost je vhodné věnovat:

• otevření mapy,
• scrollování mapy,
• výběru výdejního místa,
• zavření mapy bez výběru,
• návratu zpět do košíku,
• možnosti pokračovat v objednávce,
• zachování již vybraného výdejního místa.

Doporučujeme testování provést nejen pomocí responzivního režimu prohlížeče na počítači, ale také na reálných telefonech s Androidem a iOS.

Chování mobilního prohlížeče se totiž může od desktopového prostředí lišit.

Zachování výdejního místa mezi kroky objednávky

U vícekrokových nákupních košíků je potřeba vyřešit také ukládání výběru.

Typický scénář může vypadat následovně:

1. zákazník vybere dopravu PPL,
2. otevře mapu,
3. zvolí ParcelShop nebo ParcelBox,
4. pokračuje do dalšího kroku objednávky,
5. vrátí se zpět k výběru dopravy.

E-shop by měl i po návratu vědět, které výdejní místo zákazník zvolil.

Nestačí proto vždy držet informaci pouze v JavaScriptu aktuálně otevřené stránky. Podle konstrukce e-shopu může být vhodné údaje ukládat například do session a následně je použít při vytvoření objednávky.

Jak by měl probíhat bezpečný přechod na PPL Widget 2.0?

Při migraci doporučujeme postupovat systematicky.

Nejprve je potřeba zjistit, jak je původní PPL mapa v e-shopu implementována a kde se ukládají údaje o vybraném výdejním místě. Následně lze nasadit nový widget, upravit JavaScriptovou komunikaci a případně serverovou část aplikace.

Poté by mělo následovat kompletní otestování nákupního procesu.

Nestačí ověřit pouze to, že se mapa zobrazí.

Je potřeba zkontrolovat celý řetězec:

košík → výběr dopravy → otevření PPL mapy → výběr výdejního místa → uložení výběru → dokončení objednávky → správné údaje v administraci e-shopu.

PPL Widget 2.0 a individuální e-shopy

U běžných krabicových e-shopových systémů může být aktualizace součástí modulu nebo pluginu dodavatele platformy.

U e-shopů vytvořených na míru je ale často potřeba integraci upravit individuálně.

Výhodou je, že nový widget lze lépe napojit přímo na logiku konkrétního nákupního košíku a zachovat způsob práce, na který jsou zákazníci e-shopu zvyklí.

Potřebujete nový PPL widget implementovat do e-shopu?

V ELINE se zabýváme vývojem a správou e-shopů na míru včetně integrací dopravců a jejich výdejních míst.

Přechod na nový PPL Widget 2.0 jsme řešili přímo v reálných e-shopech, včetně úprav nákupního košíku, ukládání výdejního místa, kompatibility s dalšími dopravci a řešení problémů při zobrazení na mobilních zařízeních.

Pokud váš e-shop stále používá původní PPL widget, nový widget se nezobrazuje správně nebo po jeho nasazení nefunguje výběr výdejního místa či nákupní košík, můžeme prověřit stávající implementaci a navrhnout potřebné úpravy.

ELINE – tvorba, vývoj a dlouhodobá správa e-shopů na míru.