FW Food Menu – Documentation
Delivery
The FWFM Delivery addon adds delivery zone management and fee calculation to your ordering flow. Once active, customers see a delivery address field and zone selector at checkout, and the delivery cost is automatically added to their order total.
What It Adds
- Delivery zones — define named zones, each with its own delivery fee and minimum order amount.
- Distance-based pricing — calculate delivery cost dynamically using Google Maps, based on the customer's distance from the restaurant.
- Room service mode — apply a flat fee, a percentage charge, or both, for in-room or table service ordering at hotels and venues.
- Checkout integration — a delivery address field and zone selector appear in the cart checkout form; the delivery cost appears as a separate line in the order total.
Use Cases
- Charge different delivery fees for different neighbourhoods or postal areas.
- Enforce a higher minimum order for distant delivery zones.
- Add a room service surcharge for hotel in-room ordering.
- Let customers select their zone manually, or detect it automatically by address.
Delivery Settings
Once the addon is active, a Delivery tab appears in FW Food Menu → Settings. Configure your zones and calculation method there.
| Setting | Description |
|---|---|
| Delivery zones | Define named zones, each with a delivery cost, minimum order amount, and maximum distance. |
| Distance calculation | Choose between manual zone selection by the customer or automatic calculation using Google Maps Distance Matrix. |
| Google Maps API key | Required for automatic distance-based calculation. Must have the Distance Matrix API enabled. Shared with the General settings tab. |
| Restaurant coordinates | Sets the origin point used for distance calculation. |
Delivery Zone Fields
Each zone entry you create includes the following fields:
| Field | Description |
|---|---|
| Zone name | Display name shown to the customer (e.g. "City Centre", "Zone A"). |
| Delivery cost | Flat fee charged for delivery to this zone. |
| Minimum order | Minimum cart total required to place an order to this zone. |
| Max distance (km) | Upper distance limit for this zone, used in automatic distance mode. |
Room Service
The addon includes a Room Service mode for hotels and venues with table service. When a customer selects room service at checkout, additional charges can be applied:
| Parameter | Description |
|---|---|
| Room service fixed fee | A flat charge added to every room service order. |
| Room service percentage | A percentage of the cart total added as a surcharge. |
Both fields can be used together. If neither is set, room service is available without an extra charge.
Requirements
- The Cart plugin must be active — delivery options are injected into the cart checkout flow.
- If both the Delivery and Tables addons are active, customers choose between Delivery and Dine In at checkout.
- Automatic distance mode requires a valid Google Maps API key with the Distance Matrix API enabled.
To install this addon, open the Add-ons panel inside FW Food Menu. See Getting Started → Add-ons for details on free addons, paid addons, and site verification.
