內容簡介
Riders Delivery for WooCommerce 將您的 WooCommerce 商店與 Riders Kuwait 送貨平台連接，處理從結帳地址捕捉到訂單送達和追蹤的整個流程。
【主要功能】
• 支援科威特地址小工具，提供逐層下拉選單
• 自動或手動訂單同步至 Riders
• 每 5 分鐘更新一次訂單狀態
• 支援 Webhook 實時狀態更新
• 管理員訂單列表可依同步狀態篩選
• 提供追蹤連結至 WooCommerce 訂單完成郵件
外掛標籤
開發者團隊
② 後台搜尋「Riders Delivery for WooCommerce」→ 直接安裝（推薦）
原文外掛簡介
Riders Delivery for WooCommerce connects your WooCommerce store to the Riders Kuwait delivery platform. It handles the entire flow — from address capture at checkout all the way to order delivery and tracking.
Key Features
Kuwait address widget at both classic and Blocks (Gutenberg) checkout: Governorate → Area → Block → Street → House cascading dropdowns
Civil ID / PACI lookup — customers can auto-fill their address from their Kuwaiti civil ID number
Automatic or manual order sync to Riders via Action Scheduler background jobs
Delivery status polling — order status updated every 5 minutes; or instantly via webhook push
Webhook support — receive real-time status updates from Riders (HMAC-verified)
Admin orders list — filter by sync status, retry failed orders individually or in bulk
Per-order meta box — view sync status, delivery fee, fleet number, and edit the Kuwait address with cascading dropdowns directly in the WooCommerce order
Tracking links — fleet tracking link appended to WooCommerce order completion emails
Proper WC_Shipping_Method — add Riders Delivery to any shipping zone with configurable flat rate and free-shipping threshold
WooCommerce REST API extension — /wc/v3/orders responses include ridedefo_sync_status, ridedefo_uid, and ridedefo_fleet_number
English and Arabic (RTL) support
HPOS compatible — High-Performance Order Storage declared and tested
Idempotent sync — duplicate delivery prevention with syncing-status guard
Transient-cached geo data — governorates/areas/blocks/streets cached for 1 hour to reduce API calls
Requirements
WooCommerce 7.5 or higher
PHP 8.0 or higher
A Riders vendor account with an API key
External Services
This plugin connects to the Riders delivery platform (https://tryriders.com) to sync WooCommerce orders and retrieve Kuwait address data.
API endpoint: https://app-order.tryriders.com/api
API documentation: https://app-order.tryriders.com/docs/vendor
Vendor portal: https://vendor.tryriders.com
Data sent to Riders:
Order details (items, total, billing/shipping address, customer phone) — when an order is synced
Kuwait Civil ID number — only when a customer voluntarily uses the PACI lookup to auto-fill their address
All requests are made over HTTPS. A Riders vendor account and API key are required.
Please review the Riders website (https://tryriders.com) for terms and privacy information before using this plugin.
Development
Source code: https://github.com/Phoenix-H22/riders-woocommerce-plugin
The Blocks checkout script is built with @wordpress/scripts.
Source: assets/checkout/blocks/src/index.js
Compiled output: assets/checkout/blocks/build/index.js
The same source is also included in this plugin package under assets/checkout/blocks/src/.
To rebuild from source:
npm install
npm run build
