{"id":366110,"date":"2026-09-10T07:29:49","date_gmt":"2026-09-10T07:29:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/cycloon\/"},"modified":"2026-09-10T07:29:23","modified_gmt":"2026-09-10T07:29:23","slug":"cycloon","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/cycloon\/","author":23562879,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.1","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"Cycloon","header_author":"Cycloon","header_description":"Ship your WooCommerce orders with Cycloon: create shipments, print PDF labels and follow the track & trace status.","assets_banners_color":"f094a3","last_updated":"2026-09-10 07:29:23","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.cycloon.eu","header_author_uri":"https:\/\/cycloon.eu","rating":0,"author_block_rating":0,"active_installs":0,"downloads":29,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"cycloon","date":"2026-09-10 07:29:23","revision":3689457}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3689457,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3689457,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3689457,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3689457,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3689457,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3689457,"resolution":"1","location":"assets","locale":"","width":1065,"height":1715},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3689457,"resolution":"2","location":"assets","locale":"","width":896,"height":344},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3689457,"resolution":"3","location":"assets","locale":"","width":940,"height":844},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3689457,"resolution":"4","location":"assets","locale":"","width":342,"height":901},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3689457,"resolution":"5","location":"assets","locale":"","width":280,"height":364},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3689457,"resolution":"6","location":"assets","locale":"","width":832,"height":288},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3689457,"resolution":"7","location":"assets","locale":"","width":690,"height":866}},"screenshots":{"1":"The settings page under WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Cycloon.","2":"The \"Delivery by Cycloon\" method in a shipping zone.","3":"The shipping method settings: rate, free shipping threshold, product and pickup points.","4":"Creating a shipment from the order page: product, number of parcels and options.","5":"The shipment panel with status, history and the label buttons.","6":"The Cycloon column in the order list, with the bulk action for labels.","7":"Choosing a pickup point at checkout."}},"plugin_section":[],"plugin_tags":[280060,13827,3808,12855,3546],"plugin_category":[45],"plugin_contributors":[280061],"plugin_business_model":[],"class_list":["post-366110","plugin","type-plugin","status-publish","hentry","plugin_tags-cycloon","plugin_tags-delivery","plugin_tags-labels","plugin_tags-parcel","plugin_tags-shipping","plugin_category-ecommerce","plugin_contributors-cycloon","plugin_committers-cycloon"],"banners":{"banner":"https:\/\/ps.w.org\/cycloon\/assets\/banner-772x250.png?rev=3689457","banner_2x":"https:\/\/ps.w.org\/cycloon\/assets\/banner-1544x500.png?rev=3689457","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/cycloon\/assets\/icon.svg?rev=3689457","icon":"https:\/\/ps.w.org\/cycloon\/assets\/icon.svg?rev=3689457","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-1.png?rev=3689457","caption":"The settings page under WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Cycloon."},{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-2.png?rev=3689457","caption":"The \"Delivery by Cycloon\" method in a shipping zone."},{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-3.png?rev=3689457","caption":"The shipping method settings: rate, free shipping threshold, product and pickup points."},{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-4.png?rev=3689457","caption":"Creating a shipment from the order page: product, number of parcels and options."},{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-5.png?rev=3689457","caption":"The shipment panel with status, history and the label buttons."},{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-6.png?rev=3689457","caption":"The Cycloon column in the order list, with the bulk action for labels."},{"src":"https:\/\/ps.w.org\/cycloon\/assets\/screenshot-7.png?rev=3689457","caption":"Choosing a pickup point at checkout."}],"raw_content":"<!--section=description-->\n<p>This plugin integrates the Cycloon API into WooCommerce.<\/p>\n\n<ul>\n<li><strong>Shipping method at checkout<\/strong>: add \"Delivery by Cycloon\" to your shipping zones, with its own rate per zone, an optional free-shipping threshold and a fixed Cycloon product per method. Works in both the classic checkout and the checkout blocks.<\/li>\n<li><strong>Create a shipment<\/strong> from the order page, or automatically when an order reaches \"Processing\" \u2014 for all orders, or only for orders where the customer chose Cycloon at checkout. Choose the product (Pakket, Pakket XL, Brievenbuspakket, Aangetekende brief, Aangetekend pakket), the number of parcels, and the \"Handtekening\" (signature) and \"Niet bij buren\" (no delivery to neighbours) options.<\/li>\n<li><strong>PDF labels<\/strong> per order, or in bulk from the order list. ZPL for label printers is available as a setting.<\/li>\n<li><strong>Pickup points<\/strong>: let customers choose a nearby parcel point at checkout. Enable it per shipping method, either alongside home delivery or on its own.<\/li>\n<li><strong>Link an existing shipment<\/strong>: created a shipment in the Cycloon dashboard? Enter its track &amp; trace code on the order and the plugin pulls in the status, the history and the labels.<\/li>\n<li><strong>Track &amp; trace<\/strong>: refresh the status per order, an hourly automatic sync through Action Scheduler, and a webhook receiver for push updates, secured with HMAC verification. The link to the public tracking page comes from the API, so there is nothing to configure.<\/li>\n<li><strong>Customer communication<\/strong>: the track &amp; trace code in the order emails and on the \"My account\" order page.<\/li>\n<li><strong>Customs<\/strong>: the customs form is shown and required for destinations outside the EU, pre-filled from the order.<\/li>\n<li><strong>Translation ready<\/strong>: English source strings and a bundled .pot template; translations are delivered through translate.wordpress.org.<\/li>\n<\/ul>\n\n<p>Request an API key through klant@cycloon.eu.<\/p>\n\n<p><strong>Please note:<\/strong> Cycloon only collects parcels in the Netherlands. The plugin therefore requires the store location (WooCommerce \u25b8 Settings \u25b8 General) to be set to the Netherlands. With any other store location, the shipping method and shipment creation are disabled.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin sends data to the Cycloon Parcel API at <code>dabba.cycloon.eu<\/code>. That\nconnection is required to create shipments, retrieve labels and follow the\nstatus; without it the plugin does not work. Authentication uses the email\naddress and API key that you request from Cycloon and enter in the plugin\nsettings. Nothing is sent to Cycloon until those credentials are filled in.<\/p>\n\n<p>What is sent, and when:<\/p>\n\n<ul>\n<li><strong>When a shipment is created<\/strong> (manually from the order page, or\nautomatically if you enable that): the recipient's name, company name,\naddress, postcode, city, country, phone number and email address, the order\nnumber as a reference, the number of parcels, the selected product, the\ndelivery options and an optional note for the courier. The email address is\nincluded so that Cycloon can send track &amp; trace updates to the recipient.\nYour store address from the WooCommerce settings is sent as well, both as\nthe collection address and as the sender on the label. For destinations\noutside the EU, the customs details are included: item descriptions,\nquantities, weights, values and HS codes.<\/li>\n<li><strong>When refreshing a status, retrieving a label, cancelling a shipment or\nlinking an existing shipment<\/strong>: the shipment id or the track &amp; trace code.\nStatus refreshing also runs automatically, once an hour, for shipments that\nare still in transit.<\/li>\n<li><strong>When testing the connection<\/strong>: a non-existent shipment id, to verify that\nthe connection and your credentials work.<\/li>\n<li><strong>When looking up pickup points at checkout<\/strong>: your customer's postcode and\ncountry code. This only happens if you enable pickup point delivery and the\ncustomer selects that shipping method. The customer's browser only talks to\nyour own site; the plugin performs the lookup server-side and caches the\nresponse for six hours per postcode. No other customer data is included, and\nnothing is sent to Cycloon before the customer selects that shipping method.<\/li>\n<\/ul>\n\n<p>Cycloon can also push status updates to your site through a webhook, but only\nif you ask for that yourself by passing the webhook URL and an HMAC secret to\nCycloon. Requests without a valid signature for that secret are rejected.<\/p>\n\n<p>Terms of use and privacy policy of the service:<\/p>\n\n<ul>\n<li>Terms of use: https:\/\/www.cycloon.eu\/algemene-voorwaarden<\/li>\n<li>Privacy policy: https:\/\/www.cycloon.eu\/privacy-policy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> and activate the plugin.<\/li>\n<li>Go to WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Cycloon.<\/li>\n<li>Enter your email address and API key, save, and click \"Test connection\".<\/li>\n<li>Under WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Shipping zones, add the \"Cycloon\" method to the zones you want and set the rate.<\/li>\n<li>Open an order and create your first shipment from the \"Cycloon shipment\" panel.<\/li>\n<\/ol>\n\n<p>For webhook push updates, enter an HMAC secret under WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Cycloon and pass both that secret and the URL <code>https:\/\/yourshop.com\/wp-json\/cycloon\/v1\/webhook<\/code> to klant@cycloon.eu. Without a secret the webhook endpoint rejects every request, so no one else can change your shipment data.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20cycloon%20account%3F\"><h3>Do I need a Cycloon account?<\/h3><\/dt>\n<dd><p>Yes. Request an email address and API key through klant@cycloon.eu, then enter both under WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Cycloon.<\/p><\/dd>\n<dt id=\"why%20is%20the%20shipping%20method%20missing%20at%20checkout%3F\"><h3>Why is the shipping method missing at checkout?<\/h3><\/dt>\n<dd><p>Cycloon only collects parcels in the Netherlands, so the plugin requires the store location under WooCommerce \u25b8 Settings \u25b8 General to be set to the Netherlands. Check that first; the plugin also shows a notice in the admin explaining this.<\/p><\/dd>\n<dt id=\"can%20customers%20choose%20between%20home%20delivery%20and%20a%20pickup%20point%3F\"><h3>Can customers choose between home delivery and a pickup point?<\/h3><\/dt>\n<dd><p>Yes. Enable pickup point delivery in the plugin settings, then open your Cycloon shipping method and set \"Pickup point delivery\" to \"The customer chooses\". That single shipping method then offers both options at checkout, each with its own title and rate.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20fetch%20shipping%20rates%20from%20cycloon%3F\"><h3>Does the plugin fetch shipping rates from Cycloon?<\/h3><\/dt>\n<dd><p>No. The API does not offer a rates endpoint, so you set the shipping costs per zone yourself.<\/p><\/dd>\n<dt id=\"can%20i%20print%20labels%20for%20several%20orders%20at%20once%3F\"><h3>Can I print labels for several orders at once?<\/h3><\/dt>\n<dd><p>Yes. Select the orders in the order list and choose the \"Cycloon: download labels\" bulk action. You get one merged PDF, or one ZPL file if you set the label format to ZPL.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>First version in the WordPress.org plugin directory. The plugin itself is unchanged; this release adds the screenshots and the images for the directory page.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>The webhook endpoint now requires an HMAC secret. Incoming status updates are only accepted when their X-Fietskoeriers-Hash header matches that secret; without a secret every request is rejected. If you use the webhook, enter a secret under WooCommerce \u25b8 Settings \u25b8 Shipping \u25b8 Cycloon and pass it to klant@cycloon.eu.<\/li>\n<li>Translations are delivered through translate.wordpress.org; the plugin only ships the .pot template.<\/li>\n<li>Admin notices are limited to the screens where they belong: the WooCommerce requirement and the Dutch shop location requirement only show up on the plugin list and on the Cycloon settings section, and all notices can be dismissed. On the order page the shop location requirement was already explained in the Cycloon panel itself.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: shipping method for the checkout (per zone, with a free-shipping threshold), shipment creation, PDF labels (per order and in bulk), status sync (manual, hourly and webhook), track &amp; trace in customer emails, customs for destinations outside the EU, and pickup point delivery.<\/li>\n<\/ul>","raw_excerpt":"Ship your WooCommerce orders with Cycloon: create shipments, print PDF labels and follow the track &amp; trace status.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/366110","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=366110"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/cycloon"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=366110"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=366110"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=366110"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=366110"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=366110"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=366110"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}