Версия: 6.x
burger close
Обновление ReadyScript с версии 4.1 до 5.0

Обзор технических изменений ReadyScript 5.0. Данный материал предназначен для разработчиков, создающих собственные темы оформления и модули.

В ReadyScript 5.0 добавлена поддержка двухфакторной авторизации и настройки отображения различных полей при регистрации. Ниже будет представлена подробная инструкция о том как обновить шаблоны, чтобы поддержка данных функций появилась.

Как обновить тему оформления для поддержки двухфакторной авторизации?

Разверните самую свежую тестовую версию ReadyScript в максимальной редакции. Загрузите в нее тему оформления, вашего производства.

Для начала корректировки темы оформления, необходимо в настройках модуля "Пользователи и группы" во вкладке "Настройки входа/регистрации" переключить сценарий авторизации в режим "По номеру телефона". Опцию "Использовать двухфакторную регистрацию" установить в режим "Использовать вместо капчи". Установить флажок напротив опции "Включить Демо-режим. Код из СМС будет виден прямо в поле его ввода". С данными настройками будет возможно протестировать все необходимые функции и все новые шаблоны.

auth_settings.jpg
Настройки модуля Пользователи и группы

На время разработки, рекомендуем отключать кэш в разделе Управление -> Настройка системы, для этого необходимо включить опцию "Всегда проверять шаблоны на предмет модификации", а также снять флажки "Включить кэширование данных" и "Включить кэширование Smarty".

В файле /templates/{ВАША ТЕМА}/layout.tpl необходимо подключить следующие css, js файлы. Данные файлы необходимы для корректной работы функций "Запросить код подтверждения", таймера обратного отсчета, "изменить номер телефона".

{addcss file="%users%/verification.css"}
{addjs file="%users%/verification.js"}

Далее необходимо откорректировать шаблон /templates/{ВАША ТЕМА}/moduleview/users/blocks/authblock/authblock.tpl

В ReadyScript 5.0 ссылка на авторизацию становится динамической, т.е. разной в зависимости от текущих настроек. Получать ссылку на авторизацию в PHP файлах можно с помощью конструкции:

$url = \RS\Config\Loader::byModule('users')->getAuthorizationUrl();

Внутри шаблона authblock.tpl, данная ссылка доступна в переменной $authorization_url Измените жестко указанную ссылку для кнопки "Войти" на переменную {$authorization_url}.

Далее обновите в вашей теме из одной из сестмных тем оформления следующие файлы:

  • /templates/{ТЕМА}/resource/js/common.js (если в вашей теме есть такой файл. Актуально для young, default, perfume, fashion)
  • /templates/{ТЕМА}/resource/js/rs.indialog.js (если в вашей теме есть такой файл. Актуально для flatlines)

Обновления данных js скриптов необходимо, чтобы в клиентской части могли происходить переходы от одного всплывающего окна к другому с помощью ответов сервера. Это необходимо, для того, чтобы после ввода номера телефона клиент увидел новое окно, в котором необходимо ввести код подтверждения.

Далее скопируйте в вашу тему из одной из системных тем оформления новые шаблоны:

  • /templates/{ТЕМА}/moduleview/users/authorization_by_phone.tpl
  • /templates/{ТЕМА}/moduleview/users/authorization_two_step.tpl
  • /templates/{ТЕМА}/moduleview/users/verification/type_code.tpl
  • /templates/{ТЕМА}/moduleview/users/verification/type_phone_inline.tpl

После этого этапа уже можно приступать к стилизации диалогов в рамках вашей темы оформления. Попробуйте открыть страницу авторизации по телефону {ВАШ ДОМЕН}/auth/byphone/ и указать там корректный номер телефона. Система перебросит вас на страницу ввода кода верификации. Проверьте корректность отображения, в случае необходимости внесите изменения в стили вашей темы оформления.

Проверьте как эти же операции работают во всплывающих окнах. Вот как это выглядит в стандартной теме оформления.

auth_by_phone.jpg
Диалог авторизации с подтверждением

Как подключить опции отображения полей к регистрации?

В ReadyScript 5.0 появилась возможность настраивать поля, которые будут отображены пользователю в формах регистрации. Данные настройки можно установить во вкладке "Настройка полей входа/регистрации" в настройках модуля "Пользователи и группы".

В новых версиях шаблона /templates/{ТЕМА}/moduleview/users/register.tpl, формы с полями обернуты условиями. Ниже представлен пример из темы flatlines:

1 {$user_config=$this_controller->getModuleConfig()}
2 
3 {if $user_config.user_one_fio_field} {* Если включено единое поле для ФИО *}
4  <div class="form-group">
5  <label class="label-sup">{t}Ф.И.О.{/t}</label>
6  {$user->getPropertyView('fio', ['placeholder' => "{t}Например, Иванов Иван Иванович{/t}"])}
7  </div>
8 {else}
9  {if $user_config->canShowField('name')} {* Если включено отображение данного поля *}
10  <div class="form-group">
11  <label class="label-sup">{t}Имя{/t}</label>
12  {$user->getPropertyView('name', ['placeholder' => "{t}Например, Иван{/t}"])}
13  </div>
14  {/if}
15 
16  {if $user_config->canShowField('surname')}
17  <div class="form-group">
18  <label class="label-sup">{t}Фамилия{/t}</label>
19  {$user->getPropertyView('surname', ['placeholder' => "{t}Например, Иванов{/t}"])}
20  </div>
21  {/if}
22 
23  {if $user_config->canShowField('midname')}
24  <div class="form-group">
25  <label class="label-sup">{t}Отчество{/t}</label>
26  {$user->getPropertyView('midname', ['placeholder' => "{t}Например, Иванович{/t}"])}
27  </div>
28  {/if}
29 {/if}
30 
31 {if $user_config->canShowField('phone')}
32  <div class="form-group">
33  <label class="label-sup">{t}Телефон{/t}</label>
34  {$user->getPropertyView('phone', ['placeholder' => "{t}Например, +7(XXX)-XXX-XX-XX{/t}"])}
35  </div>
36 {/if}
37 
38 {if $user_config->canShowField('login')}
39  <div class="form-group">
40  <label class="label-sup">{t}Логин{/t}</label>
41  {$user->getPropertyView('login', ['placeholder' => "{t}Придумайте логин для входа{/t}"])}
42  </div>
43 {/if}
44 
45 {if $user_config->canShowField('e_mail')}
46  <div class="form-group">
47  <label class="label-sup">{t}E-mail{/t}</label>
48  {$user->getPropertyView('e_mail', ['placeholder' => "{t}Например, demo@example.com{/t}"])}
49  </div>
50 {/if}

Если объем ваших кастомных изменений небольшой, можно просто обновить данный шаблон из той системной темы оформления, на основе которой вы делали свою. Обратите внимание на то, что появилась новая форма Логин.

Стилизуйте отображение сложного поля Телефон в рамках вашей темы оформления. Вот как выглядит данное поле в стандартной теме оформления:

register_user.jpg
Форма регистрации пользователя

Как подключить опции оторажения полей к оформлению заказа?

В оформлении заказа, для неавторизованных пользователей мы убрали вкладку "Я авторизовывался ранее". Вместо нее мы добавили ссылку "Если Вы регистрировались ранее, пожалуйста, авторизуйтесь". перед формами со сведениями о пользователе.

checkout.jpg
Оформление заказа

Формы с полями регистрации пользователя также должны быть обернуты условиями, аналогичными тем, что используются в регистрации.

Рекомендуем обновить шаблон /templates/{ТЕМА}/moduleview/shop/checkout/address.tpl из той темы оформления, на основе которой вы делали вашу тему.

В случае, если внутри вашей темы есть шаблон для модуля onepageorder (оформление заказа на одной странице), не забудь в нем также обернуть все формы новыми условиями.