RY City Select for WooCommerce

Plugin Banner

RY City Select for WooCommerce

by Richer Yang

Download
Description

This plubin is based on WC City Select

WooCommerce uses a text input for the customers to enter the city or town.
With this plugin you can provide a list of cities to be shown as a select dropdown.

This will be shown in checkout pages, edit addresses pages and shipping calculator if it’s configured that way.

After selected the city or town, auto set the postcode number if is defined.

How to add cities

A list of cities can be added in your theme functions.php file.

Use ry_wc_city_select_cities filter to load your cities.
This is done similarly to Add/Modify States.
It should be added on your functions.php or a custom plugin.

add_filter( 'ry_wc_city_select_cities', 'my_cities' );
/**
 * Replace XX with the country code. Instead of YYY, ZZZ use actual state codes.
 * The City list can list of city name with postcode or just city name.
 */
function my_cities( $cities ) {
    $cities['XX'] = array(
        'YYY' => array( // city name with postcoe
            ['City', '100'],
            ['Another City', '101']
        ),
        'ZZZ' => array( // just city name
            'City 3',
            'City 4'
        )
    );
    return $cities;
}

Minimum Requirements

  • PHP 8.0+
  • WordPress 6.6+
  • WooCommerce 8.0+
Where can I contribute the cities list of my country?

Please use GitHub repository.
Use issuu give me the list, or use pull requests the file change.

If your country don’t have states list in woocommerce (see file /woocommerce/i18n/states.php).
You also need contribute the states list.

The sample file is cities/TW.php and states/TW.php

Where can I report bugs or contribute to the project?

Report bugs on the GitHub repository,
or my person website page.

All cities list from http://geonames.org/

From the RY-WC-City-Select-cities-files
You can add almost main states and cities list in the world.
But some state or city may use different name with the official name.

To enable geonames.org data, add code into you theme functions.php.
Or use Code Snippets[https://wordpress.org/plugins/code-snippets/] to add code.

add_filter('ry_wcs_load_geonames_org', '__return_true');

非常棒

By millenniumlin on August 22, 2025

五顆星~

Not correct Armenian city name

By Raffi (raffie) on August 18, 2023

Good plugin, but the names of cities in my country Armenia are incorrect, please correct it.
The list of cities in Armenia can be found on wikipedia site in the search you need to type "List of cities and towns in Armenia"
it's not much, only 49 pieces. please fix in zip archive \geonames-org-data\cities\AM.php

符合台灣郵遞區號

By 田小蓉 (g618) on April 11, 2023

太感動了,裝了立即可用。

使用KadenceTheme

Excellent, marbellous plugin

By fcalabro on January 2, 2021

Thank you thank you thank you!!!

Works very well

By shivchawla on December 20, 2020

Works very well!!!

Works perfect

By Samir Rifai (srifaia) on May 29, 2020

Very easy to setup and works perfect.

Awesome!

By Mauricio Lopez Coria (damonh) on May 10, 2020

It works like a charm! Thank you!!

It works!

By curlyshrimp on April 29, 2020

謝謝你協助提供這麼佛心的外掛,裝上去立刻就可以使用,不用額外修 theme 喔!感謝你!

Really Helpful

By big26ht on February 6, 2020

Thank you so much!!!

2.1.9 – 2025/04/29

  • Change minimum requires to WordPress 6.6

2.1.8 – 2025/02/17

  • Fixed error text-domain.
  • Smaller cities name list file.

2.1.6 – 2025/02/07

  • Update language .pot file.

2.1.5 – 2025/02/07

  • Fixed the error default setting.

2.1.4 – 2025/02/04

  • Update postal code for Romania state Sibiu (#9).

2.1.3 – 2025/02/02

  • Update cities for Romania state Sibiu (#8).

2.1.2 – 2024/11/21

  • Change WordPress croe required / tested version info.
  • Change PHP required version info.

2.1.0 – 2024/03/022

  • CHANGE Plugin name.

2.0.1 – 2023/08/26

  • Fixed change city maynot edit the zip code.

2.0.0 – 2023/04/23

  • CHANGE License to GPLv3.

1.1.3.1 – 2023/03/30

  • Change WordPress croe tested version info.

1.1.3 – 2023/02/13

  • Change main class name.

1.1.2 – 2022/07/16

  • Change plugin info.

1.1.1 – 2022/06-03

  • add Romanian cities. (by condor2)

1.1.0 – 2022/04/04

  • postal code clear with selected no postal code city (issuu #6)
  • change form field html style more like woocommerce

1.0.0 – 2019/12/07

  • First release
Back to top