=== SEO Auditor Tools ===
Contributors: fernandofas2909
Author URI: https://seoauditor.one
Tags: seo, audit, sitemap, open graph, robots.txt
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Short Description ==

**SEO Auditor Tools** is a lightweight, all-in-one SEO toolkit for WordPress.

== Description ==

Scan your WordPress site for SEO issues and get actionable fixes. Includes sitemap, robots.txt, LLMS.txt, Open Graph, cookie consent, analytics, UTM builder, and QR code generator.

Full SEO audit dashboard with 4-category scoring, plus sitemap, robots.txt, LLMS.txt, Open Graph, cookie consent, analytics, UTM builder, and QR code generator. Free. No limits.

== Description ==

**SEO Auditor Tools** is a complete, no-paywall SEO toolkit for WordPress. Run an automated site audit that crawls the pages and returns a fully scored report across four categories - SEO, Accessibility, Performance, and Best Practices - with plain-language issue cards and actionable fixes for every finding.

Everything in this plugin is free. No feature is locked, no upsell gates your results.

= Full Audit Dashboard =

Run a single scan to get a four-category scored report covering your entire site:

* **SEO score** - H1 usage, heading hierarchy, missing alt text, empty links, broken assets, meta descriptions, canonical issues, and more.
* **Accessibility score** - Heading sequence violations, images missing alt attributes, empty interactive elements, and ARIA concerns.
* **Performance score** - Homepage response time, asset count, blocking scripts, third-party asset count, CSS/JS payload size, large assets, and unminified files.
* **Best Practices score** - Image dimension attributes, asset error rates, and general hygiene checks.

Each issue card includes:
* Severity badge (Critical / Warning)
* Plain-language description of the problem
* Concrete fix recommendation
* Verification step so you know when it's resolved

The dashboard also shows:
* **PageSpeed Insights integration** - connect your Google API key to pull live Lighthouse scores directly into the dashboard
* **LCP image detection** - identifies the image most likely affecting Largest Contentful Paint
* **Crawl summary** - discovered URLs, crawl depth, seed URLs, and error list
* **Site inventory** - WordPress version, PHP version, active theme, plugin list, available updates
* **Score history** - track how your scores change over time
* **Audit issues export** - download a full CSV of all findings

= All Free Tools Included =

* **Audit Dashboard** - Crawled pages, 4-category scoring, detailed issue list, score history, and CSV export.
* **Open Graph & Meta Description** - Set global OG title, description, image, Twitter card, and fallback meta description. Includes a live Meta Tag Analyzer and OG Checker tool.
* **Per-Page Meta** - Override meta description and keywords on any post or page directly from the block editor sidebar.
* **Sitemap Generator** - One-click XML sitemap with full page list and auto-regeneration on publish.
* **Robots.txt Editor** - Edit or regenerate robots.txt with live preview and instant deploy.
* **LLMS.txt Generator** - Generate an llms.txt file at your site root to guide AI crawlers.
* **Cookie Consent Banner** - GDPR-friendly accept/reject banner with custom message, colours, positioning, and analytics/marketing consent defaults.
* **Google Analytics & Tag Manager** - Paste your GA4 or GTM snippet for automatic head injection. Additional tracking scripts (Bing, Yandex, others) also supported.
* **IndexNow** - Automatically ping Bing, Yandex, and compatible search engines whenever content is published or updated.
* **UTM Campaign Builder** - Build UTM-tagged marketing URLs and copy them in one click.
* **QR Code Generator** - Create QR codes for any URL. Download as PNG or copy Base64 inline.
* **Settings Export** - Export all plugin settings as JSON or CSV to migrate to another site in seconds.

= Why Upgrade to Pro? =

[SEO Auditor Tools Pro](https://seoauditor.one) adds a second layer of advanced site management tools on top of the free audit engine:

* **Security Monitor** - File integrity checks, login hardening, HTTP security headers, and brute-force protection.
* **Image Tools** - Bulk add missing width/height dimensions, regenerate thumbnails, and non-destructive image editing.
* **Cache Tool** - Server-side page caching with rules editor and pre-warming.
* **Minify Tools** - HTML, CSS, and JavaScript minification with per-file control.
* **.htaccess Editor** - Safe .htaccess editing with automatic backup and one-click restore.
* **Redirection Manager** - 301/302 redirect rules with import/export and first-login redirect support.
* **AI Chatbot** - On-site AI assistant for visitor support.
* **Product Schema** - WooCommerce structured data for rich results.
* **PDF Audit Export** - Branded PDF report suitable for clients or stakeholders.
* **Per-page keywords & robots directives** - noindex, nofollow, and meta keywords per post/page.

== Installation ==

1. Upload the `seo-auditor-tools` folder to `/wp-content/plugins/`.
2. Activate the plugin through **Plugins → Installed Plugins**.
3. Go to **SEO Auditor Tools → Dashboard** and click **Run Audit** to scan your site.

== Frequently Asked Questions ==

= How many pages can the audit scan? =

Up to 200 pages by default. You can adjust this using the `seoautopro_post_scan_limit` filter.

= Are all four score categories free? =

Yes. SEO, Accessibility, Performance, and Best Practices scores - including all issue details and fix recommendations - are fully available in the free plugin.

= Does this plugin slow down my site? =

No. The audit runs on-demand in the admin only. Front-end output is limited to the cookie banner and analytics snippets, both of which are lightweight and only active when you configure them.

= Is the cookie banner GDPR compliant? =

The banner provides accept/reject functionality with configurable consent defaults. You are responsible for ensuring your overall site complies with applicable privacy regulations.

= Can I use this alongside other SEO plugins? =

Yes. SEO Auditor Tools focuses on auditing and tooling rather than overriding all your meta output, so it works well alongside Yoast, Rank Math, or similar plugins.

= How does PageSpeed Insights integration work? =

Enter your free Google API key in **SEO Auditor Tools → Audit Settings**. The plugin will fetch Lighthouse scores when you run a scan and display them directly in the dashboard.

== External Services ==

This plugin connects to the following third-party services:

= QR Server (api.qrserver.com) =

Used by the QR Code Generator tool to create QR code images on demand. When a user generates a QR code, the target URL is sent to the QR Server API and an image is returned.

* Service URL: https://api.qrserver.com/v1/create-qr-code/
* Terms of Use: https://goqr.me/api/
* Privacy Policy: https://goqr.me/de/rechtliches/datenschutz-goqrme.html

Data sent: the URL you enter in the QR code generator. No personal data is transmitted.

= IndexNow (api.indexnow.org) =

Used by the IndexNow feature to notify Bing, Yandex, and other search engines when content is published or updated. This feature is opt-in and disabled by default.

* Service URL: https://api.indexnow.org/indexnow
* Terms of Use: https://www.indexnow.org/faq
* Privacy Policy: https://privacy.microsoft.com/en-us/privacystatement

Data sent: the public URL of the updated page and your IndexNow API key. No personal data is transmitted.

= Google PageSpeed Insights (optional) =

Used when a PageSpeed Insights API key is configured. When a scan runs, the plugin sends the homepage URL to the PSI API and retrieves Lighthouse scores. This feature is disabled by default.

* Service URL: https://www.googleapis.com/pagespeedonline/v5/runPagespeed
* Terms of Use: https://developers.google.com/terms
* Privacy Policy: https://policies.google.com/privacy

Data sent: your site's homepage URL. No personal data is transmitted.

== Screenshots ==

1. Full Audit Dashboard with 4-category scoring - SEO, Accessibility, Performance, and Best Practices.
2. Detailed issue cards with severity badges and plain-language fix recommendations.
3. Crawl summary and site inventory panel.
4. Open Graph & Meta Description settings with Meta Tag Analyzer.
5. Sitemap Generator with page list.
6. Cookie Consent Banner settings with consent defaults.

== Changelog ==

= 1.2.0 =
* Audit Dashboard fully unlocked: all four score categories (SEO, Accessibility, Performance, Best Practices) now available to all users.
* Scan limit raised from 10 to 200 pages.
* All issue categories (accessibility, performance, best practices, security, privacy) now visible in the audit results.
* PageSpeed Insights card shown in dashboard when API key is configured.
* Additional tracking scripts (beyond GA/GTM) now available in Tracking settings.
* PageSpeed Insights API key and strategy selector now available in Audit settings.
* Removed all upgrade prompts from the Audit Dashboard.

= 1.1.0 =
* Initial release of SEO Auditor Tools for WordPress.org.
* SEO audit with scored dashboard and issue cards.
* Open Graph, sitemap, robots.txt, LLMS.txt generators.
* Cookie consent banner with accept/reject.
* Google Analytics and Tag Manager injection.
* IndexNow automatic pinging.
* UTM builder and QR code generator.
* Settings export (JSON/CSV).

== Upgrade Notice ==

= 1.2.0 =
Major update: full 4-category audit scoring is now free. Update to unlock Accessibility, Performance, and Best Practices scores plus all issue categories.
