-
Notifications
You must be signed in to change notification settings - Fork 41
/
Copy pathreadme.txt
105 lines (79 loc) · 2.82 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
=== WC City Select ===
Contributors: mantish, rwky
Donate link: mailto:[email protected]
Tags: woocommerce, city select, cities select, city dropdown, cities dropdown
Requires at least: 4.0
Tested up to: 6.7
Stable tag: 1.0.9
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
City Select for WooCommerce. Show a dropdown select as the cities input.
== Description ==
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.
This will be shown in checkout pages, edit addresses pages and shipping calculator if it's configured that way.
### WooCommerce Cart and Checkout Blocks
This plugin is not yet compatible with Blocks.
It works using the legacy shortcodes: `[woocommerce_cart]` and `[woocommerce_checkout]`.
To make this plugin work, you can use these shortcodes instead of the blocks for your Cart and Checkout pages.
### How to add cities
A list of cities has to be loaded in the functions.php file (the plugin already includes cities from some countries).
Use `wc_city_select_cities` filter to load your cities. This is done similarly to [adding states/provinces](https://docs.woothemes.com/document/addmodify-states/).
It should be added on your functions.php or a custom plugin.
`
add_filter( 'wc_city_select_cities', 'my_cities' );
/**
* Replace XX with the country code. Instead of YYY, ZZZ use actual state codes.
*/
function my_cities( $cities ) {
$cities['XX'] = array(
'YYY' => array(
'City ',
'Another City'
),
'ZZZ' => array(
'City 3',
'City 4'
)
);
return $cities;
}
`
It's also possible to use a list of cities without grouping them by state:
`
add_filter( 'wc_city_select_cities', 'my_cities' );
function my_cities( $cities ) {
$cities['XX'] = array(
'City ',
'Another City'
);
return $cities;
}
`
### Github
Source code and contributions at [github](https://github.com/8manos/wc-city-select)
== Changelog ==
= 1.0.9 =
* Load select with only the correct cities for the Country / State
* Declare Blocks (in)compatibility
= 1.0.8 =
* Fix issue in Egypt cities file (EGDK missing)
* Declare WooCommerce HPOS compatibility
= 1.0.7 =
* Add city files for Egypt
* Update Italian cities
= 1.0.6 =
* Add support to WordPress multisite.
= 1.0.5 =
* Version bump without changes. Update if missing city files for new countries.
= 1.0.4 =
* Add city files for several countries: EC, DK, CA, CN, IT, BR, RO.
* fix warnings when using multiple countries.
= 1.0.3 =
* fix some issues when loading cities initially, that were causing warnings.
= 1.0.2 =
* fix some issues with shipping calculator and other edge cases.
* Now works with countries that have no states, only cities.
= 1.0.1 =
* select2 enhancement when available. Adds a JS version of the select dropdown.
= 1.0 =
* First release.