The Courier Guy Shipping for WooCommerce

= 5.5.1 – June 21, 2026
* Fixed fatal TypeError when processing orders with missing or deleted shipping zone settings.
* Fixed TCG shipping options rendering on checkout when the shipping method is disabled.
* Fixed critical cart and checkout errors caused by malformed shipping rate IDs containing colons.
* Improved shipping zone settings lookup to include the default zone and fallback to a database scan.
* Fixed order shipping item method ID being incorrectly overwritten for non-TCG shipping methods.

= 5.5.0 – May 18, 2026
* Updated ‘https://api.thecourierguy.co.za/v2/’ to ‘https://api.portal.thecourierguy.co.za/v2/’.
* Refactored core API classes for improved code quality, security, and maintainability.
* Updated logic for rendering checkout blocks in frontend JavaScript for better WooCommerce Blocks and classic checkout compatibility.
* Encryption and secure storage of API keys.
* Support for PHP 8.3.
* Improved rate caching and performance.
* Rate re-calculation prior to creating shipments to ensure rates have not expired.
* Add an option to exclude products from free shipping.
* Improved escaping of output, elimination of security warnings.
* Improved handling of locker rates and opt-in rates in API logic.
* Various bug fixes and code style improvements across PHP and JS files.
* Minor fixes in vendor dependencies for better compatibility.
* Removed legacy code for TCG suburb/area functionality.

= 5.4.0 – December 08, 2025
* D2L (Door to Locker) TCG Locker Functionality: Integrated Basic TCG locker delivery options via Shiplogic API based on customer’s delivery city.
* Method Box Shipping Display Issue: Fixed shipping totals and options visibility toggle when switching between courier and collection modes.

= 5.3.3 – November 10, 2025
* Fixed critical conflict with LearnDash plugin that caused REST API fatal errors.
REST API routes are now properly registered using the ‘rest_api_init’ hook instead of during plugin initialization.
This resolves “Uncaught TypeError” errors in LearnDash REST controllers and prevents plugin loading conflicts.

= 5.3.2 – October 17, 2025
* Fixed critical cart error preventing checkout when delivery address is incomplete.
Added validation to ensure all required address fields (country, state, postcode, city, address) are present before calling ShipLogic API.
This resolves the “400 Bad Request response: the delivery address is missing” error that occurred when:
– New visitors added items to cart without being logged in.
– Users viewed cart before completing their shipping address.
– Customers attempted to proceed to checkout with incomplete address information.

= 5.3.1 – October 17, 2025
* Fixed critical error when using the WooCommerce admin order “Recalculate” button with The Courier Guy plugin enabled.
The plugin now skips the ShipLogic API call if required shipping rates are missing.

= 5.3.0 – October 15, 2025
* Introduce WooCommerce Blocks support.

= 5.2.0 – October 08, 2025
* WooCommerce order ID now included on the waybill for reference.
* Resolved the plugin text domain issue that caused admin panel warnings.

= 5.1.5 – August 05, 2025
* Maintenance update to align with WordPress Code Standards.

= 5.1.4 – July 16, 2025
* Resolved an issue that caused an infinite loop on certain sites when retrieving cart totals.

= 5.1.3 – June 19, 2025
* Changed insurance to not be included in free shipping.

= 5.1.2 – July 22, 2024
* Guzzle HTTP upgrade.

= 5.1.1 – June 11, 2024
* Tested with WooCommerce 8.9.3 and WordPress 6.5.4.
* General fixes.
* New waybill parcel description changes.
* Fix bug with WooCommerce recalculate shipping button.

= 5.1.0 – November 14, 2023
* Tested with WooCommerce 8.2.2 and WordPress 6.4.
* Fix issues with free shipping after coupons have been applied.
* “Access Token” label changed to “API Key”.
* Add IND rate support.
* Add support for HPOS.
* Amend liability insurance instructions.
* Add notice about blocks compatibility with method box and liability insurance.
* Add notice about dimensions being in CM and weight in KG.
* Fix undefined array key error.
* Add “Return TCG Shipment” feature.

= 5.0.9 – July 12, 2023
* Tested with WooCommerce 7.8.2 and WordPress 6.2.
* Add Currency Converter Support.
* Add Currency to Shipping Meta.
* Add Shop Contact Name.
* Add WooCommerce Blocks support.
* Add support for new API keys and deprecate legacy API keys (AWS v4 key).
* Bug fixes and improvements.

= 5.0.8 – June 02, 2022
* Tested with WooCommerce 6.5.1 and WordPress 6.0.
* Throw error on an empty cart.
* Improve prohibited product handling.
* Fix parcel description not sent to the portal.
* Fix Billing Phone not sent to the portal.
* Fix Company Name not sent to the portal.
* Fix Street Addresses sent to the portal.
* Fix inflated insurance added to shipping quote.
* Fix payments going through with no available shipping methods.
* Improve the compatibility of “Send to Courier Guy” and “Print WayBill”.

= 5.0.7 – January 28, 2022
* Tested with WordPress 5.9
* Bug fixes and improvements.
* Re-enable generic description feature.

= 5.0.6 – January 25, 2022
* Remove rate descriptions from checkout.
* Fix price override tax calculations.
* Fix LSF booking as ‘ECO’.
* Add option to enable/disable insurance.

= 5.0.5 – January 17, 2022
* Bug fixes and improvements.
* Fix undefined offset error.
* Fix VAT and tax.
* Fix empty quote warning.
* Fix Province/State on older WooCommerce.
* Fix invalid type issue.

= 5.0.4 – January 7, 2022
* Bug fixes and improvements.
* Fix “Always pack as single parcel” logic.
* Add “Enable specific shipping options” feature.
* Remove “Disable Shipping Options” as this is now redundant.
* Remove “The Courier Guy PUDO: Fuel charge” from exclude rates.
* Add “Rates for free Shipping” feature.
* Update “Send Order to Courier Guy” and “Print Waybill” for recent ShipLogic API changes.

= 5.0.3 – January 1, 2022
* Add additional rates to rate override features.

= 5.0.2 – December 30, 2021
* Fix percentage markup.
* Add Disable Shipping Options feature.
* Add Exclude Rates feature.
* Add Price Rate Override Per Service feature.
* Label Override Per Service feature.
* Fix warnings on datatypes for some server configurations.

= 5.0.1 – December 28, 2021
* Fix shipping options auto-selecting.
* Normalise weight to KG if config set to other weight units.
* Fix Uncaught TypeError: class TCG_Plugin does not have a method “updateTCGServiceOnOrder”

= 5.0.0 – December 27, 2021
* Initial version using Ship Logic API. PLEASE CONTACT TCG DIRECTLY BEFORE UPDATING.

= 4.5.4 – November 18, 2021
* Fix free shipping error on multi-box.
* Improve logic to prevent area/suburb field from being skipped.
* Add server side filtering of rates when method box is enabled.
* Fix undefined operand issue on items without dimensions.
* Change apiToken storage to use transient.
* Reduce potential of hanging on checkout.
* Improve items per box algorithm.
* Tested on WooCommerce 5.9.0.

= 4.5.0 – August 30, 2021
* Fix free shipping for product when “free shipping over a certain amount” is disabled.
* Make entire label clickable for method box feature.
* Fix failed to open stream for .htaccess.setup.
* Tested on WooCommerce 5.6.0.

= 4.4.9 – August 5, 2021
* Fix undefined index ‘enablenonstandardpackingbox’ warning.
* Encrypt waybill number name on the filesystem.
* Improve non-standard algorithm for single-product parcels.

= 4.4.8 – July 27, 2021
* Revert to using local storage of waybills but include htaccess file.
* Fix LSF showing up if cart is non-flyer compatible.
* Tested with WordPress 5.8 and WooCommerce 5.5.2
* Improve alternate method calculations.

= 4.4.7 – June 28, 2021
* Fix rate filter error on WCMP.
* Add ‘Use non-standard packing algorithm’ option for improved quotes.
* Remove local caching of Waybills for better POPI compliance.
* Add “specinstruction” so customer order notes appear on waybill.
* Improve code format and refactor.
* Test on WooCommerce 5.4.1

= 4.4.6 – June 15, 2021
* Fix incorrect weight calculation.
* Add “SPX : Special Trip” to rate options.

= 4.4.5 – June 11, 2021
* Fix ‘actmass’ per parcel when multiple items of the same product.

= 4.4.4 – June 11, 2021
* Fix Undefined variable: bestFitIndex.
* Fix Province/State fixed width of 1px when method box is enabled.
* Show “Deliver to a different address?” checkbox when method box is disabled.
* Fix JSON decode array/stdclass issue in TCG_Plugin.php.

= 4.4.3 – May 15, 2021
* Fix issue where destperemail was not sent to TCG.

= 4.4.2 – May 13, 2021
* Fix Undefined index: error.
* Tested with WordPress 5.7.2 and WooCommerce 5.3.0

= 4.4.1 – May 11, 2021
* Refactor product pooling for more efficient resource handling.
* Remove flyer services if parcel size too large.
* Add support for failures caused by long URIs sent.

= 4.4.0 – Apr 23, 2021
* Add exclude cartage from free shipping feature.
* Add disclaimer feature.
* Always select free shipping if present.
* Add 3 more custom parcel sizes.
* Fix customer name missing from destpers field if Company empty.
* Tested with WooCommerce 5.
* Remove pre-populate javascript implementation.
* Improve quote caching reset and reliability.
* Fix the “Prohibit The Courier Guy” function for variable products.
* Add (cm) to parcel dimensions titles.
* Improve product box calculations by adding the ‘pool products’ capability.
* Fix logging when getting a quote.
* Fix Internet Explorer 11 checkout issue.

= 4.3.5 – Feb 10, 2021
* Fix Fatal error: Uncaught Error: Unsupported operand types in /wp-content/plugins/the-courier-guy/Core/ParcelPerfectApiPayload.php:728 on some servers.
* Fix destpercell field to use order billing phone.
* Add ‘Send to Courier Guy’ and ‘Print Waybill’ to action items.
* Remove “Percentage for free Shipping”.

= 4.3.4 – Jan 25, 2021
* Tested with WooCommerce 4.9.1 and WordPress 5.6.
* Improve area/suburb field handing.
* Fix extra line added to WayBill.
* Change Monolog to the WooCommerce Logger.
* Don’t stop checkout if shipping internationally.
* Improve product parcel calculations.
* Change the default flyer sizes.
* Add pool products capability.

= 4.3.3 – Nov 16, 2020
* Add cache buster.

= 4.3.2 – Nov 16, 2020
* Fix ‘CRITICAL syntax error, unexpected ” (T_ENCAPSED_AND_WHITESPACE)’ issue.

= 4.3.1 – Nov 16, 2020
* Add ‘Prohibit The Courier Guy’ in product settings if cart contains this product.
* Add Shipping Selector feature.
* Fix consistent naming of session variable and general tidy-up.
* Pre-populate city area in billing.

= 4.3.0 – Oct 23, 2020
* PLEASE NOTE: If you use a multivendor platform, please test the integration thoroughly after updating.
* Fix SyntaxError: JSON Parse error: Unrecognized token ‘<.
* Fix undefined index warnings.
* Force cart reload in shipping field change.

= 4.2.9 – Oct 12, 2020
* Add option for single product per parcel at the product level.
* Add option to remove lowest cost quotes in multi vendor.
* Improve handling of failed POST requests to Parcel Perfect quotes.
* Fix TCG VAT total added when using free shipping feature.
* Fix free shipping bug in multi vendor plugin.
* Fix missing instance_id for some third party plugins.
* Remove use of cookies which caused failures on large orders and in multi vendor.
* Remove LOF Only Service.

= 4.2.8 – Sep 25, 2020
* PLEASE NOTE: Parcel sizes are based on your packaging structure. The plugin will compare the cart’s total dimensions against “Flyer”, “Medium” and “Large” parcel sizes to determine the best fit. The resulting calculation will be submitted to The Courier Guy as using the parcel’s dimensions. By downloading and using this plugin, you accept that incorrect ‘Parcel Size’ settings may cause quotes to be inaccurate, and The Courier Guy will not be responsible for these inaccurate quotes.
* Amend shipping calculations to account for the entire order rather than individual line items.

= 4.2.7 – Sep 16, 2020
* Fix session_set error on some servers.
* Fix Invalid Product error for variable products.

= 4.2.6 – Sep 11, 2020
* Correct for index name changes in $package when using multivendor package.
* Simplify order shipping calculations and configuration.
* Remove product parcel settings.
* Remove global product quantity setting.
* Fix undefined index errors.
* Change payload calculation method for new sizes.
* Add customer phone on destpercell.

= 4.2.5 – Aug 25, 2020
* First try order meta to find shipping total, otherwise try the session, and if that fails, fallback to the cookie.
* Fix issue on guest checkout where the customer name was lost on waybill.

= 4.2.4 – Aug 12, 2020
* PLEASE NOTE: Print pending waybills before updating.
* Make insurance on checkout optional.
* Fix “An error of type E_ERROR”.
* Remove old barcode and dompdf libraries.
* Show “Print Waybill” and “Send Order to Courier Guy” as appropriate.
* Add backup Cookie method if shipping missing from session.
* Fix “Undefined index: billing_insurance”.
* Add option for generic product description on waybill.

= 4.2.3 – Aug 05, 2020
* Fix Call to undefined method ParcelPerfectApiPayload::factorise() if settings not configured.
* Improve ambiguous label “South Africa Only” -> “Ship internationally using other carriers”.
* Waybill in email invalid if ‘collect from courier guy’ is not enabled.

= 4.2.2 – Jul 31, 2020
* Fix malformed number error.
* Use WC() session rather than $_SESSION to fix missing shipping information on orders.
* Fix null string issue.
* Add NFS service.
* Fix variable product calculations.
* Make shipping insurance on checkout optional.

= 4.2.1 – Jul 29, 2020
* Remove delivery date selection from checkout.

= 4.2.0 – Jul 25, 2020
* Add conditional free shipping feature.
* Add custom label and location for suburb area field.
* Fix shipment notifications.
* Fix parcel size, volume and weight calculations.
* Add parcel dimension configuration at both global and product levels.
* Add order id as WayBill reference.
* Add order notes for Parcel Perfect endpoint queries.
* Problem of variable products not calculating resolved with new methods.
* Adjust Waybill position and add clickable link in emails.
* Fix deprecated code warnings.
* Fix PHP missing index warnings.
* Fix collections submitted for the following day.
* Fix contact number is present where the name is supposed to go.
* Add option: If free shipping is active, remove all other shipping methods from checkout.
* Add option: Enable free shipping if selected products are in the cart.
* Add option: Enable free shipping if shipping total is a selected percentage of the total order value.
* Added VAT option for TCG shipping.

= 4.2.1 – November 28, 2020
* Change monolog to WC_Logger