Delivery Date and Time Slot for PrestaShop: module documentation

This module adds a mandatory delivery date and time slot choice to the PrestaShop 8 and 9 checkout, capped by the real capacity of your workshop, with zones served by weekday, a message card, store pickup and delivery surcharges. Technical name: dfflorist.

Installation

1. In Modules > Module Manager, click Upload a module and drop the ZIP file.
2. On installation the module creates its tables, two demo slots (Morning 09:00-12:00 and Afternoon 14:00-18:00), four illustrated card designs and a hidden Delivery surcharge product (reference DFFLO-SURCHARGE).
3. A new Orders > Florist deliveries tab appears. The module navigation bar gives access to the planning, zones, slots, closures, cards, workshop load and settings.

General settings

Scope

• Products concerned: all products, or only those in the checked categories (fresh flowers, plants, fresh food).
• Carriers concerned: leave everything unchecked to apply the planning to every carrier. With a selection, the other carriers (dried flowers by parcel, for example) ask no date.
• Store pickup carriers: see below.
• Deliver only inside the zones: once a zone is active, a postcode outside every zone cannot order with a concerned carrier.
• Product page badge and accent color of the checkout block.

Delivery date and lead times

• Date required and time required (applied only when slots exist for the chosen day).
• Same-day delivery and its cutoff (HH:MM, shop time zone).
• Daily order cutoff (optional): an order placed after this time counts from the next day. Example: 16:00 with a one-day lead time, an order placed at 17:00 on Monday cannot be delivered on Tuesday.
• Minimum lead time in days, preparation time before a slot for same-day orders, booking window in days.

Workshop capacity

• Workshop delivery days and capacity per weekday in units (0 = no daily limit).
• Default load per product: units used by each item. Set a different load per product in Workshop load.
• Hold during checkout (20 minutes by default): carts that picked a slot hold it during this time.
• Few places left warning and order statuses that free capacity (canceled, payment error, refunded by default).

Message card and recipient

Enable the card, make the message required if needed, set the maximum length, offer the signature field and the unsigned card option. The recipient phone can be hidden, optional or required.

Delivery zones

A zone groups postcodes and the days it is delivered. Accepted patterns, one per line or separated by commas:

• exact code: 06000
• prefix: 75* or SW1*
• range: 06000..06300

The country is optional. The extra lead time is added to the minimum lead time for distant zones and disables same-day delivery in that zone. When several zones match, the first active zone in the list wins.

Time slots

Each slot has a translatable label, a start and end time, weekdays, a capacity in units (0 = only the day capacity applies), an optional tax-included surcharge and, if needed, a restriction to some zones. With no active slot, the customer only picks a date.

Closures and peak days

• Closed: the date is blocked (holidays, stocktaking).
• Peak day or exceptional opening: the day capacity is replaced by yours (0 = no limit) and the day opens even if it is normally closed. If no slot exists for that weekday, every active slot is offered.

Message cards

Each design has a name, a suggested text that prefills the message when the customer picks the card, and a JPG, PNG or WebP visual of 2 MB maximum, 3:2 ratio recommended. The four designs provided (Birthday, Love, Thank you, Condolences) can be edited.

Workshop load per product

For each product, set the units per item (0 for a vase or chocolates that need no preparation) and the extra preparation in days for made-to-order items. When such a product is in the cart, the lead time grows accordingly and same-day delivery is disabled.

What the customer sees at checkout

At the Shipping step the block appears under the carrier list, above the Continue button. The customer picks a day in the calendar (the gauge shows the load, a “+” marks a surcharge), then a slot showing the last places and its surcharge. They then pick a card design, write the message and signature and watch the card preview update. The choice is saved automatically.

The Continue button is blocked while required information is missing, and the server checks everything again when the step is validated.

Store pickup

Check your Click & collect carriers in Store pickup carriers. For them the block becomes Pickup date: no zone, no recipient phone, no surcharge. Slots restricted to zones are not offered. When the customer changes carrier, the block reloads and the surcharge is added to or removed from the cart.

Delivery surcharges

Three sources add up, all tax included in the default currency:

• the surcharge of the chosen slot (express, fixed time);
• the surcharge of the weekday (Sunday, for example);
• the same-day surcharge.

The total is added to the cart as a Delivery surcharge line, with the tax rule of the hidden product. It shows in the summary, the order and the invoice. The surcharge is removed automatically if the customer switches to store pickup or if the cart no longer contains a concerned product.

Planning and printing

The Planning page shows a 14-day strip with its fill rate, the load of the selected day per slot, the units held by carts in checkout and the list of deliveries (time, zone or Store pickup label, recipient, address, items, card). Three actions:

• Print message cards: A6 cards, four per A4 sheet with cut lines, marked Printed afterwards;
• Delivery sheet: round by slot, store pickups in a separate section;
• Export CSV: semicolon separator, Excel compatible.

Orders, emails and PDF

• The back-office order list gets a sortable Delivery date column with a date range filter.
• The order page shows a panel with the date, slot, zone, surcharge and card, and lets you change them (without capacity check).
• In the native emails, the date is added after the carrier name, in the order language. Variables available for your templates: {dfflo_delivery_date}, {dfflo_delivery_slot}, {dfflo_card_message}.
• The PDF invoice shows the date and the recipient phone, the delivery slip adds the message.

Upgrading from 1.0.0

Upload the 1.1.0 ZIP over the existing version from the Module Manager. The upgrade script adds the new columns and settings, creates the Delivery surcharge product and attaches the visuals to the demo cards. Your zones, slots and orders are kept.

Frequently asked questions

The block does not appear at checkout

Check that the module is enabled in the settings, that the cart contains a concerned product and that the selected carrier is concerned or set as store pickup.

No date is offered

Check the workshop delivery days, the delivery days of the customer’s zone, the minimum lead time and the booking window. A product with extra preparation also shifts the first date.

What happens on uninstall?

Zones, slots, cards and the dates stored on orders are deleted, together with the Delivery surcharge product. Surcharge lines already invoiced stay on the orders.