Description
NES Ciudades y Departamentos de Colombia improves the checkout process in WooCommerce for Colombian customers by providing organized dropdown lists for departments (states) and cities. The city list automatically updates based on the selected department.
Key Features
- Complete list of 33 Colombian departments
- Over 1,100 cities and municipalities
- Compatible with WooCommerce Blocks (block checkout)
- Compatible with classic WooCommerce checkout
- Dynamic city updates via AJAX (classic checkout)
- Compatible with WooCommerce High-Performance Order Storage (HPOS)
- Clean, user-friendly interface
- No configuration required
- Translation ready
How It Works
- The plugin automatically detects when the selected country is Colombia
- Converts state and city fields into dropdown lists
- When a department is selected, the city list updates automatically
- Works for both billing and shipping addresses
- Compatible with account and address pages
Benefits
- Better User Experience: Customers can easily select their location without typos
- Consistent Data: Standardized information for analytics and shipping
- Zero Configuration: Works immediately after activation
Compatibility
- WordPress 5.8 or higher (tested up to 7.1)
- WooCommerce 5.0 or higher (tested up to 11.3)
- WooCommerce Blocks / Cart & Checkout blocks
- PHP 7.4 or higher
- All modern browsers
For Developers
The plugin offers hooks and filters for customization:
// Modify city list for a department (state code as second argument)
add_filter( 'nesciudde_cities', 'my_custom_cities', 10, 2 );
// Modify department list
add_filter( 'nesciudde_states', 'my_custom_states' );
For more information, visit the plugin page.
Credits
Developed by Nes Gallego.
Department and city data based on Colombia’s official territorial structure.
Installation
Automatic Installation
- Go to Plugins > Add New in your WordPress admin
- Search for “NES Ciudades y Departamentos de Colombia”
- Click “Install Now”
- Activate the plugin
- Ready! The plugin works automatically
Manual Installation
- Download the plugin ZIP file
- Go to Plugins > Add New > Upload Plugin
- Select the ZIP file and click “Install Now”
- Activate the plugin
FTP Installation
- Extract the ZIP file
- Upload the
nes-ciudades-y-departamentos-de-colombiafolder to/wp-content/plugins/ - Activate the plugin from the Plugins menu in WordPress
After Activation
No configuration required. The plugin works automatically when:
– WooCommerce is active
– The country selected at checkout is Colombia (CO)
FAQ
Does this work with WooCommerce Blocks?
Yes. The plugin supports both the classic WooCommerce checkout and the block-based checkout.
Can I modify the city list?
Yes. Use the nesciudde_cities filter, or edit includes/data-places-CO.php.
Does it affect site performance?
The classic checkout loads cities on demand via AJAX. The block checkout receives the places map once with the page scripts.
Is it translation ready?
Yes. The plugin is internationalized and includes a .pot file.
Is it compatible with HPOS?
Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage.
How do I get support?
For public support, please use the plugin support forum on WordPress.org:
https://wordpress.org/support/plugin/nes-ciudades-y-departamentos-de-colombia/
You can also contact the author by email at hello@nesgallego.com or visit https://nesgallego.com/.
Screenshots
Changelog
1.0.1
- Declared compatibility with WooCommerce HPOS and Cart/Checkout blocks
- Applied Colombia country checks to billing and shipping field filters
- Implemented documented filters
nesciudde_citiesandnesciudde_states - Removed always-on console logging in Blocks script (debug mode only)
- Reduced Blocks polling fallback and improved field selectors
- Fixed classic checkout default city option label
- Fixed classic checkout city dropdown refresh with SelectWoo/Select2
- Updated WordPress tested up to 7.1 and WooCommerce tested up to 11.3
1.0.0
- Initial release
- Support for 33 Colombian departments
- Over 1,100 cities included
- WooCommerce Blocks compatibility
- Classic checkout compatibility
- Dynamic AJAX city loading


