Шаблоны и оформление
Обновлено
Какие файлы использует плагин
При поиске переопределений плагин проверяет корень текущей темы Shop-Script. Имена файлов чувствительны к регистру на файловых системах, где различаются прописные и строчные буквы.
Исходник относительно wa-apps/shop/plugins/checkoutauth/ |
Имя файла в корне темы | Когда используется |
|---|---|---|
templates/Wrapper.html |
checkoutauth_plugin.wrapper.html |
При вызове хелпера. |
templates/actions/forms/Login.html |
checkoutauth_plugin.login.html |
При AJAX-загрузке входа. |
templates/actions/forms/Signup.html |
checkoutauth_plugin.signup.html |
При AJAX-загрузке регистрации. |
templates/actions/forms/Forgot.html |
checkoutauth_plugin.forgot.html |
При AJAX-загрузке восстановления. |
Плагин выбирает тему через waRequest::getTheme(). Если текущая тема не определена или переопределение не найдено, используется встроенный файл.
Первая загрузка и переключения
Стандартный Wrapper.html включает первую форму напрямую через относительный путь ./actions/forms/.... Поэтому файл checkoutauth_plugin.login.html сам по себе меняет AJAX-ответ формы входа, но не её первый вывод внутри стандартной обёртки.
Чтобы изменить формы и при первой загрузке, и после переключений, разработчику нужно согласовать обёртку и шаблоны форм:
- Скопировать обёртку и нужные формы в корень активной темы с именами из таблицы.
- В копии обёртки заменить относительные подключения форм на файлы темы. Например, подключение входа должно ссылаться на
./checkoutauth_plugin.login.html. Аналогично изменить подключения регистрации и восстановления, подготовив соответствующие файлы. - Учесть вложенное подключение OAuth-кнопок: в формах входа и регистрации используется
../../includes/auth-adapters.html. После переноса формы в корень темы этот путь нужно изменить.
Для последнего шага можно скопировать templates/includes/auth-adapters.html в корень темы под собственным именем, например checkoutauth_plugin.auth-adapters.html, и в обеих формах использовать:
{include file="./checkoutauth_plugin.auth-adapters.html"}Это обычное включение файла из изменённого шаблона. Автоматического поиска переопределения для auth-adapters.html в плагине нет.
Сохраняйте используемые JavaScript классы js-checkoutauth-*, атрибуты data-form, data-switch-to, data-plugin-url и контейнер формы. Проверьте все переходы между формами после изменения разметки.
Стили
«Подключать CSS плагина» управляет загрузкой css/checkoutauth.css. При собственном оформлении тема должна также обеспечить скрытие элементов с классом hidden: на нём основано раскрытие обычной формы.
Встроенные формы Webasyst вызываются с отключённым подключением их CSS, поэтому при отключении CSS плагина проверьте оформление полей и сообщений.
Тёмный режим встроенных стилей включается селекторами html.dark, html[data-theme="dark"] и html[data-bs-theme="dark"]. Отдельной настройки тёмного режима у плагина нет.