Woo Food Delivery

Introduction

Woo Food Delivery is a comprehensive WordPress plugin designed to transform your WooCommerce store into a complete food delivery platform. Perfect for restaurants, pizzerias, cafes, and any food business offering home delivery services.

Why Choose Woo Food Delivery?

Features

Address Validation

• Interactive Map Integration - Powered by Leaflet.js and OpenStreetMap
• Route Calculation - Uses Graphopper API to calculate actual road distance
• Visual Feedback - Show delivery route on map with customizable colors
• Distance Validation - Automatically reject addresses beyond delivery range
• Geolocation Support - Let customers use their device location
• House Number Check - Ensure complete addresses with house numbers
• City Restriction - Optionally limit deliveries to specific cities
• Google Maps Integration - For accurate address geocoding

Delivery Management

• Date Selection - Calendar picker for delivery date
• Time Slots - Fully configurable delivery time slots
• Order Capacity - Set maximum orders per time slot
• Smart Availability - Automatically hide full or past slots
• Minimum Preparation Time - Set required time before first available slot
• Additional Fields - Doorbell name, floor number, apartment number
• Required Fields - Make delivery details mandatory or optional

Kitchen Order PDF

• One-Click Generation - Generate PDF from order list with single click
• Complete Order Details - Customer info, address, products, delivery time
• Product Variations - Includes all product variations and attributes
• YITH Integration - Special support for YITH Advanced Product Options
• Customer Notes - Display special requests and order notes
• Professional Layout - Clean, printer-friendly design
• Full Text Localization - Translate the PDF text in every language via PO files

Additional Features

System Requirements

Required API Keys (Free Plans Available)

The plugin requires two API keys to function properly. Both services offer generous free plans that are sufficient for most small to medium food delivery businesses.

How to Get Your Graphopper API Key:

1. Sign Up for Free Account

   Visit https://graphhopper.com/dashboard/#/signup and create a free account using your email address.

2. Verify Your Email

   Check your inbox for the verification email and click the confirmation link.

3. Access Your Dashboard

   Once verified, log in to the Graphopper Dashboard at https://graphhopper.com/dashboard/

4. Get Your API Key

   Your API key will be displayed on the dashboard homepage. Copy it and paste it into the plugin settings under Graphopper API Key

5. Monitor Usage

   The dashboard shows your daily usage. The free plan includes 500 requests per day, which resets every 24 hours.

How to Get Your Google Maps API Key:

1. Create Google Cloud Project

   Visit https://console.cloud.google.com/ and sign in with your Google account. Click on "Select a project" at the top, then "New Project". Give it a name (e.g., "Food Delivery") and click "Create".

2. Enable Billing

   Go to Billing in the left menu and set up a billing account. Don't worry - you get $200 free credit per month and won't be charged unless you exceed this amount.

3. Enable Maps JavaScript API

   In the left menu, go to APIs & Services > Library. Search for "Maps JavaScript API" and click on it. Click the "Enable" button.

4. Enable Geocoding API

   Go back to APIs & Services > Library. Search for "Geocoding API" and click on it. Click the "Enable" button.

5. Create API Key

   Go to APIs & Services > Credentials. Click "Create Credentials" and select "API Key". Your new API key will be displayed.

6. Restrict API Key (Recommended)

   Click on the API key name to edit it. Under "Application restrictions", select "HTTP referrers (web sites)". Add your website URL (e.g., https://yourdomain.com/*). Under "API restrictions", select "Restrict key" and choose only "Maps JavaScript API" and "Geocoding API". Click "Save".

7. Copy API Key to Plugin

   Copy your API key and paste it into the plugin settings under Google Maps API Key.

Installation

Method 1: WordPress Admin (Recommended)

1. Download the Plugin

   Download the woo-food-delivery.zip file from CodeCanyon.

2. Upload to WordPress

   Go to Plugins > Add New > Upload Plugin in your WordPress admin panel.

3. Select ZIP File

   Click "Choose File" and select the downloaded ZIP file.

4. Install and Activate

   Click "Install Now" and then "Activate Plugin".

5. Verify Installation

   You should see a new "Food Delivery" menu item in your WordPress sidebar.

   

Method 2: FTP Upload

1. Extract the ZIP file on your computer
2. Upload the woo-food-delivery folder to /wp-content/plugins/ via FTP
3. Go to Plugins in WordPress admin
4. Find "Woo Food Delivery" and click "Activate"

Configuration

Access plugin settings by clicking Food Delivery in the WordPress admin menu.

Section 1: Address Validation

Section 2: Delivery Management

Delivery Slots Configuration Example:

19:00|19:30|2
19:30|20:00|2
20:00|20:30|2
20:30|21:00|3
21:00|21:30|3
21:30|22:00|3

Section 3: Other Features

Usage Guide

Customer Experience (Frontend)

Checkout - Address Validation

1. Customer enters address in search field
2. Dropdown shows address suggestions
3. Customer selects correct address
4. Map displays route from store to delivery address
5. Green success message if address is within delivery range
6. Red error message if address is too far
7. Address fields automatically filled if valid
8. The cross icon at the right og the address input box let you activate the Geolocation of your device, so the address will automatically fill with the geolocated position

Delivery Date & Time

1. Select delivery date (today or future)
2. Choose time slot from available options
3. Enter doorbell name
4. Enter floor number
5. Enter apartment number (if required)

Admin Experience (Backend)

Viewing Orders

In WooCommerce > Orders, each order displays:

• Delivery date
• Delivery time slot
• Doorbell name
• Floor number
• Apartment number

Generating Kitchen Order PDF

1. Go to WooCommerce > Orders
2. Find the order you want to print
3. Click the document icon in Actions column
4. PDF opens automatically in new tab
5. Print or save for kitchen use

Shortcodes

[woo-food-delivery]

Display the address validator map on any page or post.

Basic Usage:

[woo-food-delivery]

With Custom Parameters:

[woo-food-delivery 
    uid="homepage-map" 
    placeholder_text="Enter your delivery address"
    clear_address_message="Clear address"
    geolocation_message="Use my location"
    softwall_message="Validating..."]

Available Parameters:

Use Cases:

• Homepage: Let visitors check if you deliver to them before browsing
• "Delivery Area" Page: Dedicated page showing coverage area
• Footer: Quick access from any page
• Popup/Modal: Exit intent popup to capture non-deliverable visitors

Frequently Asked Questions

Q: Does this work with WooCommerce block checkout?

Q: Do I need to pay for the API keys?

Q: Can I have different time slots for different days?

A: Currently, the plugin uses the same time slots for all days. Different slots per weekday/weekend would require custom development.

Q: Is the plugin translation-ready?

A: Yes! The plugin is fully compatible with:

• Loco Translate
• WPML
• Polylang
• .po/.mo translation files

Q: Can I customize the kitchen PDF template?

A: Yes, the template is located at /admin/partials/kitchen_order.html. However, modifications will be lost on updates. Consider using child plugins or hooks for permanent customizations.

Q: Does the plugin slow down my site?

A: No. The plugin loads map libraries only on checkout pages and pages with the shortcode. It has minimal impact on overall site performance.

Q: Can customers order for pickup instead of delivery?

A: The plugin is focused on delivery. For pickup options, you'd need to either disable address validation for pickup orders or use WooCommerce's built-in local pickup shipping method.

Q: What happens when a time slot is full?

A: When a slot reaches its maximum capacity, it automatically becomes unavailable and won't appear in the time slot dropdown for new orders.

Q: Can I set different delivery fees based on distance?

A: The plugin validates addresses but doesn't directly control shipping costs. You can use the calculated distance with other WooCommerce shipping plugins for distance-based pricing.

Q: How do I find my store coordinates?

Q: Can I limit deliveries to specific zip codes or neighborhoods?

A: The plugin uses distance-based validation. For zip code restrictions, you can use the "Force City" option to limit to one city, but specific zip code filtering would require custom development.

Compatibility

Tested With

Compatible Themes

• Storefront
• Astra
• OceanWP
• GeneratePress
• Kadence
• Flatsome
• Any theme that follows WooCommerce standards

Compatible Plugins

• YITH WooCommerce Advanced Product Options Premium - Full integration for product addons
• Loco Translate - Easy translation management
• WPML - Multi-language support
• Polylang - Multi-language support
• WooCommerce PDF Invoices & Packing Slips
• WooCommerce Email Customizer

Changelog

Version 1.0.0 - December 10, 2025

• Initial Release
• Address validation with Leaflet + OpenStreetMap
• Delivery date and time scheduling
• Configurable time slots with capacity limits
• Kitchen order PDF generation
• Google Maps API integration
• Graphopper routing integration
• Minimum order amount validation
• Ingredients/allergens list support
• Custom message system
• Automatic order completion
• Shortcode for address validator
• YITH Advanced Product Options integration
• Translation ready (WPML, Loco Translate, Polylang)
• WooCommerce 3.x - 8.x compatibility
• Full support for both classic and block-based WooCommerce checkout
• Optimized API call management with debouncing
• Enhanced address validation with single API call per address

Support & Documentation

Before Requesting Support

1. Verify your API keys are correctly configured
2. Clear your site and browser cache
3. Check browser console (F12) for JavaScript errors
4. Review the documentation and FAQ section
5. Try disabling other plugins to check for conflicts
6. Note which checkout type you're using (classic or block-based) when reporting issues

When Reporting Issues

Please provide:

• WordPress version
• WooCommerce version
• PHP version
• Active theme name
• List of active plugins
• Description of the issue
• Steps to reproduce
• Screenshots if applicable
• Browser console errors (if any)

Credits & Licenses

Plugin License

GPL 2.0 - https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html

Third-Party Libraries

External Services

• OpenStreetMap - Map tiles (Free)
• Graphopper API - Route calculation (Freemium)
• Google Maps API - Geocoding and Places (Freemium)