FAIR

Federated and Independent Repositories

WC City Select

Plugin Banner

WC City Select

by mantish

Download
Description

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.

WooCommerce Cart and Checkout Blocks

This plugin is not yet compatible with Blocks.
It works using the legacy shortcodes: [woocommerce_cart] and [woocommerce_checkout].

To make this plugin work, you can use these shortcodes instead of the blocks for your Cart and Checkout pages.

How to add cities

A list of cities has to be loaded in the functions.php file (the plugin already includes cities from some countries).

Use wc_city_select_cities filter to load your cities. This is done similarly to adding states/provinces.
It should be added on your functions.php or a custom plugin.

add_filter( 'wc_city_select_cities', 'my_cities' );
/**
 * Replace XX with the country code. Instead of YYY, ZZZ use actual  state codes.
 */
function my_cities( $cities ) {
    $cities['XX'] = array(
        'YYY' => array(
            'City ',
            'Another City'
        ),
        'ZZZ' => array(
            'City 3',
            'City 4'
        )
    );
    return $cities;
}

It’s also possible to use a list of cities without grouping them by state:

add_filter( 'wc_city_select_cities', 'my_cities' );
function my_cities( $cities ) {
    $cities['XX'] = array(
        'City ',
        'Another City'
    );
    return $cities;
}

Github

Source code and contributions at github

Good, but must be updated

By floartgraphy on November 25, 2024

It's a very good plugin, but must be updated for latest wp version. My website is loading very slow. I deactivate the plugin and works fine. I use it with woocommerce. Please update the plugin!

ESTUPENDA, EXCELENTE

By vallesierra7 on November 12, 2024

Es un plugin muy valioso, en mi caso lo es, me ayudo muchisimo, ademas el codigo para agregar las ciudades es muy facil de implementar.

Me encanto!

Lovvvve ❤

By Mahmoud Hossam (moodyhosam) on April 9, 2023

Especially after the latest update, greetings from Egypt! ❤

Love it

By kanzaw on December 20, 2019

Love it, but this should be update for the new version. it's good plugin for all users

Core function

By josemuro on December 5, 2018

It should be a core function. Thanks, great job.

Help me Please

By kr0128 on July 16, 2018

I want to add district dropdown base on the option value of city. because in your code you just get the option name as option value. i want to make it like country and states thats have a option value code. thank you!

Does a great job. Requires some, but very minimal theme editing skills.

By (frankmarion) on January 17, 2018

This plugin does exactly what you need it to do. It adds a list of cities based on country/region. Handles all of the front-end stuff for you, and does so very simply. Note: this plugin is probably best used by people who know a minimum of the basics of theme editing. If you're a pure user with no dev skills, find yourself a dev and ask them to implement it for you. If you don't find your country, you can easily create a file to handle it. May I recommend that since the author is giving away the plugin for free, if you're going to add a non-included country anyway, why not submit it to github so that he may add it to his next update? https://github.com/8manos/wc-city-select

A very good and much needed plugin

By yehudaT on March 2, 2017

I use this plugin in order to limit the cities that can be selected. Works very well and cleverly coded.

Works Fine

By vmumo on February 16, 2017

Does what it says. Now it would be great to have ability to use the Cities as Shipping Zones. Thanks.

It not working for me!

By max72 on September 3, 2016

woocommerce 2.6.3
i installed wp city select then i added this code at the end of functions.php in my theme.

in what I did wrong

Thank you very much

add_filter( 'wc_city_select_cities', 'my_cities' );

function my_cities( $cities ) {
  $cities['NG'] = array(
    'LA' => array(
        'Ikorodu',
        'Ikeja'
    ),
    'OY' => array(
        'Ibadan',
        'Saki'
    )
  );
  return $cities;
}

1.0.10

  • Update Romanian cities

1.0.9

  • Load select with only the correct cities for the Country / State
  • Declare Blocks (in)compatibility

1.0.8

  • Fix issue in Egypt cities file (EGDK missing)
  • Declare WooCommerce HPOS compatibility

1.0.7

  • Add city files for Egypt
  • Update Italian cities

1.0.6

  • Add support to WordPress multisite.

1.0.5

  • Version bump without changes. Update if missing city files for new countries.

1.0.4

  • Add city files for several countries: EC, DK, CA, CN, IT, BR, RO.
  • fix warnings when using multiple countries.

1.0.3

  • fix some issues when loading cities initially, that were causing warnings.

1.0.2

  • fix some issues with shipping calculator and other edge cases.
  • Now works with countries that have no states, only cities.

1.0.1

  • select2 enhancement when available. Adds a JS version of the select dropdown.

1.0

  • First release.
Back to top