Title: Gellum Delivery Calculator for WooCommerce Author: Gellum.com Published: 30. Maj 2025. Last modified: 17. Februar 2026. --- Search plugins ![](https://ps.w.org/gellum-delivery-calculator/assets/banner-772x250.png?rev=3303794) ![](https://ps.w.org/gellum-delivery-calculator/assets/icon.svg?rev=3303794) # Gellum Delivery Calculator for WooCommerce By [Gellum.com](https://profiles.wordpress.org/gellum/) [Download](https://downloads.wordpress.org/plugin/gellum-delivery-calculator.1.1.3.zip) * [Details](https://me.wordpress.org/plugins/gellum-delivery-calculator/#description) * [Reviews](https://me.wordpress.org/plugins/gellum-delivery-calculator/#reviews) * [Installation](https://me.wordpress.org/plugins/gellum-delivery-calculator/#installation) * [Development](https://me.wordpress.org/plugins/gellum-delivery-calculator/#developers) [Support](https://wordpress.org/support/plugin/gellum-delivery-calculator/) ## Description #### Calculate Shipping Costs by GPS Distance in WooCommerce with Interactive Map [Gellum](https://gellum.com/opensource) Delivery Calculator transform your WooCommerce store’s local delivery experience. This plugin offers a robust and user-friendly way to calculate shipping costs based on the **precise GPS distance** from your store to the customer’s location. It goes beyond simple calculations by integrating an **interactive Google Map** directly into your cart or checkout process. Customers can easily pinpoint their exact delivery location on the map, or allow their browser to attempt **automatic GPS detection** for an even quicker start. You define your operational reach by drawing or uploading a **GeoJSON boundary**, ensuring that rates are only offered within your designated service area. The plugin visually displays this area on the map, providing clear feedback to the customer. The standout feature is the integration of **Google Maps Reverse Geocoding**. When a customer selects or moves their pin on the map: 1. The plugin instantly fetches detailed address information via the Google Geocoding API. 2. It identifies the **Google Plus Code**, **City**, **State/Province**, **Postal Code**, and **Country**. This streamlines the checkout process, reduces typing errors, and enhances the overall user experience by leveraging WooCommerce’s native checkout update mechanisms. It’s particularly useful for areas where traditional street addresses might be less precise or for customers who prefer the simplicity of dropping a pin. **Key Features:** * **Interactive Google Map:** Customers visually select their delivery location. * **GPS Distance Calculation:** Uses the Haversine formula for accurate distance measurement. * **GeoJSON Delivery Area:** Define precise service zones using GeoJSON (Polygon/ MultiPolygon support) and visually display them. * **Reverse Geocoding:** Fetches Plus Codes, City, State, Postcode, and Country from a map point. * **Automatic Address Field Updates:** Populates WooCommerce Billing/Shipping fields( Address 1, City, State, Postcode, Country) in real-time. * **Initial GPS Auto-Detection:** Attempts to find the customer’s current location via browser Geolocation API. * **Configurable Rate Structure:** Set a base fee, define a maximum distance for that base fee, and add a per-kilometer cost for distances beyond that. * **Free Shipping Threshold:** Offer free delivery for orders above a certain subtotal. * **Order Details Storage:** Saves the customer’s selected GPS coordinates (Latitude& Longitude) with each order for your records. * **Admin Order View:** Displays the customer’s GPS coordinates and a link to Google Maps directly on the order details page in the WordPress admin. * **HPOS Compatible:** Works seamlessly with WooCommerce’s High-Performance Order Storage. * **Shortcode Support:** Easily place the map anywhere using the `[gellumdcw_map]` shortcode. * **Server-Side Validation:** Includes checks during checkout to ensure the final delivery location is still within the valid GeoJSON area. * **Independent Configuration:** Each subsite within your Multisite network can have its own unique Gellum Delivery Calculator settings. This includes distinct Google Maps API Keys, store locations (latitude and longitude), GeoJSON delivery areas, and pricing structures. * **Separate Data Handling:** Customer sessions, cart data, and order details ( including GPS coordinates saved with each order) are managed independently for each subsite, ensuring no data conflicts across your network. * **Seamless Integration:** The plugin integrates smoothly with WooCommerce’s standard shipping methods and checkout processes across individual subsites. **✨ NEW Features** * **Configurable Distance Unit:** Choose to calculate distances and set rates in either Kilometers (km) or Miles (mi). * **Selectable Calculation Method:** Added a new setting in the shipping method configuration allowing administrators to choose between ‘Driving Route (Directions API)’ for high accuracy and ‘Straight Line (Bird’s-eye view)’ for a fast, free approximation. * **Dynamic Map Visualization:** The interactive map now dynamically displays the selected calculation method. It will show the precise turn-by-turn driving route or a new, stylized curved line instead of a simple straight line. * **Email Map Snapshot:** A static map image is now automatically added to the WooCommerce order confirmation emails sent to the customer. This map clearly shows the store location (A) and the customer’s delivery location (B). Gellum Delivery Calculator is ideal for restaurants, local shops, and any business offering delivery services within a defined geographic area, providing both operational control and customer convenience. ### External Services This plugin utilizes services from Google Maps Platform to provide accurate delivery cost calculation and location selection. * **Service:** Google Maps JavaScript API, Google Geocoding API, Static Maps API, Directions API. * **Purpose:** The Maps JavaScript API is used to display an interactive map, allow customers to select their delivery location, and visualize the defined delivery area. The Geocoding API is used to translate the selected map coordinates into human-readable address components (e.g., Plus Code, City, State, Postal Code, Country) and to update WooCommerce checkout fields automatically. Maps Static API is used for display the delivery map on customer email. Directions API is used to retrieve, display, and calculate the distance between the merchant and the customer following the correct route. * **Data Sent:** - **Customer’s Location (Latitude and Longitude):** Sent from the user’s browser to Google Maps API when the map is initialized (if geolocation is allowed by the user) or when the user clicks/drags the marker on the map. This data is used to geocode the location and calculate the distance from the store. - **Google Maps API Key:** Sent with every request to Google Maps Platform services for authentication and billing. * **When Data is Sent:** - Upon loading a page containing the `[gellumdcw_map]` shortcode (for map initialization and optional auto-detection). - Whenever a user manually selects or drags the delivery location marker on the map. - During the checkout process when the Gellum Delivery method is selected and validated. * **Terms of Service:** [https://policies.google.com/terms](https://policies.google.com/terms) * **Privacy Policy:** [https://policies.google.com/privacy](https://policies.google.com/privacy) ## Screenshots [⌊WP Admin configuration⌉⌊WP Admin configuration⌉[ WP Admin configuration [⌊Map displayed with the shortcode⌉⌊Map displayed with the shortcode⌉[ Map displayed with the shortcode ## Installation 1. **Download:** Download the plugin .zip file. 2. **Upload:** Go to your WordPress Dashboard > Plugins > Add New > Upload Plugin. Select the downloaded .zip file and click ‘Install Now’. 3. **Activate:** Once installed, click ‘Activate Plugin’. 4. **Configure Shipping Zone:** 5. * Go to WooCommerce > Settings > Shipping. * Click ‘Add shipping zone’. Give it a name (e.g., „Local Delivery Zone“). Assign regions if necessary (though Gellum uses its own GeoJSON). * Click ‘Add shipping method’. Select ‘Gellum Delivery’ from the dropdown and click ‘Add shipping method’. 6. **Configure Gellum Delivery:** 7. * Hover over ‘Gellum Delivery’ in your shipping zone and click ‘Edit’. * **Crucially, enter your Google Maps API Key**. Ensure you have enabled both the **Maps JavaScript API**, **Geocoding API**, **Static Maps API**, and ** Directions API** in your Google Cloud Console for this key. * **Setup your calculation method:** Choose how you want to calculate the distance between the commerce and the customer. * **Select your preferred Distance Unit** (Kilometers or Miles). This choice will apply to the distance-based rate fields. * Enter your **Store Latitude** and **Store Longitude**. You can find these using Google Maps. * Set up your **Base Shipping Rate**, **Max Distance for Base Rate**, and **Additional Rate per km**. * Define your **Delivery Area GeoJSON**. You can create this using a tool like [geojson.io](http://geojson.io/) and paste the code here. * Set a **Minimum Order for Free Shipping** if desired (set to 0 to disable). * Click ‘Save changes’. 8. **Add the Map:** 9. * Edit your WooCommerce Checkout page (or any other page where you want the map). * Add the `[gellumdcw_map]` shortcode where you want the interactive map to appear. 10. **Test:** Place a test order, select a location on the map, and verify that the shipping costs and address fields update correctly. ## FAQ ### How do I get a Google Maps API Key? You need to create a project in the [Google Cloud Console](https://console.cloud.google.com/), generate an API key, and enable the „Maps JavaScript API“ and „Geocoding API“ for that key. Remember to restrict your key for security (e.g., by HTTP referrers). ### How do I create the GeoJSON for my delivery area? Use a free online tool like [geojson.io](http://geojson.io/). Use the drawing tools( Polygon) to outline your delivery area on the map. Copy the generated GeoJSON code from the right-hand panel and paste it into the plugin settings. Ensure it’s a valid GeoJSON `FeatureCollection` or `Polygon`/`MultiPolygon`. ### Will it work with my theme’s checkout page? The plugin uses standard WooCommerce hooks and AJAX calls. It’s designed to be compatible with most themes. The `[gellumdcw_map]` shortcode allows you to place the map flexibly. Some highly customized checkouts might require minor CSS adjustments. ### Does it update both billing and shipping addresses? Currently, the JavaScript focuses on updating the **billing** address fields. If your checkout uses separate shipping fields, you might need to adjust the `gellumdcw- frontend.js` or implement a filter if you need both updated automatically. ### Can I customize the map’s appearance? Yes, there are a couple of ways to customize the map’s appearance: 1. **CSS Styling:** The included `gellumdcw-frontend.css` provides basic styling for the map container and related elements. You can override these CSS styles in your theme’s `style.css` file or via the WordPress Customizer’s „Additional CSS“ section for a more integrated look with your site. This primarily affects the elements _around_ the map (like the info text, error messages). 2. **Google Cloud Map Styling (via Map ID):** For advanced customization of the map _itself_ (colors of roads, water, points of interest, density of features, etc.), the plugin now supports Google Maps Cloud-based map styling. 3. * You need to create a **Map Style** in the [Google Cloud Console](https://console.cloud.google.com/google/maps-apis/overview) under „Maps Platform“ > „Map Styles“. * Then, create a **Map ID** under „Maps Platform“ > „Map IDs“, ensuring it’s configured for „JavaScript“ and „Vector“ maps. * **Associate your custom Map Style with this Map ID** within the Map ID’s settings in the Google Cloud Console. * Finally, enter this **Map ID** into the „Google Maps Map ID“ field in the Gellum Delivery Calculator settings in WooCommerce (WooCommerce > Settings > Shipping > [Your Zone] > Gellum Delivery). * When a valid Map ID is provided, the plugin will instruct Google Maps to use the associated cloud-based style, giving you rich visual control over the map’s look and feel directly from the Google Cloud Console. 4. **GeoJSON Delivery Area Styling:** The appearance of the delivery area (the polygon drawn on the map) can also be customized. 5. * Currently, the plugin styles it as an outline (no fill). * If you need to change the color, stroke weight, or opacity of this delivery area outline, you would need to modify the `self.map.data.setStyle({…})` section within the `drawDeliveryArea` function in the `assets/js/gellumdcw-frontend. js` file. ### Multisite Compatibility Gellum Delivery Calculator is designed to be fully compatible with WordPress Multisite installations. To configure: Simply activate the plugin on each subsite where you intend to offer Gellum Delivery, and then set up its specific settings within the WooCommerce Shipping Zone configuration for that particular subsite. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Gellum Delivery Calculator for WooCommerce” is open source software. The following people have contributed to this plugin. Contributors * [ Gellum.com ](https://profiles.wordpress.org/gellum/) * [ Venancio Cespedes West ](https://profiles.wordpress.org/venywest/) [Translate “Gellum Delivery Calculator for WooCommerce” into your language.](https://translate.wordpress.org/projects/wp-plugins/gellum-delivery-calculator) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/gellum-delivery-calculator/), check out the [SVN repository](https://plugins.svn.wordpress.org/gellum-delivery-calculator/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/gellum-delivery-calculator/) by [RSS](https://plugins.trac.wordpress.org/log/gellum-delivery-calculator/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.1.3 (2026-02-17) * Confirmed compatibility with WordPress 6.9.1. * Confirmed compatibility with WooCommerce 10.5.2. * Minor CSS fixes for the latest version. #### 1.1.2 (2025-06-11) * Fix: Fixes a synchronization issue that prevented the shipping method from updating correctly at checkout. * Fix: The Plus Code customer address is now always updated. (In or out of coverage area). * Improvement: We implemented a new system to generate the static map with API Key restricted by http. * Improvement: Improved security in Ajax processes. #### 1.1.1 (2025-06-11) * Minor bug fixes. #### 1.1.0 (2025-06-10) * Improvement: Selectable calculation method for the distance between the business and the customer. The Google Direction API is now used to calculate the correct vehicle route, taking into account streets, roads, and more. * Update: New dynamic map that matches the calculation method selected by the administrator. * Improvement: The static map of the delivery location is now automatically displayed in the customer’s email. * Improvement: Added a setting to allow admin to choose between Kilometers (km) and Miles (mi) for distance calculattion and rate configuration. * Improvement: The delivery cost summary on the checkout page now optionally displays the calculated distance and the selected unit (e.g., 7.5 mi). * Update: The backend logic for cost calculation was refactored to support both distance units. * CSS updates: Minor changes in colors. * Minor Fixes have been made. #### 1.0.7 (2025-05-30) * Bug fix that prevented „View on Google Map“ from being displayed within order management. * Update: Only Address 1 si readonly when Gellum Delivery is selected. #### 1.0.6 (2025-05-30) * Updated gdc prefixes to gellumdcw. * Updated [gdc_map] shortcode to [gellumdcw_map]. * Created gellum-delivery-calculator.pot within language. #### 1.0.5 (2025-05-26) * Feat: Add internal order note with customer GPS Google Maps link. * Fix: Ensure geocoded address fields always update, overwriting previous values. * Fix: Improve state/province dropdown selection by matching option text. * Feat: Make Address 1 & City fields `readonly` when Gellum Delivery is selected. #### 1.0.4 (2025-05-26) * Updated server-side PHP execution to JS for compatibility with HTTP Refer APIKey restrictions * Improved security. * Minor bug fixes. #### 1.0.3 (2025-05-26) * CSS and icon changes. * Minor bug fixes. * Improved security. #### 1.0.2 (2025-05-24) * Minor bug fixes. * CSS updates. * Descriptive text fixes. * Update store icon. #### 1.0.1 (2025-05-23) * **Robust Map Initialization:** Improved JavaScript stability by ensuring latitude/ longitude values are correctly parsed as numbers before being used by the Google Maps API, resolving potential map load failures. * **Advanced Marker Implementation:** Updated map markers to use `google.maps.marker. AdvancedMarkerElement` when a Google Maps Map ID is provided, addressing deprecation warnings for `google.maps.Marker`. * **Conditional Marker Logic:** Implemented a fallback to the standard `google. maps.Marker` if no Map ID is configured, ensuring the map remains functional even without advanced marker features. This includes conditionally loading the` marker` library. * **Configurable Map ID:** Added a new setting in the WooCommerce shipping method configuration for store owners to input their Google Maps Map ID, allowing for the use of cloud-based map styles and vector maps. * **GeoJSON Layer Click-Through:** Resolved an issue where the GeoJSON delivery area overlay would intercept map clicks, preventing users from selecting a delivery location within the drawn area. Clicks now pass through to the map correctly. * **GeoJSON Styling Option:** Modified the GeoJSON delivery area to display as an outline only (no fill) for clearer map interaction, by adjusting `fillOpacity`. * **Optimized Google Maps API Script Loading:** Implemented `async` and `defer` attributes for the Google Maps API script tag via a WordPress filter, addressing performance warnings and improving page load behavior. * **Enhanced Debugging & Error Handling:** Added more console log messages and error handling in JavaScript for map initialization and GeoJSON processing to aid in troubleshooting. #### 1.0.0 (2025-05-20) * Initial release and subsequent bug fixes. * Switched primary AJAX action to handle both reverse geocoding and Gellum cost calculation in a single call. * Refined session handling and cart total recalculation logic, leveraging WooCommerce checkout fragments and triggers. * Adjusted `is_available` logic to be more permissive, relying primarily on `calculate_shipping`( based on session data) to add/remove the rate dynamically. * Improved GeoJSON handling and validation in both PHP and JavaScript. * Enhanced logging for easier debugging. * Improved handling of Google Maps API loading and error messages. * Added core features: Distance calculation, GeoJSON area, rate configuration, interactive map. * Included `[gdc_map]` shortcode. * Added server-side checkout validation. ## Meta * Version **1.1.3** * Last updated **8 months ago** * Active installations **10+** * WordPress version ** 6.9 or higher ** * Tested up to **6.9.10** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/gellum-delivery-calculator/) * Tags * [delivery](https://me.wordpress.org/plugins/tags/delivery/)[Google Maps](https://me.wordpress.org/plugins/tags/google-maps/) [gps](https://me.wordpress.org/plugins/tags/gps/)[shipping calculator](https://me.wordpress.org/plugins/tags/shipping-calculator/) [woocommerce](https://me.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://me.wordpress.org/plugins/gellum-delivery-calculator/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/gellum-delivery-calculator/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/gellum-delivery-calculator/reviews/) ## Contributors * [ Gellum.com ](https://profiles.wordpress.org/gellum/) * [ Venancio Cespedes West ](https://profiles.wordpress.org/venywest/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/gellum-delivery-calculator/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://gellum.com/opensource)