Free Qubn - SEO Audit 1.3.2

SEO Audit for XenForo 2.3+​

• 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)

• 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

• 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

php cmd.php qubn-seoaudit:scan [options]

• 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​

• A = 90+
• B = 80-89
• C = 70-79
• D = 60-69
• F = below 60

• 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)

• 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

• 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

• 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

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

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

• 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