=== VizzEx ===
Contributors: vizzex
Tags: geomesh, seo, semantic seo, internal links, knowledge graph
Requires at least: 6.2
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Transform disconnected pages into a structured GEOMesh (Generative Engine Ecosystem) that AI models can discover, trust, and cite with confidence.

== Description ==

Most WordPress sites suffer from a silent structural problem: posts that exist as isolated "content islands," categories with no clear hub, and internal links scattered randomly rather than strategically placed.

VizzEx is the first horizontal content analysis tool built specifically to create the GEOMesh (Generative Engine Ecosystem). Where traditional SEO tools analyze individual pages in depth, VizzEx analyzes your entire blog as a connected knowledge network — identifying what’s disconnected, what’s missing, what’s undermining your authority, and what needs to change.

Then it does something no other tool does: for every semantic relationship it identifies, it writes the linking text in your blog’s own tone, ready to paste. Not a keyword suggestion. A semantic relationship link — the explicit, reasoned connection between ideas that AI systems recognize as a signal of real, integrated expertise.


When ChatGPT, Perplexity, Google Gemini, Claude, or agentic RAG crawlers analyze your site, they do not evaluate pages in isolation. They map relationships. If your content exists in unstructured silos, it triggers extraction filters and reads as an expensive, low-confidence source. If your content is interconnected with clear semantic paths and a consistent heading hierarchy, it forms a highly cohesive GEOMesh (Generative Engine Ecosystem) — a machine-readable knowledge graph that proves topical authority and minimizes inference costs for AI crawler agents.

VizzEx builds that GEOMesh (Generative Engine Ecosystem). Starting with your most recent posts.

= Why AI Citation Requires GEOMesh (Generative Engine Ecosystem) Architecture =

AI retrieval agents operate under tight inference budgets. Parsing disconnected, bloated content costs real server money. When your site requires expensive calculations to determine how topics relate, your content gets deprioritized.

When your posts form a structured GEOMesh (Generative Engine Ecosystem) with clear internal link paths, consistent heading hierarchies, and unambiguous category ownership, the computation cost for an AI agent to parse, chunk, and cite your site drops dramatically. By organizing your WordPress site into a low-compute layout, VizzEx makes your content the most mathematically efficient, lowest-latency option on the web — and a far more attractive citation source than a competitor's disjointed collection of pages.

VizzEx takes a database-wide approach: analyzing your posts horizontally as an interconnected system and delivering specific, non-destructive structural changes that reduce AI crawler compute tax and maximize citation probability.

= What VizzEx BASIC (Free Version) Does =

**Baseline Analysis**
VizzEx uses your own Anthropic Claude API key to map semantic relationships between content nodes, identify topic clusters, score each post's internal connectivity, and surface high-value content with strong AI citation potential.

**Content Analysis Dashboard**
After your analysis, explore your results via an intuitive, action-oriented workspace:

* **Topic Clusters** — groups of semantically-related posts with an authoritative hub page at the center.
* **Connectivity Scores** — a numeric metric showing how well each post is integrated into your site-wide GEOMesh (Generative Engine Ecosystem).
* **Posts Needing Attention** — content nodes with low connectivity scores or missing internal links.
* **High-Value Content** — posts displaying the strongest natural signals for AI citation potential and strategic link impact.

**Link Recommendations**
VizzEx delivers internal link recommendations per analysis run. No more writing your own connecting sentences. VizzEx uses Claude AI to read your source paragraph, generate the exact replacement paragraph with the link naturally embedded, and explain the placement rationale.

**Heading Structure Analysis**
Clear, hierarchical headings provide explicit semantic boundaries between topics—reducing the compute tax for crawling agents. VizzEx reviews your heading (h2–h4) hierarchy to ensure your core facts reside in the premium extraction zone (The Knowledge Window).

**Primary Category Recommendations**
When a post belongs to multiple categories, VizzEx identifies the ideal primary category, sharpening your topical authority signals and eliminating the category ambiguity that causes AI models to assign lower confidence to your content.

**Business Profile Integration**
Set your industry and business model so VizzEx can apply industry-specific scoring and localized domain authority weighting in future analyses.

= Requirements =

To use VizzEx, you need:

1. **Your own Anthropic Claude API key** — get one at [console.anthropic.com](https://console.anthropic.com/). VizzEx does NOT provide, resell, or proxy Claude API access; you bring your own key to maintain absolute data sovereignty over your content database.

= VizzEx PRO =

VizzEx builds the structural foundation—the internal link architecture, heading hierarchy, and topical clustering that AI retrieval agents need to recognize your site as a coherent GEOMesh (Generative Engine Ecosystem). VizzEx PRO adds the next layers of signal on top of that foundation.

When the structural work from VizzEx aligns with PRO's Signal Architecture and Dynamic Semantic Schema (JSON-LD), the combination creates an explicit, machine-readable signal stack: your entities are named, your relationships are defined, and your topical authority is verifiable—not just implied by link structure. That alignment is what makes it easy for AI systems to discover, trust, and cite your expertise with confidence.

**VizzEx PRO**, available at [vizzex.ai](https://vizzex.ai/), adds:

* **Incremental Analysis Runs** — Run analyses as often as you publish or update content. Only what's changed gets uploaded, reducing the time per analysis.
* **Signal Architect** — explicit semantic schema and entity alignment that makes your topical authority machine-readable for AI recognition.
* **Dynamic Semantic Schema (JSON-LD)** — embed bespoke structured entity and relationship data behind your content as JSON-LD schema, giving AI retrieval agents a machine-readable map of your expert knowledge graph without inference guesswork.
* **Semantic Schema Glossary** — build the knowledge graph that defines your domain, your entities, and the relationships between them.
* **Category-focused cluster analysis** — strategic, iterative optimization by topic area.
* **Expanded analysis capacity** — ability to be more selective about what gets analyzed.
* **Multisite network support.**

When you activate VizzEx PRO, all your analysis data, link recommendations, and connectivity scores are fully preserved.

= VizzEx Requirements =

To use VizzEx you need:

1. **Your own Anthropic Claude API key** — get one at [console.anthropic.com](https://console.anthropic.com/).

== External Services ==

VizzEx connects to three external services. This plugin will not function without them.

**1. VizzEx Analysis Server** (bka-api.vizzex.com)
What it does: Post titles and content are sent to the VizzEx Analysis Server to generate topic clusters, connectivity scores, link recommendations, and heading analysis.
What data is sent: Post titles, category, post content, and your site URL, sent when you initiate a Baseline Analysis.
[Terms of Use](https://vizzex.ai/terms-of-use/) | [Privacy Policy](https://vizzex.ai/privacy-policy/)

**2. VizzEx Registration Server** (vizzex.ai)
What it does: Registers the site with the VizzEx analysis service when you explicitly save your Claude API key during setup. This is a one-time action that provisions your free service access credentials. No background or periodic calls are made after registration.
What data is sent: Your site URL and a locally-generated anonymous site identifier (a random string created on your server). No personal information, no admin credentials, no tracking data.
[Terms of Use](https://vizzex.ai/terms-of-use/) | [Privacy Policy](https://vizzex.ai/privacy-policy/)

**3. Anthropic Claude API** (api.anthropic.com)
What it does: Powers the AI reasoning for semantic analysis, link text generation, and heading recommendations. You provide your own Anthropic API key — VizzEx does not proxy or resell API access.
What data is sent: Post content is sent to Anthropic's API when you run an analysis or generate semantic link text, using your own account credentials.
[Terms of Use](https://www.anthropic.com/legal/aup) | [Privacy Policy](https://www.anthropic.com/legal/privacy)

VizzEx does not collect personal visitor data. No analytics, tracking pixels, or visitor identifiers are used.

== Installation ==

1. Upload the `vizzex` folder to `/wp-content/plugins/`
2. Activate VizzEx from the WordPress Plugins screen
3. You will be taken to a Welcome screen — follow the two setup steps:
   * Enter your Anthropic Claude API key
   * Run your first Baseline Analysis
4. After analysis completes, explore your results under **VizzEx → Dashboard** and start working through **VizzEx → Link Recommendations**

== Frequently Asked Questions ==

= I want AI models like ChatGPT or Perplexity to cite my business. Can VizzEx help? =

Yes. AI tools cite businesses that are the most authoritative, structurally sound, and computationally efficient source of information for a given topic. VizzEx builds the GEOMesh (Generative Engine Ecosystem) foundation that makes your content easier for AI retrieval agents to parse, chunk, and cite: clear internal link paths, consistent heading hierarchies, unambiguous category ownership, and strategically placed anchor text that explicitly communicates why two posts are related.

= How is VizzEx different from traditional SEO plugins like Yoast or Rank Math? =

Traditional SEO plugins analyze posts one at a time, optimizing meta tags and keyword density for human search engines. VizzEx analyzes your posts horizontally as a complete system—mapping the semantic relationships between them and identifying the Parity Gaps that cause AI retrieval agents to treat your site as a collection of disconnected pages rather than a coherent GEOMesh (Generative Engine Ecosystem). The goal is not keyword density; it is topical coherence and low-compute link architecture.

= What is the "Symmetry Gate Scanner" and how does it relate to the plugin? =

The [Symmetry Gate Scanner](https://symmetrygate.ai) is the diagnostic framework used to perform the initial baseline audit of your site's Parity Gaps. It measures mismatches between human-visible DOM content and raw underlying code. The VizzEx plugin is the companion operational tool that builds the non-destructive semantic containers, header densities, and link bridges to resolve those gaps.

= Do I need an Anthropic Claude API key? =

Yes. VizzEx uses Anthropic Claude for Baseline Analysis, Heading Structure Analysis, Primary Category Recommendations, and Semantic Link Text generation. You must provide your own API key from [console.anthropic.com](https://console.anthropic.com/). All analyses run via your direct, private Claude account — VizzEx does not provide, resell, or proxy Claude API access, ensuring absolute data sovereignty.

= How many posts does VizzEx analyze? =

VizzEx analyzes your most recently published posts. The number of posts per analysis run is determined by the VizzEx Analysis Server.

= Will VizzEx automatically insert links into my posts? =

Never. VizzEx provides recommendations only. Every link insertion is made manually by you through the post editor. VizzEx shows you where and what to link — you decide whether to act on it.

= How often should I run a Baseline Analysis? =

VizzEx allows two full analysis per month. Link recommendations are returned per analysis. The iterative approach is intentional: implement your link recommendations, improve your heading structures, publish new content, then run your next analysis to measure the impact.

VizzEx Pro allows unlimited analysis runs, and identifies the most strategic high-impact actions you should take first, allowing you to move faster.

= Will my data be preserved if I upgrade to VizzEx Pro? =

Yes. VizzEx and VizzEx Pro use identical database table schemas with the same `vizzex_` prefix. All your analysis results, link recommendations, connectivity scores, and heading recommendations are preserved when you install Pro.

= Can I use VizzEx on a multisite network? =

VizzEx supports single-site installations only. Multisite support is available in the VizzEx Pro upgrade.

= What WordPress and PHP versions are supported? =

VizzEx requires WordPress 5.8 or higher and PHP 7.4 or higher. It has been tested up to WordPress 7.0.

= Where can I get support? =

Visit the [VizzEx support forum](https://wordpress.org/support/plugin/vizzex/) on WordPress.org, or contact us through [vizzex.ai](https://vizzex.ai/).

== Screenshots ==

1. **Dashboard** — Run a Baseline Analysis and kick off your first content structure review
2. **Analysis Results** — Connectivity scores, topic clusters, posts needing attention, and high-value content
3. **Content Analysis — Bridges** — Visual bridges showing semantic connections between your content islands
4. **Link Recommendations** — Review pending internal link recommendations per analysis
5. **Heading Structure Analysis** — h2–h4 recommendations to sharpen semantic structure for any post
6. **Semantic Link Text** — AI-generated paragraph replacement with the link naturally embedded
7. **Post Editor Metabox** — Connectivity score, hub status, and pending link recommendations at a glance
8. **Settings — API Keys** — Connect your Anthropic Claude API key to enable AI-powered analysis
9. **Adding Your Claude API Key** — Paste and save your Anthropic Claude API key in Settings to activate AI-powered analysis

== Changelog ==

= 1.0.0 =
* Initial release of VizzEx.
* Baseline Analysis: analyzes your most recently published posts via the VizzEx Analysis Server.
* Content Analysis page: topic clusters, connectivity scores, posts needing attention, high-value content.
* Link Recommendations: pending recommendations per analysis with apply / dismiss / restore workflow.
* Semantic Link Text: AI-generated paragraph replacement with link placement rationale, per recommendation.
* Heading Structure Analysis: h2–h4 ratio analysis and recommendations per post.
* Primary Category Recommendations: identifies the best primary category for multi-category posts.
* Business Profile: industry and business model settings for improved analysis scoring.
* Post Edit Metabox: connectivity score, hub designation, pending recommendations, and change-detection warning.
* Onboarding: two-step welcome screen guiding users through Claude API key setup and first analysis.
* Upgrade encouragement: friendly Pro upgrade callouts throughout — no gates, no blurs.
* Full GPLv2+ license compliance.
* Shared database table schemas with VizzEx Pro for seamless upgrade path.

== Upgrade Notice ==

= 1.0.0 =
Initial release of VizzEx. No upgrade action needed.
