Skip to main content

Stop Desk Selector

Category: Storefront  ·  Min plan: Free  ·  Slug: stop-desk

Let customers choose a specific desk/pickup point when selecting desk delivery.

Features​

  • Desk selection on checkout
  • Shows desk name, address & phone
  • Fallback to commune when no desks available
  • Only works with linked providers

Stop desk vs. this add-on​

In DZBuild, stop desk is two distinct things:

  1. A delivery type — delivery_type = 'desk' on an order, vs. 'home'. This works without any add-on: the customer types or selects a desk name in a free-text field at checkout.
  2. This add-on — replaces that free-text field with a structured picker showing the actual list of desks for the customer's wilaya, including each desk's address and phone.

You only need this add-on if you want the structured picker. The base delivery-type behavior works without it.

For courier setup details (which couriers expose desk lists, how addresses are synced), see Couriers → Stop Desk.

Why use it​

  • Customers picking up at a desk want to know exactly where: which desk, what hours, what phone to call if they're late.
  • A free-text field lets them type a desk that doesn't exist or is misspelled — courier rejects it, you have to call back.
  • A structured picker eliminates that error class. Every order has a valid desk reference the courier accepts immediately.

How to activate​

  1. Make sure at least one of your couriers is linked with desk data (Yalidine, Maystro, Noest, ZR Express New, EcoTrack — see Couriers → Stop Desk).
  2. Open Dashboard → Add-ons at /dashboard/addons.
  3. Find Stop Desk Selector under Storefront.
  4. Click Activate (Free plan).

How it behaves at checkout​

When the customer picks Desk delivery:

  1. The storefront fetches the desk list for the customer's selected wilaya from the linked courier.
  2. Each desk renders with name, address, phone.
  3. The customer picks one. The selection is stored alongside the order.

If no desks are returned (e.g. small wilaya, or courier API didn't respond), the picker falls back to the commune field — the customer enters the commune in free text.

Tips​

  • Only the couriers that actually expose desk endpoints will populate the picker. Stores using couriers without desk data will see the picker but with no entries — those customers fall back to the commune field automatically.
  • The picker fetches desks per wilaya, so make sure customers select their wilaya before the desk picker renders. (DZBuild's checkout already enforces that order.)
  • Pair with Multi-Language so desk names render in the customer's chosen language when the courier provides translated names.
  • Pair with Custom Delivery Label to keep the printed label readable for the courier even when the desk text is long.