=== Colciudades - Ciudades de Colombia para el Checkout ===
Contributors: davidzoque
Tags: colombia, block checkout, shipping, cities
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

City dropdown by department for the WooCommerce block checkout, plus per-city shipping. Built for Colombia.

== Description ==

**Works in the block checkout, not only the classic one.** WooCommerce shows Colombia's 33 departments at checkout, but the City field is left as free text. Classic-checkout plugins turn it into a dependent dropdown, but none work in the new **block checkout** (the React based one). This plugin does, and it also adds per-city shipping.

* City dropdown that depends on the selected department, in the WooCommerce **block checkout** (works for both shipping and billing addresses).
* Adds a **per-city shipping method** (based on flat rate): pick the cities and a cost inside a zone, with an option to hide the other methods when it applies. The city selector is a search box.
* Bundles Colombia's **1,104 official municipalities** (DANE), with correct accents.
* Uses WooCommerce's native departments (ISO 3166-2). **No other plugin required.**
* Saves the value in the standard `city` field, so shipping, taxes and the invoice get it unchanged.
* Compatible with HPOS and the cart/checkout blocks. Translation ready, with Spanish included.

== Installation ==

Upload the `colciudades` folder to `/wp-content/plugins/` (or install the ZIP from Plugins > Add New > Upload Plugin), then activate it. Make sure WooCommerce is active and that you use the block Checkout. For per-city shipping, go to WooCommerce > Settings > Shipping, add the "Shipping by city (Colombia)" method to a zone, and pick the cities and the cost.

== Frequently Asked Questions ==

= Do I need another "Colombia departments and cities" plugin? =

No. It uses WooCommerce's own departments plus its own municipality list and its own per-city shipping.

= Does it work in the classic checkout? =

The city dropdown targets the **block checkout**. The per-city shipping method works in both, because it is a standard WooCommerce shipping method.

= A customer's town is not in the list =

The list has the official DANE municipalities. You can add values with the `colciu_ciudades` filter.

== Screenshots ==

1. The City field turned into a department-dependent dropdown in the block checkout.
2. The "Shipping by city (Colombia)" method with the searchable city selector and the cost.

== Changelog ==

= 1.0.1 =
* City label position fix on some themes.
* Per-city shipping method with a searchable city selector, and support for country-level zones.
* Translation ready, with Spanish included.

= 1.0.0 =
* Initial release: department-dependent city dropdown in the block checkout, and per-city shipping method.

== Upgrade Notice ==

= 1.0.1 =
Searchable city selector and per-city shipping improvements.

== Credits ==

The municipality list is built from the open-source "colombia-json" dataset by Marco Vega (https://github.com/marcovega/colombia-json), available under the MIT license, based on official DANE (public domain) data.
