Attachment Integrity for XenForo 2.3
Attachment Integrity is a powerful attachment auditing, repair and storage analysis addon for XenForo.
Built for both small forums and large communities with millions of attachments, including support for external storage providers such as Cloudflare R2 and S3-compatible systems.
Main features
The scalable scan engine supports chunked low-priority background processing to avoid ACP timeouts and reduce load on large forums.
Supports:
Safe duplicate cleanup
Duplicate cleanup uses a dry-run first workflow and intentionally avoids deleting referenced attachments automatically.
Only duplicate attachment data rows with zero active attachment references are considered safe for automated deletion.
Current status
This addon is currently considered an early access / beta release while additional large-scale testing and edge-case hardening continues.
Recommended before production deployment:
Version 5.5.4 :
- Turns out the bulk action form wasn’t actually submitting correctly in certain situations, which is why nothing appeared to happen when pressing “Search and process”.
- I’ve corrected it properly for v5.5.4 and reworked the form handling through XenForo’s normal framework flow rather than relying on the previous implementation.
Télécharger V5.5.4 :
Attachment Integrity is a powerful attachment auditing, repair and storage analysis addon for XenForo.
Built for both small forums and large communities with millions of attachments, including support for external storage providers such as Cloudflare R2 and S3-compatible systems.
Main features
- Attachment integrity scanning
- Missing attachment detection
- Advanced thumbnail verification
- Duplicate attachment detection
- Safe duplicate cleanup workflow
- Attachment repair queue system
- Background low-priority scalable scans
- Cloudflare R2 / external storage awareness
- Storage analytics and reporting
- Attachment age reports
- Per-user attachment statistics
- Export tools (CSV / JSON / TSV / HTML)
- Scheduled scan support
- Critical issue email alerts
- Repair audit logging
- Archived scan history
- Enhanced filtering/search tools
- ACP dashboard panels and widgets
- CLI support for large forums
The scalable scan engine supports chunked low-priority background processing to avoid ACP timeouts and reduce load on large forums.
Supports:
- local filesystem storage
- XenForo filesystem abstraction
- Cloudflare R2
- S3-compatible storage
Safe duplicate cleanup
Duplicate cleanup uses a dry-run first workflow and intentionally avoids deleting referenced attachments automatically.
Only duplicate attachment data rows with zero active attachment references are considered safe for automated deletion.
Current status
This addon is currently considered an early access / beta release while additional large-scale testing and edge-case hardening continues.
Recommended before production deployment:
- full database backup
- filesystem backup
- testing on a staging environment first
Pour consulter le contenu, vous devez : Se connecter ou S'inscrire.
This update focuses heavily on stability, scalability and real-world forum support after a large amount of backend work and testing.
New in 5.2.1
Duplicate cleanup has been intentionally designed to avoid dangerous automatic deletions.
The addon now:
Large forum improvements
The scalable scan engine is designed for forums with very large attachment libraries and external object storage.
Supports:
Additional notes
This release also includes:
Changes in 5.2.2
Attachment Integrity 5.4.5 Released
This update focuses mainly on stability, scan accuracy and improving support for larger forums using external storage providers such as S3 and Cloudflare R2.
Updated in 5.4.5:
I’ve pushed another update that clears the compiled phrase row and refreshes the ACP nav phrase on upgrade
Updated in 5.4.6 :
Done a fair bit of work on this update after some proper testing on larger forums and external storage setups.
Main fixes in this version:
Updated in 5.4.7 :
I’ve pushed another update that clears the compiled phrase row and refreshes the ACP nav phrase on upgrade
Attachment Integrity v5.5.0 Update
New in 5.2.1
- Low-priority scalable background scans
- Cloudflare R2 / external storage aware scanning
- Chunked scan processing for very large forums
- Resumable scan state system
- Safe duplicate attachment cleanup workflow
- Duplicate cleanup dry-run mode
- Duplicate cleanup audit logging
- Improved repair queue handling
- Better ACP scan management
- Enhanced attachment verification checks
- Improved button/action wiring validation
- Storage probe and adapter detection
- Additional reporting and analytics improvements
Duplicate cleanup has been intentionally designed to avoid dangerous automatic deletions.
The addon now:
- detects duplicate attachment data
- builds a cleanup queue
- performs dry-run validation first
- only deletes duplicate data rows with zero active attachment references
Large forum improvements
The scalable scan engine is designed for forums with very large attachment libraries and external object storage.
Supports:
- local filesystem storage
- Cloudflare R2
- S3-compatible storage
- XenForo filesystem abstraction
Additional notes
This release also includes:
- template cleanup
- controller/action verification
- PHP lint validation
- XML validation
- improved internal wiring checks
- please back up your forum before running repair/cleanup tools
- staging/testing is recommended before production deployment on very large forums
Changes in 5.2.2
- Improved export handling
- Added explicit CSV export support/validation
- Improved admin permission handling
- Additional ACP button/action validation
- Additional service/job wiring checks
- Additional XML validation cleanup
- Internal release-readiness checks and cleanup
- General backend stability improvements
Attachment Integrity 5.4.5 Released
This update focuses mainly on stability, scan accuracy and improving support for larger forums using external storage providers such as S3 and Cloudflare R2.
Updated in 5.4.5:
- Added proper "hashes.json" support for XenForo file health checks
- Fixed scalable/background scan failures on stricter MySQL setups
- Improved remote storage detection for S3/R2 environments
- Removed misleading local disk free-space reporting on external storage
- Duplicate attachment analytics now only show confirmed scan results
- Missing thumbnail analytics now only show confirmed scan results
- Disabled unsupported local thumbnail sampling/benchmark checks for remote storage
- Improved ACP navigation phrase handling
- Additional backend stability improvements and cleanup across scan handling and analytics
I’ve pushed another update that clears the compiled phrase row and refreshes the ACP nav phrase on upgrade
Updated in 5.4.6 :
Done a fair bit of work on this update after some proper testing on larger forums and external storage setups.
Main fixes in this version:
- Fixed S3/R2 scans incorrectly flagging attachments as missing
- Files are now only marked missing if the addon can actually verify they’re gone
- Improved external storage handling and remote object checks
- Standard scans now use the storage adapter properly instead of local-only checks
- Fixed ACP navigation phrase issues
- Added proper hashes.json support for XenForo file health checks
- General cleanup and stability improvements across the scan system
- XML validation
- PHP syntax checks
- ACP route/button checks
- permission checks
- hashes verification
- scalable/background scan checks
Updated in 5.4.7 :
I’ve pushed another update that clears the compiled phrase row and refreshes the ACP nav phrase on upgrade
Attachment Integrity v5.5.0 Update
- Scheduled automatic integrity scans
- Email notifications for critical issues
- Attachment repair queue system
- Advanced thumbnail verification
- Storage usage analytics
- Duplicate attachment detection
- Attachment age reporting
- Per-user attachment statistics
- CLI scan and repair commands for large forums
- Improved repair automation (one-click repair, guided maintenance)
- Additional export formats (CSV, JSON, TSV, HTML)
- Storage benchmarking
- ACP dashboard widget
- Archived scan history
- Enhanced filtering and search (per-forum scans, severity filtering)
- Bulk delete attachments by filename pattern with dry-run preview before committing
- Background scans now start properly instead of silently completing with no results
- Stale scans stuck running for 2+ hours are automatically marked as failed
- Email alerts for critical issues now report the correct issue count
- Fixed file health check showing false "missing" results due to incorrect hash format
- All XML data files updated to XF 2.3 format for clean installs on any site
- New "Bulk actions" sectionadded to the ACP page with:
- Filename pattern search field (searches ALL attachments, not just scan results)
- Dry run checkbox (on by default) — previews what would be deleted
- Confirmation checkbox required for live deletion
- "Search and process" button
- Clarifying note added to the Results filter: "Filters below search scan results only. Run a scan first to populate this table. To search all attachments by filename, use the Bulk actions section."
- Turns out the bulk action form wasn’t actually submitting correctly in certain situations, which is why nothing appeared to happen when pressing “Search and process”.
- I’ve corrected it properly for v5.5.4 and reworked the form handling through XenForo’s normal framework flow rather than relying on the previous implementation.
Télécharger V5.5.4 :
Pour consulter le contenu, vous devez : Se connecter ou S'inscrire.
Pièces jointes
-
Screenshot_20260518_192932_Chrome.webp44.5 KB · Affichages: 4 -
Screenshot_20260518_192946_Chrome.webp64.1 KB · Affichages: 4 -
Screenshot_20260518_192956_Chrome.webp65.8 KB · Affichages: 4 -
Screenshot_20260518_193002_Chrome.webp70 KB · Affichages: 4 -
Screenshot_20260518_193013_Chrome.webp46.1 KB · Affichages: 4 -
Screenshot_20260518_193024_Chrome.webp27.6 KB · Affichages: 4 -
Screenshot_20260518_193030_Chrome.webp30 KB · Affichages: 4

