Решения

Как пользоваться разделом

Ниже — типовые ситуации, с которыми сталкиваются пользователи модуля. Если проблему не удалось решить — обратитесь в техподдержку: modul@ipromo.ru.

Установка и удаление

Как установить модуль

Купите модуль на Маркетплейс или скачайте архив.
В админке откройте Marketplace → Установленные решения.
Найдите «АйПромо: Управление контактной информацией» и нажмите «Установить».
После установки откроется страница с сообщением об успехе и ссылкой на настройки.

Где найти настройки после установки

Через Настройки → Настройки продукта → Настройки модулей → Управление контактной информацией, либо из списка модулей.

Как удалить модуль

Откройте модуль в списке и нажмите «Удалить».
В форме удаления выберите, удалять ли сохранённые контактные данные:
- галочка «Удалить все сохранённые контактные данные» — опции и логотипы будут стёрты;
- без галочки — данные сохранятся, при повторной установке подтянутся.
Подтвердите удаление.

Настройки

Не сохраняются значения

Причины:

нет прав на запись в модуль — обратитесь к администратору;
истекла сессия — обновите страницу и повторите;
на сервере отключена запись в опции — проверьте права на директорию /bitrix/.

Где хранятся значения контактов

Все поля хранятся в опциях модуля ipromoagency.contact. Логотипы — в /upload/contact/.

Контакты на сайте

Не выводятся значения в шаблоне

Проверьте, что модуль подключён:

<?php
if (CModule::IncludeModule('ipromoagency.contact')) {
    $contact = \Ipromoagency\Contact\ContactHelper::getContactArray();
}
?>

Если переменная пуста — модуль не установлен или поле не заполнено в настройках.

Телефон выводится без ссылки

Используйте метод formatPhone() или вручную уберите лишние символы:

<a href="tel:<?= preg_replace('/[^\d+]/', '', $contact['PHONES']['MAIN']) ?>">
    <?= $contact['PHONES']['MAIN'] ?>
</a>

Email выводится как текст

Для кликабельного email используйте mailto::

<a href="mailto:<?= $contact['EMAILS']['MAIN'] ?>">
    <?= $contact['EMAILS']['MAIN'] ?>
</a>

Пустые поля выводятся как «Array»

Значит, обращаетесь к несуществующему ключу. Проверьте через pcode($contact) или print_r($contact) — какие ключи доступны.

Логотип

Логотип не загружается

Проверьте:

формат файла — JPG, JPEG, PNG, GIF, WEBP;
размер — если файл больше лимита PHP, увеличьте upload_max_filesize и post_max_size;
права на директорию /upload/contact/ — модуль создаёт её автоматически, но если сервер запрещает запись, появится ошибка.

Логотип не удаляется

Кнопка «Удалить логотип» отправляет POST-запрос с подтверждением. Проверьте, что в браузере не блокируется JavaScript, и что сессия активна.

После обновления логотип пропал

Возможно, файл удалён из /upload/contact/ вручную. Перезалейте логотип через форму.

Логотип не подставляется в шаблон

Проверьте:

<?php
$logo = \Ipromoagency\Contact\ContactHelper::getLogoUrl('LOGO');
var_dump($logo); // должен вернуть URL
?>

Если пусто — логотип не загружен или ID файла обнулён.

Социальные сети

Соцсети не отображаются на сайте

Метод getActiveSocial() возвращает только заполненные поля. Если все поля пусты — массив будет пустым. Проверьте через:

<?php
$social = \Ipromoagency\Contact\ContactHelper::getActiveSocial();
var_dump($social);
?>

Заполнена одна соцсеть, а выводятся все

Используйте getActiveSocial(), а не $contact['SOCIAL']. Первый возвращает только заполненные поля, второй — все.

Можно ли добавить свою соцсеть

В текущей версии модуля список фиксирован. Если нужна дополнительная площадка — напишите в техподдержку, возможно расширение списка.

Что с запрещёнными в РФ соцсетями

Facebook, Instagram, WhatsApp, Twitter/X признаны экстремистскими и запрещены на территории РФ. Модуль показывает предупреждение прямо в интерфейсе. Рекомендуется заполнять только VK, MAX, Telegram, RuTube, Одноклассники.

Карта

Ссылка на карту не открывается

Проверьте URL в поле «Ссылка на Яндекс.Карты». Он должен начинаться с https://yandex.ru/maps/. Не вставляйте код встраивания <iframe> — модуль принимает именно ссылку на страницу с меткой.

Как получить ссылку на карту

Откройте Яндекс.Карты.
Найдите свой офис.
Нажмите «Поделиться» → «Скопировать ссылку».
Вставьте ссылку в поле модуля.

Кеш

Изменил настройки, а на сайте — старое значение

Очистите кеш: Настройки → Автокеширование → Очистить весь кеш. Если на сайте включён композитный кеш — очистите и его.

Не вижу изменений в шапке/футере

Проверьте, что компонент, выводящий контакты, не кеширован отдельно. Отключите кеш компонента на время отладки или настройте автосброс по тегам.

Куда обращаться

Email: modul@ipromo.ru
Часы работы: Пн–Пт, 10:00–19:00 (MSK, UTC+3)
Ответ направляется в течение одного рабочего дня.

В письме укажите версию модуля, версию Битрикса и PHP, описание проблемы и шаги воспроизведения.