Add|Plugins SEO Audit 1.1.0

Compatible XF 2.x versions 2.3
Additional requirements PHP cURL extension
License Free / Open Source
Visible branding No
SEO Audit for XenForo 2.3+
A comprehensive SEO audit dashboard built into AdminCP. Scan your forum for 80+ SEO issue types across schema markup, meta tags, content quality, internal/external links, images, and HTML structure. Optionally auto-fix common gaps at render time, no core file edits required.

Where to find it
Admin CP > Tools > Checks and tests > SEO Audit


Scanning
Checkers
Configuration (on by default) - board URL, friendly URLs, HTTPS, sitemap inspection, noindex, metadata logo, analytics
Schema / JSON-LD (on by default) - thread author, body, title length, duplicates, slug collisions, forum descriptions
Meta Tags (on by default) - empty/short/polluted meta descriptions, duplicates, forum descriptions
Content Quality (on by default) - BBCode pollution, missing alt text, spam links, thin content, all-caps titles
Internal Links (off by default) - internal broken links via HTTP HEAD requests, rate-limited at 10 per batch, default cap of 500 per scan
External Links (off by default) - external broken links with per-domain rate limiting (100ms between same-domain requests), default cap of 5,000 per scan
Images (off by default) - broken image detection via HTTP HEAD requests on image URLs found in post content
HTML Verification (off by default) - OG tags, heading structure, JSON-LD syntax, canonical URLs in rendered HTML (sample-based)

Advanced Options
Report core schema gaps - flag pages where XF core has no JSON-LD generation
Theme heuristics - H1 and duplicate description checks (theme-dependent, may produce false positives)
Soft 404 detection - detect pages that return HTTP 200 but show error content
Batch size - configurable threads per batch (default: 200, minimum: 10). Lower for weaker hosts
Use URL cache - toggle per-scan. Cached results don't count against request limits

Analysis
80+ issue types across 6 categories: config (23), schema (16), html (19), content (11), link (6), meta (5)
Impact-ranked issues - each issue gets a priority score based on severity and frequency, so the most impactful problems appear first
Score improvement hints - shows the potential score gain per fix category (e.g., "Fix 5 critical schema issues for +50 points")
Per-forum breakdown - table showing how many issues each forum contributes
Delta scanning - only scans threads modified since the last completed scan, using last_post_date and post_date/last_edit_date. Falls back to a full scan if no previous scan exists. Delta scans are marked with a badge on the dashboard
Forum/date scoping - select one or more forums and/or set a date range to narrow the scan. Scope parameters are saved with the report for reference
URL caching - link check results cached to avoid redundant HTTP requests: 2xx cached 7 days, 4xx/5xx cached 1 day, timeouts cached 6 hours. Expired entries cleaned up automatically via daily cron
Concurrent scan lock - only one scan can run at a time
50,000 issue cap per report

CLI Scanner
Run scans from the command line:
Code:
php cmd.php qubn-seoaudit:scan [options]
Flags: --help, --delta, --forum=N, --date-from, --date-to, --links, --external-links, --images, --html, --no-config, --no-schema, --no-meta, --no-content, --core-schema-gaps, --theme-heuristics, --no-url-cache, --soft-404, --batch-size=N, --email, --email-to

Auto-Fix (template modification callbacks, all opt-in)
Auto-fix runs at render time via template modifications and an event listener. It does not modify your database content or core files. All auto-fix features are off by default and must be explicitly enabled. Each issue with a specific AdminCP fix includes a Fix it link that takes you straight to the right page.

JSON-LD injection: CollectionPage (forums/categories), WebPage + Article (static pages), WebSite + Organization (homepage). Uses JSON_HEX_TAG encoding for XSS safety
BreadcrumbList JSON-LD - injects BreadcrumbList structured data on all pages that have breadcrumb navigation
Fallback meta description - generates a meta description for forum pages and static pages that don't have one set
OG tag gap filling - injects a fallback og:image using your site's public metadata logo URL when no og:image is present
ALL CAPS title case correction - automatically converts thread titles with >70% uppercase characters to title case at render time
Debug logging - when enabled, logs every auto-fix injection to a dedicated audit log table
Audit log - records date, content type, content URL, fix type, and injected HTML for every auto-fix action. Entries auto-prune after 7 days via cron. View the log at SEO Audit > Auto-Fix Log

SEO Score
Each scan produces a score from 0 to 100: max(0, 100 - critical*10 - warning*3 - info*1)
A = 90+
B = 80-89
C = 70-79
D = 60-69
F = below 60

Severity levels:
Critical - actively harming SEO (e.g., noindex enabled globally, missing board URL, broken canonical URLs)
Warning - significant issues that should be addressed (e.g., missing meta descriptions, broken links, duplicate titles)
Info - suggestions and minor optimizations (e.g., short titles, missing alt text, thin content)

Reporting
Score trend chart - bar chart showing your score over the last 20 completed scans, with clickable bars to jump to any report
Category trend chart - stacked bar chart showing issue counts by category (config, schema, meta, content, link, html) over time, with a color legend. Delta scans are marked with a badge
Report diff - compare any report against the previous one to see new issue types, fixed issue types, and persistent issues
Filterable and sortable - filter by category, severity, and content type (thread, forum, category, page). Sortable by any column
Paginated - 200 issues per page with per-type summary on the first page. Scan history shows 20 reports per page
CSV export - downloads a CSV with columns: severity, category, issue type, content type, content ID, content title, content URL, detail, recommendation
JSON export - downloads the full report as structured JSON
Delete reports - remove any report and its associated issues
Issue dismissal - dismiss a single issue, bulk-select multiple issues, or dismiss all issues of a specific type. Link issues are dismissed by URL hash (one dismissal covers all threads with that URL), content issues by content type + content ID, config issues by type only. Each dismissal supports an optional note. Manage all dismissals from SEO Audit > Dismissed Issues

Notifications
Scheduled scanning - configure weekly, biweekly, or monthly automatic scans via cron. The dashboard shows the current schedule and last run timestamp
Auto-cleanup - automatically keeps the last N reports (default: 10) and deletes older ones after each scan
Email notification - sends a scan summary email with total issues, severity breakdown, score comparison vs previous scan, and a link to the report. Triggered by the CLI --email flag or automatically on scheduled scans
Critical issue alerts - sends a separate email when new critical issue types are detected that weren't in the previous scan, including a list of the new types and a score comparison
Webhook notifications - sends scan results to a Discord or Slack webhook URL on completion. Payload includes score, grade, issue counts by severity, and a link to the report. Auto-detects Discord vs Slack format from the URL. Delivery uses a background job with up to 3 retry attempts

Issue Configuration
Navigate to SEO Audit > Issue Configuration:
Override the severity level (critical, warning, info) of any issue type
Disable specific issue types entirely so they're skipped during scans
Adjust detection thresholds: minimum title length (default: 15 chars), maximum title length (default: 150 chars), SERP title max length (default: 60 chars), minimum meta description length (default: 50 chars), thin content minimum word count (default: 300 words), thin thread minimum characters (default: 50 chars), noindex minimum thread count (default: 100 threads)
Changes apply to future scans only
Reset all overrides to defaults with one click

AdminCP Dashboard Widget
Shows your current SEO score, letter grade, and issue summary from the most recent completed scan directly on the main AdminCP dashboard page.


Requirements
XenForo 2.3.0 or later
PHP cURL extension (for link checking)

Installation
Upload the ZIP via Admin CP > Add-ons > Install/upgrade from archive
Navigate to Admin CP > Tools > Checks and tests > SEO Audit
Run your first scan
Optionally enable auto-fix features under the Auto-fix settings tab

Technical Details
Zero class extensions - uses 2 template modifications and 1 event listener only
6 database tables (all prefixed xf_qubn_seoaudit_*): reports, issues, scan dedup, URL cache, dismissed issues, autofix log
3 cron entries: autofix log cleanup (daily), scheduled scan trigger, URL cache cleanup (daily)
15 configurable options in the qubn_seoaudit option group
Clean install and uninstall, all tables and data removed on uninstall
PHPStan level 3 clean

Support
If you encounter any issues or have feature requests, please use the discussion tab on this resource page. When reporting problems, include:
Your XenForo version
PHP version
Any relevant entries from xf_error_log
Steps to reproduce the issue