Page tree
Skip to end of metadata
Go to start of metadata

Внимание! На текущий момент функционал не доступен, информация не актуальна. Документация будет дополнена после обновления механизма кастомизации страницы.

На git­hub текущий шаблон для ввода карточных данных. Надо придерживаться указанных в шаблоне полей. Вся верстка для платежной формы формируется исходя из приложенного json + новый css + новые картинки. Для отладки собственных тем используйте следующий сервис https://test.rficb.ru/theme-­debug/.

Процесс подготовки темы:

  1. размещаете исходную тему на своем сервере, открываете внешний доступ к чтению каталога по HTTPS
  2. https://test.rficb.ru/theme-debug – в поле URL темы прописываете адрес темы из п1
  3. в dropdown “страница”  – выбираете какую именно страницу хотите тестировать, проверяете
  4. вносите изменения в тему, отлаживаете
  5. готовая тема предоставляется для проверки сотрудникам банка, после проверки тема выкладывается на боевые сервера.

Задание структуры страниц

layout и аналогичные параметры содержат описание древовидной структуры страницы. Все узлы дерева являются <div>-ами, а в качестве листьев можно использовать либо предопределённые блоки, либо блоки с фиксированным содержимым. Названия предопределённых блоков состоят полностью из заглавных букв.

Один массив задаёт один <div> и всё его содержимое, а первый элемент массива – это идентифкатор/класс, который будет использован. Формат либо идентификатор, либо идентификатор.css-класс. Остальные элементы – то же самое рекурсивно.

превращается в

Блоки с фиксированным содержимым

Названия блоков в layout указываются строчными буквами. По умолчанию это пустые <div>-ы, но через параметр fragments им можно задать любое содерижмое. Сам fragments представляет собой ассоциативный массив, где ключ – это название блока из layout, а содержимое это одно из двух:

  1. Непосредственно строка
  2. Ассоциативный массив с переводами, где ключ – это язык, а значение – уже непосредственно содержимое блока для этого языка.

Предопределенные блоки

Названия состоят из полностью заглавных букв, набор таких блоков ограничен. Одним из самых главных блоков является FORM – это форма ввода карточных данных.
Если под тему всё-таки требуется специальная настройка блока, то это необходимо делать расширенем самого блока, и эта настройка должна срабатывать на появление в theme.json дополнительных параметров.

Интернационализация

Предопределённые блоки переводятся встроенными средствами и стандартным для всех тем образом.
Для блоков с фиксированным содержимым можно задавать локализованное содержимое.
Метод UniversalTheme::image() (в шаблонах блоков доступен через $theme) позволяет выбрать картинку в зависимости от того, переопределена ли она в субтеме и есть ли вариант для текущего языка. Первый из найденных в следующем порядке перебора и будет показан (пример при языке ‘en’ и имени файла “image.png”):
– “image_en.png” из текущей субтемы
– “image.png” из текущей субтемы
– “image_en.png” из обычной темы default
– “image.png” из обычной темы default

3DS авторизация

Для 3DS карт будут отрываться окна ввода пароля и они будут совершенно различных дизайнов и форм. Страницы для ввода 3DS паролей большинства банков запрещают отрисовку в iframe, поэтому мы можем передавать дополнительные параметры на страницу интернет магазина через JS следующим образом:

На странице интернет магазина необходимо реализовать обработчик “trigger”, который переадресует пользователя с параметрами заданными в поле “data” в текущем родительском окне.

  • No labels