外掛標籤
開發者團隊
原文外掛簡介
ReactWoo Geo Core provides country-targeted content for your website. It detects a visitor’s country on your server and lets you use that result in content and rules. Country lookup uses a GeoLite2 Country database that you download with your own MaxMind account. No ReactWoo account is required for the features below.
Included:
Country detection from the GeoLite2 Country database stored on your site
Download or upload that database from the MaxMind screen
Shortcodes for country, country code, city, region, and currency
A conditional shortcode for showing content to selected countries
A REST location endpoint for front-end code, and a capabilities endpoint for discovery
The Geo Content block for the block editor
Visibility rules for country and country groups, in Elementor, the block editor, and reusable rules
PHP helpers for themes and other plugins
Optional add-ons are separate plugins. Geo Core keeps working when they are not installed. Geo Core Pro adds device, language, schedule, campaign, visitor, page, weather, audience, and full-page version targeting. Geo Commerce and WHMCS Bridge can use this plugin as their country source. Those products update themselves.
Usage
After setup, you can use Geo Core in multiple ways:
Shortcodes: [rwgc_country], [rwgc_country_code], [rwgc_currency], [rwgc_city], [rwgc_region]
Conditional shortcode: [rwgc_if country="US,CA"]Special content[/rwgc_if]
PHP helpers: rwgc_get_visitor_country(), rwgc_get_visitor_currency(), rwgc_get_visitor_data()
REST endpoints (when enabled in settings): /wp-json/reactwoo-geocore/v1/location (visitor geo; not cached; the IP address is shown only to admins), /wp-json/reactwoo-geocore/v1/capabilities (plugin discovery: event types and hooks; no visitor PII)
Gutenberg: Use the Geo Content block to show/hide content by country
Elementor (free baseline): Use Page/Popup document settings for basic show/hide by country. Classic widgets/sections use Advanced → Geo Visibility; Elementor Atomic (V4) widgets use a sibling Geo Visibility Settings section (ISO country codes and saved visibility rules).
For an in-dashboard guide, open Geo Core → Usage in wp-admin.
Country targeting uses ISO2 country codes (example: US, CA, GB) because they are stable and reliable for logic. Use country names for display text to visitors.
Example conditional content:
[rwgc_if country="US,CA"]Free shipping for North America[/rwgc_if]
External services
Geo Core runs country detection on your server. It does not call ReactWoo while a visitor page is rendering. The services below are contacted only in the cases described.
MaxMind GeoLite2
An administrator can download the GeoLite2 Country database from Integrations → MaxMind (GeoLite2).
Service: https://download.maxmind.com/geoip/databases/GeoLite2-Country/download?suffix=tar.gz
Sent: the MaxMind account ID and license key, as HTTP Basic authentication. This plugin does not send the visitor IP address to MaxMind. Country lookups use the database file stored on your server.
After that: MaxMind redirects to its file host (the host is chosen by MaxMind and can change). The plugin follows that one redirect and does not send the account ID or license key again.
When: only when an administrator starts the database update.
Terms: https://www.maxmind.com/en/geolite/eula
Privacy policy: https://www.maxmind.com/en/privacy-policy
QUIC.cloud
Optional, and off unless an administrator enables “My site uses QUIC.cloud CDN”.
Service: https://www.quic.cloud/ips-all?json
Sent: no visitor data. The plugin requests QUIC.cloud’s published list of edge IP addresses.
When: a daily background refresh while that setting is on. A copy of the list is also included with the plugin and is used if the refresh fails.
Terms: https://www.quic.cloud/terms-of-use/
Privacy policy: https://www.quic.cloud/privacy-policy/
ReactWoo API
Service: https://api.reactwoo.com
Optional AI: when a separately installed commercial add-on provides a ReactWoo license key, Geo Core can send that key and this site’s hostname to /api/v5/auth/login, then call AI routes such as /ai/health, /api/v5/ai/assistant/usage, and /api/v5/ai/geo/variant-draft. A variant draft sends the page id, title, excerpt, country code, language, and the editor’s instructions. Geo Core does not call license.reactwoo.com. Licensing for paid add-ons stays on that add-on.
Updates: the ReactWoo distribution of this plugin (not the WordPress.org build) sends the plugin slug, current version, release channel, and site hostname to /api/v5/updates/check. The WordPress.org build does not include that updater. Commercial add-ons update themselves.
When: only while an administrator uses those AI tools, or while WordPress checks for updates on the ReactWoo distribution.
Terms: https://reactwoo.com/terms-conditions/
Privacy policy: https://reactwoo.com/privacy-policy/
ReactWoo Decision Cloud
Optional. Nothing is sent until an administrator pairs the site under Integrations → ReactWoo Cloud.
Service: https://decision.reactwoo.com/api/v1
A stored legacy address of https://cloud.reactwoo.com/api/v1 is rewritten to Decision Cloud. Geo Core does not call cloud.reactwoo.com.
Pairing sends the pairing token, site URL, site name, Geo Core version, and a short plugin list (slug, version, and whether it is active).
While the site stays paired, later administrator or scheduled requests can send the site id, a manifest sync, and a health snapshot (WordPress, PHP, Geo Core, WooCommerce, and Elementor versions, plus heartbeat and queue status). Import sends local audiences, slots, variants, and rules only after an administrator clicks Import.
Visitor page rendering does not call Decision Cloud.
Terms: https://reactwoo.com/terms-conditions/
Privacy policy: https://reactwoo.com/privacy-policy/
Anonymous Cloud telemetry
Off by default. An administrator must enable “Share anonymous experience events” on the ReactWoo Cloud screen. Pairing the site does not enable it.
When it is on, and only while the site is paired, Geo Core sets a first-party cookie named rwgc_vid (a random id, about one year). It stores the event type, experience, variant, audience, and goal ids, and an optional order total. Email addresses are removed before anything is queued.
Those events are sent to Decision Cloud on a later administrator or scheduled flush. They are not sent while visitor HTML is generated.
Turning the setting off stops collection and clears rwgc_vid.
Other cookies (rwgc_returning, rwgc_rv, rwgc_ft, rwgc_st, rwgc_cc, rwgc_pv) stay on this site for detection, returning visitors, and full-page cache variation. Telemetry does not upload them.
