Title: Sri Lankan Cities for WooCommerce Author: Thushara Lakshan Published: 3 جولای 2026 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://fa.wordpress.org/plugins/sl-cities-woo/#description) * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/sl-cities-woo/#reviews) * [نصب](https://fa.wordpress.org/plugins/sl-cities-woo/#installation) * [توسعه](https://fa.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 ](https://ps.w.org/sl-cities-woo/assets/screenshot-4.png?rev=3594909) 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** * آخرین به‌روزرسانی **1 هفته پیش** * نصب‌های فعال **کمتر از 10** * نگارش وردپرس ** 6.5 یا بالاتر ** * آزمایش‌شده تا **7.0.1** * نگارش PHP ** 7.4 یا بالاتر ** * زبان * [English (US)](https://wordpress.org/plugins/sl-cities-woo/) * برچسب * [checkout](https://fa.wordpress.org/plugins/tags/checkout/)[districts](https://fa.wordpress.org/plugins/tags/districts/) [postcode](https://fa.wordpress.org/plugins/tags/postcode/)[sri lanka](https://fa.wordpress.org/plugins/tags/sri-lanka/) [woocommerce](https://fa.wordpress.org/plugins/tags/woocommerce/) * [نمایش پیشرفته](https://fa.wordpress.org/plugins/sl-cities-woo/advanced/) ## امتیازها هنوز هیچ نقدی ارسال نشده است. [Your review](https://wordpress.org/support/plugin/sl-cities-woo/reviews/#new-post) [مشاهده همه بررسی‌ها](https://wordpress.org/support/plugin/sl-cities-woo/reviews/) ## مشارکت کنندگان * [ Thushara Lakshan ](https://profiles.wordpress.org/lakshan12/) ## پشتیبانی چیزی برای گفتن دارید؟ نیاز به کمک دارید؟ [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/sl-cities-woo/)