{"id":391292,"date":"2026-10-29T08:05:31","date_gmt":"2026-10-29T08:05:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/balikobot-for-woocommerce\/"},"modified":"2026-10-29T08:05:15","modified_gmt":"2026-10-29T08:05:15","slug":"balikobot-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/balikobot-for-woocommerce\/","author":23569717,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.1","stable_tag":"0.1.1","tested":"7.1.4","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"Balikobot Shipping App","header_author":"Balikobot","header_description":"Adds the Balikobot pickup-point widget to WooCommerce checkout, classic and Blocks.","assets_banners_color":"cdccca","last_updated":"2026-10-29 08:05:15","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.balikobot.cz\/woocommerce\/","header_author_uri":"https:\/\/www.balikobot.cz\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":126,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.1":{"tag":"0.1.1","author":"balikobot","date":"2026-10-29 08:05:15","revision":3772354}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3772354,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3772354,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3772354,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3772354,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3772354,"resolution":"1","location":"assets","locale":"","width":840,"height":700},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3772354,"resolution":"2","location":"assets","locale":"","width":1840,"height":1120},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3772354,"resolution":"3","location":"assets","locale":"","width":1552,"height":852},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3772354,"resolution":"4","location":"assets","locale":"","width":840,"height":790},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3772354,"resolution":"5","location":"assets","locale":"","width":1280,"height":620}},"screenshots":{"1":"The pickup point picker at checkout: the customer chooses a point on the map or from the list, with its price and delivery date.","2":"Each carrier has its own pin on the map.","3":"A pickup point's details: address, price, opening hours and a photo.","4":"The chosen pickup point on the Checkout block, before the order is placed.","5":"WooCommerce &gt; Settings &gt; Shipping &gt; Balikobot: the Portal connection status and how the picker is shown."}},"plugin_section":[],"plugin_tags":[289407,3148,150192,3546,286],"plugin_category":[45],"plugin_contributors":[289408],"plugin_business_model":[],"class_list":["post-391292","plugin","type-plugin","status-publish","hentry","plugin_tags-balikobot","plugin_tags-checkout","plugin_tags-pickup-point","plugin_tags-shipping","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-balikobot","plugin_committers-balikobot"],"banners":{"banner":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/banner-772x250.png?rev=3772354","banner_2x":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/banner-1544x500.png?rev=3772354","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/icon-128x128.png?rev=3772354","icon_2x":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/icon-256x256.png?rev=3772354","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/screenshot-1.png?rev=3772354","caption":"The pickup point picker at checkout: the customer chooses a point on the map or from the list, with its price and delivery date."},{"src":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/screenshot-2.png?rev=3772354","caption":"Each carrier has its own pin on the map."},{"src":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/screenshot-3.png?rev=3772354","caption":"A pickup point's details: address, price, opening hours and a photo."},{"src":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/screenshot-4.png?rev=3772354","caption":"The chosen pickup point on the Checkout block, before the order is placed."},{"src":"https:\/\/ps.w.org\/balikobot-for-woocommerce\/assets\/screenshot-5.png?rev=3772354","caption":"WooCommerce &gt; Settings &gt; Shipping &gt; Balikobot: the Portal connection status and how the picker is shown."}],"raw_content":"<!--section=description-->\n<p>For the shipping methods your Balikobot Portal marks as pickup-point methods, this plugin shows a\npickup point picker at checkout. The customer chooses a point on a map, and the chosen point is saved\non the order for Balikobot to read.<\/p>\n\n<p>Both WooCommerce checkout implementations are supported:<\/p>\n\n<ul>\n<li>The classic shortcode checkout (<code>[woocommerce_checkout]<\/code>)<\/li>\n<li>The Checkout block (<code>woocommerce\/checkout<\/code>)<\/li>\n<\/ul>\n\n<p>Nothing has to be copied into the shop by hand. The plugin asks the Balikobot Portal which widget\nbelongs to this shop, matched on the shop's own web address, and which shipping methods offer a\npickup point. No Balikobot credential is stored here. The only setting is whether the map opens in a\ndialog or is shown directly in the checkout.<\/p>\n\n<p>Balikobot is a paid shipping service. The plugin does nothing until you have a Balikobot account with\nthis shop connected in the Balikobot Portal.<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=wrKZqTbeipE<\/p>\n\n<h4>Source code<\/h4>\n\n<p>The Checkout block script in <code>blocks\/build\/<\/code> is compiled from <code>blocks\/src\/<\/code>, which ships with the\nplugin. To rebuild it, run <code>npm install &amp;&amp; npm run build<\/code> in the <code>blocks\/<\/code> directory.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to services operated by Balikobot s.r.o. (https:\/\/www.balikobot.cz\/). Without\nthem there is no pickup point picker.<\/p>\n\n<h4>Balikobot widget host<\/h4>\n\n<p>The widget files are hosted by Balikobot on Google Cloud Storage, under\n    https:\/\/storage.googleapis.com\/bb-dist-prod\/widget\/. Google only hosts the files: Google Cloud\nterms https:\/\/cloud.google.com\/terms, Google Cloud privacy notice\nhttps:\/\/cloud.google.com\/terms\/cloud-privacy-notice.<\/p>\n\n<ul>\n<li>Your server downloads <code>widget\/v1\/config.json<\/code>, which names the Balikobot Portal API address,\nbefore it calls the Portal API (see below). The request carries only WordPress's standard user\nagent, which includes the site address.<\/li>\n<li>The customer's browser loads the widget script <code>widget\/v1\/balikobot-widget.js<\/code> on the checkout\npage. When the customer opens the picker, the browser also loads the picker page, the map tiles\n(OpenStreetMap data) and the street search index from the same host. The picker page address\ncarries the widget id, the shop's web address and the checkout language. Like any web request,\nthese requests reveal the customer's IP address and browser to the host.<\/li>\n<\/ul>\n\n<h4>Balikobot Portal API<\/h4>\n\n<p>The Portal API (<code>https:\/\/portal-api.balikobot.com<\/code>) tells the plugin which widget belongs to the shop\nand returns the pickup points.<\/p>\n\n<ul>\n<li>Your server calls <code>GET \/api\/widgets\/resolve<\/code> and <code>GET \/api\/widgets\/{id}\/config<\/code> to learn which\nwidget belongs to this shop and which shipping methods offer a pickup point. Both requests send\nthis shop's web address (the Site Address from Settings &gt; General) and nothing else. They run when\nthe cart or checkout page loads, when an order is placed, and on the Balikobot settings screen.<\/li>\n<li>When the customer opens the picker, their browser requests the pickup points and their details.\nThese requests send the widget id, the shop's web address, the destination country and the name\nof 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.<\/li>\n<li>If the customer allows it, the browser's location is used to centre the map. It stays in the\nbrowser and is not sent.<\/li>\n<\/ul>\n\n<p>The pickup point the customer picks is posted back to your shop and saved on the order.<\/p>\n\n<p>Terms of use: https:\/\/www.balikobot.cz\/wp-content\/uploads\/2026\/08\/Vseobecne-obchodni-podminky-2026_EN.pdf\nPrivacy policy: https:\/\/www.balikobot.cz\/wp-content\/uploads\/2026\/08\/Zasady-ochrany-osobnich-udaju-Balikobot-s.%E2%80%85r.%E2%80%85o._CZ.pdf\nAll legal documents: https:\/\/www.balikobot.cz\/dokumenty\/<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin. WooCommerce 8.3 or later has to be active.<\/li>\n<li>In the Balikobot Portal, connect this shop and switch the pickup point widget on. The Portal\nmatches the shop by its web address, so the Site Address in Settings &gt; General has to be the\naddress registered in the Portal.<\/li>\n<li>In the Portal, map your WooCommerce shipping methods to Balikobot deliveries and mark the ones\nthat are pickup point deliveries.<\/li>\n<li>Open WooCommerce &gt; Settings &gt; Shipping &gt; Balikobot. The Connection panel there says whether the\nPortal recognises this shop. The same screen sets whether the map opens in a dialog or is shown\ndirectly in the checkout.<\/li>\n<\/ol>\n\n<p>The picker then appears at checkout for the shipping methods you marked in the Portal.<\/p>\n\n<p>You need this plugin only for pickup point delivery. Connecting WooCommerce to Balikobot does not\nrequire it.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20this%20plugin%20to%20use%20balikobot%3F\"><h3>Do I need this plugin to use Balikobot?<\/h3><\/dt>\n<dd><p>No. WooCommerce connects to Balikobot without it. Install it only when you want customers to choose a\npickup point during checkout.<\/p><\/dd>\n<dt id=\"i%20activated%20the%20plugin%20and%20nothing%20changed%20at%20checkout.\"><h3>I activated the plugin and nothing changed at checkout.<\/h3><\/dt>\n<dd><p>That is what happens until the shop is connected in the Balikobot Portal. The plugin asks the Portal\nwhich widget belongs to this shop; with no answer it shows no picker and checkout works as before.\nThe Connection panel under WooCommerce &gt; Settings &gt; Shipping &gt; Balikobot shows the web address the\nPortal was asked about. It has to match the one registered in the Portal exactly. A fix there shows\non the next page load.<\/p><\/dd>\n<dt id=\"where%20do%20i%20choose%20which%20shipping%20methods%20offer%20a%20pickup%20point%3F\"><h3>Where do I choose which shipping methods offer a pickup point?<\/h3><\/dt>\n<dd><p>In the Balikobot Portal, not in WordPress. The plugin reads the list from the Portal each time the\ncheckout page loads.<\/p><\/dd>\n<dt id=\"the%20picker%20failed%20to%20load%20for%20a%20customer.%20can%20they%20still%20order%3F\"><h3>The picker failed to load for a customer. Can they still order?<\/h3><\/dt>\n<dd><p>Every other shipping method is unaffected. A pickup point method needs a chosen point, so the\ncustomer sees a message saying the picker could not be loaded, and can try again or choose a\ndifferent shipping method.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20the%20checkout%20block%20and%20high-performance%20order%20storage%3F\"><h3>Does it work with the Checkout block and High-Performance Order Storage?<\/h3><\/dt>\n<dd><p>Yes. Both are declared compatible, and the chosen point is saved the same way on either checkout.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Every function, class, constant, option, hook, script handle and CSS class has a unique prefix.<\/li>\n<li>No admin notice when the shop is not connected; the Plugins screen links to the settings instead.<\/li>\n<li>Classic checkout: an order with a pickup point method can no longer be placed without a chosen point.<\/li>\n<li>Classic checkout: a point chosen and then abandoned for another shipping method is not saved on the order.<\/li>\n<li>The External services section lists every service the plugin connects to.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>First release: classic and Blocks checkout, order meta, admin, customer and email display.<\/li>\n<li>The widget and the pickup-point shipping methods come from the Balikobot Portal.<\/li>\n<li>The picker can open in a dialog or be shown inline in the checkout.<\/li>\n<li>Checkout stays usable when the picker cannot load, and the customer is told why.<\/li>\n<\/ul>","raw_excerpt":"Lets your customers choose a Balikobot pickup point during WooCommerce checkout, classic and Blocks.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/391292","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=391292"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/balikobot"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=391292"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=391292"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=391292"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=391292"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=391292"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=391292"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}