NES Ciudades y Departamentos de Colombia

By nesgallego

10+ active installationsVersion 1.0.1

Enhances the WooCommerce checkout experience for Colombian customers by replacing state and city text fields with dynamic dropdown lists.

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

  1. The plugin automatically detects when the selected country is Colombia
  2. Converts state and city fields into dropdown lists
  3. When a department is selected, the city list updates automatically
  4. Works for both billing and shipping addresses
  5. 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

  1. Go to Plugins > Add New in your WordPress admin
  2. Search for “NES Ciudades y Departamentos de Colombia”
  3. Click “Install Now”
  4. Activate the plugin
  5. Ready! The plugin works automatically

Manual Installation

  1. Download the plugin ZIP file
  2. Go to Plugins > Add New > Upload Plugin
  3. Select the ZIP file and click “Install Now”
  4. Activate the plugin

FTP Installation

  1. Extract the ZIP file
  2. Upload the nes-ciudades-y-departamentos-de-colombia folder to /wp-content/plugins/
  3. 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_cities and nesciudde_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