Подготовка поставки макета YOOtheme Pro

Подготовьте ZIP, из которого покупатель сможет извлечь макет и импортировать его в YOOtheme Pro. Понадобятся работающий макет, окружение для проверки импорта и элемент SovMart с платформой «Макет YOOtheme Pro».

Экспортируйте макет

YOOtheme Pro позволяет сохранить макет в библиотеку и скачать его в JSON через действие Download. Для обратной загрузки используется Upload Layout. Подписи зависят от языка интерфейса; описанный способ соответствует официальной инструкции Layout Library.

1. Откройте готовую страницу в конструкторе и сохраните предназначенный для поставки макет в библиотеку.
2. Скачайте JSON нужного макета.
3. Проверьте импорт этого файла в отдельном проекте с заявленными версиями Joomla, PHP и YOOtheme Pro.
4. Запишите зависимости: собственные элементы конструктора, дополнительные расширения, источники динамических данных, изображения и настройки, необходимые для воспроизведения результата.

Не заменяйте проверку импорта снимком исходной страницы. Макет может выглядеть правильно у автора и требовать отсутствующие на другом сайте расширения или данные.

Опишите каждый JSON

В YOOtheme Pro сохранённый объект имеет один из трёх типов: Layout — макет страницы из секций, Section — одна секция, Rows — набор строк без секций. Тип Rows используется, например, в выпадающем mega menu, элементе Sublayout и модуле конструктора вне позиций top и bottom. При загрузке в обычный макет страницы YOOtheme оборачивает Rows стандартной секцией. В контекстах, которые принимают только Rows, при загрузке Layout или Section секции отбрасываются. Это поведение описано в Layout Library.

Для каждого JSON в поставке укажите:

• имя файла и его тип: Layout, Section или Rows;
• целевой контекст: целая страница, отдельная секция либо строки в поддерживаемом контексте;
• что создаст импорт и какой режим применения нужен: Replace layout, Insert at the top или Insert at the bottom;
• проверенные версии Joomla, PHP и YOOtheme Pro, зависимости и действия после импорта.

Не называйте любой JSON «макетом страницы»: это создаст неверное ожидание для Section и Rows.

Подготовьте содержимое ZIP

Ниже пример авторской организации файлов. Это рекомендация для удобства покупателя, а не обязательная схема архива SovMart:

landing_example_1_0_0.zip
├── layouts/
│   └── landing.json
├── images/
│   └── preview.webp
└── README.md

В инструкции внутри архива укажите:

• какой JSON импортировать, его тип и какой результат он создаёт;
• проверенные версии Joomla, PHP и YOOtheme Pro;
• обязательные расширения и источники данных;
• какие изображения поставляются вместе с ZIP, а какие остаются внешними; куда перенести поставляемые файлы и какие пути заменить;
• какие действия требуются после импорта, включая настройку ссылок, форм и динамических источников.

Само наличие папки images/ в ZIP не размещает изображения на сайте покупателя. Объясните необходимые действия для своего макета и не обещайте перенос внешних ресурсов. Включайте только файлы, которые вы можете распространять вместе с продуктом.

Назовите внешний архив, например landing_example.1.0.0.zip или landing_example_1_0_0.zip. Одиночные точки между непустыми частями основы разрешены. Используйте обычный ZIP без шифрования, символических ссылок и небезопасных путей. Общие проверки и причины отказа описаны в файлах выпуска.

Настройте выпуск SovMart

1. Добавьте элементу платформу «Макет YOOtheme Pro».
2. Создайте её версию и загрузите подготовленный ZIP.
3. Заполните «Версия Joomla», «Версия PHP» и «Версия YOOtheme Pro». Все три значения нужны для готовности совместимости.
4. Используйте простые сравнения, например >=4.5 <5.0, только если такой диапазон действительно проверен для макета. Синтаксис разобран в совместимости версий.
5. Добавьте историю изменений и инструкцию импорта в документацию элемента. Для каждого нового выпуска перечислите изменённые JSON, ресурсы, зависимости и ручные действия перехода с предыдущего варианта.
6. Проверьте готовность, опубликуйте выпуск и скачайте его из карточки продукта.

Адаптер SovMart сохраняет метаданные файла, проверяет заявленные ограничения и выдаёт ZIP. Обычная загрузка не проверяет схему JSON, наличие всех ресурсов или визуальную корректность макета. Загрузка выпуска на площадку сама по себе не импортирует макет на сайт покупателя, не подключает коллекции и не создаёт специальный токен макетов или XML сервер обновления. На стороне покупателя возможны ручной импорт и установщик SovMart: клиент сам скачивает ZIP и распаковывает его. Действия применения макета описывайте по актуальной версии клиента, отдельно от серверной загрузки выпуска.

Проверьте путь покупателя

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

При загрузке макета из библиотеки YOOtheme Pro по умолчанию заменяет текущую структуру страницы; доступны также варианты вставки в начало или конец. Для проверки используйте отдельную страницу и явно укажите нужный способ в своей инструкции. При выпуске новой версии не обещайте автоматическое слияние: покупатель сохраняет текущий JSON и вручную переносит нужные изменения после сравнения. Поведение загрузки макетов YOOtheme Pro.

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

К оглавлению помощи