=== Digital Root Tools ===
Contributors: drtplugin
Tags: seo, woocommerce, geo, alt text, ai
Requires at least: 5.8
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

AI-powered SEO & GEO tools for WordPress. Generate alt text, blog posts, and product descriptions optimised for Google and AI search.

== Description ==

Digital Root Tools brings AI-powered content generation and on-page SEO & GEO analysis directly into your WordPress editor. Every piece of content it generates is structured to rank on Google and get cited by AI search engines like ChatGPT, Perplexity, and Google AI Overviews.

**SEO & GEO Meta Manager (free — no account needed)**

* Meta title and description with live character counters and SERP preview
* GEO-optimised AI meta generation — one click writes both meta title and description using answer-first structure preferred by AI search engines
* Social meta tags: Open Graph (Facebook/LinkedIn) and Twitter Card
* Canonical URL control
* Meta robots (index/noindex, follow/nofollow)
* Schema type selector (Article, Blog Post, Product, FAQ, and more)
* Automatic JSON-LD structured data output — Article, FAQPage, Product, WebPage, LocalBusiness, Service, and BreadcrumbList
* Structured last-modified meta output

**On-Page SEO Analysis**

Every post and page gets an SEO score with traffic-light checks covering:

* Meta title and description length
* Heading structure (H1/H2 audit)
* Focus keyword in permalink
* Internal and outbound link counts
* Image alt text audit
* Canonical and robots status
* Social meta tag presence
* Last modified date
* Structured data

**AI Content Tools (requires free Digital Root Tools account)**

All AI-generated content is structured for both traditional search rankings and GEO — designed to be cited and surfaced by AI-powered search engines.

* Alt Text Generator — generate SEO and WCAG-compliant alt text for individual Media Library images
* Bulk Alt Text — process your entire media library in one run with a progress bar and auto-save; select all or individual images
* Blog Post Generator — full blog posts with GEO-structured headings, meta title, meta description, excerpt, and slug suggestions
* Keyword Content Brief — structured briefs optimised for both search intent and AI citation
* WooCommerce Product Generator — titles, descriptions, meta, and tags written for Google and AI shopping search
* WooCommerce Product Enricher — rewrite and optimise individual product listings for SEO and GEO visibility
* Bulk Product Enricher — enrich descriptions across your entire WooCommerce catalogue in one run with a progress bar and auto-save

Works with all themes including Elementor, Divi, Beaver Builder, and the default WordPress block editor.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate through the Plugins menu
3. The SEO & GEO meta box appears immediately on all posts, pages, and custom post types
4. To enable AI tools: go to **DRT SEO & GEO → Settings** and connect your Digital Root Tools account

== Frequently Asked Questions ==

= Do I need an account to use the SEO features? =
No. The SEO meta manager, on-page analysis, schema output, and head tag output all work without an account. An account is only needed for AI content generation.

= Where do I get my API key? =
From your dashboard at digitalroottools.com — go to Account → API Key.

= What is GEO (Generative Engine Optimisation)? =
GEO is the practice of structuring content so it gets cited and surfaced by AI-powered search engines like ChatGPT, Perplexity, and Google AI Overviews. Digital Root Tools optimises for both traditional SEO and GEO simultaneously.

= Does this conflict with Yoast or RankMath? =
You should only use one SEO plugin at a time to avoid duplicate meta tags. Deactivate other SEO plugins before activating Digital Root Tools.

= Does it work with Elementor? =
Yes. The meta box appears in Elementor's WordPress panel (bottom of the editor). The SEO analyser also reads Elementor page content automatically.

= Does it output structured data automatically? =
Yes. Once activated, the plugin outputs JSON-LD schema on every published post, page, and product — auto-detecting the correct type (Article, Product, FAQPage, etc.) with a BreadcrumbList on every page.

== Screenshots ==

1. Full WooCommerce product editor showing AI-generated description applied to a live product, with product image and the DRT SEO & GEO meta box visible below
2. The DRT SEO & GEO meta box — focus keyword, meta title with character counter, meta description, and live SERP search preview
3. The Product Generator output panel — AI-generated title, HTML description, meta title, meta description, and tags ready to apply in one click
4. The Product Generator form with key features, category, price, and target audience filled in — and the smart Enricher guard warning when no description exists yet
5. The Product Enricher output — enriched HTML description, short description, SEO title, SEO description, focus keyword, and tags with field-by-field helper text
6. The Product Enricher lower fields — call to action, image alt text, and the Apply Enriched Content button with completion confirmation
7. The Bulk Alt Text Generator — 4 images processed showing accurate AI-generated alt text per image, progress bar, and graceful error handling for unsupported file types

== External Services ==

This plugin connects to the Digital Root Tools API (digitalroottools.com) to generate AI-powered content. This connection is only made when a user explicitly clicks a generation button. No data is sent automatically or without user action.

**What is sent:** Image data (base64 encoded), post titles, existing descriptions, product details. No personally identifiable information is transmitted unless present in the content.

**Service information:**
* Service: Digital Root Tools API
* URL: https://digitalroottools.com
* Privacy Policy: https://digitalroottools.com/privacy
* Terms of Service: https://digitalroottools.com/terms

An account and API key are required to use AI generation features. The SEO meta manager, on-page analysis, and structured data output work entirely locally with no external requests.

== Changelog ==

= 1.0.0 =
* Initial release — SEO & GEO meta manager, on-page analysis, schema output, AI content tools, bulk alt text generator, WooCommerce product tools, bulk product enricher
