Portuguese Postcodes for WooCommerce changelog

7.0 – To be released

  • NEW Fix errors that occur when using Stripe Express Checkout with Apple Pay or Google Pay on websites that have the Portugal States (Distritos) for WooCommerce plugin activated. It resolves these issues by modifying the address received from Stripe (which does not include the district) to include the correct Portuguese district (state) based on the provided postcode.
  • NEW Postcode database update (313869 unique records)
  • DEV Tested with WordPress 6.9-alpha-60932 and WooCommerce 10.3.0-beta.2

6.9 – 2025-10-15

  • FIX Postcodes for PO boxes (apartados) were not being imported since version 6.6
  • DEV Add deployment GitHub actions and better WordPress Coding Standards rules
  • DEV Tested with WordPress 6.9-alpha-60932 and WooCommerce 10.3.0-beta.2

6.8 – 2025-08-08

  • FIX Incorrect postcode city values after the last update

6.7 – 2025-08-08

  • FIX Refactor database import to avoid errors while updating the new schema

6.6 – 2025-08-07

  • DEV Changes in the database structure that improve performance up to 55% on frontend queries (postcode autocomplete) and 99% on backend queries (check valid postcode on the edit order screen)
  • NEW Postcode database update (312805 unique records)
  • DEV Tested up to WordPress 6.9-alpha-60613 and WooCommerce 10.1.0-rc.2

6.5 – 2025-07-23

  • NEW Postcode database update (312676 unique records)
  • TWEAK Do not allow autocomplete mode if the license is expired
  • DEV Apply WordPress Coding Standards on all the codebase
  • DEV Updater improvements (v11.0) to check for expired licenses
  • DEV Tested up to WordPress 6.9-alpha-60497 and WooCommerce 10.0.4

6.4 – 2025-04-11

  • NEW We are now called Naked Cat Plugins 😻
  • NEW Postcode database update (312024 unique records)
  • FIX PHP notice when trying to get the district for PO boxes (apartados) postcodes
  • DEV Apply more WordPress Coding Standards
  • DEV Tested up to WooCommerce 9.8.1

6.3 – 2025-04-03

  • NEW Postcode database update (311997 unique records)
  • FIX Shipping postcode validation on the classic checkout when the shipping address is forced to be used
  • TWEAK Loading spinner CSS
  • DEV Improve updater
  • DEV Start applying WordPress Coding Standards
  • DEV Rename some files to comply with WordPress Coding Standards
  • DEV Requires WordPress 5.4 and WooCommerce 8.0
  • DEV Tested up to WordPress 6.8-RC2-60118 and WooCommerce 9.8.0-rc.1

6.2 – 2024-12-20

  • FIX Postcode search on the blocks checkout
  • DEV Tested with WordPress 6.8-alpha-59545 and WooCommerce 9.6.0-beta.1

6.1 – 2024-11-13

  • FIX Fatal error when WooCommerce is running update routines for 9.4
  • DEV License validation on websites with WPML set to have different domains per language
  • DEV Tested with WordPress 6.7 and WooCommerce 9.4.1

6.0 – 2024-10-08

  • NEW Postcode database update (311272 unique records)
  • FIX Error message positioning when editing addresses on the order backend screen
  • FIX Load text domain at the right time to avoid PHP notices on WordPress 6.7 and above
  • DEV Load main class on init instead of plugins_loaded
  • DEV Tested with WordPress 6.7-beta1-59184 and WooCommerce 9.4.0-beta.2

5.9 – 2024-09-11

  • NEW Postcode validation on the blocks checkout
  • NEW Postcode against District validation on the blocks checkout
  • FIX Shipping postcode against District validation was not working properly on the classic checkout

5.7 – 2024-09-11

  • FIX Postcode against District validation was not working properly
  • DEV Tested with 6.7-alpha-59003 and WooCommerce 9.3.0-rc.1

5.7 – 2024-08-28

  • FIX Show database update errors properly as a WordPress admin notice and provide a link to retry the update
  • DEV Tested with 6.7-alpha-58943 and WooCommerce 9.3.0-beta.1

5.6 – 2024-08-13

  • TWEAK Omit backend validation error message when the postcode field is not set
  • NEW Postcodes database update (308918 unique records)
  • DEV Add empty index.php to all folders
  • DEV Tested with 6.7-alpha-58888 and WooCommerce 9.2.0-rc.1

5.5 – 2024-05-06

  • NEW Possibility of deactivating the backend validation and warnings for incorrect postcode cities
  • NEW Postcodes database update (310856 unique records)
  • DEV Tested with 6.6-alpha-58099 and WooCommerce 8.9.0-beta.1

5.4 – 2024-04-01

  • TWEAK Add “Requires Plugins” header
  • TWEAK Delay and retry JavaScript location initialization as the form may not be available immediately
  • FIX Deprecated: Creation of dynamic property in PHP 8.3
  • NEW Postcodes database update (310748 unique records)
  • DEV Plugin updater improvements
  • DEV Tested with WordPress 6.5-RC4-57894 and WooCommerce 8.8.0-beta.1

5.3 – 2024-03-04

  • NEW Postcode autocomplete on the backend subscription edit screen (Woo Subscriptions)
  • DEV Improve plugin updater – Show translation update notices
  • NEW Postcodes database update (310716 unique records)
  • DEV Tested with WordPress 6.5-beta3-57738 and WooCommerce 8.7.0-beta.2

5.2 – 2024-01-30

  • NEW Warn about incorrect postcode or city on the order admin screen
  • TWEAK Information about validations is only available on the classic checkout, for now
  • DEV Plugin updater improvements
  • NEW Postcodes database update (310643 unique records)

5.1 – 2024-01-24

  • Feedback when the license expires
  • Tested with WordPress 6.5-alpha-57299 and WooCommerce 8.5.1

5.0 – 2023-12-13

  • Declare WooCommerce block-based Cart and Checkout compatibility
  • Add PO boxes (apartados) postcodes (no district validation or full address available)
  • Postcodes database update (311550 unique records)
  • Update plugin translations online instead of shipping them with the main plugin
  • Requires WordPress 5.4
  • Tested with WordPress 6.5-alpha-57159 and WooCommerce 8.4.0

4.2 – 2023-09-28

  • New option to validate postcodes at checkout and not allow proceeding if it doesn’t exist
  • New WooCommerce Blocks Checkout compatibility (in beta)
  • Postcodes database update (309890 unique records)
  • Tested with WordPress 6.4-beta1-56736 and WooCommerce 8.2.0-beta.1

4.1 – 2023-07-07

  • General changes to improve the new experimental autocomplete “Full address” mode:
    • Remove streets without a name so that the field is not filled with “Sem Nome”
    • Better UI on the new mode autocomplete list
    • “Know more” link, about the new mode, on the settings page
  • Fix version number

4.0 – 2023-07-06

  • New experimental autocomplete “Full address” mode in which all the address fields are pre-filled with the customer’s address details (only on the checkout)
  • Implement a locking mechanism to avoid duplicate entries on the postcodes database
  • Postcodes database update (309498 unique records)
  • Code cleanup
  • Requires WooCommerce 5.0
  • Tested with WordPress 6.3-beta3-56143 and WooCommerce 7.9.0-rc.2

3.1 – 2023-01-17

  • Postcodes database update
  • Tested with WordPress 6.2-alpha-55080 and WooCommerce 7.3

3.0 – 2022-11-14

  • Add High-Performance Order Storage compatibility
  • Fix bug on admin causing the scripts not to load
  • Postcodes database update
  • Code cleanup
  • Tested with WordPress 6.2-alpha-54748 and WooCommerce 7.1

2.3 – 2022-09-27

  • Integration with the “My Account” address edit forms
  • Postcodes database update
  • Requires WordPress 5.0 and WooCommerce 4.0 or above
  • Tested with WordPress 6.1-alpha-54043 and WooCommerce 7.0.0-beta.2

2.2 – 2021-05-07

2.1 – 2021-03-11

  • Remove debug var_dump call

2.0 – 2021-02-08

  • New option to validate the inserted postcode against the district if the Portugal States (Distritos) for WooCommerce plugin is installed
  • Postcodes database update
  • Tested with WordPress 5.7-RC3-50503 and WooCommerce 5.1.0-rc.1

1.8 – 2021-01-26

  • Loading indicator on the frontend when using the autocomplete feature
  • Postcodes database update
  • Tested with WordPress 5.7-alpha-50017 and WooCommerce 5.0.0-beta.2

1.7 – 2020-06-16

  • Better handling of postcode city names

1.6 – 2020-06-12

  • Now also triggering on the frontend shipping address
  • Postcodes database update

1.5 – 2020-05-26

  • Fix a bug that would cause the shipping recalculation to not be triggered when leaving the postcode field
  • Postcodes database update

1.4 – 2020-05-15

  • Fix Ajax URL on some installs
  • Tested with WooCommerce 4.2.0-beta.1

1.3 – 2020-05-06

  • Postcode autocomplete on the backend order edit screen
  • Javascript refactor
  • Postcodes database update

1.2 – 2020-05-05

  • Better handling of the database import, to avoid duplicates (thanks adegga.com)

1.1 – 2020-05-04

  • Fix autocomplete on the Flatsome theme
  • Some javascript debug via console.log() when WP_DEBUG is set to true

1.0 – 2020-05-03

  • First stable release
  • Autocomplete mode (as default)

0.9 – 2020-05-02

  • First beta release