=== States, Cities, and Places for WooCommerce === Contributors: chitezh, yordansoares, luisurrutiaf, nobnob, joseayram Donate link: https://github.com/chitezh Tags: woocommerce, locations, states, cities, provinces, regions, departments, municipalities, districs, governorates, counties, cantons Stable tag: 1.3.1 Requires at least: 4.0 Tested up to: 5.6 Requires PHP: 7.0 WC requires at least: 3.0.x WC tested up to: 4.8 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html
WordPress plugin that shows dropdowns for State and City Select for WooCommerce.
== Description ==
This WooCommerce plugin transforms the text input for states, the city or town. With this plugin you can provide a list of states and cities to be shown as a select dropdown.
This will be shown in checkout pages, edit addresses pages, shipping calculator, etc.
= Supported Countries =
- 🇩🇿 Algeria
- 🇦🇺 Australia
- 🇧🇭 Bahrain
- 🇧🇧 Barbados
- 🇧🇴 Bolivia
- 🇧🇷 Brazil
- 🇨🇱 Chile
- 🇨🇴 Colombia
- 🇩🇰 Denmark
- 🇩🇴 Dominican Republic
- 🇪🇨 Ecuador
- 🇪🇬 Egypt
- 🇸🇻 El Salvador
- 🇬🇭 Ghana
- 🇬🇹 Guatemala
- 🇭🇳 Honduras
- 🇮🇹 Italy
- 🇰🇿 Kazakhstan
- 🇰🇼 Kuwait
- 🇱🇧 Lebanon
- 🇳🇮 Nicaragua
- 🇳🇬 Nigeria
- 🇴🇲 Oman
- 🇵🇰 Pakistan
- 🇵🇦 Panama
- 🇵🇾 Paraguay
- 🇵🇪 Peru
- 🇵🇹 Portugal
- 🇷🇴 Romania
- 🇷🇺 Russia
- 🇸🇦 Saudi Arabia
- 🇪🇸 Spain
- 🇱🇰 Sri Lanka
- 🇹🇳 Tunisia
- 🇦🇪 United Arab Emirates
- 🇺🇾 Uruguay
- 🇻🇪 Venezuela
- Do you want to add your country here? Help us extending this list adding your country.
== 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. Thexx
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. Thexx
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, Guatemala, Honduras, Mexico, Peru, Puerto Rico, Uruguay, and Venezuela)
- Do you want to see your language here? Help us translating the plugin to your language.
== 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!
== Screenshots ==
- In this screenshot you can see the plugin in action.
== 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.
== Changelog == = 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. Thexx
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. Thexx
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 Algeriascpwoo_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 translation support 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 =
- Change author name.
= 1.0.1 - August 10, 2016 =
- Updated README file.
= 1.0 - August 10, 2016 =
- First release.