Инструкция: Настройка и управление секцией FAQ (WEBLEGKO FAQ META)


Эта инструкция описывает, как работает новая секция FAQ. Она построена на метаобъектах Shopify (без сторонних приложений), оптимизирована для нейросетей (ChatGPT, Perplexity) и имеет гибкие настройки вывода.

🛠 Шаг 1. Создание базы данных (Метаобъекты)


Делается один раз при первоначальной настройке.

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

Зайди в админку Shopify → Settings (Настройки) → Custom data (Пользовательские данные) → Metaobjects.
Нажми Add definition.
1.1. Создаем категории (faq_category)
Name: FAQ Category (ключ автоматически станет faq_category).
Fields (поля):
Name: Name | Type: Single line text
Name: Position | Type: Integer (целое число, управляет порядком: 10, 20, 30…)
В блоке Storefront access поставь галочку Visible.
Appear in search — выключи. Нажми Save.
1.2. Создаем вопросы (faq_item)
Name: FAQ Item (ключ faq_item).
Fields (поля):
Name: Question | Type: Single line text
Name: Answer | Type: Rich text (форматированный текст)
Name: Category | Type: Metaobject reference → выбери FAQ Category
Name: Position | Type: Integer (порядок внутри категории: 10, 20, 30…)
Name: Published | Type: Boolean (Да/Нет — включает/выключает вопрос на сайте)
Name: Show on Homepage | Type: Boolean (Да/Нет — выводить ли этот вопрос в тизере на главной)
В блоке Storefront access поставь галочку Visible. Нажми Save.


📝 Шаг 2. Добавление контента (Категории и Вопросы)


Это рутинная задача менеджера после настройки.

В админке перейди в Content (Контент) → Metaobjects.
Открой FAQ Category → нажми Add entry. Впиши название (например, “Доставка”) и позицию (10). Сохрани.
Открой FAQ Item → нажми Add entry.
Напиши вопрос и ответ.
В поле Category выбери созданную категорию.
В поле Position поставь 10.
В поле Published выбери true (показывать на сайте).
В поле Show on Homepage выбери true, если хочешь, чтобы этот вопрос был на главной (иначе false).
Нажми Save.


🎨 Шаг 3. Настройка секции в редакторе темы (Customizer)


Секция WEBLEGKO FAQ META работает в двух режимах. Добавь её на Главную страницу и на отдельную страницу /pages/faq, затем настрой каждую по сценарию ниже.

Сценарий А: Настройка для ГЛАВНОЙ страницы (Тизер)
Цель: показать 5-7 избранных вопросов плоским списком без категорий и дать кнопку перехода на полную базу.

Открой настройки секции на главной странице и выстави:

Отключить JSON-LD (для главной страницы): ✅ ВКЛЮЧИТЬ (разметка нужна только на отдельной странице).
Спрятать названия категорий: ✅ ВКЛЮЧИТЬ (выводим красивый плоский список).
Heading: Впиши заголовок (например, “Frequently Asked Questions”).
Режим главной страницы (только избранные): ✅ ВКЛЮЧИТЬ (секция возьмет из базы только те вопросы, где стоит галочка Show on Homepage).
Limit questions: Поставь 5 или 7 (ограничивает количество выводимых вопросов).
Button Text: Впиши “More FAQ”.
Select FAQ Page: Выбери из списка страницу FAQ (появится кнопка под вопросами).
Сценарий Б: Настройка для страницы /pages/faq (Полная база)
Цель: вывести вообще все вопросы, сгруппировав по категориям, и сгенерировать скрытый код для нейросетей (JSON-LD).

Открой страницу FAQ в редакторе темы и выстави:

Отключить JSON-LD (для главной страницы): ⬜ ВЫКЛЮЧИТЬ (Критически важно! Здесь нейросети будут читать разметку).
Спрятать названия категорий: ⬜ ВЫКЛЮЧИТЬ (Категории должны отображаться).
Heading: Впиши заголовок (например, “Help Center & FAQ”).
Режим главной страницы (только избранные): ⬜ ВЫКЛЮЧИТЬ (Выводим все опубликованные вопросы).
Limit questions: Поставь 0 (0 = показать абсолютно все вопросы).
Select FAQ Page: ⬜ ОЧИСТИТЬ (оставь пустым. Кнопка “More FAQ” здесь не нужна).
⚙️ Как управлять вопросами каждый день (Для контент-менеджера)
Вам не нужно трогать код или настройки темы, чтобы добавить или скрыть вопрос.

Зайди в Content → Metaobjects → FAQ Item.

Чтобы добавить вопрос: нажми Add entry, заполни поля, поставь Published = true. Вопрос мгновенно появится на /pages/faq и в JSON-LD.
Чтобы вопрос попал на главную: в настройках этого вопроса поставь Show on Homepage = true.
Чтобы скрыть вопрос со всего сайта: поставь Published = false. Он исчезнет с главной, со страницы /pages/faq и из кода разметки.


🚨 QA Чек-лист (Перед публикацией)


В Settings → Custom data у метаобъектов faq_category и faq_item стоит галочка Visible (Storefront access).
Создано хотя бы 2 тестовых вопроса (один с галочкой Show on Homepage, другой без).
На главной странице включен “Режим главной страницы” и отключен JSON-LD.
На странице /pages/faq “Режим главной страницы” выключен, лимит стоит на 0, JSON-LD включен.
Проверка кода: открой /pages/faq, нажми Ctrl + U (View Source). Найди через Ctrl + F слово FAQPage. Убедись, что там лежит валидный JSON с твоими вопросами и ответами (без HTML-тегов внутри поля “text”).
Проверка кликов: убедись, что анимация открытия/закрытия вопросов работает плавно и без рывков.