Changelog

Mirrors CHANGELOG.md in the plugin repository.

0.1.0

Initial release.

• Reference-data import, from the plugin configuration (Run reference-data import) or with bin/console africa:reference:import: activates 26 African countries, adds 443 ISO 3166-2 regions and states, and sets ISO 4217 decimal places for 18 African currencies (XOF, XAF, RWF, UGX and others use 0 decimals, TND uses 3). See Reference data.
• Country address policies applied as data: Ghana no longer requires a postal code, Nigeria shows the state field at registration.
• The import is safe to re-run: a second run changes nothing. Currencies that are not installed are listed as Missing and never created; create them under Settings → Currencies, then run the import again.
• Merchant override field on countries, currencies, states and divisions: tick it and the import never changes that record. In the Administration it can be set on countries and currencies; states and divisions need the API.
• Optional local divisions below the state (for example Nigerian LGAs and wards), with a cascading Local division drop-down in the storefront address forms. Ships a Lagos sample.
• Optional extra address fields in registration and account address forms: nearest landmark, area / neighbourhood, directions, digital address code and local division. Saved values are kept when an address is edited by a client that does not send them.
• Optional live phone check in the address forms: the number is shown in international format, or a warning appears if it does not look valid. It never blocks the order.
• Store API endpoints for headless storefronts: GET /store-api/kmh-af/divisions/{countryIso} and POST /store-api/kmh-af/phone/normalize.
• Each capability has its own on/off switch in the plugin configuration; the storefront ones can differ per sales channel.
• Country rules setting for the expected division depth, read by the address validator. Nothing in 0.1.0 calls the validator yet, so the setting has no visible effect — see Configuration.
• Optional debug logging, per sales channel. The plugin writes no log entries yet in 0.1.0.
• Uninstalling without keeping data removes the plugin's own tables and fields; countries, states and currencies stay, so existing orders and addresses are unaffected.
• Storefront in English, German and French; Administration in English and German. Compatible with Shopware 6.6 and 6.7.

INFO

The remarks on where Merchant override can be set, on the Country rules setting having no visible effect, and on logging are added here from the 0.1.0 code; the repository changelog does not include them.