Документация к плагину "Нормальная маска телефона"

1. Установите плагин
2. Зайдите в настройки плагина («Магазин» --> «Плагины» ---> «Нормальная маска телефона»)
3. Включите плагин
4. Активируйте те настройки плагина, которые вам необходимы.
5. Если вы используете маску телефона на формах плагинов Bodysite, то обязательно отключите маски телефонов в настройках плагинов Bodysite. Во всех плагинах Bodysite маска телефона включается через заполнение соответствующего поля в настройках формы, выглядит это примерно так: Очистите это поле, чтобы получилось вот так: И после этого не забудьте после этого сохранить настройки плагина. Повторите это действие для всех используемых плагинов Bodysite.
6. Если вы используете маску телефона на странице оформления заказа в корзине и у вас установлен плагин Подсказки к оформлению заказа, то обязательно отключите маску телефона в настройках данного плагина. В данном плагине маска включена по умолчанию в настройках плагина (в админке название плагина: BNP Dadata). Зайдите в настройки плагина, найдите это поле: Очистите это поле, чтобы получилось вот так: И после этого не забудьте сохранить настройки плагина (кнопка расположена в нижней левой части экрана, немного внизу).
7. Если вы используете маску телефона на странице оформления заказа в корзине и у вас установлен плагин Форматирование и проверка телефонного номера, то обязательно отключите данный плагин в инсталлере. Данный плагин может внедрять свои скрипты даже при отключении его в настройках плагина! Поэтому отключать его нужно именно в инсталлере!

Плагин из коробки работает со всеми штатными формами приложения "Магазин", использующих поле для ввода номера телефона. Если вы хотите использовать нормальную маску телефона на форме своего плагина или на какой-нибудь нестандартной форме своей темы дизайна - можете использовать метод плагина "getPhonemaskScripts".

Для интеграции плагина в свою тему дизайна используйте следующий код (Smarty):

{if $wa->shop} {if method_exists('shopPhonemaskPlugin', 'getPhonemaskScripts')} {shopPhonemaskPlugin::getPhonemaskScripts('.selector')} {/if} {/if}

Для интеграции плагина в свой плагин используйте следующий код (PHP):

if (wa()->appExists('shop')) { if (method_exists('shopPhonemaskPlugin', 'getPhonemaskScripts')) { shopPhonemaskPlugin::getPhonemaskScripts('.selector'); } }

Метод вернет JS скрипт, который внедряет нормальную маску телефона для элемента, селектор которого вы укажите в параметре. В примере выше в качестве селектора указан '.selector'. Используйте вместо него свой селектор. Например: '.myplugin input[name*="[phone]"]'.

Важные моменты

Скрипт не только внедрит маску, но и заполнит атрибут "placeholder", если такая опция включена в настройках плагина. Если вы этого не хотите (например, если на вашей форме это отображаться некорректно/некрасиво) - передайте значение "false" вторым параметром функции: "shopPhonemaskPlugin::getPhonemaskScripts('.selector', false)". Тогда в вернувшемся JS коде не будет добавлен скрипт для заполнения атрибута "placeholder", независимо от настроек плагина.

В скрипте, возвращаемым плагином, JS код выводится в событии "$(document).ready(function()". Поэтому, если вы хотите, например, подключить нормальную маску телефону для полей формы, открывающейся во всплывающем окне, - обратитесь к методу плагина именно из формы.

Если вам необходимо подключить маску телефона для нескольких полей - обратитесь к методу несколько раз, каждый раз передав первым параметром уникальный селектор. При использовании неуникальных селекторов, маска должна работать для всех полей на странице, но возможны баги.

Библиотека, необходимая для работы плагина, выведется плагином отдельно через хук "frontend_footer". Если вы хотите подключить маску для своего продукта в бекенде, или во фронтенде, где в темах дизайна не выводится данный хук - напишите в поддержку плагина. По запросу, мы выпустим обновление плагина и добавим возможность запрашивать вывод библиотеки с помощью дополнительного параметра при обращении к методу плагину.

Проблема. Что делать если плагин на пользовательской части сайта? (Вообще нигде)

1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
2. Если плагин не работает - проверьте наличие хука frontend_footer в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).

Проблема. Что делать если плагин не работает в корзине сайта?

1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
2. Если плагин не работает в корзине /order/ - проверьте наличие хука frontend_order в файле order.html в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
3. Если плагин не работает в корзине /cart/ - проверьте наличие хука frontend_footer в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).

Проблема. Что делать если плагин не работает на форме плагина "Купить в 1 клик" (buy1click)?

1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
2. Если вы убедились в корректности всех настроек, но плагин все равно не работает - обратитесь в техническую поддержку.

Проблема. Что делать если плагин не работает на других формах?

1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
2. Проверьте наличие хука frontend_footer в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
3. Если вы убедились в корректности всех настроек, но плагин все равно не работает - обратитесь в техническую поддержку.

Вопрос. Как быть с покупателями без российского номера телефона?

В премиум-версии плагина реализована поддержка маски телефона для всех стран мира.

Хочу скидку на плагин! Дадите?

На все наши продукты действует скидка 50% на повторные лицензии. На покупку первой лицензии скидок нет.

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

Хочу скидку на услуги! Дадите?

Нет. Если для вас приоритетным критерием по выбору подрядчика для проведения работ на сайте является низкая цена - рекомендуем вам поискать других исполнителей. Мы работаем в среднем ценовом диапазоне, делаем упор на самый качественный сервис и высокое качество оказываемых услуг.

Хочу настройку плагина бесплатно! Сделаете?

Нет. Мы не осуществляем настройку плагинов на бесплатной основе. К каждому плагину прилагается подробная документация и мы прилагаем максимум усилий для того, чтобы разобраться с каждым плагином мог даже неопытный пользователь.

Если вы не можете или не хотите самостоятельно настраивать плагин - вы можете обратиться за помощью к стороннему специалисту, либо заказать у нас платные услуги.

Хочу настройку плагина платно! Сделаете?

Зависит от текущей загрузки. Свяжитесь с нами любым удобным образом и уточните детали.

Обычно мы настраиваем плагины в рамках комплексных услуг. Например, настраиваем плагины "SEO Link Canonical" и "SEO Meta Robots" в рамках услуги Оптимизация сайта с внедрением региональных поддоменов (SEO), а плагин "Доработки оформления заказа в корзине" в рамках услуги Продвинутая настройка оформления заказа в корзине.

Рекомендуем ознакомиться со всеми нашими комплексными услугами.

• Техническая поддержка осуществляется только через личный кабинет. Инструкция по созданию заявки здесь. Пожалуйста, не пишите на электронную почту и в мессенджеры.
• Техническая поддержка обычно осуществляется в рабочее время: Пн-Сб 08:00-17:00 (мск).
• Среднее время реакции на обращения: 2-3 часа
• Максимальное время реакции на обращения: 2-3 рабочих дня