О том, где живут настройки виджетов
Почему у виджетов 2.0 два способа хранить настройки, чем скрипт провайдера отличается от бандла, какая настройка побеждает и как загружается код виджетов
Одна и та же настройка виджета может лежать в трёх местах: в скрипте провайдера на стороне Aplaut, в коде вашего сайта и в атрибуте на теге виджета. От того, где она лежит, зависит, кто её меняет и почему правка иногда не доходит до сайта.
Скрипт провайдера и бандл
Бандл — сам код виджетов, без настроек. Скрипт провайдера — небольшой скрипт компании, который хранится в Aplaut: он вызывает aplaut.init с настройками и подключает бандл. Способ установки определяет, кто из них отвечает за настройки.
При установке «Настройки в коде сайта» загрузчик на странице берёт бандл напрямую, а aplaut.init с настройками стоит рядом в коде сайта. Любая правка настроек означает правку кода и выкладку сайта.
При установке «Настройки в скрипте провайдера» загрузчик запрашивает адрес app.js вашей компании. Что придёт по этому адресу, решает переключатель Отдавать скрипт провайдера вместо бандла в окне скрипта провайдера: его открывает раздел Виджеты, а также Админ → Виджеты и формы → Настройки виджетов, вкладка Widgets 2.0. Включён — скрипт провайдера с настройками, выключен — бандл без них. Настройки меняет менеджер в личном кабинете, разработчик сайта не участвует.
Отсюда самая частая причина вопроса «сохранил, а на сайте ничего не изменилось»: скрипт провайдера сохранён, но переключатель выключен. Вторая причина — кеш: браузеры и CDN хранят ответ по адресу app.js до трёх часов. Бывает и наоборот. Переключатель включили, а в скрипте нет токена, и виджеты пропадают сразу на всех страницах.
Если сайт и сам вызывает aplaut.init, а по адресу компании приходит скрипт провайдера, вызов сайта молча теряется. Загрузчик до загрузки бандла хранит аргументы только последнего init, а последним его вызывает скрипт провайдера. Два места с настройками на одной странице работают против друг друга.
Почему в разделе «Виджеты» сохраняется не всё
Раздел Виджеты — стенд для подбора. Превью показывает виджет с настройками из панели, но общие настройки поведения и видимости живут только в панели, пока их не записали в скрипт провайдера или не скопировали в код сайта. Уйдя со страницы, их можно потерять.
Сохраняются три вещи: пресеты оформления, сохранённые теги и сам скрипт провайдера. Пресет и тег хранятся у компании, и их видят все, у кого есть доступ к разделу. Тег — набор отличий одного места на сайте от общих настроек, он попадает в код контейнера data-атрибутами. Скрипт провайдера хранит последние 10 версий, и к любой из них можно откатиться. Ссылка Поделиться ссылкой передаёт товар, виджет, тег, пресет и скрытые элементы, но не настройки поведения: панель не хранит их даже в адресе.
Скрипт провайдера правят и руками: добавляют свою аналитику или setAuthParams. Раздел Виджеты обновляет в нём только блок между маркерами aplaut:playground, и ручной код вокруг переживает обновление настроек. Скрипт уходит на сайт как есть, и одна синтаксическая ошибка в нём выключила бы все виджеты сразу. Поэтому кабинет не сохраняет скрипт, который не разбирается как JavaScript, и показывает строку с ошибкой.
Какая настройка побеждает
Настройка из widgetsConfig в aplaut.init сильнее data-атрибута на теге. Так менеджер меняет поведение всех виджетов из одного места, не разыскивая теги по шаблонам сайта. Обратная сторона: если виджет в каталоге и в карточке товара должен вести себя по-разному, эту настройку не стоит задавать в widgetsConfig. Её задают атрибутами на тегах, и каждый экземпляр получает своё значение. В разделе Виджеты такие атрибуты собирает сохранённый тег: см. как использовать отзывы за пределами карточки товара.
Тема устроена иначе: общая тема из aplaut.init действует на все виджеты, а атрибут data-theme накладывается поверх неё на один экземпляр. Тему из секций widgetsConfig виджеты пропускают, иначе она перекрыла бы и data-theme, и смену темы на лету через aplaut.setTheme.
Как загружается код виджетов
Скрипт при инициализации регистрирует теги всех виджетов, но код и данные виджета загружает, только когда его тег появляется на странице. Страница с одним информером поэтому не тянет код формы и галереи, а виджет, тег которого вставили позже, например при подгрузке листинга, загрузится сам. Перечислять виджеты не нужно, и забытый в списке виджет больше не остаётся пустым.
Раньше набор виджетов задавал параметр availableWidgets: виджет не из списка не регистрировался. Теперь скрипт его молча игнорирует. Вместо него есть необязательный preloadWidgets: код перечисленных виджетов загружается сразу при инициализации, не дожидаясь тега. Это имеет смысл для виджетов первого экрана, например информера рядом с ценой. Данные виджет всё равно запрашивает, когда появится тег: ID товара берётся из него.
Как отправить настройки на сайт — см. как настроить виджеты в личном кабинете. Все параметры — в справочнике настроек виджетов.