Опис
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’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.
Скріншоти
→ Settings Shipping.” class=”wp-image-9000004″ 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″ height=”868″ loading=”eager” fetchpriority=”high” decoding=”async”/>Встановлення
- 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’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’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.
Часті питання
-
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’s official wp.data store API.
-
What if a customer’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.
Відгуки
Для цього плагіна немає відгуків.
Учасники та розробники
“Sri Lankan Cities for WooCommerce” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:
Учасники
Перекладіть “Sri Lankan Cities for WooCommerce” на вашу мову.
Цікавитесь розробкою?
Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.
Журнал змін
1.0.0
- Initial release: 25 districts at checkout, 288-city suggestions, postcode autofill, district shipping zones, classic + block checkout.