🏠 Содержимое главной страницы

Главная страница собирается в отдельном редакторе контента Strapi. В нём секции называются по-английски — в этой инструкции названия приведены дословно.

Где открыть редактор

Адрес: <адрес редактора контента>/admin.

Точный адрес узнайте у разработчика: он зависит от установки магазина.

🧩 Все секции главной

Точное имя в редакторе	Что видит покупатель	Главное поле
Product carousel	Карусель товаров	kind: promotions или new_arrivals
Promo banners	Группа рекламных баннеров	Один или несколько Promo banner
Information tabs	Шесть вкладок полезной информации	catalog, brands, contacts, about, paintSelection, delivery
Catalog navigation	Навигация каталога	defaultView: categories или brands
Social networks and reviews	Контакты, соцсети и ссылка на отзывы	Сам текст берётся из Site settings

Порядок секций в Homepage становится их порядком на сайте.

Пример опубликованной главной страницы на стенде: секции идут в том порядке, который задан в записи Homepage.

Галочка enabled работает

У каждой секции есть обязательная галочка enabled. Если её снять и опубликовать изменения, сервер удалит секцию из снимка до того, как главная попадёт на витрину. Страница сайта поэтому не проверяет галочку второй раз — она получает уже отфильтрованный список.

У отдельного Promo banner своя галочка enabled, и она тоже скрывает конкретный баннер.

Шаг 1. Откройте Homepage

1. Войдите в редактор контента.
2. Откройте Content Manager → Single Types → Homepage.
3. Найдите поле с секциями главной.
4. Добавляйте, удаляйте и перетаскивайте секции в нужном порядке.

Homepage — одна общая запись на весь сайт, а не список отдельных страниц.

Поле internalName самой записи обязательно. По умолчанию в нём стоит «Главная страница»; если очистить его, Save завершится ошибкой.

Шаг 2. Настройте Product carousel

Поле	Обязательное	Как работает
enabled	✅	Показывать или скрыть секцию
kind	✅	Источник товаров: promotions или new_arrivals
heading	✅	Заголовок до 80 символов

Как отличаются типы

Значение kind	Какие товары попадут в карусель
promotions	Опубликованные товары из коллекции, название которой В ТОЧНОСТИ — символ в символ, с тем же регистром и без лишних пробелов — равно «Акции», но не более 500 товаров этой коллекции. Порядок алфавитный по названию товара
new_arrivals	12 самых новых опубликованных товаров

Карусель promotions может исчезнуть целиком

Название коллекции должно быть ровно «Акции». Магазин ищет коллекцию по точному совпадению. «АКЦИИ», «акции», «Акции 2026» или «Акции » с пробелом на конце — уже другая коллекция, и секция не покажет ничего. Поле heading само по себе подборку не создаёт.

Почему new_arrivals может показать меньше 12 товаров

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

Шаг 3. Добавьте Promo banners

У секции Promo banners поле banners обязательное: нужна хотя бы одна запись Promo banner.

Обязательные поля баннера

Поле	Обязательное	Что вводить
internalName	✅	Внутреннее имя до 100 символов; покупатель его не видит
enabled	✅	Показывать этот баннер
heading	✅	Заголовок до 120 символов
text	нет	Пояснение до 300 символов
desktopImage	✅	Изображение для широкого экрана
mobileImage	✅	Отдельное изображение для телефона
alt	✅	Краткое описание изображения до 180 символов
target	✅	Куда ведёт нажатие — компонент Commerce target

heading самой группы баннеров необязателен и ограничен 80 символами.

Если недоступны или выключены все баннеры группы, с витрины уходит вся секция Promo banners вместе с её заголовком.

Как написать alt

Опишите смысл изображения, а не начинайте со слов «картинка» или «баннер». Например: Комплект грунта и лака со скидкой 15%. Этот текст помогает тем, кто не видит изображение.

Шаг 3.1. Выберите цель в Commerce target

Компонент называется Commerce target и хранит тип ссылки отдельно от её значения.

type	Что заполнить	Куда ведёт баннер
product	medusaId товара	Карточка товара
category	medusaId категории	Каталог с фильтром по категории
collection	medusaId коллекции	Каталог (*)
external_url	url, обязательно с https:// или http://	Внешний сайт в новой вкладке

Для product, category и collection заполняйте только medusaId, а url оставляйте пустым. Для external_url — наоборот.

Цель collection не фильтрует каталог

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

Если нужно показать баннер именно на подборку товаров, используйте тип category, если товары можно объединить категорией, либо свяжитесь с разработчиком.

Если заполнить оба поля, черновик не сохранится: редактор покажет техническую ошибку на английском вида Medusa target requires only target.medusaId. Очистите лишнее поле и нажмите Save снова.

Шаг 3.2. Скопируйте Medusa ID

1. В новой вкладке откройте админку магазина: https://mirkrasok.termitsdigital.ru/app.
2. Откройте нужный товар, категорию или коллекцию.
3. Посмотрите адресную строку браузера.
4. Скопируйте последнюю часть адреса:

Объект	Как выглядит ID в адресе
Товар	/app/products/prod_… → скопировать prod_…
Категория	/app/categories/pcat_… → скопировать pcat_…
Коллекция	/app/collections/pcol_… → скопировать pcol_…

Цель проверяется перед показом

Товар должен быть опубликован, категория — активна и не служебная, коллекция — существовать. Недоступная цель получает предупреждение «Цель недоступна и баннер будет скрыт на сайте», а сам баннер не попадает на витрину.

Предупреждение ставится редактором контента при публикации. Если магазин в этот момент был недоступен, предупреждение появится у всех баннеров сразу — это признак проблемы связи, а не ваших данных; опубликуйте ещё раз и проверьте витрину.

Шаг 4. Заполните Information tabs

Секция показывает шесть фиксированных вкладок:

Поле	Вкладка покупателя
catalog	Каталог
brands	Бренды
contacts	Контакты
about	О нас
paintSelection	Подбор краски
delivery	Условия доставки

Поле heading задаёт общий заголовок, по умолчанию «Полезная информация». Текст вводится блочным редактором.

Пустую вкладку сайт не скрывает

Если оставить её без текста, на главной покупатель увидит «Информация появится позже». Это не та же заглушка, что на отдельной странице контактов.

Отдельные страницы редактируются в другом месте

Эти поля меняют только вкладки на главной. Страницы /contacts и /delivery берут текст из раздела «Главная страница» в админке магазина. Подробнее — «Как изменить контакты магазина».

Шаг 5. Настройте Catalog navigation

Поле	Значение
enabled	Показывать или скрыть секцию (обязательное)
heading	Заголовок, по умолчанию «Каталог», до 80 символов
defaultView = categories	Сначала показать категории
defaultView = brands	Сначала показать бренды

Эта настройка выбирает только начальный вид. Она не создаёт категории и бренды — они приходят из каталога магазина.

Шаг 6. Настройте Social networks and reviews

У секции есть heading, по умолчанию «Мы на связи», и enabled. Самих контактов, ссылок на соцсети и отзывов внутри секции нет: витрина берёт их из Content Manager → Single Types → Site settings.

Пустая секция может ничего полезного не показать

Сначала заполните contacts, socialLinks и reviewsUrl в Site settings, затем добавляйте Social networks and reviews в Homepage.

🖼️ Требования к изображениям

Требование	Значение
Разрешённые форматы	JPEG, PNG, WebP, AVIF
Размер одного файла	До 8 МБ по умолчанию
Для баннера	Обязательны отдельные desktopImage и mobileImage
Запрещено	Исполняемые файлы и скрипты

Лимит 8 МБ может быть изменён разработчиком через настройку сервера. Ограничений ширины, высоты или пропорций в коде нет, поэтому редактор сам не гарантирует хорошее кадрирование.

Проверяйте обе версии изображения

На телефоне используется mobileImage, а на широком экране — desktopImage. Один удачный кадр не гарантирует, что второй не обрежет товар или текст.

👥 Кто может сохранить и опубликовать

Роль	Черновики	Медиа	Публикация
Editor	Создаёт и редактирует	Загружает, обновляет, скачивает и копирует ссылки	❌ нет
Publisher	Создаёт и редактирует	Те же права	✅ да

Обе роли работают только с Homepage, Seo entry, Site settings и медиатекой в пределах выданных прав.

Шаг 7. Сохраните черновик

1. Нажмите Save.
2. Убедитесь, что запись сохранена без ошибок.
3. Не нажимайте Publish, пока не проверите черновик.

Save не меняет главную для покупателей.

Шаг 8. Откройте временный предпросмотр

1. В записи Homepage используйте действие предпросмотра.
2. Откройте выданную временную ссылку.
3. Проверьте порядок секций, тексты и широкие изображения баннеров.
4. Закройте ссылку после проверки.

Ссылка действует 10 минут и показывает черновик. На странице есть пометка «Режим предпросмотра» и пояснение «Покупатели не видят эти изменения.»

Предпросмотр — это сводка, а не точная копия главной

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

Предпросмотр не отсеивает баннеры с недоступной целью: в нём баннер виден, а на опубликованной главной его не будет.

Если ссылка истекла, появятся «Предпросмотр недоступен» и «Ссылка недействительна или устарела. Создайте новую ссылку в Strapi.» Создайте новую ссылку из Homepage.

Шаг 9. Опубликуйте и проверьте

1. Вернитесь в Homepage.
2. Нажмите Publish. Если кнопки нет, попросите пользователя с ролью Publisher.
3. Подождите до одной минуты.
4. Откройте https://mirkrasok.termitsdigital.ru.
5. Проверьте широкую и мобильную версии.
6. Нажмите каждый баннер и убедитесь, что он ведёт к нужной цели.

Save недостаточно

Покупатели видят только опубликованную версию. Сохранённый черновик доступен в редакторе и по временной ссылке, но не на обычной главной.

Одна повреждённая запись держит на сайте старую версию всей главной

Сервер обновляет снимок для витрины сразу по трём записям — Homepage, Site settings и SEO entry. Если хотя бы одна из них не проходит проверку, снимок целиком не обновляется, и покупатели продолжают видеть предыдущую опубликованную версию — даже если остальные две записи опубликованы верно. Если после Publish на сайте ничего не поменялось, а с самой изменённой секцией всё в порядке, проблема может быть в другой из этих трёх записей — сообщите разработчику.

🆘 Если что-то не получилось

Что видите	Что делать
Изменения есть в редакторе, но не на сайте	Проверьте Publish, затем подождите до минуты
Нет кнопки Publish	У учётной записи роль Editor; нужен Publisher
Баннер скрыт	Включите его enabled, проверьте обязательные поля и цель
«Цель недоступна…»	Проверьте тип и Medusa ID; товар должен быть опубликован
Карусель акций не видна	Проверьте коллекцию с названием «Акции» и товары внутри неё
Во вкладке «Информация появится позже»	Заполните соответствующее поле Information tabs
«Содержимое главной временно недоступно»	Витрина не загрузила снимок. Каталог продолжает работать; обновите страницу, затем обратитесь к разработчику
Файл изображения не принимается	Проверьте JPEG/PNG/WebP/AVIF и лимит 8 МБ
Предпросмотр устарел	Создайте новую временную ссылку из Homepage