AdamSmartSearchUI

Enhanced unified search module for FreeScout.

Version: 2.5.0 Author: AdamCoffeeOverflow

Features

• Exact numeric conversation search (conversation ID or thread ID)
• Common wrappers supported (#123, [#123], (123))
• Email search
• Phone search
• Customer name search
• CustomFields (Freescout Module Compatible) search
• Optional status filter (Any / Open / Pending / Closed, etc.)
• Optional folder filter (auto-hides if folders are not available in your FreeScout DB)
• Mailbox permission-safe filtering
• Performance-optimized queries
• Multilingual UI (ships with English + French)

UI enhancements

• Always-visible topbar search input (next to notifications)
• Native magnifier hidden by default (configurable)
• Keyboard shortcut: press / to focus the topbar search
• Lightweight autosuggest dropdown (permission-safe)
• Small focus animation for intentional feel
• Dark-mode friendly styles (prefers-color-scheme + future body classes)

Install

1. Download the Release Version for easy install (Do not download via <> Code link)
2. Copy the module folder into your FreeScout instance:
   • Modules/AdamSmartSearchUI
3. Activate it in Manage → Modules.
4. (Optional) clear caches:
   • php artisan cache:clear

Updates

This module can be updated in Freescout module page (if available), for future GitHub releases.

Compatibility

• FreeScout >= 1.8.0+
• CustomFields module

License

AGPL-3.0

Notes

• happy searching!