![States, Cities, and Places for WooCommerce Plugin banner](https://github.com/chitezh/woocommerce_states_places/raw/master/assets/banner-1544x500.png)
States, Cities, and Places for WooCommerce
- Stable tag: 1.3.2
- Requires at least: 4.0
- Tested up to: 5.9
- Requires PHP: 7.0
- WC requires at least: 3.0.x
- WC tested up to: 5.6
- License: GPLv2 or later
- License URI: http://www.gnu.org/licenses/gpl-2.0.html
This plugin adds locations of available countries (see list below) to the State and City fields of the WooCommerce address forms, making the fields filterable to enhance the user experience.
Additionally it adds the States to the Shipping Zones (Cities are not compatible with this area).
Supported Countries
- ๐ฉ๐ฟ Algeria
- ๐ฆ๐บ Australia
- ๐ง๐ญ Bahrain
- ๐ง๐ฉ Bangladesh
- ๐ง๐ง Barbados
- ๐ง๐ด Bolivia
- ๐ง๐ท Brazil
- ๐ง๐ซ Burkina Faso
- ๐จ๐ฑ Chile
- ๐จ๐ด Colombia
- ๐จ๐บ Cuba
- ๐ฉ๐ฐ Denmark
- ๐ฉ๐ด Dominican Republic
- ๐ช๐จ Ecuador
- ๐ช๐ฌ Egypt
- ๐ธ๐ป El Salvador
- ๐ฌ๐ญ Ghana
- ๐ฌ๐น Guatemala
- ๐ญ๐น Haiti
- ๐ญ๐ณ Honduras
- ๐ฎ๐น Italy
- ๐ฐ๐ฟ Kazakhstan
- ๐ฐ๐ท South Korea
- ๐ฐ๐ผ Kuwait
- ๐ฑ๐ง Lebanon
- ๐ฒ๐พ Malaysia
- ๐ฒ๐บ Mauritius
- ๐ฒ๐ฝ Mexico
- ๐ณ๐ฎ Nicaragua
- ๐ณ๐ช Niger
- ๐ณ๐ฌ Nigeria
- ๐ด๐ฒ Oman
- ๐ต๐ฐ Pakistan
- ๐ต๐ฆ Panama
- ๐ต๐พ Paraguay
- ๐ต๐ช Peru
- ๐ต๐น Portugal
- ๐ท๐ด Romania
- ๐ท๐บ Russia
- ๐ธ๐ฆ Saudi Arabia
- ๐ช๐ธ Spain
- ๐ฑ๐ฐ Sri Lanka
- ๐น๐ณ Tunisia
- ๐น๐ท Turkey
- ๐ฆ๐ช United Arab Emirates
- ๐บ๐พ Uruguay
- ๐ป๐ช Venezuela
- ๐ป๐ณ Vietnam
- Do you want to add your country here?
Help us extending this list adding your country.
Plugin Demo Site
If you want to see the plugin in action, follow the steps below:
- Visit the plugin demo site: https://wcstatesandcities.yordansoar.es/
- Select a sample product from the list.
- Go to the Checkout to interact with available country locations.
Available filter hooks
States, Cities, and Places for WooCommerce has two filter hooks for handling the States and Places in all the available countries:
scpwoo_custom_states_xx
: It allows you to handle the States of a given country. The xx
at the end must be replaced by the two-letter country code in lower case.
scpwoo_custom_places_xx
: It allows you to handle the Places of a given country. The xx
at the end must be replaced by the two-letter country code in lower case.
Please read the article Using the filter hooks to learn How to use.
Available languages
- English (US, Australia, Canada, UK, New Zealand, and South Africa)
- Spanish (Argentina, Chile, Colombia, Costa Rica, Dominican Republic, Ecuador, Guatemala, Honduras, Mexico, Peru, Puerto Rico, Spain, Uruguay, and Venezuela)
- Do you want to see your language here?
Help us translating the plugin to your language.
Screenshots
- In this screenshot you can see the plugin in action:
![Plugin in action Plugin in action](https://github.com/chitezh/woocommerce_states_places/raw/master/assets/screenshot-1.gif)
Installation
Automatic installation
- Go to your Dashboard ยป Plugins ยป Add new
- In the search form write "States, Cities, and Places for Woocommerce"
- When the search return the result, click on the Install Now button
- Finally, click on the Activate button
- Enjoy the plugin!
Manual Installation
- Download the plugin from this page clicking on the Download button
- Go to your Dashboard ยป Plugins ยป Add new
- Now select Upload Plugin button
- Click on Select file button and select the file you just download
- Click on Install Now button and the Activate Plugin
- Enjoy the plugin!
FTP Installation
- Download the plugin from this page clicking on the Download button
- Decompress the file in your desktop
- Run your FTP client software and conect to your WordPress installation
- Copy to [root folder]/wp-content/plugins/ the plugin directory you just descompress
- Go to your Dashboard ยป Plugins ยป Find the plugin and click on Activate option
- Enjoy the plugin!
Frequently Asked Questions
How do I report bugs?
Kindly create an issue stating the bug and how you caught it: Create new issue.
Can I suggest a new place or location?
Yes, you can always suggest or request new locations by creating an issue in the plugin repository in GitHub. Please refer to the Adding a new country instructions to get more details.
Contributors
Changelog
- 1.3.2 - Dec 31, 2020
- Added ten new countries:
- ๐ง๐ฉ Bangladesh: Districts and Cities (thanks to S.M. Mehdi Akram)
- ๐ง๐ซ Burkina Faso: Regions and Provinces (thanks to Stรฉphane SAMANDOULOUGOU):
- ๐จ๐บ Cuba: Provinces and Municipalities (thanks to Ramiro Rodpa)
- ๐ญ๐น Haiti: Departments and Communes (thanks to Edner Zephir)
- ๐ฒ๐พ Malaysia: States, Federal territories and Districts (thanks to Amirah Zainuddin)
- ๐ฒ๐บ Mauritius: Districts, Cities, Towns, and Regions (thanks to Audrey)
- ๐ฒ๐ฝ Mexico: States and Municipalities (thanks to Carlos Velasco)
- ๐ณ๐ช Niger: Regions and Departments (thanks to Ibrahim Nasir)
- ๐น๐ท Turkey: Provinces and Districts (thanks to Selcuk)
- ๐ป๐ณ Vietnam: Provinces and Districts (thanks to Nguyen Le)
- 1.3.1 - Dec 9, 2020
- Fix filter hook for places in Sri Lanka and Mauritius
- 1.3 - Nov 30, 2020
- Since this release you can use two new filter hooks that allows you handling both the list of States and Places:
scpwoo_custom_states_xx
: It allows you to handle the States of a given country. The xx
at the end must be replaced by the two-letter country code in lower case.
scpwoo_custom_places_xx
: It allows you to handle the Places of a given country. The xx
at the end must be replaced by the two-letter country code in lower case.
Please read the article Using the filter hooks to learn How to use.
- 1.2.11 - Oct 07, 2020
- Added four new countries:
- ๐ฆ๐บ Australia: States, Territories, and Cities (thanks to Gopinath N A)
- ๐ง๐ญ Bahrain: Parishes and Districts (thanks to Ebrahim Ahmed)
- ๐ต๐พ Paraguay: Departments and Districts.
- ๐ต๐ช Peru: Departments and Districts (thanks to David Soto)
- Updated 1 country:
- ๐ช๐ธ Spain: Updated keys from States array (thanks to Javier Esteban)
- 1.2.10 - Jul 31, 2020
- Added five new countries:
- ๐ช๐ฌ Egypt: Governorates and Cities (thanks to Heba Fareed)
- ๐ฌ๐ญ Ghana: Regions, Cities, and Towns (thanks to Edem Adjokatcher)
- ๐ฐ๐ผ Kuwait: Governorates and Districts (thanks to 3Lahoonk)
- ๐ฑ๐ง Lebanon: Provinces and Cities (thanks to Mohamad Ali Makkeh)
- ๐ฆ๐ช United Arab Emirates: Emirates and Localities (thanks to Waqas Ahmad)
- Updated 2 countries:
- ๐ฉ๐ฐ Denmark: The "State" field was deactivated and all the cities were listed in "City" field directly.
- ๐ฉ๐ฐ Denmark: Updated list of cities (thanks to jonasskafte)
- ๐ป๐ช Venezuela: Removed "Municipality" variable from places/VE.php.
- 1.2.9 - Jun 20, 2020
- Added two new countries:
- ๐ง๐ด Bolivia: Departments and Municipalities (thanks to ionixcorp)
- ๐ฉ๐ด Dominican Republic: Provinces and Municipalities (thanks to Javier Molina)
- Fixed: Algeria did not display the cities (thanks to @yas-se for reporting)
- 1.2.8 - Jun 01, 2020
- Added three new countries:
- ๐ฉ๐ฐ Denmark: Regions and Municipalities (thanks to jonasskafte for testing this country)
- ๐ญ๐ณ Honduras: Departments and Municipalities (thanks to jbermudez00)
- ๐ต๐ฐ Pakistan: Provinces, Territories and Districts (thanks to Faisal Basra)
- Updated 1 country:
- ๐ด๐ฒ Oman: Added translation support for location names (thanks to Moayid)
- 1.2.7 - May 17, 2020
- Added five new countries:
- ๐ช๐จ Ecuador: Provinces and Cantons (thanks to Franklin Lucero)
- ๐ฐ๐ฟ Kazakhstan: Regions and Districts (thanks to Iminov Anvar)
- ๐ด๐ฒ Oman: Governorates and Provinces (thanks to iAlwardi)
- ๐ท๐ด Romania: Counties and Cities (thanks to Razvan Farte)
- ๐ฑ๐ฐ Sri Lanka: Districts and Cities (thanks to Pasindu Perera)
- Updated 1 country:
- ๐จ๐ฑ Chile: removed "Regiรณn:" in State names (thanks to CLobo96)
- 1.2.6 - April 16, 2020
- Added four new countries:
- ๐ง๐ง Barbados: Parishes and Places (thanks to Damien Alleyne)
- ๐ธ๐ป El Salvador: Departments and Municipalities (thanks to ChronHeart)
- ๐ฎ๐น Italy: Provinces and Municipalities (thanks to Claudio Tegazzini)
- ๐ต๐น Portugal: Districts, Autonomous Regions and Municipalities (thanks to Javier Esteban)
- Fixed some issues with ๐ณ๐ฌ Nigeria (thanks to Ibrahim Nasir)
- Added two experimental filter hooks to Algeria (How to use):
scpwoo_custom_states_dz
- handles Provinces of Algeria
scpwoo_custom_places_dz
- handles Communes of Algeria
- 1.2.5 - April 06, 2020
- Added three new countries:
- ๐จ๐ด Colombia: Departments and Cities (thanks to Josรฉ Ayrรกm)
- ๐ธ๐ฆ Saudi Arabia: Regions and Governorates.
- ๐บ๐พ Uruguay: Departments and Cities (thanks to Alfonso Frachelle)
- Added support translation feature for location names of Algeria and Saudi Arabia.
- Added plugin page banner and icon. Thanks to Javier Esteban!
- Updated screenshot.
- 1.2.4 - March 30, 2020
- Fix an issue with a country (Algeria)
- 1.2.3 - March 22, 2020
- Added localization to "State" and "City" field labels
- 1.2.2 - March 22, 2020
- Added six new countries:
- ๐ฉ๐ฟ Algeria: Departments (Wilaya) and Municipalities (Baladiyahs) (thanks to Walid Yacine MAZED)
- ๐ง๐ท Brazil: States and Municipalities (country request - issue #35)
- ๐ณ๐ฎ Nicaragua: Departments and Cities (thanks to ahc505)
- ๐ท๐บ Russia: States and Cities (thanks to Sarge Madovsky)
- ๐ช๐ธ Spain: Provinces and Municipalities (thanks to Javier Esteban)
- ๐น๐ณ Tunisia: Governorates and Districts (thanks to Anouar Ben Saad)
- Updated 2 countries:
- ๐จ๐ฑ Chile: states codes (thanks to Luis Urrutia)
- ๐ฌ๐น Guatemala: missing municipalities (thanks to macnomo)
- Tested up to WooCommerce 4.0.1
- 1.2.1 - March 18, 2020
- Added two new countries:
- ๐ต๐ฆ Panama: Provinces, Districts and Corregimientos
- ๐ป๐ช Venezuela: States and Municipalities (with their capitals)
- Invert the order of State and City fields to have more sense with the steps of form.
- Fix text domain in plugin header comment (states-cities-and-places-for-woocommerce).
- Fix some typos and strings without translation functions.
- 1.2.0 - February 07, 2019
- Added a new country:
- ๐ฌ๐น Guatemala
- 1.1.1 - August 28, 2018
- Updated Chilean states and cities (16 states, no numbers).
- 1.1.0 - July 09, 2017
- Added a new country:
- ๐จ๐ฑ Chile
- 1.0.2 - August 11, 2016
- 1.0.1 - August 10, 2016
- 1.0 - August 10, 2016