WP Manifestindependent plugin directory
manifest / ecommerce / woocommerce-address-shipping-surcharge

WooCommerce Address Shipping Surcharge

A lightweight WooCommerce plugin for applying shipping surcharges based on customer address keywords and delivery zones.

by Kamran Hajhossein · github.com/kamranhajhossein/woocommerce-address-shipping-surcharge

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/kamranhajhossein/woocommerce-address-shipping-surcharge/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/kamranhajhossein/woocommerce-address-shipping-surcharge ↗

Automatically apply transparent shipping surcharges based on customer address keywords, cities, and delivery zones in WooCommerce.

Features

  • Address keyword-based surcharges
  • City and delivery-zone detection
  • Real-time checkout recalculation
  • Customizable surcharge rules
  • Custom fee label
  • Transparent fee display in cart and checkout
  • Does not create a new shipping method
  • Persian address normalization
  • WooCommerce Classic Checkout support
  • Privacy-conscious WooCommerce debug logs

Rule format

Add one rule per line:

چیتگر|200000
پاکدشت|300000
پردیس|300000

Format:

keyword|surcharge_amount

Use the same currency unit configured in WooCommerce.

When multiple keywords match, the most specific (longest) keyword wins.

Requirements

  • WordPress 6.5 or newer
  • WooCommerce 8.0 or newer
  • PHP 7.4 or newer
  • WooCommerce Classic Cart and Checkout

Installation

  1. Go to Plugins > Add New > Upload Plugin.
  2. Upload the ZIP file.
  3. Activate WooCommerce Address Shipping Surcharge.
  4. Open its settings under WooCommerce.
  5. Add your rules and save.
  6. Test checkout with a matching address.

Privacy

Debug logging is disabled by default. When enabled, the plugin logs the matched rule and surcharge amount without storing the customer's full address.

Limitations

  • The current release supports WooCommerce Classic Cart and Checkout.
  • WooCommerce Checkout Blocks are not supported yet.

Changelog

1.0.1

  • Disabled debug logging by default
  • Removed full customer addresses from debug logs
  • Fixed shipping-address selection when a separate delivery address is used
  • Removed hidden surcharge display mode for pricing transparency
  • Added compatibility and privacy documentation

1.0.0

  • Initial release

Author

Kamran Hajhossein
https://webrabin.com

License

GPL v2 or later.