man partner.phonemask

Маска телефона: установка и настройка

Установка

  1. В админке откройте «Marketplace → Каталог решений», найдите модуль и нажмите «Установить» (или «Попробовать» для демо-версии).
  2. В списке «Marketplace → Установленные решения» нажмите «Установить».
  3. Готово: поля телефона на сайте получили флаг страны, маску и проверку номера.

Требования: главный модуль 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 и модуля, адрес страницы и скриншот.

Поддержка

man zelenkindev

Горячие клавиши

/
поиск по модулям
?
эта справка
Esc
закрыть