{"id":149932,"date":"2021-12-12T13:10:52","date_gmt":"2021-12-12T13:10:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/swoove-delivery\/"},"modified":"2026-02-11T14:40:50","modified_gmt":"2026-02-11T14:40:50","slug":"swoove-delivery","status":"publish","type":"plugin","link":"https:\/\/test.wordpress.org\/plugins\/swoove-delivery\/","author":20062371,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.3.1","stable_tag":"2.3.1","tested":"6.8.5","requires":"6.8.1","requires_php":"7.4","requires_plugins":null,"header_name":"Swoove 360","header_author":"Swoove360","header_description":"The plugin is to enable ecommerce be able to get shipping estimates and request shipping from their store","assets_banners_color":"fafafa","last_updated":"2026-02-11 14:40:50","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.swoove360.com\/wordpress-plugin-setup","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1381,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["installation","faq","changelog","description"],"tags":{"1.0.0":{"tag":"1.0.0","author":"swoove","date":"2021-12-12 13:15:42"},"1.0.1":{"tag":"1.0.1","author":"swoove","date":"2021-12-12 13:46:14"},"1.0.2":{"tag":"1.0.2","author":"swoove","date":"2021-12-22 15:23:39"},"1.0.3":{"tag":"1.0.3","author":"swoove","date":"2022-10-04 11:26:39"},"2.0.0":{"tag":"2.0.0","author":"swoove","date":"2024-12-16 12:51:38"},"2.0.1":{"tag":"2.0.1","author":"swoove","date":"2025-01-06 07:41:43"},"2.0.2":{"tag":"2.0.2","author":"swoove","date":"2025-01-06 08:04:28"},"2.0.3":{"tag":"2.0.3","author":"swoove","date":"2025-01-07 18:52:43"},"2.0.4":{"tag":"2.0.4","author":"swoove","date":"2025-01-14 10:31:43"},"2.1.0":{"tag":"2.1.0","author":"robbycarter","date":"2025-05-15 14:49:11"},"2.1.1":{"tag":"2.1.1","author":"robbycarter","date":"2025-06-19 13:35:37"},"2.1.2":{"tag":"2.1.2","author":"robbycarter","date":"2025-09-10 17:02:08"},"2.2.0":{"tag":"2.2.0","author":"robbycarter","date":"2025-11-09 11:24:14"},"2.3.0":{"tag":"2.3.0","author":"robbycarter","date":"2025-11-12 07:06:52"},"2.3.1":{"tag":"2.3.1","author":"robbycarter","date":"2026-02-11 14:40:50"}},"upgrade_notice":{"2.3.1":"<ul>\n<li>Fixed issue with delivery customer details not sent for some orders<\/li>\n<\/ul>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":2643032,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon-512x512.png":{"filename":"icon-512x512.png","revision":2643032,"resolution":"512x512","location":"assets","locale":"","width":512,"height":512}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":2643032,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2643032,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":2643032,"resolution":"772x250","location":"assets","locale":"","width":773,"height":251},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2643032,"resolution":"772x250","location":"assets","locale":"","width":773,"height":251}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","2.0.0","2.0.1","2.0.2","2.0.3","2.0.4","2.1.0","2.1.1","2.1.2","2.2.0","2.3.0","2.3.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"swoove1.png - Configure your setting","2":"swoove2.png - configure the product vendors"}},"plugin_section":[],"plugin_tags":[3546,286],"plugin_category":[45],"plugin_contributors":[236476],"plugin_business_model":[],"class_list":["post-149932","plugin","type-plugin","status-publish","hentry","plugin_tags-shipping","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-swoove","plugin_committers-robbycarter","plugin_committers-swoove"],"banners":{"banner":"https:\/\/ps.w.org\/swoove-delivery\/assets\/banner-772x250.png?rev=2643032","banner_2x":"https:\/\/ps.w.org\/swoove-delivery\/assets\/banner-1544x500.png?rev=2643032","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/swoove-delivery\/assets\/icon-256x256.png?rev=2643032","icon_2x":"https:\/\/ps.w.org\/swoove-delivery\/assets\/icon-256x256.png?rev=2643032","generated":false},"screenshots":[],"raw_content":"<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/plugin-name<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Use the WooCommerce shipping settings page to configure the plugin.\n\n<ul>\n<li>Set the shipping zone.<\/li>\n<li>Pick the country, then select <strong>Swoove<\/strong> as the shipping method.<\/li>\n<li>Click on <strong>Edit<\/strong> to update settings.<\/li>\n<li>Enable the plugin.<\/li>\n<\/ul><\/li>\n<li>Configure the following settings:\n\n<ul>\n<li><strong>Shop Location<\/strong>: Enter the location of your shop.<\/li>\n<li><strong>Environment<\/strong>: Set to <code>Test<\/code> for testing deliveries or <code>Live<\/code> for real orders.<\/li>\n<li><strong>Swoove API Key<\/strong>: Obtain your API key from <a href=\"https:\/\/business.swoove.delivery\/\">Swoove Business Panel<\/a>:\n\n<ul>\n<li>Sign up and create a business.<\/li>\n<li>Navigate to <strong>Settings &gt; API Key<\/strong>.<\/li>\n<li>Use the provided test and live keys accordingly.<\/li>\n<\/ul><\/li>\n<li><strong>Google Maps API Key<\/strong>: Enter your Google Maps API Key.<\/li>\n<\/ul><\/li>\n<li>Copy the <strong>Callback URL<\/strong> provided in the plugin settings and set it in your Swoove Business Panel at <a href=\"https:\/\/business.swoove.delivery\/\">Swoove Business Panel<\/a>.<\/li>\n<\/ol>\n\n<p><strong>Testing Your Setup<\/strong>\n- Place a test order using the <strong>Test Environment<\/strong> to confirm that everything works.\n- Switch to <strong>Live Environment<\/strong> when you\u2019re ready to process real orders.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20this%20free%20to%20use%3F\"><h3>Is this free to use?<\/h3><\/dt>\n<dd><p>Yes, this plugin is free to use.<\/p><\/dd>\n<dt id=\"where%20do%20i%20get%20the%20swoove%20api%20key%3F\"><h3>Where do I get the Swoove API key?<\/h3><\/dt>\n<dd><p>Sign up at <a href=\"https:\/\/business.swoove.delivery\/\">https:\/\/business.swoove.delivery\/<\/a>, create a business, and retrieve the API keys from <strong>Settings &gt; API Key<\/strong>.<\/p><\/dd>\n<dt id=\"what%20should%20i%20set%20for%20the%20environment%3F\"><h3>What should I set for the environment?<\/h3><\/dt>\n<dd><p>Use <code>Test<\/code> to simulate deliveries or <code>Live<\/code> for processing real orders.<\/p><\/dd>\n<dt id=\"how%20do%20i%20set%20up%20the%20callback%20url%3F\"><h3>How do I set up the callback URL?<\/h3><\/dt>\n<dd><p>Copy the URL provided in the plugin settings and set it in the Swoove Business Panel under <strong>Settings &gt; API Key<\/strong>.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20plugin%20in%20other%20countries%3F\"><h3>Can I use this plugin in other countries?<\/h3><\/dt>\n<dd><p>No, this plugin is designed specifically for businesses in Ghana and Kenya.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20plugin%20with%20other%20shipping%20methods%3F\"><h3>Can I use this plugin with other shipping methods?<\/h3><\/dt>\n<dd><p>Yes, you can use this plugin alongside other shipping methods in WooCommerce.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20plugin%20for%20international%20shipping%3F\"><h3>Can I use this plugin for international shipping?<\/h3><\/dt>\n<dd><p>No, this plugin is designed specifically for local deliveries in Ghana and Kenya.<\/p><\/dd>\n<dt id=\"what%20is%20the%20google%20maps%20api%20key%20used%20for%3F\"><h3>What is the Google Maps API Key used for?<\/h3><\/dt>\n<dd><p>The Google Maps API Key is used to get the accurate location of the delivery address.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.3.1<\/h4>\n\n<ul>\n<li>Fixed issue with delivery customer details not sent for some orders<\/li>\n<\/ul>\n\n<h4>2.3.0<\/h4>\n\n<ul>\n<li>Added support for WooCommerce 6.8.1<\/li>\n<li>Fixed missing payment complete action<\/li>\n<\/ul>\n\n<h4>2.2.0<\/h4>\n\n<ul>\n<li>Added support for WooCommerce 6.8.3<\/li>\n<li>Improved delivery status update mechanism<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Added ability to mark orders as delivered<\/li>\n<li>Fixed issue with webhook not updating order status<\/li>\n<li>Show Swoove Delivery action only when order is in processing status and has not been requested<\/li>\n<li>Minor bug fixes and improvements<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Fixed issue with shop location not being saved correctly<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Plugin upgraged to use latest flow and features<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<p>Fix: Deliveries not creating in order page<\/p>\n\n<h4>1.0.2<\/h4>\n\n<p>Allow Ghana Post GPS to be used during location search\nFix: Email not passed during shipping requests<\/p>\n\n<h4>1.0.1<\/h4>\n\n<p>Updated Read Me with setup instructions<\/p>\n\n<h4>1.0.0<\/h4>\n\n<p>Initial release<\/p>\n\n<h4>0.0.1<\/h4>\n\n<p>Initial release.<\/p>\n\n<!--section=description-->\n<p>Integrate Swoove delivery services into your WooCommerce store for seamless shipping management.<\/p>\n\n<h3>Short Description<\/h3>\n\n<p>This plugin integrates Swoove delivery services into WooCommerce, enabling automated shipping management. \nMerchants can configure shipping zones, set up Swoove as a shipping method, and process both test and live orders with ease.\nThis plugin is designed specifically for businesses in Ghana and Kenya.<\/p>\n\n<h3>Third-Party Services<\/h3>\n\n<p>This plugin integrates with:\n1. <strong>Swoove Delivery API<\/strong>: Used to calculate delivery costs and track shipment status.<\/p>\n\n<p>Data Sent:\n- Shipping addresses\n- Order IDs\n- Delivery notes<\/p>\n\n<p>Data Received:\n- Delivery cost estimates\n- Real-time tracking updates<\/p>\n\n<p>The integration requires an API key, which is securely stored in the database.\n2. <strong>Google maps Api<\/strong>: Used to get the latitude and logitude of a location address.<\/p>\n\n<p>Data Sent:\n- Shipping addresses<\/p>\n\n<p>Data Received:\n- latitude\n- logitude<\/p>\n\n<p>The integration requires an API key, which is securely stored in the database.<\/p>\n\n<h3>Why Choose This Plugin?<\/h3>\n\n<p>1.Designed specifically for businesses in Ghana and Kenya.\n2.Supports multiple delivery options: same-day, next-day, and scheduled deliveries.\n3.Perfect for local retailers, grocery stores, and restaurants offering delivery services.<\/p>\n\n<h3>How It Works<\/h3>\n\n<p>The Swoove WooCommerce plugin seamlessly integrates with your store to manage shipping during the checkout process and order handling. Here's how it works:<\/p>\n\n<ol>\n<li><p><strong>Customer Checkout<\/strong><\/p>\n\n<ul>\n<li>When a customer adds products to their cart and proceeds to checkout, they\u2019ll see the Swoove shipping option as part of the available shipping methods.<\/li>\n<li>The shipping cost is dynamically calculated based on the shop location, destination, and other parameters configured in your Swoove settings.<\/li>\n<li>The customer selects the Swoove shipping method, and the shipping cost is added to their order total.<\/li>\n<\/ul><\/li>\n<li><p><strong>Order Placement<\/strong><\/p>\n\n<ul>\n<li>Once the customer places an order, WooCommerce processes it, and the order appears in the <strong>Orders<\/strong> page in your WordPress admin panel.<\/li>\n<li>For the Swoove plugin to create a delivery request, the order must be in the <strong>Processing<\/strong> stage. Ensure the order status is updated accordingly.<\/li>\n<li>To trigger the delivery creation manually:\n\n<ul>\n<li>Open the <strong>Orders<\/strong> page in WooCommerce.<\/li>\n<li>Click on <strong>Screen Options<\/strong> in the top-right corner of the page.<\/li>\n<li>Enable the <strong>Actions<\/strong> column by checking the corresponding box.<\/li>\n<li>This will reveal an <strong>\"Action\"<\/strong> button next to each order.<\/li>\n<li>Click on the <strong>\"Create Delivery\"<\/strong> button to send the order details to Swoove for processing.<\/li>\n<\/ul><\/li>\n<li>When the delivery is triggered:\n\n<ul>\n<li>The plugin communicates with the Swoove API to create a delivery request that includes customer details, order items, and delivery instructions.<\/li>\n<li>The request is processed depending on the environment settings:<\/li>\n<li><strong>Test Environment<\/strong>: Simulated delivery request for testing purposes.<\/li>\n<li><strong>Live Environment<\/strong>: Real delivery request sent to Swoove, assigned to a rider.<\/li>\n<\/ul><\/li>\n<\/ul><\/li>\n<li><p><strong>Order Management<\/strong><\/p>\n\n<ul>\n<li>In the WooCommerce <strong>Orders<\/strong> page:\n\n<ul>\n<li>You can view the order\u2019s shipping details, including the Swoove delivery status, delivery code, secret code and tracking link<\/li>\n<li>Order statuses are updated automatically based on real-time updates from Swoove (e.g., \"Out for Delivery,\" \"Delivered\").<\/li>\n<\/ul><\/li>\n<li>Callback functionality ensures the plugin receives and updates order statuses in WooCommerce without manual intervention.<\/li>\n<\/ul><\/li>\n<li><p><strong>Customer Notification<\/strong><\/p>\n\n<ul>\n<li>Customers receive order confirmation emails with the delivery details.<\/li>\n<li>They can track their delivery status using the provided tracking link.<\/li>\n<li>Customers can either share the secret code with the rider or use it to confirm delivery or sign to confirm delivery.<\/li>\n<\/ul><\/li>\n<li><p><strong>Delivery Completion<\/strong><\/p>\n\n<ul>\n<li>The Swoove rider completes the delivery, and the final status is updated in WooCommerce.<\/li>\n<li>You can review completed orders in the WooCommerce admin panel and track delivery analytics via the Swoove Business Panel.<\/li>\n<\/ul><\/li>\n<\/ol>\n\n<p><strong>Notes<\/strong>\n- Configure your shop location, environment (test\/live), Swoove API key, and Google Maps API key in the Swoove plugin settings.\n- Use the Swoove Business Panel to manage API keys, set callback URLs, and monitor deliveries.<\/p>\n\n<h4>Docs and support<\/h4>\n\n<p>If you have questions, need help, or encounter any issues while using this plugin, please contact us:<\/p>\n\n<p>Email: <a href=\"mailto:developer@swoove.delivery\">developer@swoove.delivery<\/a>\nWebsite: <a href=\"https:\/\/www.swoove360.com\/\">https:\/\/www.swoove360.com\/<\/a><\/p>","raw_excerpt":"Integrate Swoove delivery services into your WooCommerce store for seamless shipping management.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/149932","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=149932"}],"author":[{"embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/swoove"}],"wp:attachment":[{"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=149932"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=149932"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=149932"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=149932"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=149932"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/test.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=149932"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}