Essential Addons for YOOtheme Pro - Расширение Joomla

Руководство по настройке и применению Essential Addons for YOOtheme Pro

Essential Addons for YOOtheme Pro нужен не как отдельный конструктор страниц, а как расширение привычного рабочего процесса YOOtheme Pro. В этом руководстве разберём, как подойти к установке на Joomla-сайте, какие панели проверить после включения, как не перегрузить проект лишними аддонами и как использовать возможности продукта в реальном сценарии: динамический каталог, форма заявки, условный показ блоков и проверка результата.

Материал рассчитан на администратора или разработчика Joomla-сайта, который уже использует YOOtheme Pro и хочет понять, где заканчиваются базовые возможности конструктора и где начинается польза Essentials: внешние источники данных, составные динамические поля, расширенные формы, действия после отправки, библиотеки макетов, коллекции иконок и правила доступа. Здесь нет инструкций по покупке или активации лицензии. Речь только о безопасной настройке уже имеющегося расширения и о проверках, которые помогают не сломать рабочий сайт.

Главная мысль простая: Essentials лучше внедрять не "всё сразу", а через конкретную задачу. Сначала включают нужный аддон, затем настраивают один источник, одну форму или одно правило видимости, после этого проверяют публичную часть сайта, кэш, логи и поведение в разных ролях пользователя. Такой подход снижает риск скрытых конфликтов и делает дальнейшее обслуживание понятным для всей команды.

Что именно добавляет расширение к YOOtheme Pro

YOOtheme Pro уже умеет строить шаблоны, выводить динамический контент Joomla и управлять дизайном страниц. Essential Addons for YOOtheme Pro работает поверх этого слоя и добавляет набор рабочих инструментов, которые особенно заметны на проектах с повторяемыми данными, формами, внешними сервисами и несколькими сайтами на одной связке.

По официальной документации и странице ZOOlanders продукт объединяет несколько крупных направлений: Dynamic Content, Form Builder, Access Conditions, Layout Libraries, Icon Collections и дополнительные Builder Elements. Важно не смешивать их в одну абстрактную "функциональность". Каждый блок решает свою задачу и имеет отдельные настройки в Customizer -> Essentials.

Dynamic Content: источники, поля и повторное использование запросов

Базовый YOOtheme Pro умеет брать данные из Joomla: статьи, категории, теги, пользователей, файлы и поля. Essentials расширяет эту модель. Он позволяет создавать именованные экземпляры источников, подключать внешние данные и назначать источник не только на узел макета, но и на отдельное поле элемента. Это полезно, когда один блок должен брать заголовок из текущей статьи, картинку из внешнего источника, а подпись собирать из нескольких значений.

Особенно ценны Global Queries и составные источники. Если один и тот же запрос используется в нескольких макетах, его лучше вынести в глобальную точку настройки. Тогда при изменении фильтра, лимита или источника данных не нужно проходить все страницы вручную. Составные источники позволяют соединять статический текст и динамические значения в одном поле, а также добавлять условия внутри составного вывода.

Forms: форма как часть макета, а не отдельный компонент

Form Builder в Essentials добавляет форму прямо в рабочий процесс YOOtheme Pro. В текущей документации это делается через Form Element и поля из группы Form Essentials. После отправки запускаются действия: сообщение пользователю, письмо, запись в базу, CSV, Google Sheets, маркетинговые сервисы, webhook, перенаправление и другие варианты. Действия идут последовательно, поэтому порядок важен: проверку и изменение данных ставят перед отправкой и сохранением, а необязательные интеграции лучше отделять от критичного уведомления.

Для Joomla-проекта это удобно, когда не нужен большой отдельный компонент форм, но нужна аккуратная форма внутри уже собранного YOOtheme-макета. Например, заявка на консультацию, мини-опрос, запрос прайс-листа, форма подбора услуги или простая форма обратной связи с условной логикой.

Access Conditions: правила показа для элементов и действий

Access Conditions управляют тем, будет ли элемент отрисован, а в формах - будет ли выполнено действие. В правилах используются группы Site, Device и DateTime: URL, язык, пользователь, группа, уровень доступа, браузер, устройство, операционная система, IP, геолокация, дата, день, неделя, месяц и сезон. Несколько правил можно объединять через AND, OR или пользовательскую логику с ссылками вида {1} AND ({2} OR {3}).

На практике это не замена Joomla ACL, а дополнительный слой для интерфейсных сценариев: показать блок только авторизованным пользователям, скрыть промо по дате, отрисовать альтернативный текст для конкретного языка, запустить действие формы только при выбранном чекбоксе. Критичные права доступа всё равно должны оставаться на уровне Joomla, меню, категорий, компонентов и серверной логики.

Layouts, Icons и элементы: ускорение повторяемой сборки

Layout Libraries помогают хранить и переиспользовать макеты, в том числе через внешние хранилища вроде FTP или Amazon S3. Это важно для студий и сеток сайтов, где одинаковые секции нужно быстро переносить между проектами. Icon Collections добавляют в пикер YOOtheme Pro сторонние и собственные наборы иконок, а дополнительные элементы вроде Chart, Markdown и Social Sharing закрывают точечные задачи без отдельного расширения.

Именно сочетание этих направлений делает Essentials сильным, но оно же требует дисциплины. Если включить все аддоны и не вести список, где что используется, через несколько месяцев проект станет трудно поддерживать. Поэтому настройку стоит начинать с инвентаризации задач.

Кому подойдёт Essential Addons for YOOtheme Pro, а кому лучше не спешить

Расширение особенно хорошо подходит сайтам, где YOOtheme Pro уже является основным инструментом сборки страниц. Если команда делает страницы в другом конструкторе или использует YOOtheme только как шаблон без Builder, часть возможностей Essentials останется невостребованной. Это не универсальный набор "для каждого Joomla-сайта", а надстройка для конкретной экосистемы.

Хорошие сценарии для внедрения

Первый сценарий - контентные сайты с большим количеством повторяемых материалов: каталоги услуг, базы специалистов, городские справочники, события, курсы, вакансии, медиаархивы. В таких проектах динамический вывод и глобальные запросы экономят время, потому что макет собирается один раз, а данные подставляются из источников.

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

Третий сценарий - проекты с несколькими похожими сайтами. Layout Libraries и управляемые хранилища позволяют переносить секции и шаблоны не копированием через текстовые файлы, а через библиотеку. Это не отменяет тестирования на каждом сайте, но заметно снижает ручную работу.

Четвёртый сценарий - сайты, где видимость блоков зависит от языка, роли, даты, устройства или данных запроса. Access Conditions помогают не плодить отдельные страницы ради маленьких различий в контенте, но требуют ясной логики и проверки.

Когда продукт может оказаться лишним

Если сайт состоит из нескольких статичных страниц, редактируется редко и не использует динамические шаблоны YOOtheme Pro, Essentials может добавить сложность без реальной отдачи. В этом случае проще использовать базовые возможности Joomla, сам YOOtheme Pro и одно-два точечных расширения.

Не стоит ставить продукт как "страховку на будущее", если нет понятной задачи. Чем больше аддонов подключено, тем больше поверхностей для обновлений, кэша, конфликтов и проверки после миграции. Лучшее внедрение Essentials начинается с конкретного рабочего сценария: форма, источник данных, библиотека макетов, условный блок или набор иконок для дизайн-системы.

Отдельно стоит подумать о проектах с очень строгими требованиями к внешним сервисам и персональным данным. Документация описывает Auth Manager, OAuth, ключи и секреты, но ответственность за то, какие сервисы подключены, какие данные передаются и как настроено хранение заявок, остаётся на владельце сайта.

Что проверить перед установкой на Joomla-сайт

Подготовка важнее самой установки. Essentials тесно связан с YOOtheme Pro, PHP, Joomla, плагинами системы, кэшем и внешними сервисами. Ошибка обычно проявляется не в момент загрузки пакета, а позже: не появился источник, форма не отправляет письмо, правило доступа отрабатывает не так, обновление потребовало другой версии YOOtheme Pro.

Совместимость платформы и рабочий контур

По документации текущая ветка Essentials v3 ориентирована на более свежую связку YOOtheme Pro, Joomla и PHP, чем старые ветки продукта. Поэтому перед установкой нужно сверить требования на официальной странице документации, а не полагаться на старые обзоры или архивные карточки. Если сайт живёт на старой Joomla-ветке или старом YOOtheme Pro, сначала планируют обновление платформы, а уже потом расширение.

Проверка перед установкой должна включать:

• Версию Joomla, PHP и YOOtheme Pro по официальной матрице совместимости Essentials.
• Наличие свежей резервной копии файлов и базы данных, которую можно восстановить, а не только скачать.
• Список системных плагинов, которые вмешиваются в загрузку YOOtheme Pro, кэш, оптимизацию, редиректы и безопасность.
• Тестовый контур или копию сайта, если проект уже опубликован и приносит заявки.
• Права администратора для установки расширений Joomla, управления системными плагинами и очистки кэша.

Зависимости YOOtheme Pro и Joomla-логика

Essentials не должен быть единственным местом, где хранится логика сайта. Если задача относится к правам доступа, сначала проверьте Joomla ACL, группы пользователей, уровни доступа и привязку пунктов меню. Если задача относится к данным, продумайте структуру категорий, пользовательских полей, таблиц или внешних источников. Если задача относится к формам, заранее определите, куда уйдут заявки и кто отвечает за доставку писем.

Иначе легко получить красивый макет, который сложно обслуживать. Например, каталог можно собрать через динамический источник, но если поля в Joomla названы случайно и повторяются в разных группах, редакторы не поймут, где менять данные. Форма может отправлять письмо, но без SMTP и понятного адреса отправителя оно будет попадать в спам. Условный блок может скрывать элемент визуально, но не защищать закрытую информацию, если она остаётся доступной через другой маршрут.

Безопасность ключей и внешних сервисов

Auths, Keys & Secrets в Essentials предназначены для централизованного управления подключениями к сторонним сервисам. Документация отдельно подчёркивает, что токены, ключи и секреты являются чувствительными данными, а для высоконагруженных сайтов и продвинутых сценариев предпочтительнее собственные OAuth-приложения, чтобы не зависеть от общих квот. В руководстве по сайту это означает одно: не передавайте секреты в текстовые задачи, заметки, публичные страницы и внешние редакторы.

Если источник данных требует OAuth или API-ключ, создайте его в интерфейсе продукта, сохраните внутри Auth Manager и зафиксируйте в рабочей документации только назначение подключения: например, "Google Sheets для расписания мероприятий". Сам ключ, токен или секрет в документацию сайта не копируют.

Установка, включение и первая проверка

Общий путь установки для Joomla стандартный: пакет расширения устанавливается через системный установщик, затем проверяются плагины, доступность панели Essentials и состояние YOOtheme Pro Customizer. Конкретные шаги зависят от версии Joomla и пакета, поэтому точные кнопки лучше сверить с текущей документацией ZOOlanders. В этом разделе важнее не перечислить очевидные клики, а показать, что проверять после включения.

Порядок безопасного включения

1. Сделайте восстановимую резервную копию сайта и базы данных.
2. Проверьте, что YOOtheme Pro обновлён до версии, совместимой с выбранной веткой Essentials.
3. Установите пакет Essentials через Joomla Installer.
4. Откройте список плагинов Joomla и убедитесь, что системные плагины продукта включены.
5. Перейдите в YOOtheme Pro Customizer и найдите панель Essentials.
6. Откройте Essentials -> Advanced и включите только те аддоны, которые нужны для первого сценария.
7. Сохраните изменения, очистите кэш Joomla и кэш YOOtheme Pro, затем обновите Builder.

Не включайте сразу все направления только для проверки. Если первая задача - форма, начните с Forms. Если нужно подключить RSS или Google Sheets, начните с Dynamic. Если нужно управлять видимостью блоков, включите Access. Такой порядок упрощает диагностику: когда после включения появляется ошибка, вы знаете, какой слой был добавлен последним.

Первая проверка в Customizer

После установки откройте Customizer -> Essentials и проверьте основные панели. В Settings должны быть менеджеры Sources, Global Queries, Layout Libraries, Icon Collections, Storages, Auths, Advanced и About. Набор видимых пунктов может зависеть от установленной версии и включённых аддонов, поэтому ориентируйтесь на документацию своей ветки.

Проверка должна ответить на четыре вопроса:

• Появилась ли панель Essentials без PHP-ошибок в Customizer.
• Можно ли открыть Advanced и включать аддоны по одному.
• Отображается ли версия и changelog в About.
• Не исчезли ли базовые панели YOOtheme Pro и существующие макеты сайта.

Что делать после первого сохранения

После включения аддона выполните мини-проверку на одной тестовой странице. Создайте черновой макет или используйте копию существующей страницы, добавьте один элемент из нужного направления и посмотрите, как он ведёт себя в Builder и на публичной части сайта. Если включались Forms, отправьте тестовое сообщение. Если Dynamic, выведите один источник. Если Access, создайте простое правило для скрытия тестового блока.

Практическое правило: каждое включение аддона должно заканчиваться проверкой "в Builder видно, на сайте видно, после очистки кэша поведение не изменилось". Если проверка не пройдена, не переходите к следующему аддону.

Подробная настройка Essentials после установки

Главная панель настроек находится в Customizer -> Essentials. Документация отмечает, что глобальные настройки Essentials хранятся отдельно от настроек темы в базе данных, поэтому для резервного копирования и переноса нужно использовать собственные инструменты Import/Export в панели Advanced. Это важная деталь: экспорт темы YOOtheme Pro сам по себе не обязан сохранить все настройки Essentials.

Advanced: включение аддонов и отладка

В Advanced стоит начать с перечня аддонов. У каждого направления своя нагрузка и своя область влияния. Если аддон не используется, его можно оставить выключенным. Документация прямо описывает отключение отдельных Essentials addons как способ отладки и снижения лишнего выполнения. Для типового Joomla-сайта разумный старт выглядит так:

Какие настройки проверить первыми

Задача сайта	Что включить	Как проверить
Форма заявки в макете	Forms Addon	Добавить Form Element, поле и Message action, отправить тестовую заявку.
Каталог из внешних данных	Dynamic Addon	Создать Source Instance и вывести одно поле в тестовом элементе.
Скрытие блока по роли или дате	Access Addon	Добавить правило и посмотреть Evaluation Logs.
Повторяемые секции между сайтами	Layouts Addon	Создать библиотеку, сохранить один макет и загрузить его обратно.
Расширенный набор иконок	Icons Addon	Добавить коллекцию и выбрать иконку через Icon Picker.

Если после включения появляется ошибка, отключите последний добавленный аддон, очистите кэш и повторите проверку. Для обращения в поддержку пригодится Debug Data из Advanced, но его нельзя передавать кому попало: в нём могут быть настройки темы, Essentials, schema источников и данные сервера.

Sources и Global Queries: когда создавать экземпляр источника

Source Instance нужен, когда один тип источника используется с конкретной конфигурацией. Например, один RSS-канал для новостей, один Google Sheets-документ для расписания, одна таблица базы для каталога, один YouTube-канал для видеотеки. После создания экземпляра Essentials строит схему данных, и поля становятся доступны для динамического маппинга в Builder.

Global Query нужен на следующем уровне: когда источник уже есть, но один и тот же запрос повторяется. Например, "последние 6 мероприятий", "активные филиалы", "отзывы с оценкой выше заданной", "товары конкретной категории". Вместо того чтобы вручную настраивать этот запрос в каждом элементе, его выносят в Global Queries. Это особенно полезно для командной работы: название запроса должно объяснять смысл, а не внутренний код.

Лучшие настройки для динамических источников начинаются с ограничений. Укажите разумный лимит записей, кэш, фильтр и порядок. Если источник поддерживает Query Conditions, фильтруйте данные на уровне запроса, а не только через условия отрисовки. Документация по Conditions прямо объясняет, что предварительная фильтрация снижает загрузку в память, а Dynamic или Access Condition отрабатывает уже после загрузки данных.

Auths, Keys & Secrets: аккуратная работа с подключениями

Auth Manager не является местом, где создаются все подключения вручную. Документация уточняет, что новые auths обычно появляются в процессе создания ресурсов, которым нужны конкретные scopes. После этого ими можно управлять в Essentials Advanced. Если токен истёк или подключение стало недействительным, ошибка будет связана с повторной авторизацией, а не с макетом страницы.

Для рабочего сайта заведите простое правило: название auth должно отражать сервис и назначение. Например, "Google Sheets - events schedule", "Airtable - testimonials", "Mailchimp - newsletter form". Не называйте всё "test", "api" или "main", иначе через месяц никто не поймёт, какое подключение можно удалить.

Import/Export и перенос между сайтами

Поскольку настройки Essentials независимы от темы, перенос макета без переноса настроек может дать неполный результат. Макет загрузится, но источник, библиотека, auth или глобальный запрос не найдётся. Поэтому при переносе между сайтами используйте отдельную проверку:

• Экспортируйте или восстановите настройки Essentials через Advanced, если это предусмотрено сценарием.
• Проверьте, что источники с теми же именами есть на новом сайте.
• Откройте Builder и проверьте красные или ошибочные динамические поля.
• Проверьте формы на тестовую отправку, а не только внешний вид.
• Сверьте права Joomla, группы пользователей и языки, если используются Access Conditions.

Динамический контент: источники, составные поля и маршруты

Динамический контент - один из самых сильных поводов использовать Essential Addons for YOOtheme Pro. В обычном YOOtheme Pro динамика привязана к источникам и полям, которые доступны в текущем контексте. Essentials расширяет это: появляются дополнительные источники, field-level assignment, source inheritance, dynamic query arguments, составные источники и Source Routing.

Как выбирать источник данных

Начинайте не с вопроса "что поддерживает продукт", а с вопроса "где живёт исходная правда". Если данные уже ведутся в Joomla, лучше использовать статьи, категории, поля, пользователей или таблицы сайта. Если расписание ведётся в Google Sheets, его можно подключить как внешний источник, но нужно продумать кэш, доступ и формат столбцов. Если данные приходят из RSS, XML, YouTube, Vimeo или социальной сети, проверьте стабильность API и ограничения авторизации.

В Google Sheets Source документация описывает настройки Account, Spreadsheet, Sheet, Start Column, End Column, а в Records Query - Start, Quantity и Cache. Это хороший пример того, как настраивать внешний источник: сначала ограничить диапазон и количество, затем задать кэш, после этого вывести небольшой набор данных на тестовой странице. Не начинайте с вывода сотен строк.

Field-level assignment без хаоса

Назначение источника на отдельное поле удобно, когда элемент собирается из нескольких источников. Но этот приём легко превращает макет в головоломку: заголовок из одного источника, изображение из другого, кнопка из третьего, подпись через составной источник. Для редактируемого сайта это опасно, если нет naming convention.

Договоритесь о трёх правилах:

• Источник на уровне элемента используют, когда большинство полей берётся из одной записи.
• Field-level assignment используют только для исключений, которые нельзя удобно решить наследованием.
• Составной источник применяют для текста, где действительно нужно соединить несколько значений, а не для каждого короткого поля.

После настройки откройте Content tab элемента и убедитесь, что динамические поля видны, понятны и не подсвечены как ошибочные. Если макет переносился из библиотеки, проверьте, существуют ли все источники и поля на текущем сайте.

Source Routing: SEO-дружественный маршрут или параметр в URL

Source Routing в документации объясняется на примере альбомов: можно сделать одну страницу с параметром в URL, например ?id=xxx, или создать отдельные статьи с SEO-дружественными alias и хранить внешний ID в поле статьи. Первый вариант быстрее и гибче, второй лучше для поискового URL и структуры сайта, но требует ручного управления статьями.

Для Joomla-сайта с каталогом услуг чаще безопаснее второй подход: создайте категорию, заведите статью на каждую услугу, добавьте пользовательское поле для внешнего ID и соберите шаблон Single Article. Тогда публичный адрес остаётся понятным, а внешний источник подставляет детали. Для временной галереи, внутреннего кабинета или служебной страницы можно использовать параметр URL, если SEO не является целью.

Проверка результата динамического вывода

После настройки источника проверьте не только первый удачный пример. Нужны крайние случаи:

• Запись с пустым изображением или пустым необязательным полем.
• Запись с длинным заголовком.
• Запись без связанной категории или автора, если используются relations.
• Пустой результат запроса.
• Публичная страница после очистки кэша и в режиме гостя.

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

Формы внутри YOOtheme Pro: поля, действия и проверка заявки

Формы - второй крупный сценарий, где Essentials заметно меняет работу с YOOtheme Pro. Вместо отдельной страницы компонента форма становится частью макета: редактор добавляет Form Element, размещает поля, настраивает After Submit Actions и проверяет результат в Builder. Это удобно, но требует внимания к именам полей, порядку действий и доставке писем.

Структура формы: контейнер, поля и имена

Каждая форма начинается с Form Element. Внутри размещаются поля: Input, Textarea, Select, Checkbox, Radio, Upload, Hidden, Fieldset и Button. У поля должен быть Control Name, потому что именно по нему данные потом подставляются в действия через placeholders или через источник Form Submission.

Не называйте поля случайными словами. Для заявки на консультацию лучше использовать name, email, phone, topic, message, consent. Если сайт многоязычный, внутренние имена полей оставляют стабильными, а подписи переводят средствами макета или языковых строк. Так действия не ломаются при изменении видимого текста.

After Submit Actions: порядок важнее количества

Документация подчёркивает, что действия после отправки выполняются последовательно, а ошибка в цепочке может остановить следующие действия. Поэтому сначала ставят обязательную валидацию или Alter action, затем критичное действие, например Email или Database, и только потом необязательные внешние интеграции. Если действие должно выполняться только при выбранном поле, используйте execution condition, а не создавайте отдельную форму.

Для типовой формы заявки порядок может быть таким:

1. Validate - проверить обязательное согласие и формат данных, если стандартной проверки недостаточно.
2. Email - отправить уведомление администратору с Reply To на адрес пользователя.
3. Database или CSV - сохранить заявку, если это требуется политикой проекта.
4. Message - показать понятное сообщение пользователю.
5. Webhook или маркетинговая интеграция - выполнить только если соответствующее согласие отмечено.

В Email Action документация отдельно предупреждает: если хотите отвечать пользователю как на отправителя, используйте Reply To, а не подменяйте From Email. Подмена отправителя может ухудшить доставляемость из-за SPF и DMARC.

Защита от спама и доставка писем

Essentials поддерживает разные подходы к защите форм, включая Honeypot и сторонние captcha-сервисы. В текущем changelog также есть улучшения captcha-потока Joomla. Но защита от спама не заменяет нормальную почтовую настройку. Если форма показывает успешную отправку, это ещё не значит, что письмо доставлено в ящик.

Для рабочей проверки сделайте три теста:

• Отправьте форму на почтовый ящик того же домена и проверьте, пришло ли письмо.
• Отправьте форму на внешний ящик и проверьте папку спама.
• Проверьте заголовки письма или тестовую доставку через почтовый сервис, если сайт критичен для заявок.

Если появляется ошибка Could not instantiate mail function, документация рекомендует переходить на SMTP вместо зависимости от серверной функции mail(). Это не настройка Essentials как такового, а настройка почтового слоя сайта.

Безопасная доработка: событие после отправки формы

Официальная документация описывает JavaScript-события формы, включая локальное form:submitted и глобальное yooessentials-form:submitted. Это можно использовать для лёгкой аналитики или интерфейсного эффекта после успешной отправки. Такой код лучше размещать в собственном JS-файле дочерней темы или в безопасном месте для пользовательских скриптов, а не в ядре Joomla, YOOtheme Pro или Essentials.

UIkit.util.ready(function () {
  UIkit.util.on(document, 'yooessentials-form:submitted', function (event, context) {
    if (!context || !context.form) {
      return;
    }

    // Пример: добавить класс к отправленной форме для мягкой подсветки результата.
    context.form.classList.add('form-sent-ok');
  });
});

Проверьте результат на тестовой форме: отправьте заявку, убедитесь, что в консоли браузера нет ошибок, а класс появляется только после успешной отправки. Откат простой - удалить фрагмент из своего JS-файла и очистить кэш. Не добавляйте сюда отправку персональных данных в сторонние сервисы без отдельного согласия и политики обработки данных.

Практический пример: мини-каталог услуг с заявкой и условным блоком

Теперь соберём предметный сценарий, который показывает пользу нескольких частей Essentials сразу. Допустим, на Joomla-сайте агентства нужно сделать страницу "Услуги": карточки берутся из таблицы или Google Sheets, у каждой услуги есть кнопка заявки, форма подставляет тему обращения, а блок с быстрым предложением показывается только в будние дни или только определённой группе пользователей.

Цель сценария

Нужно получить страницу, которую редактор может обновлять без ручной правки макета. Данные услуг меняются в источнике, карточки обновляются в YOOtheme Pro, форма отправляет заявку администратору и показывает сообщение пользователю, а условный блок не требует отдельной страницы. Такой сценарий особенно полезен, когда сайт часто меняет услуги, расписание, акции или список направлений.

Подготовка

Перед сборкой должны быть готовы YOOtheme Pro, Essentials с включёнными Dynamic, Forms и Access, тестовая страница или шаблон, источник данных и почтовая настройка Joomla. Если используется Google Sheets, таблица должна иметь понятные столбцы: title, summary, price_note, slug, is_active. Если используется база Joomla, заранее определите таблицу, первичный ключ и поля.

Для первого прохода не подключайте сложные relations. Возьмите пять тестовых записей, чтобы проверить механику. Когда схема понятна, можно расширять источник, добавлять фильтры, кэш и условия.

Шаги настройки

1. Создайте Source Instance в Sources Manager и назовите его, например, Services Catalog.
2. Настройте Records Query с ограничением количества, фильтром активных записей и кэшем.
3. В Builder добавьте Grid или другой многоэлементный блок и назначьте источник на уровень элемента.
4. Смаппируйте заголовок, описание и служебную пометку в поля карточки.
5. Добавьте форму ниже карточек или в модальном блоке, создайте поля name, email, service, message, consent.
6. В Actions добавьте Email и Message. В письме используйте Reply To и динамическое поле темы заявки.
7. Для блока "быстрый ответ" добавьте Access Condition: например, показывать в рабочие дни или только группе менеджеров на этапе проверки.
8. Сохраните макет, очистите кэш и протестируйте страницу как гость и как администратор.

Проверка результата

На публичной странице должны отрисоваться только активные услуги. Если в источнике меняется описание услуги, после обновления кэша на сайте должна появиться новая версия. Форма должна отправлять письмо, в котором видна выбранная услуга и данные пользователя. Сообщение после отправки должно быть понятным и не раскрывать технические детали.

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

Что может пойти не так

Если карточки не выводятся, проверьте источник, query, кэш и динамический статус элемента. Если форма отправляется, но письмо не приходит, проверьте SMTP, Reply To и политику SPF/DMARC домена. Если условный блок не меняет видимость, откройте Evaluation Logs и посмотрите, какое правило вернуло неожиданный результат. Не исправляйте всё сразу: отключайте слои по одному и возвращайтесь к последнему стабильному состоянию.

Access Conditions и производительность: как не запутаться в правилах

Access Conditions выглядят простыми, пока правило одно. Сложность появляется, когда несколько условий соединяются с динамическими значениями, датой, языком, пользователем и устройством. Здесь легко перепутать "скрыть блок в интерфейсе" и "защитить доступ". Поэтому сначала нужно понять границы инструмента.

Access Condition не заменяет Joomla ACL

Если контент должен быть закрыт от гостя по соображениям безопасности, настройте Joomla ACL, уровень доступа пункта меню, категорию, компонент или серверный доступ. Access Condition подходит для условной отрисовки элемента в макете. Он может скрыть кнопку, промо, подсказку или действие формы, но не должен быть единственным барьером для чувствительной информации.

Например, блок "Скачать закрытый файл" можно показывать только группе пользователей, но сам файл всё равно должен лежать в защищённом месте или выдаваться через компонент с проверкой прав. Иначе прямой URL обойдёт красивую логику Builder.

AND, OR и Custom без ловушек

Режим AND требует, чтобы все правила были истинными. OR достаточно одного истинного правила. Custom нужен, когда логика сложнее: например, блок показывается администраторам всегда, а гостям только в определённые дни и на определённой странице. Пользовательская формула должна быть короткой и документированной.

Хорошая практика - сначала собрать условие из двух правил и проверить Evaluation Logs. Затем добавить третье правило и снова проверить. Если сразу написать формулу из пяти правил, сложно понять, что именно сломалось. В названии правила используйте человеческий смысл: "Пользователь в группе B2B", "Рабочий день", "Страница услуги", а не "Rule 1".

Query Conditions против Access Conditions

Документация Conditions объясняет важное различие: Query Conditions фильтруют данные во время запроса, а Dynamic или Access Condition работают во время отрисовки. Если источник загружает 500 записей, а затем условие скрывает 480 из них, сайт всё равно потратил ресурсы на получение большого набора. Поэтому для каталогов, списков и повторяемых элементов сначала применяйте фильтры источника, а Access используйте для интерфейсных решений.

Если нужна точная выдача 20 элементов, не полагайтесь на последующее скрытие части записей. Из-за сочетания limit, offset и условий можно получить меньше элементов, чем ожидает макет. Лучше заранее настроить query так, чтобы он возвращал нужный набор.

Layout Libraries, иконки и повторяемые элементы в командной работе

Essentials полезен не только формами и источниками. На сайтах, которые ведёт команда, повторяемость макетов и дизайн-системы часто важнее отдельной функции. Layout Libraries и Icon Collections помогают не пересобирать одинаковые блоки вручную.

Как использовать библиотеки макетов

Layout Libraries позволяют создать собственную библиотеку, выбрать хранилище и сохранять туда макеты. Локальное хранилище удобно для одного сайта, внешнее - для нескольких сайтов. В документации упоминаются FTP и Amazon S3 как варианты внешнего хранения. Важно понимать: библиотека переносит макет, но не всегда переносит весь контекст. Если макет зависит от источника, auth, пользовательского поля или правил доступа, эти зависимости тоже нужно создать на новом сайте.

Для студии полезно разделить библиотеки по назначению: "Lead sections", "Service grids", "Form blocks", "Article templates". Не смешивайте всё в одну папку. Перед публикацией нового макета добавьте короткое описание: какие аддоны нужны, какие источники ожидаются, какие поля должны быть на сайте.

Иконки без лишних ассетов

Icon Collections добавляют наборы иконок в пикер YOOtheme Pro, а официальный сайт ZOOlanders подчёркивает, что иконки остаются UIkit-native и подгружаются по необходимости. Это лучше, чем вставлять случайные SVG из разных источников в каждый макет. Для проекта выберите 1-2 коллекции и зафиксируйте правила: где используется outline, где solid, какие размеры и цвета допустимы.

Если нужны собственные иконки, документация описывает папку {childtheme}/myicons для активной дочерней темы. Это хороший способ хранить проектные пиктограммы рядом с темой, а не вручную вставлять их в каждый элемент. Но не добавляйте кастомную коллекцию без необходимости: сначала проверьте, закрывают ли задачу стандартные коллекции.

Markdown, Chart и Social Sharing

Дополнительные элементы лучше использовать точечно. Markdown Element полезен, когда контент уже ведётся в Markdown или нужно отображать подготовленный текстовый блок. Chart Element уместен для визуализации данных, особенно если данные приходят динамически. Social Sharing Element закрывает простую задачу кнопок шаринга без отдельного расширения.

Главная ошибка - добавлять элемент, потому что он есть. Если штатный элемент YOOtheme Pro решает задачу проще, используйте его. Essentials должен сокращать сложность, а не увеличивать число вариантов для редактора.

Частые проблемы и диагностика Essentials

Большинство ошибок в связке Essential Addons for YOOtheme Pro, Joomla и YOOtheme Pro связано не с одним "сломавшимся" файлом, а с пересечением версий, кэша, плагинов, редиректов, внешних auths и почтовой настройки. Диагностику лучше вести от симптома к последнему изменению.

Панель Essentials не открывается или в Customizer видна PHP-ошибка

Симптом: при открытии YOOtheme Pro Customizer появляется сообщение об ошибке выполнения плагина, панель Essentials не загружается или Builder работает нестабильно.

Возможная причина: несовместимость версий, повреждённая установка, конфликт системного плагина или ошибка в одном из включённых аддонов. Официальная страница Troubleshooting описывает Plugin Execution Error и рекомендует проверять полное сообщение, зависимости и при необходимости обращаться в поддержку.

Что проверить: версию YOOtheme Pro, Joomla, PHP и Essentials, последние изменения в списке плагинов, кэш, системные логи PHP. Если ошибка появилась после включения конкретного аддона, отключите именно его и повторите тест.

Как исправить: обновить несовместимые зависимости, переустановить пакет поверх текущей установки без удаления прежней версии, очистить кэш, отключить конфликтующий слой. Если сообщение связано с повреждённой установкой или целостностью файлов, не правьте файлы вручную - переустановите пакет и передайте полное сообщение в поддержку.

Ошибка AbstractRule Class Not Found

Симптом: появляется фатальная ошибка класса ZOOlanders\YOOessentials\Access\AbstractRule.

Возможная причина: сторонний плагин обращается к классу раньше, чем Essentials успел его объявить. В официальной диагностике это описано как проблема порядка загрузки.

Что проверить: список системных плагинов, недавно установленные интеграции, плагины, связанные с YOOtheme Pro, кэшем, оптимизацией и доступом.

Как исправить: установить стороннему плагину более низкий приоритет загрузки, чем Essentials, затем очистить кэш и открыть Customizer. Если не уверены, меняйте порядок только на тестовой копии.

Динамический источник не показывает данные

Симптом: элемент отрисовывается пустым, поле подсвечено как ошибочное, после переноса макета источник не находится или в сетке меньше элементов, чем ожидалось.

Возможная причина: источник не создан на текущем сайте, поле переименовано, query возвращает пустой набор, кэш хранит старые данные, limit и условия конфликтуют. В документации YOOtheme Pro отдельно описаны invalid sources and fields, а документация Essentials дополняет это source instances и dynamic query arguments.

Что проверить: наличие source instance, схему полей, фильтры, кэш, доступность внешнего сервиса, права auth, ошибки в логах, статус динамического поля в Builder.

Как исправить: сначала вывести одно простое поле без условий, затем вернуть фильтры, потом лимит и только потом составные источники. Если макет перенесён из библиотеки, создайте на новом сайте источники и глобальные запросы с ожидаемыми именами.

Форма показывает успешную отправку, но письмо не приходит

Симптом: пользователь видит сообщение об успехе, но администратор не получает письмо.

Возможная причина: письмо было отправлено, но не доставлено из-за SPF, DMARC, репутации отправителя, правил почтового клиента или серверной функции mail(). Официальная документация по Email Delivery Issues подчёркивает разницу между отправкой и доставкой.

Что проверить: настройки Joomla Mail, SMTP, адрес From, Reply To, папку спама, журналы почтового сервера, тестовый ящик на другом домене.

Как исправить: использовать стабильный From с домена сайта, настроить SMTP, не подменять From Email на адрес пользователя, а использовать Reply To. Если доставка критична, добавьте запись заявки в базу или CSV как резервный канал.

Форма падает с vague error или без визуальной ошибки

Симптом: появляется Submission Failed без деталей или форма молча не завершается.

Возможная причина: подавленная PHP-ошибка, редирект POST-запроса в .htaccess, правило, которое добавляет или убирает завершающий слэш, конфликт оптимизации.

Что проверить: последние PHP-логи, Error Reporting на тестовом контуре, вкладку Network в браузере, redirect для POST-запроса, правила .htaccess.

Как исправить: ограничить проблемное правило редиректа только GET-запросами, временно отключить оптимизацию, включить SMTP при почтовой ошибке, затем повторить отправку в Builder и на публичной странице.

Access Condition показывает не тот результат

Симптом: блок виден гостю, хотя должен быть скрыт, или наоборот. Условие по дате, языку или группе пользователей работает не так, как ожидалось.

Возможная причина: неверный режим AND/OR, ошибка в Custom formula, часовой пояс, не та группа пользователя, кэш страницы, ожидание серверной защиты от инструмента визуальной отрисовки.

Что проверить: Evaluation Logs, порядок правил, текущую роль пользователя, язык сайта, часовой пояс, включённый кэш, результат в приватном окне.

Как исправить: упростить условие до одного правила, проверить лог, затем добавить остальные. Для закрытого контента вынести защиту в Joomla ACL, а Access оставить для UI-логики.

После обновления часть функций исчезла или изменилась

Симптом: после обновления YOOtheme Pro или Essentials перестали работать поля, формы, источники или правила.

Возможная причина: переход между major releases, изменение совместимости, регрессия, кэш, устаревшая конфигурация. Официальная инструкция по Updating Essentials отдельно просит планировать обновления между крупными ветками, отключать плагин на время последовательного обновления и тщательно чистить кэш.

Что проверить: changelog, матрицу совместимости, порядок обновления, старые source mappings, debug data, тестовую копию сайта.

Как исправить: восстановить резервную копию при критичном сбое, повторить обновление в правильном порядке на тестовом контуре, обновить YOOtheme Pro и Essentials согласованно, затем включать аддоны и проверять сценарии по одному.

Как проверить готовую страницу перед публикацией

После настройки Essentials нельзя ограничиваться просмотром в Builder. Builder показывает рабочую среду администратора, а посетитель видит публичную страницу с кэшем, правами гостя, другими скриптами и реальными сетевыми условиями. Перед публикацией нужен короткий, но строгий сценарий проверки.

Проверка публичной части

Откройте страницу в приватном окне как гость. Проверьте, что динамические блоки отрисованы, форма видна только там, где нужно, и условные элементы соответствуют роли гостя. Затем войдите пользователем нужной группы и повторите проверку. Если сайт многоязычный, пройдите те же шаги для каждого языка, где используется Access Condition или динамический источник.

Проверьте мобильную ширину. Динамические данные часто ломают дизайн не потому, что источник неверный, а потому что реальный текст длиннее демо. Убедитесь, что длинный заголовок карточки, пустое изображение, длинная кнопка и сообщение формы не сдвигают сетку.

Проверка кэша и скорости

Очистите кэш Joomla, YOOtheme Pro и внешних оптимизаторов. Откройте страницу повторно. Если данные берутся из внешнего источника, проверьте, не вызывает ли страница слишком много запросов. Для источников с параметром Cache установите разумное значение: мгновенное обновление данных редко важнее стабильности и скорости.

Если используется много field-level assignments, попробуйте упростить макет через наследование источника от parent node. Документация предупреждает о производительности при чрезмерно свободном назначении источников на отдельные поля. Визуально всё может работать, но на большом списке это станет заметным.

Проверка форм и журналов

Отправьте форму с корректными данными, с пустыми обязательными полями, с длинным сообщением, с файлом, если используется Upload, и с выключенным согласием, если действие зависит от чекбокса. Проверьте, какие действия реально выполнились: письмо, запись, сообщение, webhook. Если в форме используется дата, проверьте формат в письме. Документация по Common Issues описывает ситуацию, когда дата сохраняется в ISO-формате и требует форматирования через источник данных или фильтр.

Мини-итог проверки: страница считается готовой не тогда, когда она красиво выглядит в Builder, а когда гость, авторизованный пользователь, кэш, форма, письмо, пустые данные и ошибка проходят ожидаемый сценарий.

Сопровождение после запуска: что документировать и когда пересматривать настройки

Essentials часто внедряют на сайты, которые живут дольше одного релиза. Через несколько месяцев администратор может забыть, почему включён конкретный аддон, откуда берётся источник, какой auth связан с Google Sheets или почему правило доступа написано через пользовательскую формулу. Поэтому после публикации нужна не большая техническая документация, а короткая карта зависимостей, которую реально будут читать.

Мини-паспорт внедрения

Для каждого рабочего сценария заведите небольшой паспорт. В нём достаточно указать страницу или шаблон, включённые аддоны, источник данных, глобальный запрос, форму, список действий и проверку результата. Например: "Страница услуг - Dynamic Addon, Source Instance Services Catalog, Global Query Active Services, форма Service Request, действия Email -> Database -> Message, проверка - карточки обновляются после кэша, письмо приходит через SMTP". Такой паспорт экономит время при обновлениях и при передаче сайта другому администратору.

В паспорт не записывают секреты, токены, пароли и закрытые ключи. Для auths достаточно служебного названия и назначения подключения. Если источник зависит от внешнего аккаунта, укажите владельца аккаунта и процедуру восстановления доступа, но не сам ключ. Это особенно важно для OAuth-подключений: токен может истечь, а новый администратор должен понимать, где пройти повторную авторизацию.

План проверки после обновлений

После обновления Joomla, YOOtheme Pro, Essentials, почтового слоя или оптимизатора не проверяйте весь сайт вручную. Выберите контрольные сценарии, которые действительно зависят от продукта:

• Одна страница с внешним dynamic source и пустым результатом.
• Одна форма с Email action, Message action и резервным сохранением, если оно используется.
• Одно Access Condition с ролью пользователя и одно условие по дате или языку.
• Один макет из Layout Library, если библиотека используется между сайтами.
• Один элемент с иконкой из установленной коллекции или myicons.

Если эти сценарии проходят, риск скрытого сбоя ниже. Если один сценарий упал, не делайте массовую переустановку. Сначала прочитайте changelog, отключите последний изменённый слой, очистите кэш и сравните поведение на тестовой копии.

Когда пересматривать архитектуру, а не чинить точечно

Есть моменты, когда локальная правка уже не помогает. Если на странице десятки отдельных field-level assignments, несколько внешних источников без общей схемы и правила доступа с длинными формулами, проблема не в Essentials, а в архитектуре макета. Такой макет лучше упростить: вынести повторяемые запросы в Global Queries, уменьшить число внешних обращений, сгруппировать условия, описать источники и оставить в макете только понятные динамические поля.

То же относится к формам. Если одна форма одновременно валидирует данные, отправляет письма, пишет в несколько сервисов, делает webhook и меняет поведение по множеству условий, её нужно разбить на более понятный рабочий поток. Критичные действия ставят раньше, необязательные интеграции - позже, а сложные ветвления документируют. Сложность должна быть видна в настройках, а не прятаться в случайном порядке действий.

Вопросы и ответы по Essential Addons for YOOtheme Pro

Можно ли использовать расширение без YOOtheme Pro?

Практического смысла в этом нет. Продукт создан как набор аддонов для рабочего процесса YOOtheme Pro Builder. Если сайт не использует YOOtheme Pro, формы, источники и элементы Essentials не дадут ожидаемой пользы.

Нужно ли включать все аддоны сразу?

Нет. Лучше включать только то, что нужно для текущего сценария: Forms, Dynamic, Access, Layouts или Icons. Отключение неиспользуемых аддонов упрощает диагностику и снижает лишнюю нагрузку.

Почему форма отправилась, но письмо не дошло?

Успешная отправка формы не гарантирует доставку письма. Проверьте SMTP, From, Reply To, SPF, DMARC, папку спама и журналы почтового сервера. Для важных заявок добавьте резервное сохранение в базу, CSV или другой подтверждённый канал.

Можно ли хранить секреты API в тексте макета или заметках проекта?

Нет. Ключи, OAuth-токены и секреты нужно хранить через Auth Manager и настройки продукта. В документации проекта фиксируйте только назначение подключения, без самих секретов.

Что выбрать для фильтрации данных: Query Conditions или Access Conditions?

Если источник поддерживает фильтрацию на уровне запроса, используйте Query Conditions. Access Conditions подходят для отрисовки и интерфейсной логики. Для больших списков предварительная фильтрация обычно быстрее и предсказуемее.

Почему после переноса макета из библиотеки не работают динамические поля?

Макет мог перенестись без источников, auths, глобальных запросов или пользовательских полей, на которые он ссылается. На новом сайте нужно создать тот же контекст и проверить Builder на invalid sources and fields.

Можно ли использовать Access Conditions для закрытых материалов?

Только как дополнительный интерфейсный слой. Для настоящей защиты используйте Joomla ACL, уровни доступа, права меню, компонентов и файлов. Условная отрисовка элемента не должна быть единственной защитой чувствительных данных.

Стоит ли обновлять Essentials сразу на рабочем сайте?

Для небольших исправлений это зависит от политики проекта, но крупные переходы лучше проверять на копии сайта. Документация по обновлениям рекомендует делать полную резервную копию, соблюдать порядок обновления и тщательно очищать кэш.

Когда Essential Addons for YOOtheme Pro будет удачным выбором

Essential Addons for YOOtheme Pro стоит использовать, если сайт уже построен на YOOtheme Pro и вам нужны не просто дополнительные "украшения", а рабочие инструменты: источники данных, глобальные запросы, формы, условная логика, библиотеки макетов и управляемые коллекции иконок. На таких проектах расширение помогает собрать страницу как систему: данные приходят из источника, макет их отображает, форма принимает заявку, условия управляют видимостью, а проверка показывает, что результат стабилен.

Если задача узкая, сначала сравните Essentials с более точечным решением. Для только форм может подойти отдельный компонент форм, для только пользовательских полей - Advanced Custom Fields, для только базовой динамики - штатный YOOtheme Pro. Но если на одном Joomla-сайте сходятся несколько сценариев, Essentials становится удобной общей надстройкой.

Перед публикацией не пропускайте тесты: совместимость, кэш, source mappings, отправка формы, доставка писем, Evaluation Logs, пустые данные, мобильная ширина и права пользователя. После этого можно перейти к блоку скачивания и загрузить Essential Addons for YOOtheme Pro, чтобы проверить расширение на своём тестовом контуре и постепенно перенести нужные сценарии на рабочий сайт.