Overview Version (3) Discussion (3)

• 

  SEO Audit

  A comprehensive SEO auditing dashboard for XenForo administrators. Scan your forum for SEO issues
  About this resource

  

  
  

  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
  • Thread JSON-LD enrichment - enriches XF core's native DiscussionForumPosting with commentCount, isPartOf (DiscussionForum), and author fallback for deleted/banned users. Uses class extension, no duplicate structured data.
  • Thread meta description auto-fix - generates fallback descriptions for threads with empty/short first posts. Cleans BBCode artifacts and extends short descriptions with forum/board context.
  • 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, content type (thread, forum, category, page), and issue type. Sortable by any column including impact score (severity × page views). All counts in the report header, issue summary, and per-forum breakdown are clickable links that drill down to filtered views.
  • Paginated - configurable per-page display (50 / 100 / 200 / 500) 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
  • Email digest - periodic SEO summary email (weekly/biweekly/monthly) with score trend and issue breakdown
  • 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

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

  Technical Details

  • 1 class extension (DiscussionHandler for thread JSON-LD enrichment), 2 template modifications and 1 event listener
  • 6 database tables (all prefixed xf_qubn_seoaudit_*): reports, issues, scan dedup, URL cache, dismissed issues, autofix log
  • 4 cron entries: autofix log cleanup (daily), scheduled scan trigger, URL cache cleanup (daily), digest email
  • 19 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
• Version

  1.3.2 Stable Available Mar 21, 2026 · 1

  Download

  File size: 112 KB

  SHA-256: 6184db371f0ab4cad3cd487a1ea5d139c8e20338b6a33f7933cf22809011a15e

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  SEO Audit v1.3.2 - URL Extraction Fix

  Fixes a remaining issue reported by @akok where internal and external links were flagged as broken due to a trailing quote being appended during URL extraction.
  
  

  ---

  
  

  Bug Fix

  • Link checker trailing quote - the plain URL regex was re-matching inside already-parsed [URL='...'] BBCode blocks, capturing the closing quote as part of the URL. This caused valid links to be reported as broken with ' appended. The fix strips all [URL] blocks before running the plain URL regex, making duplicate extraction impossible.

  
  

  Upgrading

  Upload the ZIP via Admin CP > Add-ons > Install/upgrade from archive. No database migration needed. Code-only update.
  
  

  Requirements

  • XenForo 2.3.0+

  1.1.0 Stable Available Mar 16, 2026 · 0

  Download

  File size: 1.5 MB

  SHA-256: d2145612b7a3eb9b955b2983e7ff1add703f46b54ad8b4f11142ef9a8a314b8b

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  New Features
  

  • Webhook notifications - send scan results to Discord or Slack when a scan completes.
  • CLI scanner - run scans from the command line with qubn-seoaudit:scan. Supports flags for delta mode, forum targeting, date ranges, email notifications, and more.
  • Email notifications - receive an email when scans complete. Works with scheduled scans and CLI --email flag.
  • Critical issue alerts - get emailed when new critical issue types appear.
  • Score improvement hints - actionable suggestions showing which fixes will boost your SEO score the most.
  • Impact-ranked issues - issues are now ranked by priority score (severity x frequency), so you fix what matters first.
  • Per-forum breakdown - see how issues are distributed across your forums.
  • BreadcrumbList JSON-LD - auto-injects BreadcrumbList structured data on all pages with breadcrumbs.
  • ALL CAPS title case correction - auto-fix converts ALL CAPS thread titles to title case at render time.
  • Auto-fix audit log - full log of every auto-fix injection with date, type, URL, and injected HTML. Includes debug logging toggle.
  • AdminCP dashboard widget - your current SEO score and grade displayed on the main AdminCP page.
  • Category trend chart - stacked bar chart showing config/schema/meta/content/links/HTML issue counts over time.
  • Bulk dismiss and dismiss-by-type - dismiss multiple issues at once, with undo support.

  
  Improvements
  

  • Autofix page buttons now render inline (no longer stacking vertically)
  • Fix it buttons use primary styling for better visibility
  • Scan form integrated directly into the dashboard
  • Scheduled scan frequency shown on dashboard
  • Autofix log now humanizes raw identifiers (e.g., "missing_meta_description" → "Missing Meta Description")
  • All user-facing text fully phraseified for i18n readiness (160+ new phrases)
  • Fixed issue config page crash when option value is already decoded as array by XF

  
  Upgrading
  Upload the ZIP via Admin CP > Add-ons > Install/upgrade from archive. Three upgrade steps run automatically:
  

  1. Marks any pending scans as failed and adds redirect tracking to URL cache
  2. Adds per-forum tracking to issues
  3. Creates the autofix_log table

  
  All existing scan data and reports are preserved.
  
  Requirements
  

  • XenForo 2.3.0+

  1.0.1 Stable Available Mar 13, 2026 · 0

  Download

  File size: 1.5 MB

  SHA-256: e58d449dda0d466f69d1266412d8f56f750d6a37b9f6684c72127b8a13da2178

  SHA-256 verified Package valid Compatibility checked Last verified: Wednesday at 12:10 AM

  View attachment 5701​

  
  

  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
  • Thread JSON-LD enrichment - enriches XF core's native DiscussionForumPosting with commentCount, isPartOf (DiscussionForum), and author fallback for deleted/banned users. Uses class extension, no duplicate structured data.
  • Thread meta description auto-fix - generates fallback descriptions for threads with empty/short first posts. Cleans BBCode artifacts and extends short descriptions with forum/board context.
  • 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, content type (thread, forum, category, page), and issue type. Sortable by any column including impact score (severity × page views). All counts in the report header, issue summary, and per-forum breakdown are clickable links that drill down to filtered views.
  • Paginated - configurable per-page display (50 / 100 / 200 / 500) 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
  • Email digest - periodic SEO summary email (weekly/biweekly/monthly) with score trend and issue breakdown
  • 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

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

  Technical Details

  • 1 class extension (DiscussionHandler for thread JSON-LD enrichment), 2 template modifications and 1 event listener
  • 6 database tables (all prefixed xf_qubn_seoaudit_*): reports, issues, scan dedup, URL cache, dismissed issues, autofix log
  • 4 cron entries: autofix log cleanup (daily), scheduled scan trigger, URL cache cleanup (daily), digest email
  • 19 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
• Discussion

  This resource has a discussion thread on the forum where you can ask questions, report issues, and talk with the author and other users.

  Join the discussion (3)