nodebb-plugin-admin-chats 2.0.0 → 2.1.1

package/client.js

@@ -1,387 +1,629 @@
-$(document).ready(function() {
-    const LOCK_PREFIX = '[admin-chat-lock]';
-    const roomStateCache = new Map();
-    const TEXT = {
-        he: {
-            lockBanner: '🔒 חדר זה ננעל ע"י המנהלים.',
-            menuLock: 'נעל חדר',
-            menuRelease: 'שחרר נעילה',
-            updateError: 'לא ניתן לעדכן את נעילת החדר.',
-            viewChats: "צפיה בצ'אטים",
-            emptyState: "אנא בחר צ'אט מסרגל הצד.",
-            lockedAction: 'לא ניתן לבצע פעולה זו בחדר נעול',
-        },
-        en: {
-            lockBanner: '🔒 This room was locked by the administrators.',
-            menuLock: 'Lock Room',
-            menuRelease: 'Release Lock',
-            updateError: 'Unable to update room lock.',
-            viewChats: 'View Chats',
-            emptyState: 'Please select a chat from the sidebar.',
-            lockedAction: 'This action cannot be performed in a locked room.',
-        },
-    };
-
-    function isEnglishSystem() {
-        return $('html').attr('lang') && $('html').attr('lang').startsWith('en');
-    }
-
-    function t(key) {
-        const dict = isEnglishSystem() ? TEXT.en : TEXT.he;
-        return dict[key];
-    }
-
-    function replaceAdminEmptyStateText() {
-        if (!app.user.isAdmin) {
-            return;
-        }
-
-        $('span.text-muted.text-sm').each(function() {
-            const currentText = $(this).text().trim();
-            if (
-                currentText.includes("אין לכם צ'אטים פעילים") ||
-                currentText === "אין לכם צ'אטים פעילים." ||
-                currentText.includes('You have no active chats') ||
-                currentText === 'You have no active chats.'
-            ) {
-                $(this).text(t('emptyState'));
-                $(this).removeClass('text-muted');
-            }
-        });
-    }
-
-    function getChatWindows() {
-        return $('[component="chat/message/window"]');
-    }
-
-    function getWindowRoomId($window) {
-        const roomId = $window.find('[component="chat/messages"]').first().attr('data-roomid') ||
-            $window.closest('.chat-modal').attr('data-roomid') ||
-            (ajaxify && ajaxify.data && ajaxify.data.roomId);
-        return parseInt(roomId, 10) || 0;
-    }
-
-    function getCachedRoomData(roomId) {
-        const cached = roomStateCache.get(String(roomId));
-        if (!cached) {
-            return null;
-        }
-        if (Date.now() - cached.timestamp > 10000) {
-            roomStateCache.delete(String(roomId));
-            return null;
-        }
-        return cached.data;
-    }
-
-    function setCachedRoomData(roomId, data) {
-        roomStateCache.set(String(roomId), {
-            data,
-            timestamp: Date.now(),
-        });
-    }
-
-    async function fetchRoomData(roomId) {
-        if (!roomId) {
-            return null;
-        }
-
-        const currentRoom = ajaxify && ajaxify.data && (ajaxify.data.room || ajaxify.data);
-        if (currentRoom && parseInt(currentRoom.roomId, 10) === roomId && currentRoom.adminChatLock) {
-            setCachedRoomData(roomId, currentRoom);
-            return currentRoom;
-        }
-
-        const cached = getCachedRoomData(roomId);
-        if (cached) {
-            return cached;
-        }
-
-        const response = await fetch(`${config.relative_path || ''}/api/chats/${roomId}`, {
-            headers: {
-                'x-csrf-token': config.csrf_token,
-            },
-            credentials: 'same-origin',
-        });
-        if (!response.ok) {
-            return null;
-        }
-
-        const payload = await response.json();
-        const roomData = payload && payload.roomId ? payload : (payload && payload.room ? payload.room : null);
-        if (roomData) {
-            setCachedRoomData(roomId, roomData);
-        }
-        return roomData;
-    }
-
-    function isLockedForUser(roomData) {
-        return !!(roomData && roomData.adminChatLock && roomData.adminChatLock.isLocked && !(app.user && app.user.isAdmin));
-    }
-
-    function setComposerHidden($window, hidden) {
-        $window.find('[component="chat/composer"]').each(function() {
-            const $composer = $(this);
-            if (hidden) {
-                $composer.addClass('hidden').hide();
-            } else {
-                $composer.removeClass('hidden').show();
-            }
-        });
-
-        $window.find('[component="chat/input"], [component="chat/send"], button[data-action="send"], textarea.chat-input')
-            .prop('disabled', hidden)
-            .attr('disabled', hidden ? 'disabled' : null);
-    }
-
-    function renderLockBanner($window, hidden) {
-        $window.find('.admin-chat-lock-banner').remove();
-        if (!hidden) {
-            return;
-        }
-
-        const target = $window.find('[component="chat/messages"]').first();
-        if (!target.length) {
-            return;
-        }
-
-        const positionStyle = isEnglishSystem() ? 'float:right; clear:both;' : 'float:left; clear:both;';
-        target.prepend(`<div class="admin-chat-lock-banner alert alert-warning mb-2 text-start" style="${positionStyle} max-width: fit-content;">${t('lockBanner')}</div>`);
-    }
-
-    function updateLockedActionVisibility($window, hidden) {
-        [
-            '[data-action="reply"]',
-            '[data-action="edit"]',
-            '[data-action="delete"]',
-            '[data-action="restore"]',
-            '[data-action="kick"]',
-            '[data-action="toggleOwner"]'
-        ].forEach(function(selector) {
-            $window.find(selector).toggleClass('hidden', hidden).toggle(!hidden);
-        });
-
-        $window.find('[component="chat/controlsToggle"]').closest('.dropdown').toggleClass('hidden', hidden).toggle(!hidden);
-        $window.find('[component="chat/manage/user/add/search"], [component="chat/manage/user/list/search"], [component="chat/manage/save"]')
-            .toggleClass('hidden', hidden)
-            .toggle(!hidden)
-            .prop('disabled', hidden)
-            .attr('disabled', hidden ? 'disabled' : null);
-        $window.find('[component="chat/manage-modal"] .form-text, [component="chat/manage-modal"] .text-danger')
-            .toggleClass('hidden', hidden);
-    }
-
-    function normalizeLockMessages($window) {
-        $window.find('[component="chat/system-message"] > div').each(function() {
-            const $el = $(this);
-            const text = $el.text().trim();
-            if (!text.includes(LOCK_PREFIX.slice(1, -1)) && !text.includes('admin-chat-lock')) {
-                return;
-            }
-            $el.text(t('lockBanner'));
-        });
-    }
-
-    function getRoomMenuTargets($window) {
-        const scoped = $window.find('[component="chat/controls"]');
-        if (scoped.length) {
-            return scoped;
-        }
-        return $window.find('[component="chat/header"], .chat-header, .modal-header, [component="chat/nav"]').find('.dropdown-menu');
-    }
-
-    function renderAdminLockControl($window, roomData) {
-        $window.find('.admin-chat-lock-toggle-item, .admin-chat-lock-divider, .admin-chat-lock-item-wrap').remove();
-
-        if (!app.user.isAdmin || !roomData || !roomData.roomId) {
-            return;
-        }
-
-        const menus = getRoomMenuTargets($window);
-        if (!menus.length) {
-            return;
-        }
-
-        const lockData = roomData.adminChatLock || {};
-        const isLocked = !!lockData.isLocked;
-        const itemText = isLocked ? t('menuRelease') : t('menuLock');
-        const iconClass = isLocked ? 'fa-lock-open' : 'fa-lock';
-        const menuItemHtml = `
-            <li role="presentation" class="admin-chat-lock-item-wrap">
-                <a href="#" role="menuitem" class="dropdown-item rounded-1 d-flex align-items-center gap-2 admin-chat-lock-toggle-item" data-room-id="${roomData.roomId}" data-locked="${isLocked}">
-                    <i class="fa fa-fw ${iconClass}"></i>
-                    <span>${itemText}</span>
-                </a>
-            </li>
-            <li role="presentation" class="dropdown-divider admin-chat-lock-divider"></li>
-        `;
-
-        menus.each(function() {
-            const $menu = $(this);
-            if ($menu.find('.admin-chat-lock-toggle-item').length) {
-                return;
-            }
-            $menu.prepend(menuItemHtml);
-        });
-    }
-
-    async function applyUiToWindow($window) {
-        const roomId = getWindowRoomId($window);
-        if (!roomId) {
-            return;
-        }
-
-        const roomData = await fetchRoomData(roomId);
-        if (!roomData) {
-            return;
-        }
-
-        const hidden = isLockedForUser(roomData);
-        setComposerHidden($window, hidden);
-        updateLockedActionVisibility($window, hidden);
-        renderLockBanner($window, hidden);
-        renderAdminLockControl($window, roomData);
-        normalizeLockMessages($window);
-    }
-
-    async function refreshChatUi() {
-        replaceAdminEmptyStateText();
-        const windows = getChatWindows();
-        await Promise.all(windows.map(function() {
-            return applyUiToWindow($(this));
-        }).get());
-    }
-
-    async function toggleRoomLock(roomId, nextState) {
-        const response = await fetch(`${config.relative_path || ''}/api/admin-chats/${roomId}/lock`, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-                'x-csrf-token': config.csrf_token,
-            },
-            body: JSON.stringify({ locked: nextState }),
-            credentials: 'same-origin',
-        });
-
-        if (!response.ok) {
-            throw new Error('Unable to update room lock');
-        }
-
-        return await response.json();
-    }
-
-    $(window).on('action:ajaxify.end', function(ev, data) {
-        const templateName = ajaxify && ajaxify.data && ajaxify.data.template ? ajaxify.data.template.name : '';
-
-        if (app.user.isAdmin && templateName.startsWith('account/')) {
-            const userSlug = ajaxify.data.userslug || (ajaxify.data.user && ajaxify.data.user.userslug);
-
-            if (userSlug) {
-                const relativePath = config.relative_path || '';
-                const btnHtml = `
-                    <li role="presentation">
-                        <a class="dropdown-item rounded-1 d-flex align-items-center gap-2" href="${relativePath}/user/${userSlug}/chats" role="menuitem">
-                            <i class="far fa-fw fa-comments"></i>
-                            <span>${t('viewChats')}</span>
-                        </a>
-                    </li>
-                    <li role="presentation" class="dropdown-divider"></li>
-                `;
-                const menu = $('.account-sub-links');
-                if (menu.length) {
-                    menu.find(`a[href*="/user/${userSlug}/chats"]`).parent().remove();
-                    menu.prepend(btnHtml);
-                }
-            }
-        }
-
-        const url = data && data.url ? data.url : '';
-        if (url.match(/^user\/.+\/chats/) || url === 'chats') {
-            refreshChatUi();
-            setTimeout(refreshChatUi, 500);
-            setTimeout(refreshChatUi, 1200);
-        }
-    });
-
-    $(window).on('action:chat.loaded', function() {
-        refreshChatUi();
-        setTimeout(refreshChatUi, 200);
-        setTimeout(refreshChatUi, 1000);
-    });
-
-    $(window).on('action:chat.closed', function() {
-        setTimeout(refreshChatUi, 200);
-    });
-
-    $(window).on('action:chat.onMessagesAddedToDom action:chat.edited action:chat.renamed', function() {
-        setTimeout(refreshChatUi, 0);
-    });
-
-    $(document).on('click', '.admin-chat-lock-toggle-item', async function(ev) {
-        ev.preventDefault();
-
-        const $button = $(this);
-        const roomId = parseInt($button.attr('data-room-id'), 10);
-        const isLocked = $button.attr('data-locked') === 'true';
-
-        if (!roomId) {
-            return;
-        }
-
-        $button.addClass('disabled').attr('aria-disabled', 'true');
-
-        try {
-            const result = await toggleRoomLock(roomId, !isLocked);
-            const currentRoom = ajaxify && ajaxify.data && (ajaxify.data.room || ajaxify.data);
-            if (currentRoom && parseInt(currentRoom.roomId, 10) === roomId) {
-                currentRoom.adminChatLock = result.lockData;
-                currentRoom.canReply = !result.lockData.isLocked || (app.user && app.user.isAdmin);
-                currentRoom.showUserInput = currentRoom.canReply;
-                if (ajaxify.data.room) {
-                    ajaxify.data.room.adminChatLock = result.lockData;
-                    ajaxify.data.room.canReply = currentRoom.canReply;
-                    ajaxify.data.room.showUserInput = currentRoom.showUserInput;
-                }
-            }
-
-            const cached = getCachedRoomData(roomId) || { roomId };
-            cached.adminChatLock = result.lockData;
-            cached.canReply = !result.lockData.isLocked || (app.user && app.user.isAdmin);
-            cached.showUserInput = cached.canReply;
-            setCachedRoomData(roomId, cached);
-            await refreshChatUi();
-        } catch (err) {
-            app.alertError(t('updateError'));
-            $button.removeClass('disabled').removeAttr('aria-disabled');
-        }
-    });
-
-    // Intercept error alerts to translate locked action errors
-    if (app && app.alertError) {
-        const originalAlertError = app.alertError;
-        app.alertError = function(error) {
-            let message = error;
-            if (typeof error === 'object' && error.message) {
-                message = error.message;
-            }
-            if (typeof message === 'string' && message.includes('admin-chats:errors.lockedAction')) {
-                message = t('lockedAction');
-            }
-            return originalAlertError.call(this, message);
-        };
-    }
-
-    // Intercept and translate error messages from API
-    if (app.alertError && !app.alertError._adminChatsWrapped) {
-        const originalAlertError = app.alertError;
-        app.alertError = function(message) {
-            if (typeof message === 'string') {
-                // Check if message contains translation key
-                if (message.includes('[[admin-chats:errors.lockedAction]]') || message.includes('errors.lockedAction')) {
-                    message = t('lockedAction');
-                }
-            }
-            return originalAlertError.call(this, message);
-        };
-        app.alertError._adminChatsWrapped = true;
-    }
-});
+$(document).ready(function() {
+    const LOCK_PREFIX = '[admin-chat-lock]';
+    const roomStateCache = new Map();
+    const TEXT = {
+        he: {
+            lockBanner: '🔒 חדר זה ננעל ע"י המנהלים.',
+            menuLock: 'נעל חדר',
+            menuRelease: 'שחרר נעילה',
+            updateError: 'לא ניתן לעדכן את נעילת החדר.',
+            viewChats: "צפיה בצ'אטים",
+            emptyState: "אנא בחר צ'אט מסרגל הצד.",
+            participants: 'משתתפים',
+        },
+        en: {
+            lockBanner: '🔒 This room was locked by the administrators.',
+            menuLock: 'Lock Room',
+            menuRelease: 'Release Lock',
+            updateError: 'Unable to update room lock.',
+            viewChats: 'View Chats',
+            emptyState: 'Please select a chat from the sidebar.',
+            participants: 'Participants',
+        },
+    };
+
+    function isEnglishSystem() {
+        return $('html').attr('lang') && $('html').attr('lang').startsWith('en');
+    }
+
+    function t(key) {
+        const dict = isEnglishSystem() ? TEXT.en : TEXT.he;
+        return dict[key];
+    }
+
+    // Get lockedAction message from server translations only (based on forum settings)
+    function getLockedActionMessage() {
+        if (window.adminChatsTranslations && window.adminChatsTranslations.lockedAction) {
+            return window.adminChatsTranslations.lockedAction;
+        }
+        // If server translation not available, default to English
+        return 'This action cannot be performed in a locked room.';
+    }
+
+    function isAdminAllChatsPage() {
+        return !!(ajaxify && ajaxify.data && ajaxify.data.adminAllChats);
+    }
+
+    function getAdminChatsPageUrl(roomId) {
+        return roomId ? `chats/${roomId}` : 'chats';
+    }
+
+    function getAdminChatsDataUrl(roomId) {
+        const params = new URL(document.location).searchParams;
+        params.set('switch', 1);
+        const query = params.toString();
+        return `${config.relative_path || ''}/api/admin-chats/page${roomId ? `/${roomId}` : ''}${query ? `?${query}` : ''}`;
+    }
+
+    async function loadMoreAdminChats() {
+        const recentChats = $('[component="chat/recent"]');
+        if (!isAdminAllChatsPage() || !recentChats.length || recentChats.attr('loading')) {
+            return;
+        }
+
+        recentChats.attr('loading', 1);
+
+        try {
+            const start = parseInt(recentChats.attr('data-nextstart'), 10) || 0;
+            const response = await fetch(`${config.relative_path || ''}/api/admin-chats?start=${start}`, {
+                headers: {
+                    'x-csrf-token': config.csrf_token,
+                },
+                credentials: 'same-origin',
+            });
+
+            if (!response.ok) {
+                throw new Error('Unable to load chats');
+            }
+
+            const payload = await response.json();
+            if (payload.rooms && payload.rooms.length) {
+                payload.loadingMore = true;
+                const html = await app.parseAndTranslate('chats', 'rooms', payload);
+                recentChats.append(html);
+                html.find('.timeago').timeago();
+                recentChats.attr('data-nextstart', payload.nextStart);
+            }
+        } catch (err) {
+            app.alertError(err);
+        } finally {
+            recentChats.removeAttr('loading');
+        }
+    }
+
+    function bindAdminRecentChatsInfiniteScroll() {
+        if (!isAdminAllChatsPage()) {
+            return;
+        }
+
+        $('[component="chat/recent"]').off('scroll').on('scroll', utils.debounce(function() {
+            const $this = $(this);
+            const bottom = ($this[0].scrollHeight - $this.height()) * 0.9;
+            if ($this.scrollTop() > bottom) {
+                loadMoreAdminChats();
+            }
+        }, 100));
+    }
+
+    function patchForumChatsForAdminAll() {
+        if (!isAdminAllChatsPage()) {
+            return;
+        }
+
+        require(['forum/chats', 'forum/chats/messages'], function(Chats, ChatsMessages) {
+            if (!Chats) {
+                return;
+            }
+
+            if (!Chats._adminAllChatsPatched) {
+                const originalSwitchChat = Chats.switchChat;
+
+                Chats.switchChat = function(roomId) {
+                    if (!isAdminAllChatsPage()) {
+                        return originalSwitchChat.call(this, roomId);
+                    }
+
+                    roomId = roomId || '';
+                    Chats.destroyAutoComplete(ajaxify.data.roomId);
+                    socket.emit('modules.chats.leave', ajaxify.data.roomId);
+
+                    const url = getAdminChatsPageUrl(roomId);
+                    fetch(getAdminChatsDataUrl(roomId), { credentials: 'include' })
+                        .then(async function(response) {
+                            if (!response.ok) {
+                                throw new Error(`Received ${response.status}`);
+                            }
+
+                            const payload = await response.json();
+                            const html = await app.parseAndTranslate('partials/chats/message-window', payload);
+                            const mainWrapper = $('[component="chat/main-wrapper"]');
+                            mainWrapper.html(html);
+                            mainWrapper.attr('data-roomid', roomId);
+                            html.find('.timeago').timeago();
+                            ajaxify.data = { ...ajaxify.data, ...payload, roomId: roomId };
+                            ajaxify.updateTitle(ajaxify.data.title);
+                            $('body').toggleClass('chat-loaded', !!roomId);
+                            mainWrapper.find('[data-bs-toggle="tooltip"]').tooltip({ trigger: 'hover', container: '#content' });
+                            Chats.setActive(roomId);
+                            Chats.addEventListeners();
+                            $(window).trigger('action:chat.loaded');
+                            if (roomId) {
+                                ChatsMessages.scrollToBottomAfterImageLoad(mainWrapper.find('[component="chat/message/content"]'));
+                            }
+                            if (history.pushState) {
+                                history.pushState({ url: url }, null, `${window.location.protocol}//${window.location.host}${config.relative_path || ''}/${url}`);
+                            }
+                            bindAdminRecentChatsInfiniteScroll();
+                        });
+                };
+
+                Chats._adminAllChatsPatched = true;
+            }
+
+            // Auto-open chat if roomId is specified in URL
+            const currentRoomId = ajaxify && ajaxify.data && ajaxify.data.roomId;
+            if (currentRoomId && !$('body').hasClass('chat-loaded')) {
+                setTimeout(function() {
+                    Chats.switchChat(currentRoomId);
+                }, 100);
+            }
+
+            bindAdminRecentChatsInfiniteScroll();
+        });
+    }
+
+    function replaceAdminEmptyStateText() {
+        if (!app.user.isAdmin) {
+            return;
+        }
+
+        $('span.text-muted.text-sm').each(function() {
+            const currentText = $(this).text().trim();
+            if (
+                currentText.includes("אין לכם צ'אטים פעילים") ||
+                currentText === "אין לכם צ'אטים פעילים." ||
+                currentText.includes('You have no active chats') ||
+                currentText === 'You have no active chats.'
+            ) {
+                $(this).text(t('emptyState'));
+                $(this).removeClass('text-muted');
+            }
+        });
+    }
+
+    function getChatWindows() {
+        return $('[component="chat/message/window"]');
+    }
+
+    function getWindowRoomId($window) {
+        const roomId = $window.find('[component="chat/messages"]').first().attr('data-roomid') ||
+            $window.closest('.chat-modal').attr('data-roomid') ||
+            (ajaxify && ajaxify.data && ajaxify.data.roomId);
+        return parseInt(roomId, 10) || 0;
+    }
+
+    function getCachedRoomData(roomId) {
+        const cached = roomStateCache.get(String(roomId));
+        if (!cached) {
+            return null;
+        }
+        if (Date.now() - cached.timestamp > 10000) {
+            roomStateCache.delete(String(roomId));
+            return null;
+        }
+        return cached.data;
+    }
+
+    function setCachedRoomData(roomId, data) {
+        roomStateCache.set(String(roomId), {
+            data,
+            timestamp: Date.now(),
+        });
+    }
+
+    async function fetchRoomData(roomId) {
+        if (!roomId) {
+            return null;
+        }
+
+        const currentRoom = ajaxify && ajaxify.data && (ajaxify.data.room || ajaxify.data);
+        if (currentRoom && parseInt(currentRoom.roomId, 10) === roomId && currentRoom.adminChatLock) {
+            setCachedRoomData(roomId, currentRoom);
+            return currentRoom;
+        }
+
+        const cached = getCachedRoomData(roomId);
+        if (cached) {
+            return cached;
+        }
+
+        const endpoint = isAdminAllChatsPage() ?
+            `${config.relative_path || ''}/api/admin-chats/page/${roomId}` :
+            `${config.relative_path || ''}/api/chats/${roomId}`;
+        const response = await fetch(endpoint, {
+            headers: {
+                'x-csrf-token': config.csrf_token,
+            },
+            credentials: 'same-origin',
+        });
+        if (!response.ok) {
+            return null;
+        }
+
+        const payload = await response.json();
+        const roomData = payload && payload.roomId ? payload : (payload && payload.room ? payload.room : null);
+        if (roomData) {
+            setCachedRoomData(roomId, roomData);
+        }
+        return roomData;
+    }
+
+    function isLockedForUser(roomData) {
+        return !!(roomData && roomData.adminChatLock && roomData.adminChatLock.isLocked && !(app.user && app.user.isAdmin));
+    }
+
+    function setComposerHidden($window, hidden) {
+        $window.find('[component="chat/composer"]').each(function() {
+            const $composer = $(this);
+            if (hidden) {
+                $composer.addClass('hidden').hide();
+            } else {
+                $composer.removeClass('hidden').show();
+            }
+        });
+
+        $window.find('[component="chat/input"], [component="chat/send"], button[data-action="send"], textarea.chat-input')
+            .prop('disabled', hidden)
+            .attr('disabled', hidden ? 'disabled' : null);
+    }
+
+    function renderLockBanner($window, hidden) {
+        $window.find('.admin-chat-lock-banner').remove();
+        if (!hidden) {
+            return;
+        }
+
+        const target = $window.find('[component="chat/messages"]').first();
+        if (!target.length) {
+            return;
+        }
+
+        const positionStyle = isEnglishSystem() ? 'float:right; clear:both;' : 'float:left; clear:both;';
+        target.prepend(`<div class="admin-chat-lock-banner alert alert-warning mb-2 text-start" style="${positionStyle} max-width: fit-content;">${t('lockBanner')}</div>`);
+    }
+
+    function updateLockedActionVisibility($window, hidden) {
+        [
+            '[data-action="reply"]',
+            '[data-action="edit"]',
+            '[data-action="delete"]',
+            '[data-action="restore"]',
+            '[data-action="kick"]',
+            '[data-action="toggleOwner"]'
+        ].forEach(function(selector) {
+            $window.find(selector).toggleClass('hidden', hidden).toggle(!hidden);
+        });
+
+        $window.find('[component="chat/controlsToggle"]').closest('.dropdown').toggleClass('hidden', hidden).toggle(!hidden);
+        $window.find('[component="chat/manage/user/add/search"], [component="chat/manage/user/list/search"], [component="chat/manage/save"]')
+            .toggleClass('hidden', hidden)
+            .toggle(!hidden)
+            .prop('disabled', hidden)
+            .attr('disabled', hidden ? 'disabled' : null);
+        $window.find('[component="chat/manage-modal"] .form-text, [component="chat/manage-modal"] .text-danger')
+            .toggleClass('hidden', hidden);
+    }
+
+    function normalizeLockMessages($window) {
+        $window.find('[component="chat/system-message"] > div').each(function() {
+            const $el = $(this);
+            const text = $el.text().trim();
+            if (!text.includes(LOCK_PREFIX.slice(1, -1)) && !text.includes('admin-chat-lock')) {
+                return;
+            }
+            $el.text(t('lockBanner'));
+        });
+    }
+
+    function getRoomMenuTargets($window) {
+        const scoped = $window.find('[component="chat/controls"]');
+        if (scoped.length) {
+            return scoped;
+        }
+        return $window.find('[component="chat/header"], .chat-header, .modal-header, [component="chat/nav"]').find('.dropdown-menu');
+    }
+
+    function renderAdminLockControl($window, roomData) {
+        $window.find('.admin-chat-lock-toggle-item, .admin-chat-lock-divider, .admin-chat-lock-item-wrap').remove();
+
+        if (!app.user.isAdmin || !roomData || !roomData.roomId) {
+            return;
+        }
+
+        const menus = getRoomMenuTargets($window);
+        if (!menus.length) {
+            return;
+        }
+
+        const lockData = roomData.adminChatLock || {};
+        const isLocked = !!lockData.isLocked;
+        const itemText = isLocked ? t('menuRelease') : t('menuLock');
+        const iconClass = isLocked ? 'fa-lock-open' : 'fa-lock';
+        const menuItemHtml = `
+            <li role="presentation" class="admin-chat-lock-item-wrap">
+                <a href="#" role="menuitem" class="dropdown-item rounded-1 d-flex align-items-center gap-2 admin-chat-lock-toggle-item" data-room-id="${roomData.roomId}" data-locked="${isLocked}">
+                    <i class="fa fa-fw ${iconClass}"></i>
+                    <span>${itemText}</span>
+                </a>
+            </li>
+            <li role="presentation" class="dropdown-divider admin-chat-lock-divider"></li>
+        `;
+
+        menus.each(function() {
+            const $menu = $(this);
+            if ($menu.find('.admin-chat-lock-toggle-item').length) {
+                return;
+            }
+            $menu.prepend(menuItemHtml);
+        });
+    }
+
+    async function applyUiToWindow($window) {
+        const roomId = getWindowRoomId($window);
+        if (!roomId) {
+            return;
+        }
+
+        const roomData = await fetchRoomData(roomId);
+        if (!roomData) {
+            return;
+        }
+
+        const hidden = isLockedForUser(roomData);
+        setComposerHidden($window, hidden);
+        updateLockedActionVisibility($window, hidden);
+        renderLockBanner($window, hidden);
+        renderAdminLockControl($window, roomData);
+        normalizeLockMessages($window);
+    }
+
+
+    function getAdminRoomsMap() {
+        const rooms = ajaxify && ajaxify.data && Array.isArray(ajaxify.data.rooms) ? ajaxify.data.rooms : [];
+        return new Map(rooms.map(room => [String(room.roomId), room]));
+    }
+
+    function renderAdminParticipants() {
+        if (!isAdminAllChatsPage()) {
+            return;
+        }
+
+        const roomsMap = getAdminRoomsMap();
+        $('[component="chat/recent/room"]').each(function() {
+            const $room = $(this);
+            const roomId = String($room.attr('data-roomid') || '');
+            const roomData = roomsMap.get(roomId);
+            const $container = $room.find('[component="chat/room/title"]').closest('.d-flex.flex-grow-1.flex-column.w-100');
+
+            $container.find('.admin-chat-participants').remove();
+            if (!$container.length || !roomData || !roomData.participantsLabel) {
+                return;
+            }
+
+            const html = `<div class="admin-chat-participants text-muted text-xs text-break line-clamp-2"><span class="fw-semibold">${t('participants')}:</span> ${utils.escapeHTML(roomData.participantsLabel)}</div>`;
+            $container.find('[component="chat/room/title"]').after(html);
+        });
+    }
+
+    function applyAdminAllPageTweaks() {
+        if (!isAdminAllChatsPage()) {
+            return;
+        }
+
+        $('[component="chat/recent"] .mark-read').addClass('hidden');
+        $('[data-action="leave"]').closest('li').addClass('hidden');
+        renderAdminParticipants();
+    }
+    async function refreshChatUi() {
+        replaceAdminEmptyStateText();
+        applyAdminAllPageTweaks();
+        const windows = getChatWindows();
+        await Promise.all(windows.map(function() {
+            return applyUiToWindow($(this));
+        }).get());
+    }
+
+    async function toggleRoomLock(roomId, nextState) {
+        const response = await fetch(`${config.relative_path || ''}/api/admin-chats/${roomId}/lock`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-csrf-token': config.csrf_token,
+            },
+            body: JSON.stringify({ locked: nextState }),
+            credentials: 'same-origin',
+        });
+
+        if (!response.ok) {
+            throw new Error('Unable to update room lock');
+        }
+
+        return await response.json();
+    }
+
+    $(window).on('action:ajaxify.end', function(ev, data) {
+        const templateName = ajaxify && ajaxify.data && ajaxify.data.template ? ajaxify.data.template.name : '';
+
+        if (app.user.isAdmin && templateName.startsWith('account/')) {
+            const userSlug = ajaxify.data.userslug || (ajaxify.data.user && ajaxify.data.user.userslug);
+
+            if (userSlug) {
+                const relativePath = config.relative_path || '';
+                const btnHtml = `
+                    <li role="presentation">
+                        <a class="dropdown-item rounded-1 d-flex align-items-center gap-2" href="${relativePath}/user/${userSlug}/chats" role="menuitem">
+                            <i class="far fa-fw fa-comments"></i>
+                            <span>${t('viewChats')}</span>
+                        </a>
+                    </li>
+                    <li role="presentation" class="dropdown-divider"></li>
+                `;
+                const menu = $('.account-sub-links');
+                if (menu.length) {
+                    menu.find(`a[href*="/user/${userSlug}/chats"]`).parent().remove();
+                    menu.prepend(btnHtml);
+                }
+            }
+        }
+
+        if (isAdminAllChatsPage()) {
+            patchForumChatsForAdminAll();
+            bindAdminRecentChatsInfiniteScroll();
+            
+            // Auto-open chat if roomId is specified in URL and chat is not already loaded
+            const currentRoomId = ajaxify && ajaxify.data && ajaxify.data.roomId;
+            if (currentRoomId && !$('body').hasClass('chat-loaded')) {
+                setTimeout(function() {
+                    require(['forum/chats'], function(Chats) {
+                        if (Chats && Chats.switchChat) {
+                            Chats.switchChat(currentRoomId);
+                        }
+                    });
+                }, 200);
+            }
+        }
+
+        const url = data && data.url ? data.url : '';
+        if (url.match(/^user\/.+\/chats/) || url.match(/^chats(\/|$)/)) {
+            refreshChatUi();
+            setTimeout(refreshChatUi, 500);
+            setTimeout(refreshChatUi, 1200);
+            
+            // Handle chat navigation for internal URL changes
+            if (url.match(/^chats\/\d+/)) {
+                setTimeout(handleChatNavigation, 300);
+            }
+        }
+    });
+
+    $(window).on('action:chat.loaded', function() {
+        if (isAdminAllChatsPage()) {
+            patchForumChatsForAdminAll();
+            bindAdminRecentChatsInfiniteScroll();
+            
+            // Auto-open chat if roomId is specified in URL and no chat is currently active
+            const currentRoomId = ajaxify && ajaxify.data && ajaxify.data.roomId;
+            const activeChatId = $('[component="chat/main-wrapper"]').attr('data-roomid');
+            
+            if (currentRoomId && (!activeChatId || activeChatId !== String(currentRoomId))) {
+                setTimeout(function() {
+                    require(['forum/chats'], function(Chats) {
+                        if (Chats && Chats.switchChat) {
+                            Chats.switchChat(currentRoomId);
+                        }
+                    });
+                }, 100);
+            }
+        }
+        refreshChatUi();
+        setTimeout(refreshChatUi, 200);
+        setTimeout(refreshChatUi, 1000);
+    });
+
+    $(window).on('action:chat.closed', function() {
+        setTimeout(refreshChatUi, 200);
+    });
+
+    $(window).on('action:chat.onMessagesAddedToDom action:chat.edited action:chat.renamed', function() {
+        setTimeout(refreshChatUi, 0);
+    });
+
+    // Handle browser back/forward navigation
+    $(window).on('popstate', function() {
+        if (isAdminAllChatsPage()) {
+            setTimeout(handleChatNavigation, 100);
+        }
+    });
+
+    // Handle URL changes for internal navigation
+    function handleChatNavigation() {
+        if (!isAdminAllChatsPage()) {
+            return;
+        }
+        
+        // Try to get roomId from multiple sources
+        let currentRoomId = ajaxify && ajaxify.data && ajaxify.data.roomId;
+        
+        // If not found in ajaxify.data, try to extract from URL
+        if (!currentRoomId) {
+            const urlMatch = window.location.pathname.match(/\/chats\/(\d+)/);
+            if (urlMatch) {
+                currentRoomId = parseInt(urlMatch[1], 10);
+            }
+        }
+        
+        const activeChatId = $('[component="chat/main-wrapper"]').attr('data-roomid');
+        
+        if (currentRoomId && (!activeChatId || activeChatId !== String(currentRoomId))) {
+            require(['forum/chats'], function(Chats) {
+                if (Chats && Chats.switchChat) {
+                    Chats.switchChat(currentRoomId);
+                }
+            });
+        }
+    }
+
+    $(document).on('click', '.admin-chat-lock-toggle-item', async function(ev) {
+        ev.preventDefault();
+
+        const $button = $(this);
+        const roomId = parseInt($button.attr('data-room-id'), 10);
+        const isLocked = $button.attr('data-locked') === 'true';
+
+        if (!roomId) {
+            return;
+        }
+
+        $button.addClass('disabled').attr('aria-disabled', 'true');
+
+        try {
+            const result = await toggleRoomLock(roomId, !isLocked);
+            const currentRoom = ajaxify && ajaxify.data && (ajaxify.data.room || ajaxify.data);
+            if (currentRoom && parseInt(currentRoom.roomId, 10) === roomId) {
+                currentRoom.adminChatLock = result.lockData;
+                currentRoom.canReply = !result.lockData.isLocked || (app.user && app.user.isAdmin);
+                currentRoom.showUserInput = currentRoom.canReply;
+                if (ajaxify.data.room) {
+                    ajaxify.data.room.adminChatLock = result.lockData;
+                    ajaxify.data.room.canReply = currentRoom.canReply;
+                    ajaxify.data.room.showUserInput = currentRoom.showUserInput;
+                }
+            }
+
+            const cached = getCachedRoomData(roomId) || { roomId };
+            cached.adminChatLock = result.lockData;
+            cached.canReply = !result.lockData.isLocked || (app.user && app.user.isAdmin);
+            cached.showUserInput = cached.canReply;
+            setCachedRoomData(roomId, cached);
+            await refreshChatUi();
+        } catch (err) {
+            app.alertError(t('updateError'));
+            $button.removeClass('disabled').removeAttr('aria-disabled');
+        }
+    });
+
+    // Intercept and translate error messages from API - only for lockedAction
+    if (app.alertError && !app.alertError._adminChatsWrapped) {
+        const originalAlertError = app.alertError;
+        app.alertError = function(message) {
+            if (typeof message === 'string') {
+                if (message.includes('[[admin-chats:errors.lockedAction]]') || message.includes('errors.lockedAction')) {
+                    message = getLockedActionMessage();
+                }
+            }
+            return originalAlertError.call(this, message);
+        };
+        app.alertError._adminChatsWrapped = true;
+    }
+});
+