Widget 2.0
    • PPL Access Point Widget — Implementation Guide for E-shops
    • 1. Quick Start — Integration in 5 Minutes
    • 2. Embedding the Widget into a Page
    • 3. Static HTML Integration
    • 4. Integration: Vanilla JavaScript
    • 5. Integration: PHP
    • 6. Integration: React
    • 7. Complete API Reference
    • 8. Advanced Scenarios
    • 9. Communication Channels Overview
    Switch to czech

    3. Static HTML Integration

    The simplest form of integration — the widget is configured directly via HTML attributes without JavaScript.

    3.1 Inline Mode with Package Parameters#

    Package parameters and codRequired come from cart data — they are not part of the admin configuration, so they are passed via config:

    3.2 Modal Mode with a Button#

    Modal is the widget's default mode. If the admin hasn't switched it to inline, just provide api-key and the widget will automatically behave as a modal. In the example, viewMode: "modal" is specified explicitly so the integration works regardless of the current admin setting:

    3.3 Pre-selecting an Access Point#

    If you know the KM code of an access point (e.g. from a customer's previous order), you can pre-select it:
    The accessPointCode parameter accepts a KM code in the format KM + 7 digits (e.g. KM1234567). The KM code is the stable identifier for an access point in the PPL system and is returned in the ppl-accesspointwidget-select event as e.detail.code.

    3.4 Centering the Map on an Address#

    The map can be automatically centered on the customer's specific address:
    Or using GPS coordinates:
    Modified at 2026-04-22 11:58:46
    Previous
    2. Embedding the Widget into a Page
    Next
    4. Integration: Vanilla JavaScript
    Built with