nodebb-plugin-chat-search 1.2.0 → 1.4.0

package/README.md

@@ -0,0 +1,77 @@
+# NodeBB Global Chat Search
+
+Standard chat search in NodeBB works well when you already know which room the message is in. But sometimes you remember the message — not the chat.
+
+**NodeBB Global Chat Search** solves this by adding a global search bar to the chat sidebar, allowing you to search across **all conversations you have ever participated in**.
+
+---
+
+## 🚀 Features
+
+**Global Context**  
+Searches across all room IDs associated with your user account.
+
+**Performance Focused**  
+Messages are fetched in batches of 50 to keep the server responsive even during deep searches.
+
+**Sticky UI**  
+Your search query and results remain visible when navigating between chat rooms.
+
+**Smart Navigation**  
+Clicking a search result scrolls directly to the message and highlights it with a smooth transition.
+
+**Rich Previews**  
+Results include room names, sender avatars, and timestamps, matching the native NodeBB interface.
+
+---
+
+## 🛠 Technical Details
+
+**Hooks Used**
+
+- `static:app.load` — server initialization  
+- `filter:scripts.client` — injecting the search interface into the chat UI
+
+**DOM Management**
+
+Uses a `MutationObserver` to ensure the search bar is injected correctly regardless of how the chat page loads.
+
+**State Management**
+
+Implements `window.chatSearchState` so search results persist during Ajaxify navigation.
+
+**Compatibility**
+
+Built for NodeBB **^3.0.0**
+
+---
+
+## 📥 Installation
+
+Install the plugin via terminal:
+
+```bash
+npm install nodebb-plugin-chat-search
+```
+Then:
+
+1. Activate the plugin in the **Admin Control Panel (ACP)**
+2. **Rebuild** your NodeBB instance
+3. **Restart** the forum
+
+---
+
+## 🔗 Links
+
+**GitHub**  
+https://github.com/palmoni5/nodebb-plugin-chat-search
+
+**Issues**  
+Report bugs or request features via the repository issue tracker.
+
+---
+
+## 💬 Feedback
+
+Feedback, suggestions, and feature requests are welcome.  
+If this plugin helps you, consider starring the repository ⭐

package/library.js

@@ -1,110 +1,140 @@
-'use strict';
-
-const messaging = require.main.require('./src/messaging');
-const user = require.main.require('./src/user');
-const db = require.main.require('./src/database');
-
-const plugin = {};
-
-plugin.init = async (params) => {
-    const socketPlugins = require.main.require('./src/socket.io/plugins');
-    socketPlugins.chatSearch = {};
-    socketPlugins.chatSearch.searchGlobal = searchGlobal;
-};
-
-plugin.addClientScript = async (scripts) => {
-    scripts.push('plugins/nodebb-plugin-chat-search/static/lib/main.js');
-    return scripts;
-};
-
-async function searchGlobal(socket, data) {
-    if (!socket.uid) throw new Error('Not logged in');
-    
-    let targetUid = socket.uid;
-    if (data.targetUid && parseInt(data.targetUid, 10) !== parseInt(socket.uid, 10)) {
-        const isAdmin = await user.isAdministrator(socket.uid);
-        if (!isAdmin) throw new Error('אין הרשאה.');
-        targetUid = data.targetUid;
-    }
-
-    const query = data.query;
-    const roomIds = await db.getSortedSetRevRange('uid:' + targetUid + ':chat:rooms', 0, -1);
-    let allResults = [];
-
-    for (const roomId of roomIds) {
-        const inRoom = await messaging.isUserInRoom(targetUid, roomId);
-        if (!inRoom) continue;
-
-        try {
-            let start = 0;
-            const batchSize = 50;
-            let roomMatches = [];
-            let continueFetching = true;
-
-            while (continueFetching) {
-                const messages = await messaging.getMessages({ 
-                    callerUid: socket.uid, 
-                    uid: targetUid, 
-                    roomId: roomId, 
-                    isNew: false, 
-                    start: start, 
-                    stop: start + batchSize - 1 
-                });
-
-                if (!messages || !Array.isArray(messages) || messages.length === 0) {
-                    continueFetching = false;
-                    break;
-                }
-
-                const matches = messages.filter(msg => 
-                    msg.content && msg.content.toLowerCase().includes(query.toLowerCase())
-                );
-                
-                if (matches.length > 0) {
-                    roomMatches = roomMatches.concat(matches);
-                }
-
-                if (messages.length < batchSize) {
-                    continueFetching = false;
-                } else {
-                    start += batchSize;
-                }
-            }
-
-            if (roomMatches.length > 0) {
-                const uids = await messaging.getUidsInRoom(roomId, 0, -1);
-                const usersData = await user.getUsersFields(uids, ['uid', 'username', 'picture', 'icon:text', 'icon:bgColor']);
-                const otherUsers = usersData.filter(u => parseInt(u.uid, 10) !== parseInt(targetUid, 10));
-
-                let displayName = '';
-                if (otherUsers.length === 0) displayName = 'צ\'אט עצמי';
-                else if (otherUsers.length <= 2) displayName = otherUsers.map(u => u.username).join(', ');
-                else {
-                    const firstTwo = otherUsers.slice(0, 2).map(u => u.username).join(', ');
-                    const remaining = otherUsers.length - 2;
-                    displayName = `${firstTwo} ועוד ${remaining} משתמשים`;
-                }
-
-                const roomData = await messaging.getRoomData(roomId);
-                let roomName = (roomData && roomData.roomName) || displayName;
-
-                roomMatches.forEach(m => {
-                    if (!m.user || !m.user.username) {
-                        const sender = usersData.find(u => parseInt(u.uid, 10) === parseInt(m.fromuid, 10));
-                        m.user = sender || { username: 'Unknown', 'icon:bgColor': '#aaa' };
-                    }
-                    m.roomName = roomName;
-                    m.targetUid = targetUid;
-                    m.participants = otherUsers;
-                });
-                
-                allResults = allResults.concat(roomMatches);
-            }
-        } catch (err) { 
-            console.error(`[Chat Search] Error in room ${roomId}: ${err.message}`); 
-        }
-    }
-    return allResults;
-}
-
-module.exports = plugin;
+'use strict';
+
+const messaging = require.main.require('./src/messaging');
+const user = require.main.require('./src/user');
+const db = require.main.require('./src/database');
+
+const plugin = {};
+
+plugin.init = async (params) => {
+    const socketPlugins = require.main.require('./src/socket.io/plugins');
+    socketPlugins.chatSearch = {};
+    socketPlugins.chatSearch.searchGlobal = searchGlobal;
+};
+
+plugin.addClientScript = async (scripts) => {
+    scripts.push('plugins/nodebb-plugin-chat-search/static/lib/main.js');
+    return scripts;
+};
+
+async function getMessagesForSearch(params) {
+    const { callerUid, targetUid, roomId, start, stop, allowFullHistory } = params;
+    if (allowFullHistory) {
+        const mids = await db.getSortedSetRevRange(`chat:room:${roomId}:mids`, start, stop);
+        if (!mids || !mids.length) return [];
+        mids.reverse();
+        const messages = await messaging.getMessagesData(mids, targetUid, roomId, false);
+        messages.forEach((msg) => {
+            if (!msg.mid && msg.messageId) msg.mid = msg.messageId;
+        });
+        return messages;
+    }
+    const messages = await messaging.getMessages({
+        callerUid: callerUid,
+        uid: targetUid,
+        roomId: roomId,
+        isNew: false,
+        start: start,
+        stop: stop,
+    });
+    return messages || [];
+}
+
+async function searchGlobal(socket, data) {
+    if (!socket.uid) throw new Error('Not logged in');
+    const isAdmin = await user.isAdministrator(socket.uid);
+    
+    let targetUid = socket.uid;
+    if (data.targetUid && parseInt(data.targetUid, 10) !== parseInt(socket.uid, 10)) {
+        if (!isAdmin) throw new Error('אין הרשאה.');
+        targetUid = data.targetUid;
+    }
+
+    const query = data.query;
+    const requestedRoomIds = Array.isArray(data.roomIds) ? data.roomIds : null;
+    const roomIds = requestedRoomIds && requestedRoomIds.length
+        ? [...new Set(requestedRoomIds.map(rid => parseInt(rid, 10)).filter(rid => Number.isFinite(rid) && rid > 0))]
+        : await db.getSortedSetRevRange('uid:' + targetUid + ':chat:rooms', 0, -1);
+    let allResults = [];
+    const allowFullHistory = isAdmin && requestedRoomIds && requestedRoomIds.length;
+
+    for (const roomId of roomIds) {
+        if (!isAdmin) {
+            const inRoom = await messaging.isUserInRoom(targetUid, roomId);
+            if (!inRoom) continue;
+        }
+
+        try {
+            let start = 0;
+            const batchSize = 50;
+            let roomMatches = [];
+            let continueFetching = true;
+
+            while (continueFetching) {
+                const messages = await getMessagesForSearch({
+                    callerUid: socket.uid,
+                    targetUid: targetUid,
+                    roomId: roomId,
+                    start: start,
+                    stop: start + batchSize - 1,
+                    allowFullHistory: allowFullHistory,
+                });
+
+                if (!messages || !Array.isArray(messages) || messages.length === 0) {
+                    continueFetching = false;
+                    break;
+                }
+
+                const matches = messages.filter(msg => 
+                    msg.content && msg.content.toLowerCase().includes(query.toLowerCase())
+                );
+                
+                if (matches.length > 0) {
+                    roomMatches = roomMatches.concat(matches);
+                }
+
+                if (messages.length < batchSize) {
+                    continueFetching = false;
+                } else {
+                    start += batchSize;
+                }
+            }
+
+            if (roomMatches.length > 0) {
+                const uids = await messaging.getUidsInRoom(roomId, 0, -1);
+                const usersData = await user.getUsersFields(uids, ['uid', 'username', 'picture', 'icon:text', 'icon:bgColor']);
+                const otherUsers = usersData.filter(u => parseInt(u.uid, 10) !== parseInt(targetUid, 10));
+
+                let displayName = '';
+                if (otherUsers.length === 0) displayName = 'צ\'אט עצמי';
+                else if (otherUsers.length <= 2) displayName = otherUsers.map(u => u.username).join(', ');
+                else {
+                    const firstTwo = otherUsers.slice(0, 2).map(u => u.username).join(', ');
+                    const remaining = otherUsers.length - 2;
+                    displayName = `${firstTwo} ועוד ${remaining} משתמשים`;
+                }
+
+                const roomData = await messaging.getRoomData(roomId);
+                let roomName = (roomData && roomData.roomName) || displayName;
+
+                roomMatches.forEach(m => {
+                    if (!m.roomId) m.roomId = roomId;
+                    if (!m.user || !m.user.username) {
+                        const sender = usersData.find(u => parseInt(u.uid, 10) === parseInt(m.fromuid, 10));
+                        m.user = sender || { username: 'Unknown', 'icon:bgColor': '#aaa' };
+                    }
+                    m.roomName = roomName;
+                    m.targetUid = targetUid;
+                    m.participants = otherUsers;
+                });
+                
+                allResults = allResults.concat(roomMatches);
+            }
+        } catch (err) { 
+            console.error(`[Chat Search] Error in room ${roomId}: ${err.message}`); 
+        }
+    }
+    return allResults;
+}
+
+module.exports = plugin;

package/package.json

@@ -1,18 +1,18 @@
-{
-  "name": "nodebb-plugin-chat-search",
-  "version": "1.2.0",
-  "description": "A plugin to search text within NodeBB chats",
-  "main": "library.js",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/palmoni5/nodebb-plugin-chat-search.git"
-  },
-  "bugs": {
-    "url": "https://github.com/palmoni5/nodebb-plugin-chat-search/issues"
-  },
-  "homepage": "https://github.com/palmoni5/nodebb-plugin-chat-search#readme",
-  "nbbpm": {
-    "compatibility": "^3.0.0"
-  },
-  "dependencies": {}
+{
+  "name": "nodebb-plugin-chat-search",
+  "version": "1.4.0",
+  "description": "A plugin to search text within NodeBB chats",
+  "main": "library.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/palmoni5/nodebb-plugin-chat-search.git"
+  },
+  "bugs": {
+    "url": "https://github.com/palmoni5/nodebb-plugin-chat-search/issues"
+  },
+  "homepage": "https://github.com/palmoni5/nodebb-plugin-chat-search#readme",
+  "nbbpm": {
+    "compatibility": "^3.0.0"
+  },
+  "dependencies": {}
 }

package/plugin.json

@@ -1,14 +1,14 @@
-{
-  "id": "nodebb-plugin-chat-search",
-  "url": "https://github.com/palmoni5/nodebb-plugin-chat-search",
-  "name": "Chat Search",
-  "description": "Allows searching in chat windows",
-  "library": "./library.js",
-  "hooks": [
-    { "hook": "static:app.load", "method": "init" },
-    { "hook": "filter:scripts.client", "method": "addClientScript" }
-  ],
-  "scripts": [
-    "static/lib/main.js"
-  ]
+{
+  "id": "nodebb-plugin-chat-search",
+  "url": "https://github.com/palmoni5/nodebb-plugin-chat-search",
+  "name": "Chat Search",
+  "description": "Allows searching in chat windows",
+  "library": "./library.js",
+  "hooks": [
+    { "hook": "static:app.load", "method": "init" },
+    { "hook": "filter:scripts.client", "method": "addClientScript" }
+  ],
+  "scripts": [
+    "static/lib/main.js"
+  ]
 }

package/static/lib/main.js

@@ -1,268 +1,318 @@
-'use strict';
-
-window.chatSearchState = window.chatSearchState || {
-    query: '',
-    resultsHtml: '',
-    isOpen: false,
-    lastScroll: 0
-};
-
-$(document).ready(function () {
-    const isHebrew = (document.documentElement.lang || 'en').startsWith('he');
-    
-    const txt = {
-        placeholder: isHebrew ? 'חפש הודעה...' : 'Search messages...',
-        searching: isHebrew ? 'מחפש...' : 'Searching...',
-        error: isHebrew ? 'שגיאה' : 'Error',
-        noResults: isHebrew ? 'לא נמצאו תוצאות.' : 'No results found.',
-        unknownUser: isHebrew ? 'לא ידוע' : 'Unknown'
-    };
-
-    let observer = null;
-
-    $(window).on('action:ajaxify.end', function (ev, data) {
-        if (observer) observer.disconnect();
-        const isChatUrl = data.url.match(/^(user\/[^\/]+\/)?chats/);
-        const isChatTemplate = data.template && (data.template.name === 'chats' || data.template === 'chats');
-
-        if (isChatUrl || isChatTemplate) {
-            initSearchInjection();
-        } else {
-            window.chatSearchState = { query: '', resultsHtml: '', isOpen: false, lastScroll: 0 };
-        }
-    });
-
-    $(window).on('action:chat.loaded', function (ev, data) {
-        highlightActiveChat();
-        handleScrollToMessage();
-    });
-
-    if (ajaxify.data.template && (ajaxify.data.template.name === 'chats' || ajaxify.data.template === 'chats')) {
-        initSearchInjection();
-    }
-
-    function initSearchInjection() {
-        if (!injectSearchBar()) {
-            const targetNode = document.body;
-            const config = { childList: true, subtree: true };
-            observer = new MutationObserver(function(mutationsList) {
-                const container = findContainer();
-                if (container.length > 0) {
-                    injectSearchBar(container);
-                    observer.disconnect(); 
-                }
-            });
-            observer.observe(targetNode, config);
-        }
-    }
-
-    function findContainer() {
-        let container = $('[component="chat/nav-wrapper"]'); 
-        if (container.length === 0) container = $('.chats-page').find('.col-md-4').first();
-        if (container.length === 0) container = $('[component="chat/list"]').parent();
-        return container;
-    }
-
-    function injectSearchBar(containerElement) {
-        const container = containerElement || findContainer();
-        if (container.length === 0) return false;
-        if ($('#global-chat-search-container').length > 0) return true;
-
-        const searchHtml = `
-            <div id="global-chat-search-container" style="padding: 10px; background: #fff; border-bottom: 1px solid #ddd; margin-bottom: 5px;">
-                <div class="input-group">
-                    <input type="text" id="global-chat-search" class="form-control" placeholder="${txt.placeholder}" style="font-size: 14px; height: 34px;">
-                    <span class="input-group-btn">
-                        <button class="btn btn-primary" id="btn-chat-search" type="button" style="height: 34px;"><i class="fa fa-search"></i></button>
-                    </span>
-                </div>
-                <div id="global-search-results" class="chats-list overflow-auto ghost-scrollbar" style="margin-top: 5px; max-height: 400px; display:none;"></div>
-            </div>
-        `;
-
-        container.prepend(searchHtml);
-        restoreState();
-        attachEvents();
-        return true;
-    }
-
-    function attachEvents() {
-        $('#btn-chat-search').off('click').on('click', executeSearch);
-        const input = $('#global-chat-search');
-        input.off('keypress').on('keypress', function (e) {
-            if (e.which === 13) executeSearch();
-        });
-        input.on('input', function() {
-            window.chatSearchState.query = $(this).val();
-        });
-        $('#global-search-results').on('scroll', function() {
-            window.chatSearchState.lastScroll = $(this).scrollTop();
-        });
-    }
-
-    function restoreState() {
-        const input = $('#global-chat-search');
-        const results = $('#global-search-results');
-        if (window.chatSearchState.query) input.val(window.chatSearchState.query);
-        if (window.chatSearchState.isOpen && window.chatSearchState.resultsHtml) {
-            results.html(window.chatSearchState.resultsHtml).show();
-            if ($.fn.timeago) results.find('.timeago').timeago();
-            if (window.chatSearchState.lastScroll > 0) results.scrollTop(window.chatSearchState.lastScroll);
-            highlightActiveChat();
-        }
-    }
-
-    function buildAvatarHtml(user, sizePx, extraStyle = '', extraClasses = '') {
-        const sizeVal = sizePx + 'px';
-        const bgStyle = `background-color: ${user['icon:bgColor'] || '#5c5c5c'};`;
-        const commonStyle = `style="--avatar-size: ${sizeVal}; width: ${sizeVal}; height: ${sizeVal}; line-height: ${sizeVal}; ${bgStyle} ${extraStyle}"`;
-        const classes = `avatar avatar-rounded ${extraClasses}`;
-
-        if (user.picture) {
-            return `<span title="${user.username}" class="${classes}" component="avatar/picture" ${commonStyle}><img src="${user.picture}" alt="${user.username}" class="avatar avatar-rounded"></span>`;
-        }
-        
-        const text = user['icon:text'] || (user.username ? user.username[0].toUpperCase() : '?');
-        return `<span title="${user.username}" class="${classes}" component="avatar/icon" ${commonStyle}>${text}</span>`;
-    }
-
-    function renderMainAvatars(participants) {
-        if (!participants || participants.length === 0) {
-             return `<div class="main-avatar">
-                        <span class="avatar avatar-rounded" style="--avatar-size: 32px; width:32px; height:32px; background-color: #ccc">?</span>
-                    </div>`;
-        }
-
-        return `<div class="main-avatar">
-                    ${buildAvatarHtml(participants[0], 32)}
-                </div>`;
-    }
-
-    function cleanContent(content) {
-        if (!content) return '';
-        return content.replace(/<\/?p[^>]*>/g, ' ').trim();
-    }
-
-    function executeSearch() {
-        const query = $('#global-chat-search').val();
-        const resultsContainer = $('#global-search-results');
-
-        if (!query) {
-            resultsContainer.hide();
-            window.chatSearchState.isOpen = false;
-            window.chatSearchState.resultsHtml = '';
-            return;
-        }
-
-        let targetUid = ajaxify.data.uid || app.user.uid;
-        
-        resultsContainer.show().html(`<div class="text-center" style="padding:10px;"><i class="fa fa-spinner fa-spin"></i> ${txt.searching}</div>`);
-        window.chatSearchState.isOpen = true;
-
-        socket.emit('plugins.chatSearch.searchGlobal', { query: query, targetUid: targetUid }, function (err, messages) {
-            if (err) {
-                resultsContainer.html(`<div class="alert alert-danger" style="margin:5px;">${txt.error}</div>`);
-                return;
-            }
-            if (!messages || messages.length === 0) {
-                const noRes = `<div class="text-center" style="padding:10px; color:#777;">${txt.noResults}</div>`;
-                resultsContainer.html(noRes);
-                window.chatSearchState.resultsHtml = noRes;
-                return;
-            }
-
-            let html = '<div class="d-flex flex-column">';
-            messages.forEach(msg => {
-                const isoTime = new Date(msg.timestamp).toISOString();
-                
-                let baseUrl = window.location.pathname.replace(/\/chats\/.*$/, '/chats');
-                if (baseUrl.endsWith('/')) baseUrl = baseUrl.slice(0, -1);
-                
-                const chatLink = baseUrl + '/' + msg.roomId + '?mid=' + msg.mid;
-                const senderName = (msg.user && msg.user.username) ? msg.user.username : txt.unknownUser;
-                
-                const mainAvatarHtml = renderMainAvatars(msg.participants);
-                const senderSmallAvatar = buildAvatarHtml(msg.user, 14, 'vertical-align: text-bottom;', 'align-middle');
-                
-                const cleanedContent = cleanContent(msg.content);
-
-                html += `
-                    <div component="chat/recent/room" class="rounded-1 search-result" data-roomid="${msg.roomId}">
-                        <div class="d-flex gap-1 justify-content-between">
-                            <a href="#" onclick="ajaxify.go('${chatLink}'); return false;" class="chat-room-btn position-relative d-flex flex-grow-1 gap-2 justify-content-start align-items-start btn btn-ghost btn-sm ff-sans text-start" style="padding: 0.5rem;">
-                                
-                                ${mainAvatarHtml}
-                                
-                                <div class="d-flex flex-grow-1 flex-column w-100" style="min-width:0;">
-                                    <div component="chat/room/title" class="room-name fw-semibold text-xs text-break">
-                                        ${msg.roomName}
-                                    </div>
-                                    <div component="chat/room/teaser">
-                                        
-                                        <div class="teaser-content text-sm line-clamp-3 text-break mb-0">
-                                            ${senderSmallAvatar}
-                                            <strong class="text-xs fw-semibold teaser-username">${senderName}:</strong> 
-                                            ${cleanedContent}
-                                        </div>
-                                        
-                                        <div class="teaser-timestamp text-muted text-xs" style="margin-top: 2px; line-height: 1;">
-                                            <span class="timeago" title="${isoTime}"></span>
-                                        </div>
-
-                                    </div>
-                                </div>
-                            </a>
-                        </div>
-                    </div>
-                    <hr class="my-1">
-                `;
-            });
-            html += '</div>';
-            
-            resultsContainer.html(html);
-            
-            if ($.fn.timeago) {
-                resultsContainer.find('.timeago').timeago();
-            }
-
-            window.chatSearchState.resultsHtml = html;
-            window.chatSearchState.lastScroll = 0;
-            highlightActiveChat();
-        });
-    }
-
-    function highlightActiveChat() {
-        let currentRoomId = ajaxify.data.roomId;
-        if (!currentRoomId) {
-             const match = window.location.pathname.match(/chats\/(\d+)/);
-             if (match) currentRoomId = match[1];
-        }
-        if (!currentRoomId) return;
-        $('.search-result').removeClass('active');
-        const activeItem = $('.search-result[data-roomid="' + currentRoomId + '"]');
-        activeItem.addClass('active');
-    }
-
-    function handleScrollToMessage() {
-        const params = new URLSearchParams(window.location.search);
-        const mid = params.get('mid');
-        if (!mid) return;
-        scrollToId(mid);
-        let attempts = 0;
-        const scrollInt = setInterval(() => {
-            attempts++;
-            if (scrollToId(mid) || attempts > 15) clearInterval(scrollInt);
-        }, 300);
-    }
-
-    function scrollToId(mid) {
-        const el = $('[data-mid="' + mid + '"]');
-        if (el.length > 0) {
-            el[0].scrollIntoView({ behavior: 'smooth', block: 'center' });
-            el.css('background', '#fffeca').css('transition', 'background 1s');
-            setTimeout(() => el.css('background', ''), 2000);
-            return true;
-        }
-        return false;
-    }
-});
+'use strict';
+
+window.chatSearchState = window.chatSearchState || {
+    query: '',
+    resultsHtml: '',
+    isOpen: false,
+    lastScroll: 0
+};
+
+$(document).ready(function () {
+    const isHebrew = (document.documentElement.lang || 'en').startsWith('he');
+    
+    const txt = {
+        placeholder: isHebrew ? 'חפש הודעה...' : 'Search messages...',
+        searching: isHebrew ? 'מחפש...' : 'Searching...',
+        error: isHebrew ? 'שגיאה' : 'Error',
+        noResults: isHebrew ? 'לא נמצאו תוצאות.' : 'No results found.',
+        unknownUser: isHebrew ? 'לא ידוע' : 'Unknown'
+    };
+
+    let observer = null;
+
+    $(window).on('action:ajaxify.end', function (ev, data) {
+        if (observer) observer.disconnect();
+        const isChatUrl = data.url.match(/^(user\/[^\/]+\/)?chats/);
+        const isChatTemplate = data.template && (data.template.name === 'chats' || data.template === 'chats');
+
+        if (isChatUrl || isChatTemplate) {
+            initSearchInjection();
+        } else {
+            window.chatSearchState = { query: '', resultsHtml: '', isOpen: false, lastScroll: 0 };
+        }
+    });
+
+    $(window).on('action:chat.loaded', function (ev, data) {
+        highlightActiveChat();
+        handleScrollToMessage();
+    });
+
+    if (ajaxify.data.template && (ajaxify.data.template.name === 'chats' || ajaxify.data.template === 'chats')) {
+        initSearchInjection();
+    }
+
+    function initSearchInjection() {
+        if (!injectSearchBar()) {
+            const targetNode = document.body;
+            const config = { childList: true, subtree: true };
+            observer = new MutationObserver(function(mutationsList) {
+                const container = findContainer();
+                if (container.length > 0) {
+                    injectSearchBar(container);
+                    observer.disconnect(); 
+                }
+            });
+            observer.observe(targetNode, config);
+        }
+    }
+
+    function findContainer() {
+        let container = $('[component="chat/nav-wrapper"]'); 
+        if (container.length === 0) container = $('.chats-page').find('.col-md-4').first();
+        if (container.length === 0) container = $('[component="chat/list"]').parent();
+        return container;
+    }
+
+    function injectSearchBar(containerElement) {
+        const container = containerElement || findContainer();
+        if (container.length === 0) return false;
+        if ($('#global-chat-search-container').length > 0) return true;
+
+        const searchHtml = `
+            <div id="global-chat-search-container" style="padding: 10px; background: #fff; border-bottom: 1px solid #ddd; margin-bottom: 5px;">
+                <div class="input-group">
+                    <input type="text" id="global-chat-search" class="form-control" placeholder="${txt.placeholder}" style="font-size: 14px; height: 34px;">
+                    <span class="input-group-btn">
+                        <button class="btn btn-primary" id="btn-chat-search" type="button" style="height: 34px;"><i class="fa fa-search"></i></button>
+                    </span>
+                </div>
+                <div id="global-search-results" class="chats-list overflow-auto ghost-scrollbar" style="margin-top: 5px; max-height: 400px; display:none;"></div>
+            </div>
+        `;
+
+        container.prepend(searchHtml);
+        restoreState();
+        attachEvents();
+        return true;
+    }
+
+    function attachEvents() {
+        $('#btn-chat-search').off('click').on('click', executeSearch);
+        const input = $('#global-chat-search');
+        input.off('keypress').on('keypress', function (e) {
+            if (e.which === 13) executeSearch();
+        });
+        input.on('input', function() {
+            window.chatSearchState.query = $(this).val();
+        });
+        $('#global-search-results').on('scroll', function() {
+            window.chatSearchState.lastScroll = $(this).scrollTop();
+        });
+    }
+
+    function restoreState() {
+        const input = $('#global-chat-search');
+        const results = $('#global-search-results');
+        if (window.chatSearchState.query) input.val(window.chatSearchState.query);
+        if (window.chatSearchState.isOpen && window.chatSearchState.resultsHtml) {
+            results.html(window.chatSearchState.resultsHtml).show();
+            if ($.fn.timeago) results.find('.timeago').timeago();
+            if (window.chatSearchState.lastScroll > 0) results.scrollTop(window.chatSearchState.lastScroll);
+            highlightActiveChat();
+        }
+    }
+
+    function buildAvatarHtml(user, sizePx, extraStyle = '', extraClasses = '') {
+        const sizeVal = sizePx + 'px';
+        const bgStyle = `background-color: ${user['icon:bgColor'] || '#5c5c5c'};`;
+        const commonStyle = `style="--avatar-size: ${sizeVal}; width: ${sizeVal}; height: ${sizeVal}; line-height: ${sizeVal}; ${bgStyle} ${extraStyle}"`;
+        const classes = `avatar avatar-rounded ${extraClasses}`;
+
+        if (user.picture) {
+            return `<span title="${user.username}" class="${classes}" component="avatar/picture" ${commonStyle}><img src="${user.picture}" alt="${user.username}" class="avatar avatar-rounded"></span>`;
+        }
+        
+        const text = user['icon:text'] || (user.username ? user.username[0].toUpperCase() : '?');
+        return `<span title="${user.username}" class="${classes}" component="avatar/icon" ${commonStyle}>${text}</span>`;
+    }
+
+    function renderMainAvatars(participants) {
+        if (!participants || participants.length === 0) {
+             return `<div class="main-avatar">
+                        <span class="avatar avatar-rounded" style="--avatar-size: 32px; width:32px; height:32px; background-color: #ccc">?</span>
+                    </div>`;
+        }
+
+        return `<div class="main-avatar">
+                    ${buildAvatarHtml(participants[0], 32)}
+                </div>`;
+    }
+
+    function cleanContent(content) {
+        if (!content) return '';
+        return content.replace(/<\/?p[^>]*>/g, ' ').trim();
+    }
+
+    function isAdminAllChatsPage() {
+        return !!(ajaxify && ajaxify.data && ajaxify.data.adminAllChats);
+    }
+
+    function getDisplayedRoomIds() {
+        const ids = [];
+        const seen = {};
+
+        function addRoomId(roomId) {
+            const rid = parseInt(roomId, 10);
+            if (rid && !seen[rid]) {
+                ids.push(rid);
+                seen[rid] = true;
+            }
+        }
+
+        // Prefer server payload when available (admin-chats all-chats page)
+        if (ajaxify && ajaxify.data) {
+            if (Array.isArray(ajaxify.data.rooms)) {
+                ajaxify.data.rooms.forEach(r => addRoomId(r && (r.roomId || r.roomid)));
+            }
+            if (Array.isArray(ajaxify.data.publicRooms)) {
+                ajaxify.data.publicRooms.forEach(r => addRoomId(r && (r.roomId || r.roomid)));
+            }
+        }
+
+        // Also scan DOM (covers infinite scroll appended rooms)
+        const $recent = $("[component=\"chat/recent\"]");
+        const $scope = $recent.length ? $recent : $("#content");
+
+        $scope.find("[data-roomid], [data-room-id], [data-roomId]").each(function () {
+            addRoomId($(this).attr("data-roomid") || $(this).attr("data-room-id") || $(this).attr("data-roomId"));
+        });
+
+        // Fallback: parse chat links (e.g. /chats/123 or chats/123)
+        $scope.find("a[href]").each(function () {
+            const href = $(this).attr("href") || "";
+            const m = href.match(/(?:^|\/)(?:user\/[^\/]+\/)?chats\/(\d+)/);
+            if (m && m[1]) addRoomId(m[1]);
+        });
+
+        return ids;
+    }
+
+    function executeSearch() {
+        const query = $('#global-chat-search').val();
+        const resultsContainer = $('#global-search-results');
+
+        if (!query) {
+            resultsContainer.hide();
+            window.chatSearchState.isOpen = false;
+            window.chatSearchState.resultsHtml = '';
+            return;
+        }
+
+        let targetUid = ajaxify.data.uid || app.user.uid;
+        
+        resultsContainer.show().html(`<div class="text-center" style="padding:10px;"><i class="fa fa-spinner fa-spin"></i> ${txt.searching}</div>`);
+        window.chatSearchState.isOpen = true;
+
+        const payload = { query: query, targetUid: targetUid };
+        if (isAdminAllChatsPage()) {
+            const roomIds = getDisplayedRoomIds();
+            if (roomIds.length) payload.roomIds = roomIds;
+        }
+
+        socket.emit('plugins.chatSearch.searchGlobal', payload, function (err, messages) {
+            if (err) {
+                resultsContainer.html(`<div class="alert alert-danger" style="margin:5px;">${txt.error}</div>`);
+                return;
+            }
+            if (!messages || messages.length === 0) {
+                const noRes = `<div class="text-center" style="padding:10px; color:#777;">${txt.noResults}</div>`;
+                resultsContainer.html(noRes);
+                window.chatSearchState.resultsHtml = noRes;
+                return;
+            }
+
+            let html = '<div class="d-flex flex-column">';
+            messages.forEach(msg => {
+                const isoTime = new Date(msg.timestamp).toISOString();
+                
+                let baseUrl = window.location.pathname.replace(/\/chats\/.*$/, '/chats');
+                if (baseUrl.endsWith('/')) baseUrl = baseUrl.slice(0, -1);
+                
+                const chatLink = baseUrl + '/' + msg.roomId + '?mid=' + msg.mid;
+                const senderName = (msg.user && msg.user.username) ? msg.user.username : txt.unknownUser;
+                
+                const mainAvatarHtml = renderMainAvatars(msg.participants);
+                const senderSmallAvatar = buildAvatarHtml(msg.user, 14, 'vertical-align: text-bottom;', 'align-middle');
+                
+                const cleanedContent = cleanContent(msg.content);
+
+                html += `
+                    <div component="chat/recent/room" class="rounded-1 search-result" data-roomid="${msg.roomId}">
+                        <div class="d-flex gap-1 justify-content-between">
+                            <a href="#" onclick="ajaxify.go('${chatLink}'); return false;" class="chat-room-btn position-relative d-flex flex-grow-1 gap-2 justify-content-start align-items-start btn btn-ghost btn-sm ff-sans text-start" style="padding: 0.5rem;">
+                                
+                                ${mainAvatarHtml}
+                                
+                                <div class="d-flex flex-grow-1 flex-column w-100" style="min-width:0;">
+                                    <div component="chat/room/title" class="room-name fw-semibold text-xs text-break">
+                                        ${msg.roomName}
+                                    </div>
+                                    <div component="chat/room/teaser">
+                                        
+                                        <div class="teaser-content text-sm line-clamp-3 text-break mb-0">
+                                            ${senderSmallAvatar}
+                                            <strong class="text-xs fw-semibold teaser-username">${senderName}:</strong> 
+                                            ${cleanedContent}
+                                        </div>
+                                        
+                                        <div class="teaser-timestamp text-muted text-xs" style="margin-top: 2px; line-height: 1;">
+                                            <span class="timeago" title="${isoTime}"></span>
+                                        </div>
+
+                                    </div>
+                                </div>
+                            </a>
+                        </div>
+                    </div>
+                    <hr class="my-1">
+                `;
+            });
+            html += '</div>';
+            
+            resultsContainer.html(html);
+            
+            if ($.fn.timeago) {
+                resultsContainer.find('.timeago').timeago();
+            }
+
+            window.chatSearchState.resultsHtml = html;
+            window.chatSearchState.lastScroll = 0;
+            highlightActiveChat();
+        });
+    }
+
+    function highlightActiveChat() {
+        let currentRoomId = ajaxify.data.roomId;
+        if (!currentRoomId) {
+             const match = window.location.pathname.match(/chats\/(\d+)/);
+             if (match) currentRoomId = match[1];
+        }
+        if (!currentRoomId) return;
+        $('.search-result').removeClass('active');
+        const activeItem = $('.search-result[data-roomid="' + currentRoomId + '"]');
+        activeItem.addClass('active');
+    }
+
+    function handleScrollToMessage() {
+        const params = new URLSearchParams(window.location.search);
+        const mid = params.get('mid');
+        if (!mid) return;
+        scrollToId(mid);
+        let attempts = 0;
+        const scrollInt = setInterval(() => {
+            attempts++;
+            if (scrollToId(mid) || attempts > 15) clearInterval(scrollInt);
+        }, 300);
+    }
+
+    function scrollToId(mid) {
+        const el = $('[data-mid="' + mid + '"]');
+        if (el.length > 0) {
+            el[0].scrollIntoView({ behavior: 'smooth', block: 'center' });
+            el.css('background', '#fffeca').css('transition', 'background 1s');
+            setTimeout(() => el.css('background', ''), 2000);
+            return true;
+        }
+        return false;
+    }
+});