XF-Addon SEO Audit 1.0.0

SEO Audit
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.

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.

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


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

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

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