Repository navigation
v3.0.0 - Customizable Blocked Page & Enhanced Logging
🎉 AttachmentSecurity v3.0.0 - Major Release
Enhanced security module for FreeScout with customizable blocking, role-based control, and production-ready logging.
🎨 What's New
Customizable Blocked Page
- Custom page title - Brand your security messages
- Dynamic message with variables - Use
{filename}and{extension} - Gradient backgrounds - Choose your colors (hex codes)
- Reset to defaults - One-click restore
⚡ Architecture Improvements
- Refactored codebase - Separated ServiceProvider and Middleware
- Better code organization - Follows Laravel best practices
- Production-ready logging - Clean, structured logs
- Optimized performance - Minimal overhead
📊 Enhanced Logging
Production logs now include:
[2026-02-16 10:35:22] [WARNING] [MIDDLEWARE] BLOCKING DOWNLOAD | {
"user": "user@example.com",
"ticket": "1523",
"file": "malware.exe",
"extension": "exe"
}- Real ticket numbers (not internal IDs)
- Filename and extension
- User identification
- Structured JSON format
🚀 Features
- ✅ Extension-based blocking - Configurable list of dangerous file types
- ✅ Role-based control - Block all users, regular users only, or disable
- ✅ Real-time configuration - No cache clearing needed
- ✅ Comprehensive logging - Track all blocked attempts
- ✅ User-friendly interface - Easy settings page
📦 Installation
cd /var/www/html/Modules
tar -xzf AttachmentSecurity_v3.0.0.tar.gz
sudo chown -R www-data:www-data AttachmentSecurity
php artisan cache:clear
sudo systemctl restart php8.x-fpmActivate in: Manage → Modules → Attachment Security
⚙️ Requirements
- FreeScout 1.8.0 or higher
- PHP 7.4 or higher
- Write permissions on
storage/logs/directory
📖 Documentation
Full documentation available in [README.md](README.md)
🔄 Upgrading from v2.0.0
No breaking changes - simply replace the module folder and restart PHP-FPM.
🐛 Bug Fixes
- Fixed logging to use actual ticket numbers instead of internal IDs
- Improved error handling for missing conversations
- Optimized attachment ID extraction from URLs
🙏 Support
- ⭐ Star this repo if you find it useful!
- 🐛 Report issues on [GitHub Issues](https://github.com/rabsym/freescout-attachment-security/issues)
- 💬 Discussions for questions and feature requests
- ☕ Donate via [PayPal](https://www.paypal.com/paypalme/rabsym)
📝 Changelog
See [CHANGELOG.md](CHANGELOG.md) for complete version history.
Full Changelog: v2.0.0...v3.0.0