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.

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. For many common problems, one-click auto-fix handles the correction automatically.

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 & Corrections

• JSON-LD schema injection - automatically adds structured data markup (Article, DiscussionForumPosting, BreadcrumbList, WebSite)
• Meta description generation - generates missing meta descriptions from content
• Open Graph tags - ensures proper og:title, og:description, and og:image tags are present

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
   Code:

   Qubn/SEOAudit

   directory to
   Code:

   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 > SEO Audit to run your first scan

Getting Started​

1. After installation, go to Admin CP > SEO Audit > Dashboard
2. Click Run Scan to perform your initial full audit
3. Review issues grouped by category and severity
4. Use the Auto-Fix buttons to correct common issues with one click
5. Configure issue thresholds and severity levels under Settings to match your priorities
6. (Optional) Set up a cron schedule for automatic periodic scans

Admin CP Pages​

• Dashboard - overall score, grade, category breakdown, and trend charts
• Reports - list of all scan reports with comparison tools
• Issues - filterable issue list with dismiss and auto-fix actions
• Settings - thresholds, severity configuration, scan scope, email notifications

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
  Code:

  xf_error_log

• Steps to reproduce the issue