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
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/kamranhajhossein/woocommerce-address-shipping-surcharge/archive/refs/heads/main.zip
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.