{"id":40051,"date":"2015-11-11T15:01:12","date_gmt":"2015-11-11T15:01:12","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wc-city-select\/"},"modified":"2025-03-22T09:27:11","modified_gmt":"2025-03-22T09:27:11","slug":"wc-city-select","status":"publish","type":"plugin","link":"https:\/\/cl.wordpress.org\/plugins\/wc-city-select\/","author":6821063,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.10","stable_tag":"1.0.10","tested":"6.8.5","requires":"4.0","requires_php":"","requires_plugins":null,"header_name":"WC City Select","header_author":"8manos","header_description":"","assets_banners_color":"","last_updated":"2025-03-22 09:27:11","external_support_url":"","external_repository_url":"","donate_link":"mailto:paypal@8manos.com","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/wc-city-select\/","header_author_uri":"http:\/\/8manos.com","rating":4.9,"author_block_rating":0,"active_installs":3000,"downloads":44025,"num_ratings":13,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","changelog"],"tags":{"1.0":{"tag":"1.0","author":"mantish","date":"2015-11-11 15:02:11"},"1.0.1":{"tag":"1.0.1","author":"mantish","date":"2016-02-05 16:20:00"},"1.0.10":{"tag":"1.0.10","author":"mantish","date":"2025-03-22 09:27:11"},"1.0.2":{"tag":"1.0.2","author":"mantish","date":"2016-05-12 18:04:33"},"1.0.3":{"tag":"1.0.3","author":"mantish","date":"2017-11-21 23:12:34"},"1.0.4":{"tag":"1.0.4","author":"mantish","date":"2020-10-06 06:44:35"},"1.0.5":{"tag":"1.0.5","author":"mantish","date":"2021-02-21 10:21:43"},"1.0.6":{"tag":"1.0.6","author":"mantish","date":"2021-07-15 06:29:18"},"1.0.7":{"tag":"1.0.7","author":"mantish","date":"2023-04-09 10:34:16"},"1.0.8":{"tag":"1.0.8","author":"mantish","date":"2024-03-30 20:43:55"},"1.0.9":{"tag":"1.0.9","author":"mantish","date":"2024-12-15 10:21:50"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":1,"5":12},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.1","1.0.10","1.0.2","1.0.3","1.0.4","1.0.5","1.0.6","1.0.7","1.0.8","1.0.9"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[235811,64251,183734,64250,286],"plugin_category":[45],"plugin_contributors":[81969,97974],"plugin_business_model":[],"class_list":["post-40051","plugin","type-plugin","status-publish","hentry","plugin_tags-cities-dropdown","plugin_tags-cities-select","plugin_tags-city-dropdown","plugin_tags-city-select","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-mantish","plugin_contributors-rwky","plugin_committers-mantish"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/wc-city-select.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>WooCommerce uses a text input for the customers to enter the city or town. With this plugin you can provide a list of cities to be shown as a select dropdown.<\/p>\n\n<p>This will be shown in checkout pages, edit addresses pages and shipping calculator if it's configured that way.<\/p>\n\n<h3>WooCommerce Cart and Checkout Blocks<\/h3>\n\n<p>This plugin is not yet compatible with Blocks.\nIt works using the legacy shortcodes: <code>[woocommerce_cart]<\/code> and <code>[woocommerce_checkout]<\/code>.<\/p>\n\n<p>To make this plugin work, you can use these shortcodes instead of the blocks for your Cart and Checkout pages.<\/p>\n\n<h3>How to add cities<\/h3>\n\n<p>A list of cities has to be loaded in the functions.php file (the plugin already includes cities from some countries).<\/p>\n\n<p>Use <code>wc_city_select_cities<\/code> filter to load your cities. This is done similarly to <a href=\"https:\/\/docs.woothemes.com\/document\/addmodify-states\/\">adding states\/provinces<\/a>.\nIt should be added on your functions.php or a custom plugin.<\/p>\n\n<pre><code>add_filter( 'wc_city_select_cities', 'my_cities' );\n\/**\n * Replace XX with the country code. Instead of YYY, ZZZ use actual  state codes.\n *\/\nfunction my_cities( $cities ) {\n    $cities['XX'] = array(\n        'YYY' =&gt; array(\n            'City ',\n            'Another City'\n        ),\n        'ZZZ' =&gt; array(\n            'City 3',\n            'City 4'\n        )\n    );\n    return $cities;\n}\n<\/code><\/pre>\n\n<p>It's also possible to use a list of cities without grouping them by state:<\/p>\n\n<pre><code>add_filter( 'wc_city_select_cities', 'my_cities' );\nfunction my_cities( $cities ) {\n    $cities['XX'] = array(\n        'City ',\n        'Another City'\n    );\n    return $cities;\n}\n<\/code><\/pre>\n\n<h3>Github<\/h3>\n\n<p>Source code and contributions at <a href=\"https:\/\/github.com\/8manos\/wc-city-select\">github<\/a><\/p>\n\n<!--section=changelog-->\n<h4>1.0.10<\/h4>\n\n<ul>\n<li>Update Romanian cities<\/li>\n<\/ul>\n\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>Load select with only the correct cities for the Country \/ State<\/li>\n<li>Declare Blocks (in)compatibility<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Fix issue in Egypt cities file (EGDK missing)<\/li>\n<li>Declare WooCommerce HPOS compatibility<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Add city files for Egypt<\/li>\n<li>Update Italian cities<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Add support to WordPress multisite.<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Version bump without changes. Update if missing city files for new countries.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Add city files for several countries: EC, DK, CA, CN, IT, BR, RO.<\/li>\n<li>fix warnings when using multiple countries.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>fix some issues when loading cities initially, that were causing warnings.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>fix some issues with shipping calculator and other edge cases.<\/li>\n<li>Now works with countries that have no states, only cities.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>select2 enhancement when available. Adds a JS version of the select dropdown.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"City Select for WooCommerce. Show a dropdown select as the cities input.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/40051","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=40051"}],"author":[{"embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mantish"}],"wp:attachment":[{"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=40051"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=40051"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=40051"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=40051"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=40051"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=40051"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}