[qubn] SEO Audit 1.3.3

A comprehensive SEO auditing dashboard for XenForo administrators. Scan your forum for SEO issues, review detailed reports with severity grades, and auto-fix common problems, all from within your Admin CP.

Overview​

SEO Audit analyzes your forum across five categories, configuration, schema markup, meta tags, content quality, and link integrity, producing an overall SEO score with a letter grade (A through F). Issues are categorized by severity and presented with actionable recommendations. Each issue includes a "How to fix" recommendation. Where the fix involves a specific AdminCP page, a "Fix it" link takes you straight there.

Features​

Scanning & Analysis

• SEO score with letter grade (A-F) - instant overview of your forum's SEO health
• 5 checker categories - Config, Schema, Meta, Content, and Link checkers cover all major SEO concerns
• Delta scanning - only scan content that changed since the last scan, dramatically reducing scan time on large forums
• Forum and date scoping - target specific forums or date ranges for focused audits
• URL cache - previously checked URLs are cached to avoid redundant HTTP requests during link checks
• Scheduled scans - configure automatic scans via XenForo's cron system

Auto-Fix (Runtime Injection)

• JSON-LD schema injection - automatically adds structured data markup (CollectionPage for forums/categories, WebPage for pages, WebSite + Organization for homepage)
• Meta description generation - generates missing meta descriptions from content
• Open Graph tags - ensures proper og:title, og:description, and og:image tags are present

Auto-fix features are opt-in toggles that inject markup at page render time, nothing is written to the database. Configure via admin.php?seo-audit/auto-fix or under Admin CP > Setup > Options > SEO Audit.

Reporting & Tracking

• Score trend charts - track your overall SEO score over time
• Category trend charts - monitor improvement across individual checker categories
• Scan comparison - diff view between any two scan reports to see what changed
• Export as CSV or JSON - download full reports for external analysis or record-keeping
• Email notifications - receive an email summary when scans complete

Configuration & Customization

• Issue severity configuration - customize or completely disable individual issue types
• Detection thresholds - adjust limits for thin content word count, title length, description length, and more
• Issue dismissal - hide known or accepted issues from reports without affecting the scan

Requirements​

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

Installation​

1. Download and extract the release ZIP
2. Upload the Qubn/SEOAudit directory to src/addons/ on your server
3. Go to Admin CP > Add-ons and click Install/upgrade from archive, or install via CLI
   
   Code:

   php cmd.php xf-addon:install Qubn/SEOAudit

4. Navigate to Admin CP > Tools > SEO Audit to run your first scan

Getting Started​

1. After installation, go to Admin CP > Tools > SEO Audit
2. Click Run new scan to perform your initial full audit
3. Review issues grouped by category and severity
4. Issues with a specific AdminCP fix (configuration, forum descriptions, style properties) have a Fix it link that takes you directly to the right page
5. For automatic corrections, visit
   
   Code:

   admin.php?seo-audit/auto-fix

   and enable JSON-LD injection, meta descriptions, or OG tag filling, then re-scan to verify reduced issue counts
6. Customize thresholds and severity levels under Admin CP > Setup > Options > SEO Audit
7. (Optional) Set up a cron schedule for automatic periodic scans