Title: DZ COD Order Form Author: mrdhia Published: November 7, 2026 Last modified: November 7, 2026 --- Search plugins ![](https://ps.w.org/dz-cod-order-form/assets/banner-772x250.png?rev=3788904) ![](https://ps.w.org/dz-cod-order-form/assets/icon-256x256.png?rev=3788904) # DZ COD Order Form By [mrdhia](https://profiles.wordpress.org/mrdhia/) [Download](https://downloads.wordpress.org/plugin/dz-cod-order-form.1.5.3.zip) * [Details](https://wordpress.org/plugins/dz-cod-order-form/#description) * [Reviews](https://wordpress.org/plugins/dz-cod-order-form/#reviews) * [Installation](https://wordpress.org/plugins/dz-cod-order-form/#installation) * [Development](https://wordpress.org/plugins/dz-cod-order-form/#developers) [Support](https://wordpress.org/support/plugin/dz-cod-order-form/) ## Description Most Algerian online stores sell with cash on delivery (COD). Customers do not want a cart, an account or a long checkout: they want to type their name and phone, pick their wilaya and commune, and confirm. This plugin puts that form directly on the product page and creates a normal WooCommerce order. **Features** * All **69 wilayas** (including the 11 created in 2025) and **1541 communes**, in Arabic or Latin script. * Commune list filtered by the chosen wilaya. * **Delivery price per wilaya**, separately for home delivery and stop desk (office pickup). Disable wilayas you do not deliver to. Optional free delivery above an amount. * **Form fields you control**: show/hide, required, label and placeholder for every field, plus optional second phone, email and order note, and up to 6 **custom fields** (text, long text, dropdown, checkbox) saved on the order. * **Import delivery prices automatically** from Yalidine, ZR Express or your Ecotrack courier, or from a **Google Sheet** (template included, optional daily sync). New wilayas get their former wilaya’s price. * **Quantity offers** per product: clickable packs like “1 for 3,500 · 2 for 6,000· 3 for 8,000”, with a fixed pack price or a % discount, optional badge (“Best value”) and free delivery per pack. Prices are always recalculated on the server. * **Abandoned orders**: visitors who type a valid phone number but do not confirm are saved (after a 15-minute grace period) in WooCommerce Abandoned orders, with call and WhatsApp buttons and one-click “Create order”. Automatically deleted after a period you choose. * **Confirmation desk** (WooCommerce Confirm orders): call new orders and record the outcome in one click — confirmed, no answer, call later, cancelled — with WhatsApp messages, automatic cancel after N unanswered calls, and per-agent statistics. * **Parcel tracking**: delivered / returned / in transit pulled from Yalidine, ZR Express and Ecotrack every 3 hours; orders move to Completed or the new “Returned( refused)” status automatically. * **Customer history and repeat refusers**: every order shows how many earlier parcels the phone number accepted or refused; repeat refusers can be put on hold or refused. * **Meta Conversions API and TikTok Events API**: server-side Purchase events deduplicated with the browser pixels, with the option to count a purchase only when the order is confirmed by phone. * **Free delivery per product**: choose which products ship free — home, stop desk or both, everywhere or only in the wilayas you pick. The form shows a “Free delivery” badge and the fee is removed on the server. * **Request a feature** screen: ask for features or another delivery company, or report a problem, straight from WordPress. * **One-click upsell** after the order: add a discounted product to the same order with one tap. * **COD dashboard**: orders, confirmation rate, delivery rate, cash collected, losses on returns, best products and wilayas. * **Arabic and French** included. * Live order summary: product, delivery, total. * Simple and variable products, quantity selector. * **Anti-fraud**: Algerian phone validation (+213 accepted), duplicate detection by phone (block, or accept and put On hold), blocked phone list, per-IP rate limit, bot honeypot. * **Google Sheets export** through a small Google Apps Script (no Google account connection needed). Status changes update the sheet. * **Delivery companies**: send orders to **Yalidine**, **ZR Express** and **any courier on the Ecotrack platform** (DHD, Conexlog/UPS, Rex, MSM Go, Rocket, 48hr, Golivri, EcoRapide and more: paste its address). One click per order, bulk sending from the orders list, or automatic sending when an order reaches a status you choose. Tracking number and label saved on the order and pushed to Google Sheets. * CSV export of form orders (opens correctly in Excel with Arabic). * Fires Meta Pixel `Purchase`, TikTok `CompletePayment` and GA4 `purchase` events if those pixels are already on your site, plus a `dzcod:order` JavaScript event for custom tracking. * Shortcode `[dzcod_form]`, automatic placement on product pages, and an **Elementor widget**. * Works with full-page caching (nonce is refreshed automatically). * RTL ready. Compatible with WooCommerce HPOS. **Developers** Filters: `dzcod_free_delivery`, `dzcod_ecotrack_hosts`, `dzcod_leads_per_hour`, ` dzcod_meta_api_version`, `dzcod_locations`, `dzcod_is_valid_phone`, `dzcod_antifraud_result`,` dzcod_sheets_row`, `dzcod_auto_insert_for_product`, `dzcod_client_ip`, `dzcod_courier_providers`,` dzcod_courier_parcel`, `dzcod_courier_payload`, `dzcod_courier_logo`, `dzcod_offers`. Actions: `dzcod_before_order_save`, `dzcod_order_created`, `dzcod_order_confirmed`,` dzcod_parcel_created`, `dzcod_parcel_status`, `dzcod_lead_recovered`, `dzcod_upsell_accepted`. Source code, build-free (no compiled files), and issues: https://github.com/xthegodfatherx/ dz-cod-order-form ### External services This plugin only contacts outside services that you configure yourself: * **Google Apps Script** (Google): when you enter a web app URL, each new order( name, phone, wilaya, commune, address, products, totals, status) is sent to your own script so it can be written to your Google Sheet. [Terms](https://policies.google.com/terms), [Privacy](https://policies.google.com/privacy). * **Your delivery company**: only when you connect one in the Couriers tab and send an order (manually, in bulk or automatically), the customer name, phone, wilaya, commune, address, products, order number and amount to collect are sent to that company’s API so it can create the parcel. When you click “Import” on the Delivery prices tab, the company’s price list is read from the same API ( nothing about your customers is sent). The company is the one you choose: - **Yalidine** (api.yalidine.app): creates parcels, reads their status and delivery prices. [Transport conditions](https://yalidine.app/app/conditions_transport.php), [Privacy policy](https://www.yalidine.com/assets/docs/politique_confidentialite_yalidine.pdf). - **ZR Express** (procolis.com, the API of ZR Express): creates parcels, reads their status and delivery prices. [Privacy policy](https://www.zrexpress.net/politique-de-confidentialite). ZR Express publishes no separate terms of use; the terms are those of your contract with ZR Express. - **A courier that runs on the Ecotrack platform**: you type your own courier’s Ecotrack address (it must end with .ecotrack.dz) and the token that courier gave you; the plugin contacts only that address. The terms and privacy policy that apply are those of the courier you signed a contract with; ask that courier for them before connecting it. * **Parcel tracking**: when parcel tracking is on, the tracking numbers of your parcels are sent to the same delivery company every 3 hours to read their status. * **Meta Conversions API** (Meta Platforms): when you enter a dataset ID and access token, a Purchase event is sent to graph.facebook.com for each order (or each confirmed order). It contains the order value, currency, product IDs and quantities, the order number, the page address, the visitor’s IP address and browser, the _fbp / _fbc cookies, and the phone number, first name and commune **hashed with SHA-256**. [Terms](https://www.facebook.com/legal/terms/businesstools), [Privacy](https://www.facebook.com/privacy/policy). * **TikTok Events API** (TikTok): when you enter a pixel code and access token, a CompletePayment event with the same kind of data (phone hashed with SHA-256, IP address, browser, _ttp cookie, order value and products) is sent to business- api.tiktok.com. [Terms](https://ads.tiktok.com/i18n/official/policy/business-products-terms), [Privacy](https://www.tiktok.com/legal/page/row/privacy-policy/en). * **Delivery price import from Google Sheets** (Google): when you paste a sheet link and click “Import from sheet now”, the sheet is downloaded as CSV from docs. google.com (or from the CSV address you entered). With the daily sync option, it is downloaded once a day. Nothing about your customers is sent. [Terms](https://policies.google.com/terms), [Privacy](https://policies.google.com/privacy). * **GitHub** (feature requests): the “Request a feature” screen does not contact any server. Only when you click “Continue on GitHub” does your browser open github. com with the text you typed (and, if you leave the box ticked, the plugin, WordPress, WooCommerce and PHP version numbers). [Terms](https://docs.github.com/site-policy/github-terms/github-terms-of-service), [Privacy](https://docs.github.com/site-policy/privacy-policies/github-general-privacy-statement). Nothing is sent anywhere until you configure these services. The Meta and TikTok server events are off by default: they are tracking tools, so only switch them on if your visitors have agreed to it where your law requires consent (for example through your cookie banner), and mention them in your privacy policy. ## Installation 1. Install and activate WooCommerce. 2. Upload the plugin and activate it. 3. Go to WooCommerce DZ COD Form and set your delivery prices. 4. Open any product: the form is there. Or place `[dzcod_form product_id="123"]` / the Elementor widget wherever you want. ## FAQ ### Where do the wilaya and commune names come from? From the geoalgeria dataset (MIT License), which follows the 69-wilaya administrative division. A copy of its license is in `data/LICENSE-geoalgeria.txt`. ### How do I connect Google Sheets? Follow the steps on the “Google Sheets & export” tab. The script to paste is linked there; it is published in the plugin’s GitHub repository: [google-apps-script/Code.gs](https://github.com/xthegodfatherx/dz-cod-order-form/blob/main/google-apps-script/Code.gs). Opening the link only displays the script; nothing is sent. ### Which delivery companies are supported? Yalidine, ZR Express, and any courier that runs on the Ecotrack platform (for example DHD, Conexlog/UPS, MSM Go, Rex Livraison, EcoRapide Express): choose “Ecotrack”, then paste your courier’s Ecotrack address and API token. Maystro and Noest are planned. ### How do I import delivery prices from Google Sheets? On the Delivery prices tab, download the template, open it in Google Sheets (File Import), edit the home and desk columns, then Share “Anyone with the link can view” and paste the link. Click “Import from sheet now”, or tick the daily sync. You can also export your current prices to start from them. ### Can I show the delivery companies’ logos? The plugin shows a coloured badge with each company’s initials, because company logos are trademarks we cannot ship. To show your own logo files, use the `dzcod_courier_logo` filter: `add_filter( 'dzcod_courier_logo', function ( $url, $key ) { return 'yalidine' === $key ? 'https://your-site/logos/yalidine.png' : $url; }, 10, 2 );` ### Does the abandoned-order feature store personal data? Yes: the name, phone, wilaya, commune and address a visitor typed, plus the product. It is stored only in your own WordPress database, is shown only to shop managers, is deleted automatically after the number of days you set (30 by default), and is removed completely when you delete the plugin. A short notice under the form tells visitors their number may be saved; you can edit it or switch the feature off in General settings. Check what your local data-protection law requires. ### How do quantity offers work? Edit a product and fill in the “COD form — quantity offers” box: quantity, then either a fixed pack price or a % discount. The form then shows packs instead of the quantity selector. The pack with a badge is selected by default. ### How should I set up the confirmation workflow? In General settings set “New order status” to Pending payment and “When an order is confirmed by phone” to Processing. Your team works through WooCommerce Confirm orders. If automatic sending is set to “When an order becomes Processing”, confirmed orders go straight to your delivery company, and with “Count a purchase when the order is confirmed” Meta and TikTok only learn from real buyers. ### What happens when a parcel is refused? Parcel tracking marks it Returned and moves the order to “Returned (refused)”. The phone number’s history is updated, and if the customer refuses again they can be put on hold or refused automatically (Anti-fraud tab). ### How do I give free delivery on a product? Edit the product and use “Free delivery for this product” in the “COD form” box: free home delivery, free stop desk, or both, optionally only for some wilayas (for example 16, 09, 35). You can also give free delivery on a specific pack in the quantity offers, or above an order amount in Delivery prices. ### How can I ask for a new feature? Go to WooCommerce Request a feature. It opens a pre-filled request on GitHub that you can review before posting. You can also vote 👍 on existing requests there. ### Is Noest supported? Not yet. Noest’s API is not publicly documented; it is on the roadmap. Contributions are welcome on GitHub. ### A parcel was refused because of the commune name Delivery companies sometimes spell communes differently. Open the order, correct the commune in the shipping address, save, and click Send again. The exact error from the company is shown on the order. ### Does it replace the WooCommerce checkout? No. It creates standard WooCommerce orders with the Cash on delivery payment method, so your existing order management, emails and delivery plugins keep working. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “DZ COD Order Form” is open source software. The following people have contributed to this plugin. Contributors * [ mrdhia ](https://profiles.wordpress.org/mrdhia/) [Translate “DZ COD Order Form” into your language.](https://translate.wordpress.org/projects/wp-plugins/dz-cod-order-form) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/dz-cod-order-form/), check out the [SVN repository](https://plugins.svn.wordpress.org/dz-cod-order-form/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/dz-cod-order-form/) by [RSS](https://plugins.trac.wordpress.org/log/dz-cod-order-form/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.5.3 * The Google Apps Script is no longer shipped inside the plugin; the settings page links to it on GitHub. #### 1.5.2 * Security: atomic locks and rate-limit counters, so parallel requests cannot bypass them. * Couriers: Ecotrack couriers are connected by pasting their own address; External services section documents each service with its terms and privacy links. #### 1.5.1 * WordPress.org review: all admin JavaScript moved to an enqueued file (no inline script tags); late escaping everywhere (the order form is filtered through an allow-list with wp_kses); array input sanitized with map_deep; bundled data read with wp_json_file_decode; scripts load deferred. * Suggested privacy policy text added under Settings Privacy. * Uninstall also removes the call log and all scheduled jobs. * Coding standards: passes WordPress-Extra with no errors or warnings. * Tested up to WordPress 7.1, WooCommerce 10.8. Requires WordPress 6.3. #### 1.5.0 * New: free delivery per product — home, stop desk or both, everywhere or only in chosen wilayas — with a badge on the form, live price update and server-side pricing (also when recovering abandoned orders). * New: “Request a feature” screen that opens a pre-filled GitHub request (features, delivery companies, bugs), plus a feature-request template. * Translations: Arabic and French updated (411 strings). #### 1.4.0 * New: parcel status sync from Yalidine, ZR Express and Ecotrack every 3 hours, with a “Returned (refused)” order status and automatic Completed / Returned updates. * New: customer delivery history on every order and in the orders list; optional hold or refusal for repeat refusers. * New: confirmation desk (WooCommerce Confirm orders) with call outcomes, WhatsApp template, auto-cancel and agent statistics. * New: Meta Conversions API and TikTok Events API, deduplicated with the browser pixels; option to count purchases only after phone confirmation. * New: one-click upsell after the order. * New: COD dashboard. * New: Arabic and French translations. * Developers: GitHub Actions (lint, unit and WordPress integration tests, release zips), contribution guide. #### 1.3.1 * Security: Google Sheets sync now requires a secret of at least 12 characters ( a random one is generated if missing), and the Apps Script refuses to run with the example secret. * Security: the generic Ecotrack option only accepts *.ecotrack.dz addresses, so your API token and customer data cannot be sent to another server (filter `dzcod_ecotrack_hosts` to extend). * Security: size limits on responses from delivery companies and price sheets. * Security: site-wide hourly limit on new abandoned-order records (filter `dzcod_leads_per_hour`). * Fix: “Create order” on an abandoned order can no longer create two orders (double click or two staff members). * Fix: orders recovered from abandoned forms are now sent to Google Sheets like other orders. * Fix: orders with no wilaya or commune are not sent to the delivery company; a clear message is shown instead. * Performance: abandoned-order counts are cached instead of queried on every admin page. #### 1.3.0 * New: quantity offers per product (fixed pack price or % off, badge, free delivery per pack), shown as cards with the crossed-out normal price. * New: abandoned orders — capture after a valid phone number is typed, admin list with call/WhatsApp buttons, “Create order” in one click, automatic deletion after N days, privacy notice under the form. * Orders created by staff from an abandoned form do not record the staff member’s IP or account. #### 1.2.0 * New: Form fields tab — show/hide, required, label and placeholder for each field; second phone, email and note fields; up to 6 custom fields saved on the order, shown on the order screen and sent to Google Sheets. * New: import delivery prices from Yalidine, ZR Express or Ecotrack couriers, or from a Google Sheet / CSV (template included, optional daily sync), and export prices to CSV. * New: card-style delivery company picker with brand badges; the generic Ecotrack option lists 50+ compatible couriers (HHD Express, Eco Rapide Express…). * New: second phone is sent to the courier (ZR Express MobileB, Ecotrack telephone_2). * Fix: wilaya list no longer stays on “Loading…” — wilayas are rendered by the server, settings travel with the form (safe with JS optimisers), and communes fall back to an AJAX endpoint when the data file is blocked. * Fix: delivery prices for wilayas 10–69 could be read from the wrong row after saving (numeric keys renumbered). Re-check your prices table after updating. * Polished form design: delivery choice cards, trust line, success state. #### 1.1.0 * New: Algerian delivery companies — Yalidine, Yalitec, ZR Express and 22 Ecotrack couriers. Send from the order screen, in bulk, or automatically on a chosen status( in the background with Action Scheduler). * New: tracking number column in the orders list, label link, tracking pushed to Google Sheets. * New wilayas (59–69) are sent to couriers under their former wilaya code. * Suspected duplicate orders are never sent automatically. #### 1.0.1 * Security: Google Sheets requests use wp_safe_remote_post (no requests to internal addresses). * Security: orders are refused for draft, private or password-protected products. * Security: name and address length limits. * New: “Visitor IP from” setting for sites behind Cloudflare or a proxy, so the rate limit counts real visitors. * Fix: shop managers can now save the settings. * Fix: “Sold individually” products are always ordered with quantity 1. #### 1.0.0 * First release. ## Meta * Version **1.5.3** * Last updated **3 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.3 or higher ** * Tested up to **7.1.4** * PHP version ** 7.4 or higher ** * Tags * [algeria](https://wordpress.org/plugins/tags/algeria/)[cash on delivery](https://wordpress.org/plugins/tags/cash-on-delivery/) [wilaya](https://wordpress.org/plugins/tags/wilaya/) * [Advanced View](https://wordpress.org/plugins/dz-cod-order-form/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/dz-cod-order-form/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/dz-cod-order-form/reviews/) ## Contributors * [ mrdhia ](https://profiles.wordpress.org/mrdhia/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/dz-cod-order-form/)