bitrix-customizations

Bitrix24 Sound Customizations

Набор пользовательских доработок для Bitrix24, связанных с кастомизацией звуковых уведомлений и поведения интерфейса.

Проект рассчитан на использование в виде отдельных скриптов / браузерных расширений и не требует модификации ядра Bitrix24.

Основная цель — заменить стандартные звуки уведомлений Bitrix24 на пользовательские.

📦 Что делает расширение

Расширение:

🧩 Установка расширения (Chrome / Chromium / Edge)

Ниже описана установка в режиме распакованного расширения — это самый простой и прозрачный вариант для разработки и использования.

1️⃣ Подготовка

Склонируйте репозиторий или скачайте его в виде архива и распакуйте:

git clone https://github.com/grlbtfl/bitrix-customizations.git

2️⃣ Включение режима разработчика

Откройте страницу расширений браузера: chrome://extensions/

Chrome / Edge: Включите переключатель «Режим разработчика» (Developer mode)

3️⃣ Загрузка расширения

Нажмите «Загрузить распакованное расширение»

Укажите папку с расширением внутри проекта

Убедитесь, что расширение появилось в списке и включено

🔊 Замена стандартного звука на свой

1️⃣ Подготовка аудиофайла

Рекомендуемые параметры:

формат: mp3 или wav

длительность: до 2–3 секунд

громкость: умеренная (Bitrix24 не применяет нормализацию)

Пример имени файла: custom-notification.mp3

2️⃣ Размещение файла

Поместите аудиофайл в папку расширения, например: extension/ ├── sounds/ │ └── custom-notification.mp3 ├── content.js ├── manifest.json

3️⃣ Настройка подмены звука

В файле content.js (или аналогичном):

перехватывается создание или воспроизведение стандартного звука Bitrix24

вместо него используется пользовательский файл

Пример логики:

отключается оригинальный Audio

создаётся новый Audio с вашим файлом

воспроизведение привязывается к событию уведомления

После изменения кода:

Вернитесь на страницу chrome://extensions/

Нажмите «Обновить» у расширения

Перезагрузите вкладку Bitrix24

✅ Проверка работы

Откройте веб-версию Bitrix24

Вызовите событие уведомления (сообщение в чате, уведомление и т.п.)

Должен воспроизводиться ваш звук, а не стандартный

Если звук не воспроизводится:

проверьте путь к файлу

убедитесь, что расширение включено

откройте DevTools → Console и проверьте ошибки

⚠️ Ограничения

Расширение работает только в браузере

Мобильные приложения Bitrix24 не поддерживаются

После обновлений Bitrix24 логика уведомлений может измениться — в этом случае потребуется корректировка скрипта

🛠 Использование

Проект предназначен для:

локальной настройки под конкретного пользователя

индивидуальной кастомизации интерфейса Bitrix24

экспериментов со звуками и UX

Структура проекта может расширяться по мере добавления новых кастомизаций.

📄 Лицензия

Проект распространяется без публичной лицензии. Использование — по договорённости с автором.