Qapla' Pudo

Collection points for your shipments. This plugin integrates with Qapla’ and GLS services to provide pickup point (PUDO) selection during WooCommerce checkout.

Third Party Services

This plugin connects to the following external services:

Qapla’ API

• Service URL: https://api.qapla.it
• Purpose: Retrieve pickup points (PUDO) near a shipping address, and retrieve the list of available couriers (admin settings page only).
• Terms of Service: https://www.qapla.it/terms-and-conditions/
• Privacy Policy: https://www.qapla.io/privacy-policy
• Data transmitted: Shipping address (postcode, city, country, street) is sent on checkout to find nearby pickup points. The private API key is sent with each request for authentication. For the couriers list, only the private API key is transmitted (no user data).

GLS Italy API

• Service URL: https://api.sellsend2.gls-italy.com
• Purpose: Alternative API for GLS pickup points (when GLS platform is selected)
• Terms of Service: https://www.gls-italy.com/it/chi-siamo/legal/condizioni-di-trasporto/
• Privacy Policy: https://gls-group.eu/IT/it/privacy-policy
• Data transmitted: Shipping address (postcode, city, street) to find nearby pickup points

OpenStreetMap Nominatim

• Service URL: https://nominatim.openstreetmap.org
• Purpose: Geocoding service to convert addresses to coordinates for map display
• Terms of Service: https://operations.osmfoundation.org/policies/nominatim/
• Privacy Policy: https://wiki.osmfoundation.org/wiki/Privacy_Policy
• Data transmitted: Shipping address for geocoding

Google Maps API (Optional)

• Service URL: https://maps.googleapis.com
• Purpose: Map display when Google Maps view is configured by the user
• Terms of Service: https://cloud.google.com/maps-platform/terms
• Privacy Policy: https://policies.google.com/privacy
• Data transmitted: User location data for map rendering
• Note: Requires user to provide their own Google Maps API key

Qapla’ Tracking Service

• Service URL: https://tracking.qapla.it, https://api.qapla.it and https://cdn.qapla.it
• Purpose: Display shipment tracking widget and live status on the order detail page. Shipment event status icons are loaded from https://cdn.qapla.it as part of the tracking data returned by the Qapla’ API.
• Terms of Service: https://www.qapla.it/terms-and-conditions/
• Privacy Policy: https://www.qapla.io/privacy-policy
• Data transmitted: Tracking number and API key are sent to retrieve tracking events. Status icon images are loaded directly from cdn.qapla.it as part of the service response.
• Note: Only active when a tracking number has been assigned to the order and the Tracking View setting is not set to “Hide tracking”.

Development

Building Assets

The plugin uses npm for building JavaScript assets. To build:

1. Navigate to the plugin directory
2. Run npm install to install dependencies
3. Run npm run build to build production assets

Source Code

The source code for all compiled/minified files is included in this plugin package under js/src/.

• js/dist/qapla-pudo-block.js

  • Built from: js/src/qapla-pudo-block.js (included in this plugin)
  • Build command: npm install && npm run build

• js/google-markerclusterer.min.js

  • Library: Google Maps MarkerClusterer v2.5.3
  • License: Apache 2.0
  • Original upstream source: https://github.com/googlemaps/js-markerclusterer
  • TypeScript source included in this plugin at: js/src/google-markerclusterer/
    (files: index.ts, markerclusterer.ts, cluster.ts, renderer.ts, marker-utils.ts,
    overlay-view-safe.ts, algorithms/)

Third Party Libraries

• Leaflet.js (v1.9.4) – BSD 2-Clause License – https://leafletjs.com/

CARTO Tile Service (Optional)

• Service URL: https://basemaps.cartocdn.com
• Purpose: Alternative map tile styles (Voyager, Positron, Dark Matter) when OpenStreetMap view is configured
• Terms of Service: https://carto.com/legal/
• Privacy Policy: https://carto.com/privacy/
• Data transmitted: Map tile coordinates for rendering
• Note: Only used when user selects a CARTO tile style in plugin settings

High-Performance Order Storage (HPOS)

This plugin is compatible with WooCommerce High-Performance Order Storage (HPOS).

To enable HPOS in WooCommerce:
1. Go to WooCommerce → Settings → Advanced → Features
2. Enable “High-Performance Order Storage”
3. Click “Save changes”

The plugin uses the WooCommerce Order API ($order->get_meta(), $order->update_meta_data()) for all order data operations, ensuring full compatibility with HPOS.