Описание
Модуль Bitrix для вывода компактного виджета с иконками социальных каналов связи (Telegram, WhatsApp, VK, Телефон) на страницах сайта. Поддерживает настраиваемые ссылки, включение/выключение виджета и выбор цвета иконок через цветовой пикер.
Функциональные характеристики
- Отображение виджета: плавающий блок в правом нижнем углу с основной кнопкой и выпадающим списком иконок.
- Поддерживаемые каналы: Telegram, WhatsApp, VK, Телефон (tel:).
- Гибкая конфигурация: включение/выключение, ссылки на каналы, цвет иконок (HEX).
- Адаптивность: автоопределение мобильных устройств; поведение «по клику» на мобильных и «по ховеру» на десктопе.
- Легкая стилизация: подключение CSS и встроенная подстановка цвета в SVG через inline-style.
- Без вмешательства в шаблоны: внедрение HTML/JS через обработчик OnEndBufferContent.
Требования
-
1C‑Bitrix: Управление сайтом (ядро D7).
-
PHP 8.2.
-
Права администратора для установки и настройки модуля.
Требования к персоналу, оказывающего поддержку
- знание PHP 8.2.
- знание HTML, JS‚ CSS.
- знание Bitrix Framework ядро D7.
Состав модуля (ключевые файлы)
- install/index.php — класс модуля astonia_socialwidget с установкой/удалением, регистрацией событий, копированием файлов.
- install/version.php — текущая версия модуля (напр. 1.0.4).
- install/css/style.css — стили виджета.
- install/images/*.svg — иконки: telegram_v2.svg, whatsapp_v2.svg, vk_v2.svg, phone.svg, cloud.svg, close.svg.
- lib/eventhandler.php — обработчики событий:
- OnBeforeProlog — подключение CSS и инлайнового стиля с цветом из настроек;
- OnEndBufferContent — генерация HTML/JS виджета и вставка перед </body>.
- options.php — страница настроек модуля в админке.
- include.php — файл инициализации (пустой).
Стоимость программы:
1000 рублей - для приобретения программы - напишите нам на почту bitrix@astonia.ru с заголовком "Виджет для 1C-Bitrix мессенджеров: Telegram, WhatsApp, VK" и мы отправим инструкцию по ее приобретению.
Установка
1. Зайдите в административную панель сайта: Маркетплейс → Установленные решения → Установить решение (или через раздел «Настройки → Настройки продукта → Модули» при наличии локальной установки).
2. Установите модуль astonia.socialwidget. В процессе установки будут:
-
Скопированы стили в /bitrix/css/astonia.socialwidget/;
-
Скопированы иконки в /bitrix/images/astonia.socialwidget/;
-
Зарегистрированы обработчики событий ядра: main:OnBeforeProlog, main:OnEndBufferContent.
Альтернативно (ручная установка):
-
Скопируйте каталог модуля в /bitrix/modules/astonia.socialwidget/;
-
В админке выполните установку через список модулей.
Настройка
Откройте: Настройки → Настройки продукта → Настройки модулей → Astonia Social Widget.
Доступные опции:
-
Активность (active, checkbox): включает/выключает вывод виджета.
-
Telegram (telegram_link, text): ссылка на канал/чат/профиль.
-
WhatsApp (whatsapp_link, text):
-
VK (vk_link, text): ссылка на сообщество/профиль.
-
Телефон (phone_link, text): tel:+79991234567 или просто номер; при отсутствии префикса будет добавлено tel:.
-
Цвет иконок (color, color): HEX‑значение, применяется к SVG‑иконкам виджета.
Принцип работы
-
При OnBeforeProlog модуль подключает CSS style.css и инлайн‑стиль с цветом из опции color.
-
При OnEndBufferContent модуль:
-
Проверяет опцию active и набор ссылок;
-
Формирует HTML блока .astonia-social-widget с кнопкой и списком иконок;
-
Добавляет JS‑логику: на десктопе показ по наведению (с автоскрытием), на мобильных — раскрытие по клику.
Эксплуатация
-
Изменение ссылок и цвета производится в настройках модуля, публиковать шаблоны не требуется.
-
Для временного скрытия — снимите флажок «Активность».
-
Для добавления/изменения SVG или стилей можно заменить файлы в:
-
/bitrix/images/astonia.socialwidget/ — SVG;
-
/bitrix/css/astonia.socialwidget/style.css — стили.
Обновления и совместимость
-
Текущая версия: смотрите install/version.php.
-
При обновлении файлы в /bitrix/css/... и /bitrix/images/... могут быть перезаписаны — при кастомизациях сохраняйте бэкап.
Удаление
Удаление через список модулей в админке. Будут отменены регистрации событий, удалены папки:
-
/bitrix/css/astonia.socialwidget/
-
/bitrix/images/astonia.socialwidget/
Частые вопросы
Виджет не отображается:
-
Проверьте, что модуль установлен и активирован (опция active = Y).
-
Убедитесь, что страница не является административным разделом (ADMIN_SECTION), где виджет принудительно скрывается.
-
Проверьте наличие ссылок минимум на один канал.
Номер WhatsApp с пробелами/скобками
- допустимо, модуль очистит до цифр.
Цвет не применился
- проверьте корректность HEX и кэш браузера.
Поддержка
Вопросы и предложения по работе модуля можно писать на электронную почту bitrix@astonia.ru.
