EDZNET Geolocation

Description

EDZNET Geolocation brings the EDZNET Geo API into WordPress — no configuration required beyond an API key.

Features

• Shortcode: Display visitor location anywhere with [edznet_geo] — flag, country, city, region, ISP, timezone, currency, continent, postal code, coordinates, ASN, connection type, proxy/VPN flag.
• Geo-Content Shortcodes: Show or hide content by visitor country with [edznet_geo_show country="US,CA"] and [edznet_geo_hide country="RU,CN"].
• Visitor Logging: Automatically log IP and location on comments, logins, and user registrations. Each entry shows the visitor’s country flag next to the IP. Smart caching avoids repeat lookups.
• Comment Moderation: One-click “Block IP” actions on the Comments screen.
• IP Blocklist: Block individual IP addresses or CIDR ranges from the visitor log or the Blocking page.
• IP Whitelist: Always allow specific IPs or CIDR ranges, bypassing all blocking.
• Country Blocking: Select countries to block. Visitors from blocked countries are redirected to a restricted page.
• Continent Blocking: Block entire continents (Europe, Asia, North America, etc.) in one click.
• WordPress Widget: Drag-and-drop visitor location display in any widget area.
• Gutenberg Block: Insert visitor location directly into the block editor — no shortcode needed.
• CSV Export: Export the visitor log to CSV for external analysis.
• Client-Side Caching: Visitor location is cached in the browser’s localStorage so geo-content shortcodes and blocks display immediately on repeat visits without an AJAX call.
• API Rate Limiting: The AJAX/REST endpoint has built-in rate limiting to prevent abuse.
• Usage Dashboard: Monitor your API usage — lookups used, remaining, and reset date.
• Email Alerts: Get notified when your API credits are running low.
• API Key Encryption: Your API key is encrypted at rest using WordPress salts.
• Zero IP Retention: The API processes IP addresses in real-time and discards them immediately — no IPs are logged, stored, or retained, making it fully compliant with GDPR, POPIA, and similar privacy regulations.

Shortcode Examples

Display visitor flag and country:
[edznet_geo fields=”flag,country”]

Show all available fields:
[edznet_geo fields=”flag,country,city,region,isp,timezone,currency” class=”my-geo-box”]

Available fields: flag, country, city, region, isp, timezone, currency, continent, postal, coordinates, asn, connection, proxy, currency_symbol

Geo-Content Shortcodes

Show content only to visitors from the US or Canada:
[edznet_geo_show country=”US,CA”]This content is only visible to North American visitors.[/edznet_geo_show]

Hide content from visitors in Russia and China:
[edznet_geo_hide country=”RU,CN”]This content is hidden from visitors in these countries.[/edznet_geo_hide]

These shortcodes use AJAX to look up the visitor’s location, so they work with full-page caching plugins. Content inside [edznet_geo_show] is hidden by default and revealed via JavaScript — content inside [edznet_geo_hide] is visible by default and hidden if the visitor’s country matches.

Privacy & API Key Security

Keep your key private. Your API key is tied to your account. Do not share it, embed it in client-side code (JavaScript, mobile apps), or publish it publicly. You are responsible for all usage under your key.

Fair use. Creating multiple free accounts to circumvent rate limits is a violation of our Acceptable Use Policy and may result in suspension. If you need more lookups, upgrade your API plan at edznet.io/api-services.

No IP logging. The EDZNET Geo API processes IP addresses in real-time and does not log, store, or retain them. Looked-up IPs are discarded immediately after the response is sent. This makes the API fully compliant with GDPR, POPIA, and similar privacy regulations. The plugin itself caches lookup results locally (in your WordPress database) for 30 days to reduce API calls, but this data never leaves your server after the initial lookup.

External Services

This plugin uses the EDZNET Geo API, operated by EDZNET, to perform IP geolocation lookups (country, region, city, coordinates, ISP, timezone, ASN, connection type, proxy/VPN flags) for the shortcode, Gutenberg block, widget, visitor log, email alerts, and country/continent blocking features.

What is sent and when. When a lookup is needed (a visitor loads a page with the [edznet_geo] shortcode or a geo-content shortcode, submits a comment, logs in, registers, or the blocking feature is enabled and active), the plugin sends the visitor’s IP address and your API key to https://edznet.io/api/geo/v1/lookup. The service processes the IP in real-time and does not log, store, or retain it. Lookup results are cached locally on your server for 30 days per IP; repeat visitors are served from this cache without contacting the service.

Optional promotion submission. The admin dashboard may show an optional “Link back to EDZNET” promotion banner. If the site administrator chooses to submit a URL, the plugin sends that URL, the site URL, the submitting administrator’s email address and user ID, and the API key to https://edznet.io/api/geo/v1/promo. This submission is entirely optional and only triggered by an explicit administrator action.

Service terms. The EDZNET Geo API service is provided by EDZNET, a UK-based provider operating from ISO-certified data centres in London and Coventry, England:
* Terms of Service: https://edznet.io/terms-of-service.php
* Privacy Policy: https://edznet.io/privacy-policy.php
* Acceptable Use Policy: https://edznet.io/acceptable-use-policy.php