RY City Select for WooCommerce

外掛說明

這一個外掛是基於 WC City Select 開發的

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.

After selected the city or town, auto set the postcode number if is defined.

如何新增鄉鎮市清單

A list of cities can be added in your theme functions.php file.

Use ry_wc_city_select_cities filter to load your cities.
This is done similarly to Add/Modify States.
It should be added on your functions.php or a custom plugin.

add_filter( 'ry_wc_city_select_cities', 'my_cities' );
/**
 * Replace XX with the country code. Instead of YYY, ZZZ use actual state codes.
 * The City list can list of city name with postcode or just city name.
 */
function my_cities( $cities ) {
    $cities['XX'] = array(
        'YYY' => array( // city name with postcoe
            ['City', '100'],
            ['Another City', '101']
        ),
        'ZZZ' => array( // just city name
            'City 3',
            'City 4'
        )
    );
    return $cities;
}

安裝方式

最低安裝需求

  • PHP 8.0+
  • WordPress 6.3+
  • WooCommerce 8.0+

常見問題集

在何處可以貢獻我國家的縣市清單?

請利用 GitHub 專案.
請使用 issuu 提供你的清單,或於 pull requests 提供檔案內容。

如果你的國家於 WooCommerce 中尚未有縣市的清單 ( 檔案 /woocommerce/i18n/states.php )。
你也需要貢獻縣市的清單。

範例檔案 cities/TW.php 跟 states/TW.php

在何處可以回報程式碼錯誤或為這個專案做出貢獻?

錯誤回報請於 GitHub,或者是我 個人網站上的頁面.

All cities list from http://geonames.org/

From the RY-WC-City-Select-cities-files
You can add almost main states and cities list in the world.
But some state or city may use different name with the official name.

To enable geonames.org data, add code into you theme functions.php.
Or use Code Snippets[https://wordpress.org/plugins/code-snippets/] to add code.

add_filter('ry_wcs_load_geonames_org', '__return_true');

使用者評論

2023 年 8 月 18 日
Good plugin, but the names of cities in my country Armenia are incorrect, please correct it.The list of cities in Armenia can be found on wikipedia site in the search you need to type “List of cities and towns in Armenia”it’s not much, only 49 pieces. please fix in zip archive \geonames-org-data\cities\AM.php
閱讀全部 7 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈RY City Select for WooCommerce〉的開發相關工作。

參與者

〈RY City Select for WooCommerce〉外掛目前已有 3 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈RY City Select for WooCommerce〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

2.1.0 – 2024/03/022

  • CHANGE Plugin name.

2.0.1 – 2023/08/26

  • Fixed change city maynot edit the zip code.

2.0.0 – 2023/04/23

  • CHANGE License to GPLv3.

1.1.3.1 – 2023/03/30

  • Change WordPress croe tested version info.

1.1.3 – 2023/02/13

  • Change main class name.

1.1.2 – 2022/07/16

  • Change plugin info.

1.1.1 – 2022/06-03

  • add Romanian cities. (by condor2)

1.1.0 – 2022/04/04

  • postal code clear with selected no postal code city (issuu #6)
  • change form field html style more like woocommerce

1.0.0 – 2019/12/07

  • 首次釋出。