v1.7.0

Postcode Service 1.7.0 Release

🍰 New features

• 🇫🇷 Added French language support to the extension. French language support can be enabled in the
  backend admin panel. To upgrade your subscription to enable French language validation, see the
  pricing
  information at https://postcodeservice.com/#compare-packages.
• 🇳🇱 🇩🇪 🇧🇪 Moved Netherlands, Belgium, and Germany API calls to the latest uniform URL pattern for uniform
  error handling and debugging support.

For example, for the Netherlands, moved from API V5:

https://api.postcodeservice.com/nl/v5/find?postcode=4201KB&huisnummer=63

to V6 (uniform URL call):

https://api.postcodeservice.com/nl/v6/address-validation?zipcode=4201KB&house_number=63

See https://developers.postcodeservice.com/#netherlands-api for more details.

• Changed the internal APIs to the latest versions, resulting in code cleanup in legacy API
  validation functions.
• Restructured postcode-nl.js, postcode-be.js, postcode-de.js so that it is easier to change the
  dynamic values in the JavaScript files by using constants, which can be found in the head of the
  files.
• Updated postcode_nl.css, postcode_be.css, postcode_de.css so that the margins are better aligned
  with the default Lumen theme.
• Updated the Plugin/Model/ResourceModel/Country/CollectionPlugin.php file with the most optimal
  input fields order for Belgium, Germany, and France.
• Tested with Magento 2.4.7-beta2 and 2.4.7-beta3.

🐠 UX/UC improvements

• Changed the field order for Belgium and Germany to match the default country form-filling
  standard. For example, for Belgium and Germany, the default form input fields are zipcode ->
  city -> street -> house number. For the Netherlands, this is still zipcode -> house number.
• Changed the load delay for The Netherlands from 30 ms to instant loading.

🐞 Fixed bugs

• Fixed CSS styling bug where the dropdown list goes under input fields when there are more than the
  default 7 maximum results.
• Fixed bug where a PHP Fatal error could occur if the field order is overwritten by other
  extensions or custom code.

🐰 Release credits

• Thanks go out to the following people for contributing to this release: Tim S., Viktoria, Peter
  S., Robert

v1.6.0

Postcode Service 1.6.0 Release

New features

• Switched from Netherlands V3 API to Netherlands V5 API for quicker responses:

from:

V3: https://api.postcodeservice.com/nl/v3/getAddress?postcode=4201KB&huisnummer=63

to:

V5: https://api.postcodeservice.com/nl/v5/find?zipcode=4201KB&houseno=63
See https://developers.postcodeservice.com/#netherlands-api

• Added support for Belgium bilingual results in bilingual municipalities,
  see https://developers.postcodeservice.com/#belgium-api-GETbe-v3-zipcode-find
• Switched from Belgium V2 API to Belgium V3 API, also enabling bilingual results for zipcodes, for
  example:

V3: https://api.postcodeservice.com/be/v3/zipcode-find?zipcodezone=1050&multiresults=1

[
  {
    "zipcode": 1050,
    "city": "Brussel",
    "latitude": 50.8222854,
    "longitude": 4.3815707
  },
  {
    "zipcode": 1050,
    "city": "Bruxelles",
    "latitude": 50.8222854,
    "longitude": 4.3815707
  },
  ...
]

• Added Germany as a configuration option in the Magento Admin panel, expanding geographical
  support.
• Added Germany V1 API support in the Magento extension, for example this returns all zipcodes
  starting with 4072XX when the end-user starts typing 4072.. in the zipcode field:

https://api.postcodeservice.com/de/v1/zipcode-find?zipcodezone=4072

[
  {
    "zipcode": 40721,
    "city": "Hilden"
  },
  {
    "zipcode": 40723,
    "city": "Hilden"
  },
  {
    "zipcode": 40724,
    "city": "Hilden"
  }
]

• Added console logging and info message display when the Postcode Service API is called and an
  issue occurs, for example when the authorization is failed, improving overal debuggability. The
  code can be found in the folder view/base/web/js/postcode-handler in files postcode-nl.js
  and postcode-be.js:

if (data.error_code) {
    // show error in console
    console.error('Postcodeservice.com extension: ' + JSON.stringify(data));
    if (data.error_code > 400) {
        errorMessage = 'Could not perform address validation.';
    }
    if (data.error_code === 429) {
        errorMessage = 'Address validation temporarily unavailable.';
    }
}

• Added handling of rate limiting errors from api.postcodeservice.com in JSON format instead of
  plain text.
• Revised and updated the Magento User manual to ensure it matches the latest changes.
• Updated SECURITY.md with GitHub’s private reporting option, providing a secure channel for issue
  reporting.
• Successfully tested the extension with the new Magento 2.4.7-beta1, Magento 2.4.7-beta2,
  confirming compatibility and
  performance.

UX/UC improvements

• Substantially decreased the loading speed of the address results for the Netherlands, reducing the
  wait time from 500 milliseconds to a mere 30 milliseconds by default. This can be changed
  in postcode-nl.js,
  see comment // The last parameter is the delay in millisecond in the file.
• Similarly, decreased the loading speed of the address results for Belgium from 500 milliseconds to
  30 milliseconds for
  streets and 30 milliseconds for zipcodes by default. This can be changed in postcode-be.js, see
  twice
  the comment // Parameter for the results delay in milliseconds.
• Eliminated the redundant loading screen for Nederlands in Magento Checkout, enhancing the overall
  user experience in the vanilla Magento Luma checkout theme. You can still turn this on in the
  file postcode-api.js in the method getPostCodeNL by setting the variable showLoader: false
  to true.
• Deactivated advanced settings that were not being utilized, thereby simplifying the user
  interface.
• Added new documentation links from within the extension to the Magento User manual and underlying
  API.
• Integrated direct support form links to the Postcode Service support team in the Magento Admin
  panel, ensuring more efficient assistance when required.
• Transitioned inline SVG images to external links, resulting in a cleaner codebase and smaller svg
  files.
• Modified the external image link to align with the Postcode Service color scheme.
• Introduced explanatory text for test credentials in the Magento Admin panel to prevent confusion,
  improving user comprehension.
• Revised info messages such as Loading streets ..., Cannot find street, is it correct? to be
  more clear and consistent, enhancing
  end-user communication clarity.
• Renamed menu item in Stores -> Configuration -> Sales name from Postcode Service International
  to Postcode Service to make it more intuitive.

Fixed bugs

• Rectified a typo error in the sign-up button.
• Undertook code refactoring in tab.phtml, postcode-nl.js, postcode-be.js,
  and postcode-handler.js to improve readability and maintainability.
• Resolved a z-index/overlap issue on Belgium data fields that occurred when more than 7 results
  were returned, ensuring proper display of the result set in the checkout.
• Addressed a bug where info messages such as Loading zipcodes ... could inadvertently be copied
  into
  the postcode, street, or city field.

Language changes

• Updated the language files nl_NL.csv, be_BE.csv, and fr_FR.csv by adding new
  JavaScript and PHP output strings for improved localization support.

Release credits

• Thanks go out to the following people for contributing to this release: Robert, Tim S., Vincent,
  Erik de Groot, Viktoria and Peter S.

v1.5.5

Minor changes in contact details

v1.5.4

POSTCODENL-473 - Updated various URLs

v1.5.3

POSTCODENL-388 - code cleanup according to phpcs and calisthenics
POSTCODENL-398 - Updated logo
POSTCODENL-462 - Added validation for housenumber field
POSTCODENL-470 - Magento 2.4.6 support: Refactored usage of Zend to Laminas

v1.5.2

POSTCODENL-202 Updated README.md
POSTCODENL-391 Translations Issue #47
POSTCODENL-408, POSTCODENL-438 Visibility of street field Issue #46
POSTCODENL-409 Turn off extension
POSTCODENL-437 PHP8.1 fixes
POSTCODENL-447 PHP8.1 GuestPaymentInformationManagement::beforeSavePaymentInformation() Issue #50

v1.5.1

Plugin scopestore bugfix

V1.5.0

Added Magento 2.4.4 support
Added PHP 8.1 support

POSTCODENL-381 - Sort order fields on the payment page
POSTCODENL-379 - Divide styling files and load in the correct one
POSTCODENL-377 - added Mageplaza_OneStepCheckout support
POSTCODENL-376 - added Amasty_Checkout support
POSTCODENL-375 - disabled the advanced configuration

Refactor Frontend

• Refactor PHP fields
• Refactor knockout fields
• Refactor business logic

v1.4.1

Support toegevoegd voor 2.4.3
POSTCODENL-232 - error opgelost indien er nog geen factuuradres beschikbaar is in de checkout
POSTCODENL-284 - issue opgelost met coupons in de checkout
POSTCODENL-313 - error opgelost waarbij custom attributen ontbraken in de checkout
POSTCODENL-330 - edit-knop is weer zichtbaar voor aanpasbare adressen in de checkout

v1.4.0

Support toegevoegd voor Magento 2.3.7 en Magento 2.4.2-p1
POSTCODENL-235 - Probleem opgelost met de Mageplaza Onestepcheckout waarbij er geen apart factuuradres ingevuld kon worden.
POSTCODENL-267 - Probleem opgelost met de Mageplaza Onestepcheckout waarbij het veld straat niet zichtbaar was voor België.
POSTCODENL-255 - Probleem opgelost waarbij het huisnummer soms niet zichtbaar was bij opgeslagen verzendaddressen, optimalisaties in het laden van de verzend- en factuuradressen.
POSTCODENL-262 - Het veld stad wordt nu correct gevalideerd, en niet pas bij het plaatsen van een order.
POSTCODENL-263 - Contactgegevens support geüpdatet in de backend.
POSTCODENL-274 - Logo TIG geüpdatet.
POSTCODENL-264 - Probleem opgelost waarbij het huisnummer dubbel zichtbaar was na het annuleren van een betaling.
POSTCODENL-279 - De Postcode Service wordt nu uitgeschakeld bij de accountpagina als de extensie of een land (NL/BE) uit staat.
POSTCODENL-280 - Bij de accountpagina wordt nu goed omgegaan met het aantal ingestelde adresregels.