Releases: AdamCoffeeOverflow/freescout-Adam-Smart-SearchUI
Release list
2.8.2
🔎 AdamSmartSearchUI 2.8.2
A small usability update that makes the navbar search behave more naturally.
✨ What's Changed
- Clicking the navbar search magnifier now performs the same action as pressing Enter.
- Exact numeric conversation or ticket matches still open the matching conversation directly.
- All other searches continue into the full Smart Search workspace with the entered query preserved.
- Existing suggestions, recent searches, filters, and advanced search behavior are unchanged.
2.8.1
AdamSmartSearchUI 2.8.1
Compatibility and hardening release focused on FreeScout 1.8.233.
What's Changed
- Updated the supported FreeScout baseline from 1.8.232 to 1.8.233
- Reverified Smart Search against FreeScout 1.8.233 search and authorization behavior
- Improved search input normalization and server-side query limits
- Added bounded maximum query length and pagination limits
- Improved wildcard escaping for
%,_, and escape characters - Preserved strict mailbox and assigned-conversation visibility rules
- Improved bulk assignment, status, and note result handling
- Correctly distinguishes successful database changes from later post-commit warnings
- Improved safe diagnostic logging without exposing sensitive content
- Recent-search browser storage is now scoped to the authenticated user
- Removed legacy shared recent-search storage keys
- Improved PostgreSQL and malformed integer/input handling
- Added request throttling to Smart Search endpoints
- Removed obsolete compatibility helper usage
- Removed duplicate legacy image assets
- Cleaned and reduced the release package for GitHub distribution
Compatibility
- FreeScout: 1.8.233
- AdamSmartSearchUI: 2.8.1
- Laravel: FreeScout-compatible Laravel 5.5 APIs
- PHP: Maintains existing PHP-compatible syntax baseline
Upgrade
Replace the existing module folder:
Modules/AdamSmartSearchUI
with the version included in this release. You can also update it from your freescout instance > Manage > Modules > an update should appear.
No new database migration is required.
Existing Smart Search settings and functionality are preserved.
2.7.2 Hotfix (Compatibility)
This maintenance release improves Smart Search theme (dark mode) compatibility without changing search behavior.
Changes
- Fixed the Smart Search suggestions dropdown turning dark when Windows or the browser used dark mode while FreeScout remained in light mode.
- Added explicit light-theme text, heading, hover, focus, and keyboard-selection contrast.
- Improved dropdown readability in supported FreeScout dark themes.
- Improved highlighted search-result contrast.
- Preserved the v2.7.1 split-search performance improvements.
2.7.1
2.7.1 This release resolves the major search-performance regression introduced in v2.7.0 on large FreeScout installations as per #11 feedback reported.
- Fixed the major search slowdown introduced in v2.7.0.
- Separated fast search from message and internal-note content search.
- Kept navbar suggestions fast.
- Added an optional Search inside messages and internal notes mode.
- Restored README screenshots (these were removed accidentally) for Github module page.
Note - The split-search architecture removes the known v2.7.0 bottleneck. Final performance will still depend on the installation’s database engine, ticket volume, thread count, hardware, and selected search mode.
2.7.0
AdamSmartSearchUI v2.7.0
New - requested in discussion thread #10

- Added multi-select support to Smart Search results
- Added bulk assignment, status updates, and internal notes
- Added compact, action-specific bulk controls
Search improvements
- Improved numeric conversation and subject-title searching
- Improved conversation message, reply, and internal-note content matching
- Preserved stable navbar and mobile recent-search behavior
- Added deterministic result sorting for more reliable pagination
Compatibility and security
- Aligned assigned-only visibility with current FreeScout permissions
- Added authorization checks for exact numeric conversation lookups
- Improved Teams and assignment-extension compatibility
- Improved MySQL, PostgreSQL, and SQLite compatibility
- Hardened per-conversation permission checks for bulk actions
- Deleted conversations are skipped during bulk updates
Cleanup
- Improved provider bootstrapping and migration handling
- Prevented duplicate asset registration
- Completed English and French translation coverage
- Cleaned UI, responsive behavior, documentation, and module metadata
- Added the AdamCoffeeOverflow website link
Website
No FreeScout core files were modified.
2.6.8 Hotfix
Quick hotfix
Fixes the Smart Search navbar recent dropdown on mobile after the body-level
portal change. The dropdown now follows the mobile input width instead of
over-expanding across the screen.
Changes:
- constrain mobile recent dropdown width
- reduce mobile dropdown max-height
- add mobile-specific dropdown class handling
- preserve desktop hover expansion behavior
- keep body-level portal behavior to avoid clipping
- bump module version to 2.6.8
2.6.7
Summary
This release fixes the Smart Search mobile navbar experience.

Smart Search now remains visible in the collapsed/mobile navbar and is placed at the top of the navbar menu. The suggestions/recent-search dropdown now renders from document.body using fixed positioning, preventing dashboard/custom theme containers from clipping the dropdown background when typing.
Changed
- Kept Smart Search visible below 767px instead of hiding it on small screens.
- Added mobile navbar placement logic so the search appears at the top of the collapsed menu.
- Preserved desktop placement beside the notifications item.
- Moved the suggestions/recent-search dropdown to a body-level portal with fixed positioning.
- Added dropdown repositioning on window resize and scroll.
- Updated release metadata from
2.6.5to2.6.6. - Updated README UI enhancement notes.
QA
node --check Public/js/module.jspassed.python3 -m json.tool module.jsonpassed.php -lpassed for all PHP and Blade PHP files.- No inline JavaScript handlers or
javascript:links found. - No raw Blade
{!! ... !!}output found. - No FreeScout core files changed.
Deployment notes
Replace the existing Modules/AdamSmartSearchUI folder with this release package contents.
If the old UI still appears, clear cache or hard-refresh the browser to flush old compiled/minified assets.
Release asset
Upload the ZIP as:
AdamSmartSearchUI.zip
Additional fix that were broken from previous version:
fix(search-ui): restore hover expansion for navbar recent dropdown
- render navbar suggestions as a body-level portal to avoid clipping
- replace inline dropdown width with CSS variable sizing
- anchor desktop expanded dropdown to the right edge so it grows left
- preserve v2.6.5 search, permission, deleted-state, and migration hardening
2.6.5
Improvements & Fixes
Hardening release - Recommended
- Cleaned duplicate legacy migrations for safer module activation
- Improved Laravel 5.5 / PHP 7.x compatibility
- Hardened exact numeric search redirects to respect filters and assigned-only visibility
- Added safer search input sanitization
- Preserved numeric subject/title fallback, assignee filtering, and deleted-state badges
- Updated package metadata and README for GitHub release
2.6.1
Feature requested: [ #4 ]
- [New] Added assignee as a Smart Search filter
- [New] Supports Any assignee and Unassigned options
- [New] Applied assignee filtering to recent and search results
- Preserved numeric subject/title fallback improvements
- Improved compatibility with assigned-only search visibility rules
- Minor i18n cleanup
- Bumped from 2.6.0 > 2.6.1 (minor name convention fix)
2.5.1
What changed:
Fixed the Numeric-only shortcut path search.
Details:
- Fixed an issue where numeric-only searches could fail when the number existed
in the conversation subject/title but was not the actual conversation ID.
- Exact conversation/thread ID lookups still work as before.
Improvements
- Numeric queries now attempt exact ID resolution first, then fall back to the
regular search logic if no exact match is found.
- Improved compatibility with searches for order numbers and other numeric
references stored in conversation subjects.
Impact
- Searching a number such as an order number in the conversation title should
now return expected results.
- Existing direct conversation ID search behavior remains intact.