Darb is a delivery marketplace in Oman. This plugin connects your WordPress site\nto it: you hand Darb a customer and a destination, Darb prices the delivery,\ncharges your Darb credit and assigns a courier.<\/p>\n\n
It does not need WooCommerce. Deliveries can start from three places:<\/p>\n\n
[darb_delivery_form]<\/code> on a page and customers can\nrequest a delivery themselves.<\/li>\n- The admin.<\/strong> Darb Delivery \u2192 New delivery<\/em> \u2014 for orders taken by phone,\nWhatsApp or over the counter.<\/li>\n
- Your own code.<\/strong> Call
darb_send_delivery()<\/code> from a theme, a form plugin, or\nany other integration.<\/li>\n<\/ul>\n\nEvery request is written down locally before it is sent, so an order Darb\nrejected \u2014 or one that never reached Darb at all \u2014 is visible under\nDarb Delivery \u2192 Deliveries<\/em> instead of disappearing.<\/p>\n\nAlready selling with WooCommerce? Install Darb Delivery for WooCommerce<\/strong>\ninstead, which pushes orders automatically as their status changes. The two\nplugins are designed to run side by side if you need both.<\/p>\n\nWhere the delivery goes<\/h4>\n\n
Darb needs a map pin, not a street address. If the request carries a Google Maps\nlink the courier is dispatched straight away. Without one, Darb texts the\ncustomer a link and asks them to share their location \u2014 the delivery waits until\nthey do. The wilaya is used in the meantime for the delivery-zone check, so set\na default under Settings<\/em> even if you collect map links.<\/p>\n\nThe wilaya is chosen from a list of the sixty wilayat Darb recognises, never\ntyped. Darb matches its delivery zones on the Arabic name, so a customer typing\n\"Al Seeb\" or misspelling a wilaya would have had their delivery refused for a\nreason nobody could see. Deliveries sent from code may use either spelling \u2014\n\"Seeb\", \"As Seeb\" and \"Al Seeb\" all resolve to \u0627\u0644\u0633\u064a\u0628 \u2014 and anything\nunrecognised is passed through for Darb itself to judge.<\/p>\n\n
Sending from your own code<\/h4>\n\n$result = darb_send_delivery( array(\n 'name' => 'Ahmed',\n 'phone' => '91234567',\n 'wilaya' => '\u0627\u0644\u0633\u064a\u0628',\n 'maps_url' => 'https:\/\/www.google.com\/maps?q=23.6100,58.5450', \/\/ optional\n 'notes' => 'Villa 5, second gate',\n 'description' => 'Two cakes',\n 'value' => 12.500, \/\/ value of the goods\n) );\n\nif ( ! $result['sent'] ) {\n error_log( 'Darb: ' . $result['message'] );\n}\n<\/code><\/pre>\n\nAccepted keys: name<\/code>, phone<\/code> (required), wilaya<\/code>, maps_url<\/code>, notes<\/code>,\n description, value<\/code>, items<\/code>, external_ref<\/code>.<\/p>\n\nitems is an array of `array( 'name' => ..., 'qty' => ..., 'price' => ... )`.\n<\/code><\/pre>\n\nWhen every item carries a price, the goods value is worked out for you.<\/p>\n\n
To adjust the request just before it is signed \u2014 for example to add exact\ncoordinates your site already knows:<\/p>\n\n
add_filter( 'darb_wp_delivery_payload', function ( $payload, $record ) {\n $payload['dropoff']['lat'] = 23.6100;\n $payload['dropoff']['lng'] = 58.5450;\n return $payload;\n}, 10, 2 );\n<\/code><\/pre>\n\nWiring up a form plugin<\/h4>\n\n
Any form plugin that fires an action on submit can feed Darb. With Contact\nForm 7, for instance:<\/p>\n\n
add_action( 'wpcf7_mail_sent', function ( $form ) {\n $data = WPCF7_Submission::get_instance()->get_posted_data();\n darb_send_delivery( array(\n 'name' => $data['your-name'],\n 'phone' => $data['your-phone'],\n 'notes' => $data['your-address'],\n ) );\n} );\n<\/code><\/pre>\n\nExternal services<\/h3>\n\n
This plugin connects to the Darb delivery marketplace to create delivery\norders. Sending deliveries to Darb is what the plugin is for, so it cannot work\nwithout contacting the service.<\/p>\n\n
Only when you send a delivery -- from the form after you approve it, from the\nadmin, or from your own code -- does the plugin transmit to Darb's API the\ndetails needed to fulfil it: the customer's name and phone number, the delivery\nwilaya and, if provided, a map location or Google Maps link, order notes, and\nitem descriptions and values. Each request is signed with the secret key Darb\nissued you. Nothing is sent until you enter your credentials, and the plugin\ndoes not track usage or contact any other service.<\/p>\n\n
\n- Service: Darb delivery marketplace -- https:\/\/darbarise.com\/<\/li>\n
- API endpoint: https:\/\/us-central1-darb-42eca.cloudfunctions.net\/shopApi\n(test mode uses https:\/\/us-central1-darbdev.cloudfunctions.net\/shopApi)<\/li>\n
- Terms of Service: https:\/\/darbarise.com\/terms-of-use\/<\/li>\n
- Privacy Policy: https:\/\/darbarise.com\/privacy-policy\/<\/li>\n<\/ul>\n\n\n
\n- Upload the
darb-delivery<\/code> folder to \/wp-content\/plugins\/<\/code>, or install the\nzip from Plugins \u2192 Add New \u2192 Upload Plugin<\/em>.<\/li>\n- Activate it.<\/li>\n
- Go to Darb Delivery \u2192 Settings<\/em> and enter the Shop ID and secret key Darb\nissued you. Leave Environment<\/strong> on Test<\/em> to begin with.<\/li>\n
- Press Test connection<\/strong>. It verifies the credentials without creating a\ndelivery or spending credit.<\/li>\n
- Tick Send orders to Darb<\/strong>, then create one delivery from\nDarb Delivery \u2192 New delivery<\/em> and confirm it appears in your Darb account.<\/li>\n
- Switch Environment<\/strong> to Production<\/em> when you are satisfied. Nothing else\nin the setup changes \u2014 but the credentials do, so enter the production pair.<\/li>\n<\/ol>\n\n\n
\nDoes this need WooCommerce?<\/h3><\/dt>\nNo. Use Darb Delivery for WooCommerce<\/em> if you want WooCommerce orders pushed\nautomatically; this plugin is for everything else.<\/p><\/dd>\nIs the front-end form safe to make public?<\/h3><\/dt>\nEvery delivery sent to Darb is charged to your Darb credit, so an open form is a\nway to spend money. The form ships switched off, and when you switch it on it\nholds requests for review by default \u2014 nothing reaches Darb until you press\nSend to Darb<\/strong>. Choose Send to Darb immediately<\/em> only if you understand that\neach submission bills you.<\/p>\n\nThe form also carries a nonce, a honeypot, a minimum fill-in time and a limit of\nfive submissions per IP address every ten minutes. Those raise the cost of abuse\nbut do not remove it; review mode is what actually protects the credit.<\/p>\n\n
Logged-in administrators are exempt from the limit and the timing check, so\ntesting your own form does not lock you out of it.<\/p><\/dd>\n