=== SEO Audit & Analyzer === Contributors: hitman2019 Tags: seo audit, seo analyzer, on-page seo, content analyzer, ai seo Requires at least: 6.0 Tested up to: 7.0 Requires PHP: 7.4 Stable tag: 2.6.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Donate link: https://techzenithlabs.com/donate/ SEO audit, content analysis, conversion optimization, live SEO scoring, and optional Gemini-powered AI writing for WordPress. == Description == SEO Audit & Analyzer by Tech Zenith Labs helps you improve on-page SEO, content quality, readability, and conversion optimization directly inside WordPress. Unlike traditional SEO tools that only analyze live URLs, GGR can audit draft, private, and published content before it goes live, helping you fix issues earlier in the publishing process. The GGR SEO Command Center provides a site-wide dashboard that combines SEO audits, content analysis, conversion insights, schema monitoring, and actionable recommendations in one place, alongside real-time scoring and optimization tools inside the post editor. Built for content creators, bloggers, businesses, WooCommerce stores, and agencies who want practical SEO insights without complex workflows. The optional GGR AI Writer adds Google Gemini-powered assistance for creating new draft posts/pages and improving existing content one item at a time. The site administrator supplies their own Gemini API key. == Documentation & Resources == Learn how to install, configure, and get the most out of SEO Audit & Analyzer. * Documentation: https://www.techzenithlabs.com/products/seo-audit-analyzer-by-ggr * Official Website: https://www.techzenithlabs.com/ == SEO Command Center (Dashboard) == * Overall SEO health score for your whole site * Issues by severity — missing meta descriptions, missing focus keywords, duplicate titles, thin content, missing internal links, images missing alt text, and more * SEO content performance across posts, pages, and products with per-item grades * Readability breakdown including Flesch score, passive voice, long sentences, transition words, paragraph length, and subheading use * Prioritized SEO growth opportunities with estimated score impact * Schema status tracking for Article, Product, LocalBusiness, FAQ, HowTo, Review, BreadcrumbList, and related schema types * 404 monitoring for deleted or trashed content and redirects * Sitemap and social coverage indicators == Page Analyzer == * Search posts, pages, and WooCommerce products by title and related content information * Detailed per-page SEO analysis covering title, meta, content, readability, links, and schema * Focus keyword analysis and readability scoring * Image ALT, internal-link, and social metadata checks == Content Analyzer == * Site-wide content quality analysis across supported public content types * Word count and readability scoring * Content grades and distribution insights * Detection of thin content, missing headings, missing ALT text, missing internal links, and keyword-stuffing signals == Conversion Audit == * Site-wide conversion-readiness analysis * Conversion score and grade per page * CTA and trust-signal detection * Detection of pages with no CTA, weak trust signals, missing forms, or weak above-the-fold content * WooCommerce product health checks for common content and product-data gaps == In the Post Editor == * Live SEO score with potential-gain indicators * SEO Foundation checklist * SEO snippet editor with live preview * Content analysis including word count, keyword occurrences, and keyword density * Internal and external link analysis * Media SEO checks including featured image and ALT attributes * Content structure breakdown * Admin-bar SEO score indicator with instant rescan == AI Writer & Gemini == The optional GGR AI Writer uses Google Gemini for AI-assisted content creation and improvement. * Create new draft posts with AI * Create new draft pages with AI * Improve existing posts or pages one item at a time * Use the AI Writer with the site's own Gemini API key * Review generated content before publishing The Free version uses Google Gemini as its AI provider. Other AI providers such as OpenAI and Claude are not enabled in the public Free build. The AI Writer does not require a GGR account. The site administrator configures a Gemini API key in the plugin settings. When an AI operation is requested, the plugin sends the prompt and the minimum content context required for that request to Google Gemini. The Gemini API key is stored in the WordPress site settings and is not exposed to visitors or browser JavaScript. Do not submit confidential, personal, regulated, or otherwise sensitive information to an AI provider unless you are authorized to do so. Advanced GGR AI capabilities such as deeper keyword intelligence, semantic intelligence, content-gap analysis, bulk optimization, AEO/GEO intelligence, and other advanced capabilities may be provided separately through a substantive GGR service or add-on. These advanced capabilities are not required to use the basic AI Writer. == Setting Up Gemini AI == To use the optional AI Writer: 1. Go to **GGR Website Audit → Settings → AI Settings**. 2. Open Google AI Studio: https://aistudio.google.com/app/apikey 3. Sign in with your Google account. 4. Create or select a Gemini API key. 5. Copy the API key. 6. Return to the GGR AI Settings page. 7. Paste the key into the Gemini API Key field. 8. Save the settings. 9. Use the available connection test to verify the configuration. The Gemini API key is supplied by the site administrator and is used for AI requests made from the WordPress installation. GGR does not require users to create a GGR account for the basic AI Writer. Google Gemini service terms and policies apply to requests made through the Gemini API. Site administrators should review Google's current documentation and terms before enabling AI features. == What the plugin checks == * Title tag presence * Meta description detection * Heading hierarchy (H1-H4) * Content length and readability indicators * Internal and external links * Image ALT attributes * Canonical tag presence * Noindex detection * Structured data (JSON-LD) and schema type coverage * Calls-to-action, trust signals, and form presence * WooCommerce product data completeness * Basic technical SEO signals such as sitemap and social metadata == Features == * Site-wide SEO Command Center dashboard * Per-page deep analysis with Page Analyzer * Site-wide Content Analyzer * Site-wide Conversion Audit * Visual SEO health score with breakdown * Clear issue categories: Good, Needs Improvement, Critical * Actionable, prioritized recommendations * Admin-bar SEO score indicator * Per-page score tracking * Automatic setup screen after plugin activation * AJAX-powered audit processing * Lightweight and performance-conscious analysis * No third-party analytics or advertising tracking * Draft and private-post SEO auditing before publishing * Content-based analysis without requiring public live URLs * Support for supported public post types and WooCommerce products * Smart permalink warnings * Simple enable/disable controls in Settings * Optional Gemini-powered AI Writer == Installation == 1. Upload the `ggr-website-audit` folder to the `/wp-content/plugins/` directory. 2. Activate the plugin through the **Plugins** screen in WordPress. 3. After activation, complete the setup flow if displayed. 4. Visit **GGR Website Audit → Dashboard** and click **Run Full Audit** to generate your first site-wide report. 5. Open any supported post or page to see its live SEO score and checklist. 6. To use AI Writer, go to **GGR Website Audit → Settings → AI Settings**, configure your Gemini API key, save it, and test the connection. == Frequently Asked Questions == = Does the plugin guarantee SEO rankings? = No. The plugin provides analysis of on-page SEO, content, and conversion signals. Search rankings depend on many factors including content quality, competition, links, site quality, and search-engine systems. = Does the plugin send data externally? = Most SEO analysis runs locally inside your WordPress installation. The optional AI Writer uses Google Gemini only when an administrator configures a Gemini API key and requests an AI operation. For those requests, the plugin sends the prompt and the minimum content context required to generate the requested result. The Gemini API key is stored in the WordPress site settings and is not exposed to visitors or browser JavaScript. Do not submit confidential, personal, regulated, or otherwise sensitive information to an AI provider unless you are authorized to do so. = How many posts or pages can I create with the Free AI Writer? = The basic AI Writer does not impose a lifetime post or page quota. It can create draft posts or pages when requested by an authorized WordPress user and subject to the site's configured Gemini API availability and normal request-abuse protection. = How does improving existing content work? = The AI Writer can improve one selected post or page at a time. The user must have WordPress permission to edit the selected content. Advanced bulk and site-wide AI optimization capabilities may be offered separately through a substantive GGR service or add-on. = Which AI provider is available in the Free version? = Google Gemini is the AI provider used by the public Free build. OpenAI and Claude are not enabled as selectable providers in this build. = Is a GGR account required for AI Writer? = No. The basic AI Writer uses the site's own Gemini API key and does not require a GGR account. = Where do I get a Gemini API key? = Create or manage a Gemini API key through Google AI Studio: https://aistudio.google.com/app/apikey The plugin also provides setup guidance in **GGR Website Audit → Settings → AI Settings**. = Does the plugin store my Gemini API key? = The Gemini API key is stored in the WordPress site's plugin settings so the server can authenticate requests to Gemini. The plugin does not intentionally expose the saved key to visitors or browser JavaScript. Site administrators are responsible for protecting access to their WordPress installation and Gemini account. = Does the plugin track users? = The plugin does not include third-party analytics or advertising tracking. External communication for the optional AI Writer occurs only when the administrator has configured the Gemini integration and requests an AI operation. = Does the plugin modify my theme? = No. It does not modify theme files or override global theme styles. = Can I audit draft and private content? = Yes. The plugin supports content-based analysis of supported draft, private, and published content so that SEO issues can be reviewed before publication. == Screenshots == 1. AI Writer — Create new draft posts or pages with Google Gemini, or improve existing content one item at a time. Advanced GGR AI intelligence is presented separately as Premium. 2. SEO Command Center — Monitor site-wide SEO health, content performance, readability, schema coverage, indexing status, and prioritized growth opportunities from one dashboard. 3. Post Editor Integration — Analyze SEO foundations, snippets, content, links, media, structure, and live SEO score directly inside the WordPress editor. 4. Page Analyzer — Analyze posts, pages, and WooCommerce products with detailed SEO, readability, metadata, content, link, image, and schema checks. == Changelog == = 2.6.1 = * Added dynamic Gemini model discovery using Google's models.list endpoint. * Filters models by generateContent support and prefers the newest stable Flash model. * Added automatic model fallback and 404-triggered model rediscovery. * Added 6-hour model-list caching and a Refresh Available Models control. * Shows the currently selected Gemini model in AI Settings. * Removed hard-coded Gemini model selection from AI generation requests. = 2.6.0 = * NEW: GGR AI Writer powered by Google Gemini. * NEW: AI-assisted creation of draft posts and pages. * NEW: AI-assisted improvement of existing posts and pages one item at a time. * NEW: Gemini API key configuration and connection testing. * NEW: Guided Gemini setup instructions. * NEW: Premium presentation for advanced GGR AI intelligence. * NEW: Advanced Keyword Intelligence presentation as a Premium capability. * IMPROVEMENT: Hardened AI request permissions and content-edit authorization. * IMPROVEMENT: Improved validation, sanitization, and server-side API handling for AI operations. * IMPROVEMENT: Gemini credentials are kept server-side and are not exposed to browser JavaScript. * IMPROVEMENT: Added AI request burst protection. * IMPROVEMENT: Updated documentation and WordPress.org screenshots. * SECURITY: Improved handling of AI-generated content and external API errors. = 2.4.9 = * Fixed Admin Setting issues. = 2.4.8 = * Fixed fatal error caused by duplicate GGRWA_Settings class declarations on upgraded installations. * Improved plugin update compatibility. = 2.4.7 = * NEW: SEO Command Center dashboard. * NEW: Content Analyzer. * NEW: Conversion Audit. * NEW: Page Analyzer. * IMPROVEMENT: Restructured admin menu into Dashboard, Page Analyzer, Content Analyzer, Conversion Audit, and Settings. * IMPROVEMENT: Reworked post-editor SEO panel with clearer sectioning. * FIX: Removed leaked debug output occasionally appearing at the bottom of the Dashboard page. = 2.4.6 = * NEW: Support for draft and private post SEO audit. * NEW: Content-based audit engine. * NEW: Support for public post types including custom post types. * NEW: Admin bar enhancements with post type badge and status indicator. * NEW: Smart permalink warning for SEO-friendly URLs. * IMPROVEMENT: Faster and more reliable audit processing. * FIX: Removed "page does not exist" error for draft and preview URLs. * DEV: Refactored audit engine to support post_id based analysis. = 2.4.5 = * FIX: Resolved issue where admin bar scan always used homepage instead of current page URL. * FIX: Corrected nonce handling for secure scan requests. * FIX: Fixed URL encoding/decoding issue causing incorrect scan_url in dashboard. * FIX: Resolved admin bar click behavior. * IMPROVEMENT: Better URL detection for post editor and frontend pages. * DEV: Refactored scan URL handling logic for consistency and reliability. = 2.4.4 = * Added admin bar SEO score indicator on post and page edit screens. * Implemented per-page SEO score storage and tracking. * Introduced automatic setup screen after plugin activation. * Improved first-time user onboarding. * Enhanced UI/UX. * Improved timezone handling and UTC compatibility. * Optimized audit processing performance. * Fixed minor bugs and improved stability. = 2.4.3 = * Improved plugin naming and SEO positioning. * Enhanced readme content for discoverability. * Added visual SEO score system. * Improved UI with clearer issue categorization. * Added better explanations for SEO issues. = 2.4.2 = * Improved WordPress coding standards compliance. * Fixed prefix naming consistency. * Security and escaping improvements. = 2.4.1 = * Added AJAX-based audit execution. * Improved permission checks. * Internal stability improvements. == Upgrade Notice == = 2.6.0 = Major feature release introducing the optional GGR AI Writer powered by Google Gemini, AI-assisted draft creation and content improvement, Gemini API configuration, and updated documentation for the public WordPress.org build.