Документация актуальна для плагина версии 2.0.0
Инструкция по настройке плагина
  1. Установите плагин
  2. Зайдите в настройки плагина («Магазин» --> «Плагины» ---> «Нормальная маска телефона»)
  3. Включите плагин
  4. Активируйте те настройки плагина, которые вам необходимы.
    • Не включайте вывод маски на формах плагинов, которые вы не используете. Иначе плагин выведет на вашем сайте скрипты, которые не будут использоваться, что, пусть и незначительно, но увеличит время загрузки страниц вашего сайта.
  5. Если вы используете маску телефона на формах плагинов Bodysite, то обязательно отключите маски телефонов в настройках плагинов Bodysite.
    • Во всех плагинах Bodysite маска телефона включается через заполнение соответствующего поля в настройках формы: https://yadi.sk/i/-xaPUYUqH_cgUg. Очистите это поле, чтобы получилось вот так: https://yadi.sk/i/r8oJzRzDKNCxJg. Не забудьте после этого сохранить настройки.
  6. Если вы используете маску телефона на странице оформления заказа в корзине и у вас установлен плагин Подсказки к оформлению заказа, то обязательно отключите маску телефона в настройках данного плагина.
    • Важно! В данном плагине маска включена по умолчанию в настройках плагина (в админке название плагина: "BNP Dadata"). Зайдите в настройки плагина, найдите это поле: https://yadi.sk/i/XU-X3vUnmLJ90A, очистите его https://yadi.sk/i/QpMTZe-kYep1vA и не забудьте сохранить настройки плагина (кнопка расположена в нижней левой части экрана, немного внизу): https://yadi.sk/i/BZJHogSFWQ17HA.
  7. Если вы используете маску телефона на странице оформления заказа в корзине и у вас установлен плагин Форматирование и проверка телефонного номера, то обязательно отключите данный плагин в инсталлере.
    • Важно! Данный плагин может внедрять свои скрипты даже при отключении его в настройках плагина. Скрипты данного плагина конфликтуют со скриптами плагина "Нормальная маска телефона". Поэтому его нужно отключить именно в инсталлере: https://yadi.sk/i/gsNZz0tpUv8L3w
Инструкция по интеграции плагина в другие продукты (для разработчиков)

Плагин из коробки работает со всеми штатными формами приложения "Магазин", использующих поле для ввода номера телефона. Если вы хотите использовать нормальную маску телефона на форме своего плагина или на какой-нибудь нестандартной форме своей темы дизайна - можете использовать метод плагина "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'); } }

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

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

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

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

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

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

Если плагина нет под рукой

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

Бонус!

Если вы интегрировали с плагином «Нормальная маска телефона» свой продукт, опуликованный в маркете Webasyst, и разместили в описании своего продукта на маркете Webasyst гиперссылку на плагин «Нормальная маска телефона», напишите в поддержку плагина и пришлите ссылку на свой продукт в маркете Webasyst. Мы создадим для вас многоразовый купон на скидку 70% на плагин «Нормальная маска телефона» без ограничения срока действия. Прошу обратить внимание, что купон будет аннулирован в случае его утечки в сеть. Он предназначен только для разработчиков.

Также, если вы интегрировали плагин «Нормальная маска телефона» со своим продуктом, опубликованным в маркете Webasyst, пожалуйста, уведомите об этом разработчика, указав при этом версию своего продукта. Мы опубликуем данную информацию в описании к плагину и/или в документации и приложим ссылку на страницу вашего продукта в маркете Webasyst.

FAQ. Ответы на часто задаваемые вопросы
Что делать если плагин не работает в корзине сайта?
  1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
  2. Убедитесь, что вы проверяете действительно ТУ корзину сайта, для которой активировали соответствующую опцию в настройках плагина.
  3. Если плагин не работает в корзине /order/ - проверьте наличие хука "frontend_order" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  4. Если плагин не работает в корзине /cart/ - проверьте наличие хука "frontend_cart" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  5. Если плагин не работает в корзине, настроенной через плагин "Заказ в 1 шаг" (Bodysite), включенной на странице /cart/, - проверьте наличие хука "frontend_cart" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  6. Если плагин не работает в корзине, настроенной через плагин "Заказ в 1 шаг" (Bodysite), включенной на странице /checkout/, - проверьте наличие хука "frontend_checkout" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  7. Если плагин не работает в корзине, настроенной через какой-либо другой плагин (например, "Заказ на одной странице" (onestep), - У меня см. ответ на вопрос "У меня есть форма, с которой плагин из коробки не работает. Как можно интегрировать плагин?"
Что делать если плагин не работает на форме плагина "Купить в 1 клик" (buy1click)?
  1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
  2. Если плагин не работает в корзине /cart/ - проверьте наличие хука "frontend_cart" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  3. Если плагин не работает на других страницх сайта (в карточках товаров или в листинге) - проверьте наличие хука "frontend_footer" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  4. Если вы убедились в корректности всех настроек, но плагин все равно не рабоботает - обратитесь в техническую поддержку.
Что делать если плагин не работает на других формах?
  1. Убедитесь, что вы произвели настройку плагина согласно инструкции. Пожалуйста, будьте внимательны и проверьте каждый пункт!
  2. Проверьте наличие хука "frontend_footer" в вашей теме дизайна и, в случае его отсутствия, выведите его (как это сделать).
  3. Если вы убедились в корректности всех настроек, но плагин все равно не рабоботает - обратитесь в техническую поддержку.
У меня есть форма, с которой плагин из коробки не работает. Как можно интегрировать плагин?
  • Вариант 1 (оптимальный): обратитесь к разработчику продукта, на форме которого вы хотите вывести нормальную маску телефона. Попросите его интегрировать свой продукт с плагином "Нормальная маска телефона" в обновлении и пришлите ссылку на документацию.
  • Вариант 2: обратитесь к любому разработчику за индивидуальной доработкой вашего продукта, на форме которого вы хотите вывести нормальную маску телефона. Поставьте задачу интегрировать установленный у вас продукт с плагином "Нормальная маска телефона" в виде индивидуальной доработки и пришлите ссылку на документацию. Однако учитите, что после индивидуальной доработки вам придется либо отказаться от обновлений продукта, либо каждый раз переносить доработку в индивидуальном порядке.

    Стоимость такой доработки нашими силами - в районе 1000 руб. (зависит от продукта, который вы хотите доработать).
Как быть с покупателями из других стран?

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

Техническая поддержка
  • Техническая поддержка осуществляется только посредством электронной почты: anatoly@chikurov-seo.ru
  • Техническая поддержка обычно осуществляется в рабочее время: Пн-Сб 08:00-17:00 (мск).
  • Среднее время реакции на обращения: 2-3 часа
  • Максимальное время реакции на обращения: 2-3 рабочих дня
  • Если ответ на ваше обращение не поступил за 3 рабочих дня - напишите снова напрямую на электронную почту, не используя форму на сайте (возможны перебои в работе формы из-за антиспам-защиты)
  • В техническую поддержку плагина входят только решение вопросов, касающихся непосредственно функционала плагина. На вопросы про SEO продвижение, не относящиеся к функционалу плагина, ответы даны не будут.