About this plugin
For the shipping methods your Balikobot Portal marks as pickup-point methods, this plugin shows a
pickup point picker at checkout. The customer chooses a point on a map, and the chosen point is saved
on the order for Balikobot to read.
Both WooCommerce checkout implementations are supported:
- The classic shortcode checkout ( [woocommerce_checkout] )
- The Checkout block ( woocommerce/checkout )
Nothing has to be copied into the shop by hand. The plugin asks the Balikobot Portal which widget
belongs to this shop, matched on the shop’s own web address, and which shipping methods offer a
pickup point. No Balikobot credential is stored here. The only setting is whether the map opens in a
dialog or is shown directly in the checkout.
Balikobot is a paid shipping service. The plugin does nothing until you have a Balikobot account with
this shop connected in the Balikobot Portal.
Source code
The Checkout block script in blocks/build/ is compiled from blocks/src/, which ships with the
plugin. To rebuild it, run npm install && npm run build in the blocks/ directory.
External services
o. cz/). Without
them there is no pickup point picker.
Balikobot widget host
The widget files are hosted by Balikobot on Google Cloud Storage, under
com/bb-dist-prod/widget/. Google only hosts the files: Google Cloud
com/terms, Google Cloud privacy notice
com/terms/cloud-privacy-notice.
- Your server downloads widget/v1/config.json, which names the Balikobot Portal API address,
before it calls the Portal API (see below). The request carries only WordPress’s standard user
agent, which includes the site address.
- The customer’s browser loads the widget script widget/v1/balikobot-widget.js on the checkout
page. When the customer opens the picker, the browser also loads the picker page, the map tiles
(OpenStreetMap data) and the street search index from the same host. The picker page address
carries the widget id, the shop’s web address and the checkout language. Like any web request,
these requests reveal the customer’s IP address and browser to the host.
Balikobot Portal API
com ) tells the plugin which widget belongs to the shop
and returns the pickup points.
- Your server calls GET /api/widgets/resolve and GET /api/widgets/{id}/config to learn which
widget belongs to this shop and which shipping methods offer a pickup point. Both requests send
this shop’s web address (the Site Address from Settings > General) and nothing else. They run when
the cart or checkout page loads, when an order is placed, and on the Balikobot settings screen.
- When the customer opens the picker, their browser requests the pickup points and their details.
These requests send the widget id, the shop’s web address, the destination country and the name
of the chosen shipping method, along with the customer’s IP address like any web request. They send no cookies and no customer name, address or contact details.
- If the customer allows it, the browser’s location is used to centre the map. It stays in the
browser and is not sent.
The pickup point the customer picks is posted back to your shop and saved on the order.
cz/dokumenty/