Title: Sri Lankan Cities for WooCommerce
Author: Thushara Lakshan
Published: <strong>জুলাই 3, 2026</strong>
Last modified: জুলাই 3, 2026

---

প্লাগিনৰ সন্ধান কৰক

![](https://ps.w.org/sl-cities-woo/assets/banner-772x250.png?rev=3594909)

![](https://ps.w.org/sl-cities-woo/assets/icon-256x256.png?rev=3594909)

# Sri Lankan Cities for WooCommerce

 [Thushara Lakshan](https://profiles.wordpress.org/lakshan12/)-ৰ দ্বাৰা

[ডাউনল’ড কৰক](https://downloads.wordpress.org/plugin/sl-cities-woo.1.0.0.zip)

 * [বিশদ বিৱৰণ](https://as.wordpress.org/plugins/sl-cities-woo/#description)
 * [পৰ্য্যালোচনা](https://as.wordpress.org/plugins/sl-cities-woo/#reviews)
 *  [ইনষ্টলেশ্যন](https://as.wordpress.org/plugins/sl-cities-woo/#installation)
 * [বিকাশ](https://as.wordpress.org/plugins/sl-cities-woo/#developers)

 [সাহায্য](https://wordpress.org/support/plugin/sl-cities-woo/)

## বৰ্ণনা

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.

## স্ক্ৰীনশ্বট

[⌊Classic checkout — the required District dropdown with all 25 Sri Lankan districts.⌉⌊
Classic checkout — the required District dropdown with all 25 Sri Lankan districts
.⌉[

Classic checkout — the required District dropdown with all 25 Sri Lankan districts.

[⌊Pick a known city and the postal code fills in automatically — shipping switches
to the matching district zone.⌉⌊Pick a known city and the postal code fills in automatically—
shipping switches to the matching district zone.⌉[

Pick a known city and the postal code fills in automatically — shipping switches
to the matching district zone.

[⌊The block checkout is fully supported: district, city suggestions and postcode
autofill.⌉⌊The block checkout is fully supported: district, city suggestions and
postcode autofill.⌉[

The block checkout is fully supported: district, city suggestions and postcode autofill.

[⌊Ship by district — districts appear as regions in WooCommerce → Settings → Shipping.⌉⌊
Ship by district — districts appear as regions in WooCommerce → Settings → Shipping
.⌉[

Ship by district — districts appear as regions in WooCommerce  Settings  Shipping.

## ইনষ্টলেশ্যন

 1. Install and activate from Plugins  Add New Plugin (or upload the zip via Upload
    Plugin).
 2. WooCommerce 8.9 or newer must be active.
 3. 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_data` filter 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” হৈছে মুক্ত উৎসৰ ছফ্টৱেৰ। এইসকল লোকে এই প্লাগিনত
অৱদান আগবঢ়াইছে।

অৱদানকাৰীসকল

 *   [ Thushara Lakshan ](https://profiles.wordpress.org/lakshan12/)

[আপোনাৰ ভাষাত “Sri Lankan Cities for WooCommerce” অনুবাদ কৰক।](https://translate.wordpress.org/projects/wp-plugins/sl-cities-woo)

### বিকাশৰ প্ৰতি আগ্ৰহী?

[ক’ড ব্ৰাউজ কৰক](https://plugins.trac.wordpress.org/browser/sl-cities-woo/), [SVN ৰিপজিটৰী](https://plugins.svn.wordpress.org/sl-cities-woo/)
চাওক নাইবা [RSS](https://plugins.trac.wordpress.org/log/sl-cities-woo/?limit=100&mode=stop_on_copy&format=rss)-
দ্বাৰা [বিকাশৰ পঞ্জী](https://plugins.trac.wordpress.org/log/sl-cities-woo/) ছাবস্ক্ৰাইব
কৰক।

## সলনি-পঞ্জী

#### 1.0.0

 * Initial release: 25 districts at checkout, 288-city suggestions, postcode autofill,
   district shipping zones, classic + block checkout.

## মেটা

 *  **1.0.0** সংস্কৰণ
 *  **3 সপ্তাহ আগত** শেষবাৰ আপডে’ট হৈছিল
 *  সক্ৰিয় ইনষ্টলেশ্যন **10টাতকৈ কম**
 *  WordPress-ৰ সংস্কৰণ ** 6.5 বা তাতকৈ ওপৰৰ **
 *  ইমানলৈকে পৰীক্ষা কৰা হৈছে **7.0.2**
 *  PHP-ৰ সংস্কৰণ ** 7.4 বা তাতকৈ ওপৰৰ **
 *  ভাষা
 * [English (US)](https://wordpress.org/plugins/sl-cities-woo/)
 * [checkout](https://as.wordpress.org/plugins/tags/checkout/)[districts](https://as.wordpress.org/plugins/tags/districts/)
   [postcode](https://as.wordpress.org/plugins/tags/postcode/)[sri lanka](https://as.wordpress.org/plugins/tags/sri-lanka/)
   [woocommerce](https://as.wordpress.org/plugins/tags/woocommerce/)
 *  টেগবোৰ
 *  [উচ্চখাপৰ ভিউ](https://as.wordpress.org/plugins/sl-cities-woo/advanced/)

## ৰে’টিংবোৰ

এতিয়ালৈ কোনো পৰ্য্যালোচনা দাখিল কৰা হোৱা নাই।

[Your review](https://wordpress.org/support/plugin/sl-cities-woo/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/sl-cities-woo/reviews/)

## অৱদানকাৰীসকল

 *   [ Thushara Lakshan ](https://profiles.wordpress.org/lakshan12/)

## সাহায্য

কিবা ক’বলগীয়া আছে? সহায় লাগে?

 [সাহায্যৰ ফ’ৰাম চাওক](https://wordpress.org/support/plugin/sl-cities-woo/)