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

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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". Если вы работаете с покупателями из других стран - рекомендую отказаться от использования плагина. Возможно, в будущем плагин начнет поддерживать международные форматы номеров телефонов.

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