FAQ

For merchants

Does installing the plugin change my countries or currencies?

No. Installing only adds the Merchant override field and the plugin's own tables. Countries, states and currencies change when you click Run reference-data import or run bin/console africa:reference:import.

Is it safe to run the import more than once?

Yes. It only writes what differs from the dataset, so a second run reports 0 created and 0 updated. Note that "what differs" includes your own changes to the imported fields — protect those with Merchant override.

Which countries are covered?

26: Nigeria, Ghana, Kenya, South Africa, Rwanda, Egypt, Côte d'Ivoire, Senegal, Tanzania, Uganda, Ethiopia, Morocco, Algeria, Tunisia, Cameroon, DR Congo, Congo, Benin, Burkina Faso, Mali, Niger, Togo, Guinea, Djibouti, Comoros and Burundi — with 443 states and regions. Full list: Reference data.

Why are no currencies created?

A currency needs an exchange rate, and only you know the rate you want to use. A placeholder rate would misprice every product in that currency. Create the currency yourself, then run the import to fix its decimal places.

Why do XOF and XAF prices now show no decimals?

The CFA francs have no minor unit in ISO 4217. The import sets their rounding to 0 decimal places, and Shopware shows prices with the currency's decimal places.

Will the import change my exchange rates?

No. For currencies only the decimal places and rounding interval are written.

Does the import remove anything?

No. It never deletes or deactivates countries, states, currencies or divisions.

Is a postal code still required for Ghana?

Not after the import: Ghana's Postal code required and Check postal code pattern are switched off. Nigeria's postal code is optional too, and the state is shown at registration.

Are the landmark and directions printed on the delivery note?

No. In 0.1.0 they are saved with the customer's address book entry only — not on the order, its documents or emails, and not shown in the Administration. See Address fields.

Can I make the landmark field required?

Not with a setting. All extra fields are optional.

Is the digital address code (GhanaPostGPS) checked?

No. It is stored as typed; the plugin does not contact any lookup service.

Can customers pick their LGA?

Yes, in Lagos with the sample data: switch on Administrative-division hierarchy and Additive address fields, and run the import. Other states need division data added by a developer.

Does the phone check stop customers with a wrong number?

No. It shows a warning and the customer can still submit. The number is saved as typed.

Can each storefront have different settings?

The storefront features (extra address fields, local division, phone check) can be switched per sales channel. The import itself is shared — see Country rules & sales channels.

What happens to my data if I uninstall?

Imported countries, states and currency settings always stay. Local divisions, saved extra address details and the Merchant override field are deleted only if you choose not to keep the plugin's data. See Installation → Uninstalling.