# Epic Geo Blocker Marketplace Copy Pack

Prepared for owner review only. This copy pack does not publish the product, enable checkout, approve pricing, or mark Epic Geo Blocker sale-ready.

## Marketplace Title

**Epic Geo Blocker — Country Blocklist & Allowlist Controls for WordPress**

## Short Description

Control country-level access to WordPress with **Blocklist mode**, **Allowlist mode**, a safe **Live test (your connection)** panel, **Recent blocked requests** logs, **Download CSV** exports, and a styled **403 Access Denied** screen backed by Epic Works licensing and updates.

## Product Card

- Product: **Epic Geo Blocker**
- Version/build evidence: `EGB_VERSION` 1.3.3; `EGB_BUILD_NUMBER` 2026-06-11-004
- Suggested owner-review card pricing: **$49 Lifetime** for the approved 3-site card; remaining tiers stay pending owner review
- Customer path/CTA: `/shop/epic-geo-blocker/`
- Portal handoff: `https://portal.epicworksstudio.com/login`
- Status: owner-review storefront asset package only; no product publication performed

## Long Description

Epic Geo Blocker helps WordPress site owners and agencies manage region-based access rules without turning the product into a firewall, WAF, or compliance automation tool. Buyers can configure a selected country list and choose whether that list should block traffic or allow only selected countries. The plugin keeps logged-in admins safe from lockout, skips admin screens, AJAX, and cron before front-end blocking, and lets site owners verify their current connection before relying on the rule set.

When a visitor is denied, Epic Geo Blocker displays a styled front-end **403 Access Denied** / access-denied-for-your-region screen with site-owner contact context. The admin workflow includes a country picker, rule-mode controls, a live connection check, recent blocked-request evidence, CSV export, and clear-log controls for routine review.

Epic Geo Blocker is integrated with Epic Works fulfillment. The **License & Updates** area supports Activate License, Validate License, Deactivate License, Check for Updates, Customer Downloads, broker connectivity, native WordPress update checks, and customer portal handoff through the standard Epic Works license/update endpoints.

## Feature Bullets

- **Blocklist mode**: deny visitors from selected countries while allowing other detected traffic.
- **Allowlist mode**: serve only selected countries and deny everyone else.
- **Live test (your connection)** panel for checking the current connection against configured rules.
- **Recent blocked requests** table for time, IP, country, rule mode, result, URL, and user-agent evidence.
- **Download CSV** export with headers: `Time`, `IP`, `Country`, `Rule Mode`, `Result`, `URL`, `User Agent`.
- Styled **403 Access Denied** front-end response for blocked regional access.
- Admin safety boundaries: logged-in admins are never blocked; admin screens, AJAX, and cron are skipped before front-end blocking.
- Country lookup caching for 24 hours, with source-coded allow-on-detection-failure behavior rather than claims of perfect geolocation enforcement.
- **License & Updates** integration with Epic Works broker endpoints and customer downloads.
- Dark/Light Epic Works admin theme styling in build `EGB_BUILD_NUMBER` 2026-06-11-004.

## Buyer-Facing Value Propositions

1. **Simple regional access policy:** choose countries and switch between allowlist and blocklist behavior without custom code.
2. **Safer administration:** admin screens and logged-in admins are protected from accidental lockout by source-coded bypasses.
3. **Reviewable activity:** Recent blocked requests and CSV export give owners a practical audit trail for rule reviews.
4. **Clear visitor messaging:** blocked visitors see a styled 403 page instead of a silent failure.
5. **Managed delivery:** license activation, updates, and customer downloads connect through Epic Works fulfillment.

## Suggested Marketplace Highlights

- Country allow/block rules for WordPress storefronts, memberships, content sites, and agency-managed properties.
- Live connection check before relying on a country rule set.
- Exportable blocked-request logs for owner review.
- Customer portal/download/update handoff through Epic Works.
- Lifetime-update positioning only after owner approval; current card copy uses **$49 Lifetime** as owner-review pricing language.

## Screenshot / Visual Asset Checklist

Current staged SVG assets are present and should be used with safe demo data only:

- `assets/images/product-screenshots/epic-geo-blocker/geo-blocker-dashboard-overview.svg` — dashboard overview with rule modes and live test context.
- `assets/images/product-screenshots/epic-geo-blocker/geo-blocker-settings-workflow.svg` — country/rule configuration workflow.
- `assets/images/product-screenshots/epic-geo-blocker/geo-blocker-result-state.svg` — recent blocked requests, CSV export, and 403 result state.
- `assets/images/product-screenshots/epic-geo-blocker/geo-blocker-hero-thumbnail.svg` — hero/thumbnail for storefront cards.
- `assets/images/product-mockups/epic-geo-blocker-mockup.svg` — legacy product mockup available as secondary/backup art.

Screenshot safety: use demo-only IP addresses such as documentation ranges, staged URLs, and sanitized text. Show **no real customer IP addresses**, private locations, license keys, API tokens, passwords, production customer URLs, or credentials.

## Support and Compliance Boundaries

- Do not describe Epic Geo Blocker as a firewall, WAF, bot detector, VPN/proxy detector, fraud-scoring engine, malware scanner, legal compliance tool, or payment/security remediation product.
- Country blocking can affect legitimate customer access and may have policy/legal implications; buyers should verify their own regional obligations before enforcing allowlists/blocklists.
- The plugin allows traffic when country detection fails; do not imply perfect geolocation enforcement.
- Do not run live geo-blocking tests against production traffic for marketplace screenshots or this owner-review package.
- No checkout enablement, product publication, sale-ready classification, payment changes, DNS changes, or customer-account creation were performed.

## Source Evidence Notes

Evidence reviewed from `D:/EpicWorks/Plugins/epic-geo-blocker/epic-geo-blocker.php`, `readme.txt`, `includes/class-epic-geo-blocker-epic-works-sdk.php`, and website docs/assets.

Source-backed markers confirmed or represented in copy:

- Product description: block or allow visitors by country using a modern Epic-style admin UI.
- Constants: `EGB_VERSION` 1.3.3 and `EGB_BUILD_NUMBER` 2026-06-11-004.
- Modes/options: `egb_mode`, `egb_countries`, `egb_auto_update`.
- Admin UI labels: **Blocklist mode**, **Allowlist mode**, **Live test (your connection)**, **Recent blocked requests**, **Download CSV**, **Clear log**.
- Block response: **403 Access Denied** and access-denied-for-your-region messaging.
- Fulfillment/update endpoints: `https://api.epicworksstudio.com/api/license`, `https://api.epicworksstudio.com/api/updates`, and `https://portal.epicworksstudio.com/downloads`.
- Customer entry point for support/portal language: `https://portal.epicworksstudio.com/login`.

## Buyer FAQ

**What happens when country detection fails?**
Epic Geo Blocker allows the request when the country lookup returns no country code. This is intentional fail-open behavior, so the copy should avoid promising perfect geolocation enforcement.

**How does the product reduce admin lockout risk?**
The front-end blocking logic skips admin screens, AJAX requests, and logged-in users before applying country rules. Buyers should still use the Live test panel and staged rule changes when changing blocklist/allowlist settings.

**Who decides whether a country should be blocked or allowed?**
The site owner is responsible for their own regional access policy. Epic Geo Blocker supplies blocklist/allowlist controls, 403 messaging, recent blocked-request evidence, and CSV exports; it is not a legal/compliance automation tool, firewall, WAF, or fraud-screening replacement.

## Follow-Up Asset Tasks Drafted For Owner Review

No queue records were appended during this selected-task-only cron tick. Suggested follow-ups if the owner wants stronger publication evidence:

1. Capture live WordPress admin screenshots in a disposable staging site to supplement the current staged SVG set.
2. Add storefront-rendered page QA evidence for `/shop/epic-geo-blocker/` once publication is approved and checkout remains safely disabled until owner approval.
