WC - APG City
| 开发者 | artprojectgroup |
|---|---|
| 更新时间 | 2026年11月6日 04:11 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.2 |
| 版权: | GNU General Public License v3 or later |
| 版权网址: | 版权信息 |
详情介绍:
WC - APG City adds to your WooCommerce store a new automatic city field generated from the postcode via the GeoNames API or the Google Maps API.
Features
- Fully compatible with the Checkout block in the WordPress block editor.
- Includes a local GeoNames database that is downloaded and updated monthly to improve performance and reduce external API queries.
- You can choose between the GeoNames API and the Google Maps API.
- You must add your own Google Maps API Key or GeoNames username.
- Your API credentials are never sent to the browser: every lookup is made by the server.
- You can customize the default text of the select field.
- You can customize the text of the option used to switch to a text field.
- You can block modifications to the city and province (state) fields.
- You can customize the background color of the locked fields.
- If the postcode is shared by more than one city, the customer can select the correct city name from the list returned by GeoNames or Google Maps.
- If the city is not in the list or cannot be found in either API, the customer can manually enter their city name.
- It also selects the province (state), as long as the name matches the one obtained from GeoNames or Google Maps.
- Contextual help on the settings page, explaining every setting without leaving the screen.
- English: by Art Project Group (default language).
- Spanish: by Art Project Group.
安装:
- Install the plugin in one of the following ways:
- Upload the
wc-apg-cityfolder to the/wp-content/plugins/directory via FTP. - Upload the full ZIP file via Plugins -> Add New -> Upload in the WordPress administration panel.
- Search for WC - APG City in Plugins -> Add New and click Install Now.
- Activate the plugin through the Plugins menu in the WordPress administration panel.
- Configure the plugin in WooCommerce -> City field or through the Settings link on the plugins page.
屏幕截图:
常见问题:
Is configuration needed?
Just select between the GeoNames API and the Google Maps API, and add your own Google Maps API Key or GeoNames username.
Which API is better?
It depends on many factors, but the one that has given us the best results is the GeoNames API. In any case, if no result is found in the selected API, it will search again in the other API.
Where can I get support?
WC - APG City is a free plugin. Art Project Group does not provide free technical support, but offers a paid technical support service for installation and configuration.
更新日志:
2.2.1
- The links to the website, the documentation, the donation and the support now open in the language of whoever is looking at the screen.
- Contextual help on the settings page, explaining every setting without leaving the screen.
- Fixed: on a classic checkout the city field stopped filling in, because the plugin loaded the Checkout block script instead of the classic one.
- Fixed: a fatal error on WordPress 5.0; the plugin now declares that it needs 5.1.
- The postcode import now rejects a malformed batch instead of sending a broken query.
- Code cleanup so the plugin passes the wordpress.org Plugin Check with no warnings.
- Security: the Google Maps API Key and the GeoNames username are no longer sent to the browser.
- Security: the customizable texts of the city field can no longer inject code into the checkout.
- Security: postcode and country are validated before every lookup, and lookups are rate limited per IP.
- Security: the downloaded GeoNames file is no longer publicly accessible.
- Fixed: shop managers can now save the settings.
- Fixed: the province is filled in for city names with an apostrophe, and for Austria, France and Portugal with Google Maps.
- Fixed: the province field is released when the customer types the city manually.
- Fixed: the city selector is no longer discarded on load in the Checkout block, which now also works on block themes.
- Fixed: the city field works in browsers that do not report a user agent.
- Fixed: an API outage is no longer cached as "no results".
- Fixed: the local database refills itself if its table is emptied, instead of staying empty for good.
- The city field is no longer altered in the admin area, which the plugin was never meant to change.
- Minor fixes: locked fields color, PHP notices on a fresh install, style flicker and uninstall cleanup.
- Compatible with WordPress 7.2 and WooCommerce 11.1.0.
- Minor fix.
- Minor fix.
- Text and translation fixes.
- Screenshot updated.
- Added a new field to customize the background color of locked fields.
- Minor fix.
- Added full compatibility with the Checkout block.
- New local GeoNames database with monthly import. Update sponsored by Bestway.
- General performance improvements.
- Minor fix.
- Minor fix.
- Added a new field to enter the GeoNames username.
- Complete code adaptation to the security standards required by WordPress.
- Minor fix.
- Minor fix.
- Minor fix.
- Minor fix.
- Added new functionality to block fields. Update sponsored by Gardiun.
- New JavaScript functions and controls.
- Screenshot updated.
- Header updated.
- Stylesheet updated.
- Screenshot updated.
- Minor fix.
- Two new fields have been added to customize texts.
- Minor fix.
- Minor fix.
- JavaScript issue fix.
- Minor fix.
- Minor fix.
- Minor fix.
- Minor fix.
- Minor fix.
- Minor fix.
- Added WooCommerce 3.4 compatibility.
- Header updated.
- Stylesheet updated.
- Screenshot updated.
- Minor fix.
- New screenshot.
- Added Google Maps API Key.
- Added automatic search in both APIs in case of no results in the selected API.
- Added the replacement of the select field by an input field if no results are found in either API.
- Added an option in the select field that replaces it with an input field to let the customer manually enter their city.
- Minor fixes.
- Fixed localization.
- Support for multisite installations.
- Fixed GeoNames API support.
- GeoNames API support over iThemes Security.
- Avoid running on Microsoft Internet Explorer 11 or earlier.
- Added JavaScript to My Account form fields.
- Added select field self-opening with multiple cities.
- Fixed JavaScript bugs.
- Cloning original CSS class field.
- Fixed incompatibility with websites with an SSL certificate.
- Added GeoNames API support.
- New settings screen to select the API.
- New screenshot.
- New call to Google Maps API.
- Fixed JavaScript bugs.
- Added state name selection.
- Initial version.