Skip to content

v3.0.0 - Customizable Blocked Page & Enhanced Logging

Choose a tag to compare

@rabsym rabsym released this 17 Feb 08:51
· 10 commits to main since this release

🎉 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-fpm

Activate 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

📝 Changelog

See [CHANGELOG.md](CHANGELOG.md) for complete version history.


Full Changelog: v2.0.0...v3.0.0