Àpèjúwe
WooCommerce ships Sri Lanka with no districts and the State field hidden. This plugin makes checkout work the way Sri Lankan addresses actually work: 101, Main Street, Negombo, Gampaha, 11500, Sri Lanka.
- Adds all 25 districts as a required District dropdown, keyed by ISO 3166-2:LK codes so couriers and shipping plugins interoperate.
- Suggests cities for the selected district while the customer types — 288 verified cities across all 25 districts.
- Autofills the postal code when a known city is picked — still editable, and it never overwrites a code the customer typed themselves.
- Lets you build district-based shipping zones (WooCommerce Settings Shipping Add zone pick districts).
- Works on both the classic (shortcode) checkout and the block checkout.
Safety and design
- No external services. No data leaves your site, nothing is tracked, no account is needed.
- No AJAX endpoints, no database writes, no extra checkout fields — WooCommerce validates the district server-side automatically.
- Everything fails safe: without WooCommerce the plugin does nothing; with JavaScript blocked, the district dropdown still works and city/postcode are normal manual fields.
- Block-checkout updates go through WooCommerceÌtumọ̀ Yorùbá: ’s official wp.data store API.
Data provenance
Every autofilled postal code was verified against Sri Lanka Post and independent directories (July 2026). Cities whose codes could not be fully verified are left out — for those, the city field simply works as a plain text box.
Àwọn àwòrán ìbòjú
→ Settings Shipping.” class=”wp-image-9000004Ìtumọ̀ Yorùbá: ″ srcset=”https://i0.wp.com/ps.w.org/sl-cities-woo/assets/screenshot-4.png?rev=3594909&w=300 300w, https://i0.wp.com/ps.w.org/sl-cities-woo/assets/screenshot-4.png?rev=3594909&w=600 600w, https://i0.wp.com/ps.w.org/sl-cities-woo/assets/screenshot-4.png?rev=3594909&w=900 900w” sizes=”(max-width: 599px) 50vw, 33vw” width=”1280Ìtumọ̀ Yorùbá: ″ height=”868Ìtumọ̀ Yorùbá: ″ loading=”eager” fetchpriority=”high” decoding=”async”/>Ìgbéwọlẹ̀
- Install and activate from Plugins Add New Plugin (or upload the zip via Upload Plugin).
- WooCommerce 8.9 or newer must be active.
- Done — districts, city suggestions and postcode autofill work immediately on checkout. The plugin has no settings page of its own; the Settings link on the Plugins screen takes you to WooCommerceÌtumọ̀ Yorùbá: ’s shipping settings, where the districts appear as zone regions.
Upgrading from the code-snippet version: if you previously installed this as a snippet (FluentSnippets, a child themeÌtumọ̀ Yorùbá: ’s functions.php, or an mu-plugin file), remove that copy BEFORE activating the plugin. Both loaded at once causes a duplicate-function PHP error.
FAQ
-
How do I add my own cities?
-
Use the
slwc_city_datafilter from your child theme or a small snippet:add_filter( 'slwc_city_data', function ( $data ) { $data['LK-12']['My Village'] = '11123'; // district code => city => postcode return $data; } );District keys are ISO 3166-2:LK codes (the full list is in the District dropdown at checkout). Keep postcodes as quoted 5-digit strings — leading zeros matter.
-
Does it work with the block checkout?
-
Yes. Both the classic shortcode checkout and the block checkout are supported; block updates go through WooCommerceÌtumọ̀ Yorùbá: ’s official wp.data store API.
-
What if a customerÌtumọ̀ Yorùbá: ’s city is not in the list?
-
Nothing breaks: the city field keeps working as a normal text box and the customer types their postcode manually.
-
Can I ship by district?
-
Yes — the districts appear as regions in WooCommerce Settings Shipping Add zone, so you can price shipping per district.
Àwọn àgbéyẹ̀wò
Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.
Àwọn Olùkópa & Olùgbéejáde
“Sri Lankan Cities for WooCommerce” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.
Àwọn Olùkópa
Túmọ̀ “Sri Lankan Cities for WooCommerce” sí èdè rẹ.
Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?
Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.
Àkọsílẹ̀ àwọn àyípadà
1.0.0
- Initial release: 25 districts at checkout, 288-city suggestions, postcode autofill, district shipping zones, classic + block checkout.