man partner.phonemask
Маска телефона: установка и настройка
Установка
- В админке откройте «Marketplace → Каталог решений», найдите модуль и нажмите «Установить» (или «Попробовать» для демо-версии).
- В списке «Marketplace → Установленные решения» нажмите «Установить».
- Готово: поля телефона на сайте получили флаг страны, маску и проверку номера.
Требования: главный модуль 20.0+, PHP 7.4–8.3, сайт в кодировке UTF-8. Модули «Интернет-магазин» и «Веб-формы» не обязательны. Если включён композит, сбросьте его кеш после установки.
Настройка
Настройки: «Настройки → Настройки продукта → Настройки модулей → Маска телефона с выбором страны». Вверху выберите, для каких сайтов настройки: общие для всех или для конкретного сайта. Чтобы задать сайту свои значения, снимите галочку «Использовать общие настройки».
Вкладка «Основные»
- «Включить маску на сайте» — общий выключатель.
- «Страна по умолчанию» — выбрана, пока посетитель не выберет другую.
- «Определять страну по IP» — нужна настроенная геолокация («Настройки → Геолокация»). Без неё — страна по умолчанию.
- «Страны вверху списка» — коды через запятую, например
ru, kz, by, uz. - «Показывать только эти страны» — пусто означает все страны.
- «Запоминать страну посетителя» — выбор хранится в браузере.
- «В каком виде отправлять номер» —
+79991234567или+7 999 123-45-67. - «Если номер введён неверно» — не отправлять форму или только подсветить поле.
- «Подсказка в пустом поле» — подсказка шаблона или пример номера.
- «Подсказывать про 8 после +7»
Вкладка «Поля на сайте»
- «Все поля телефона» — поля типа «телефон» и поля с PHONE в названии.
- «Оформление заказа» и «Коды свойств заказа с телефоном» (по умолчанию
PHONE, плюс все свойства с отметкой «Является телефоном»). - «Регистрация и личный кабинет»
- «Веб-формы» и «Символьные коды вопросов» (по умолчанию
PHONE). - «Формы и всплывающие окна шаблонов Аспро»
- «Дополнительные поля» — CSS-селекторы, по одному в строке.
- «Не подключать к полям» — селекторы исключений. Можно также добавить полю атрибут
data-pmask-off. - «Отключать маску шаблона на этих полях»
Вкладка «Для 1С и CRM»
- «Приводить номера к единому виду при сохранении» — заказ и профиль получают
+79991234567. - «Поля пользователя» — какие поля профиля приводить (по умолчанию «Телефон» и «Мобильный»).
- «Проверить номер» — введите номер в любом виде и посмотрите, как он сохранится.
Вкладки «Доступ» и «Справка»
Права групп на модуль и краткая справка.
Шаблоны Аспро
Модуль сам подключается к полям input.phone и полям с кодом PHONE и снимает маску темы. Если маска темы
возвращается, очистите маску телефона в настройках темы Аспро (параметры форм).
Что проверить после установки: формы «Заказать звонок», «Задать вопрос», «Купить в 1 клик» и оформление заказа. На моём стенде шаблонов Аспро нет, поэтому эти сценарии нужно проверить в демо-режиме на вашем сайте.
Для разработчика
window.PartnerPhonemask.scan(element)— подключить маску к полям внутри элемента. Обычно не нужно: новые поля подхватываются автоматически.window.PartnerPhonemask.attach(input)— подключить к конкретному полю.window.PartnerPhonemask.isValid(input)—true,falseилиnull(справочник номеров ещё не загружен).- Атрибут
data-pmask-offили классpmask-off— не трогать поле.
Удаление
«Marketplace → Установленные решения» → «Удалить». Модуль спросит, сохранить ли настройки. После удаления поля телефона снова обычные. Номера, уже сохранённые в заказах и профилях, не меняются.
man support
Если не работает
Напишите, что не работает: версия Битрикс, PHP и модуля, адрес страницы и скриншот.