cat ~/modules/phonemask/README.md

Маска телефона

Флаг страны, маска и проверка номера во всех полях телефона на сайте. В заказ и в 1С номер уходит как +79991234567.

Скоро на Маркетплейсе partner.phonemask v1.0.0 Проверено: Битрикс «Бизнес» 26.150PHP 8.2UTF-8

Любая редакция с главным модулем 20.0+. Оформление заказа — в редакциях с модулем «Интернет-магазин».

Скоро на Маркетплейсе Посмотреть демо Документация
partner.phonemask

cat why.md

Зачем он нужен

  • В заявке не хватает цифры. Перезвонить некому.
  • Покупатель из Казахстана не может ввести номер — поле ждёт российский формат.
  • В sale.order.ajax после смены доставки маска пропадает.
  • На поле две маски, шаблонная и ещё одна. Ввод ломается.
  • В 1С один клиент записан как «8 (999)…», «+7 999…» и «79991234567».

diff before.md after.md

До и после

Сейчас

  • Поле принимает неполный номер.
  • Номера в заказах хранятся кто как ввёл.

С модулем

  • У поля флаг, поиск по странам и пример номера.
  • Неполный номер подсвечивается. Форма не уходит — или уходит, если так настроить.
  • Заказ и профиль пользователя получают +79991234567, даже если номер ввели в админке.

ls ~/modules/phonemask/features

Что умеет

Ввод

  • Список стран с поиском по названию и коду. Нужные — наверх, лишние можно скрыть.
  • Маска и пример номера под страну. На телефоне открывается цифровая клавиатура.
  • Номер можно вставить как угодно: 8 (999) 123-45-67, +7 999 1234567, 79991234567.
  • Если после +7 набрали 8, подскажет.
  • Выбранную страну запоминает для других форм.

Проверка

  • Номер проверяется по правилам выбранной страны.
  • Формат на выходе: +79991234567 или +7 999 123-45-67.
  • Страна по умолчанию задаётся для каждого сайта. Можно определять по IP через геолокацию Битрикса.

Где работает

  • Поля type=tel и поля с PHONE в имени.
  • Оформление заказа: свойства с отметкой «Является телефоном» или по коду. Смена доставки и оплаты маску не сбрасывает.
  • Регистрация, личный кабинет, веб-формы по символьному коду вопроса.
  • Попапы «Заказать звонок» и «Купить в 1 клик», которые появляются после загрузки страницы.
  • Свои поля — по CSS-селектору. Исключить поле — атрибут data-pmask-off.

Для 1С и CRM

  • Номер приводится к +79991234567 при сохранении заказа и профиля.
  • Нераспознанный номер сохраняется как есть.
  • В настройках есть кнопка «Проверить номер»: вводите любой номер и видите, как он сохранится.

ls screenshots/

Скриншоты

cat ~/modules/phonemask/install.md

Установка

  1. Установить

    «Marketplace → Установленные решения → Установить».

  2. Открыть любую форму

    Флаг и маска уже на месте.

  3. Настроить, если нужно

    «Настройки модулей → Маска телефона»: страна по умолчанию и формат.

zelenkindev@bitrix: ~

cat TESTING.md

Совместимость

ПараметрЗначениеСтатус
Стенд«1С-Битрикс: Бизнес» 26.150, PHP 8.2, шаблон «Интернет-магазин»Проверено
СценарииПопап, форма, sale.order.ajax со сменой доставки, номера RU, KZ, BY, вставка из буфераПроверено
ТребованияГлавный модуль 20.0+, PHP 7.4–8.3, UTF-8Требование
PHP 7.4 и 8.3Проверен синтаксис. Работа — на 8.2Частично
КомпозитДанных посетителя в HTML нет. С включённым композитом не проверялНе проверено
АспроПравила для форм Аспро есть. На стенде Аспро нет, не проверялНе проверено

Скрипт — около 24 КБ в сжатом виде, грузится после страницы. Справочник номеров скачивается только при первом вводе. Перед покупкой проверьте модуль на своём шаблоне в демо-режиме.

cat LICENSE

Лицензия

Модуль продаётся на Маркетплейсе 1С-Битрикс. Там цена, демо-период и продление. Возврат — по правилам Маркетплейса. Внутри библиотека intl-tel-input под MIT. Код модуля открыт.

Скоро на Маркетплейсе

Цена — на Маркетплейсе 1С-Битрикс

phonemask --help

Вопросы

Маска появилась не во всех формах.

Добавьте селектор поля на вкладке «Поля на сайте». Обычно это одна строка, например #callback input[name=tel].

На поле уже стоит маска шаблона.

Модуль её снимает, опция включена по умолчанию. Если тема ставит маску снова — выключите её в настройках темы.

Можно оставить только несколько стран?

Да. Поле «Показывать только эти страны», например ru, kz, by.

Что попадёт в 1С и CRM?

+79991234567 в свойстве заказа и в профиле. Старые заказы получат этот формат после пересохранения.

Сайт не станет медленнее?

Скрипт около 24 КБ в сжатом виде, грузится после страницы. Справочник номеров — только когда человек начал вводить номер.

Что будет после демо-периода?

Поля телефона станут обычными. Сайт продолжит работать.

У меня несколько сайтов.

Выберите сайт вверху настроек и задайте ему свои значения.

git log -3

Версии

  1. commit 5350185 (tag: v1.0.0, HEAD)

    Date:

    • Первая версия: список стран, маска, проверка номера.
    • Подключается к формам, заказу, регистрации, веб-формам и попапам.
    • Номер в заказах и профилях приводится к +79991234567.

Вся история версий

man support

Поддержка

Пишите — отвечу сразу. Укажите версии Битрикса, PHP и модуля.

Как обратиться в поддержку

mail zelenkindev

Вопросы по модулю

Пишите — отвечу сразу.

  • MAX

    QR-код: https://max.ru/u/f9LHodD0cOKhBt_X5KaDCt4SgZkqN6JkUnj_2fzv5KGWZyBjRqqFa8wa36E
    Наведите камеру телефона
    Открыть в MAX
  • Telegram

    QR-код: https://t.me/zelenkins
    Наведите камеру телефона
    Открыть в Telegram

man zelenkindev

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

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