Recipe Forums 1.0.19

Recipe Forums превращает выбранный форум XenForo в удобный каталог рецептов. Рецепт остаётся обычной темой с первым сообщением, вложениями, автором, датой публикации, реакциями, жалобами и стандартными действиями XenForo, но создаётся через специальную форму и выводится как структурированная карточка.

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

Основные возможности

• Отдельный тип форума «Рецепты». При создании или изменении обычного узла «Форум» администратор выбирает тип «Рецепты».
• Удобная форма публикации. Пользователь заполняет описание, время подготовки и приготовления, количество порций, сложность, кухню, продукты, подготовительные действия и пошаговое приготовление.
• Категории на штатных префиксах тем. Например: «Салаты», «Первые блюда», «Десерты» или «Напитки». Префиксы назначаются нужному форуму стандартными средствами XenForo.
• Продукты на штатных дополнительных полях тем. Для каждого продукта существует одно поле, а конкретный рецепт хранит в нём количество и единицу измерения — например, «450 г» или «2 зубчика».
• Создание новых продуктов из формы рецепта. Отдельное право можно выдать только доверенным группам. Остальные пользователи выбирают уже существующие продукты.
• Изображения во вложениях XenForo. Первое доступное изображение используется как обложка. Дополнительные изображения остаются обычными вложениями первого сообщения.
• Три варианта списка. Обычный компактный список, сетка из двух колонок или сетка из трёх колонок. Для каждого форума отдельно задаётся количество рецептов на странице.
• Виджет категорий. Показывает префиксы текущего раздела и количество доступных пользователю рецептов в каждой категории.
• Виджет фильтра. Позволяет выбрать кухню и несколько продуктов. Можно найти рецепты, содержащие все выбранные продукты, либо только рецепты без дополнительных продуктов.
• Штатные реакции и действия сообщений. Оценки не дублируются собственной системой: используются реакции, ответы, редактирование, жалобы, история и модераторские действия XenForo.
• Поиск и структурированные данные. В поисковый индекс добавляются параметры рецепта, продукты и этапы приготовления. Страница дополняется разметкой Schema.org Recipe.
• Гибкие права доступа. Отдельно настраиваются просмотр, публикация, изменение, реакции, вложения, создание новых продуктов и модераторские действия.

Как это работает

1. Администратор создаёт обычный форум и выбирает для него тип «Рецепты».
2. Форуму назначаются стандартные префиксы, которые становятся категориями рецептов.
3. В настройках форума выбираются доступные кухни, вид списка или сетки и количество рецептов на странице.
4. При создании темы вместо обычного редактора пользователь получает форму рецепта.
5. Описание сохраняется в первом сообщении, категория — в префиксе, параметры и продукты — в дополнительных полях темы, изображения — во вложениях.
6. На странице темы эти штатные данные XenForo собираются в аккуратную карточку рецепта.

Фильтрация по продуктам

Виджет фильтра поддерживает два режима:

• «Содержит выбранные продукты» — рецепт должен включать весь выбранный набор, но может содержать и другие продукты.
• «Только выбранные продукты» — рецепт не должен содержать никаких других заполненных полей продуктов.

Количество и единица измерения не влияют на совпадение: фильтр проверяет наличие самого продукта в рецепте.

Штатное хранение данных

Recipe Forums не создаёт собственных таблиц и не изменяет файлы ядра или стиля XenForo.

• описание — стандартное первое сообщение темы;
• категория — стандартный префикс темы;
• параметры и продукты — стандартные дополнительные поля темы;
• изображения — стандартные вложения;
• оценка — стандартные реакции сообщений.

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

Виджеты

В комплект входят два виджета:

• «Категории рецептов» — список категорий с количеством тем.
• «Фильтр рецептов» — выбор кухни, продуктов и режима совпадения.

Форум вручную выбирать не требуется. Виджеты автоматически определяют текущий форум рецептов или открытую тему рецепта. Место и условия их отображения задаются стандартными настройками виджетов XenForo.

Особенности

• Быстрое создание темы в разделе рецептов отключено, потому что для рецепта требуется полная структурированная форма.
• Штатные метки тем в форумах рецептов отключены: продукты хранятся в дополнительных полях, а не в тегах.
• Поля рецептов связываются только с форумами типа «Рецепты» и не выводятся в обычных разделах.
• Категории остаются обычными префиксами тем и используют стандартную фильтрацию XenForo.

Требования

• XenForo 2.3.0 или новее.
• PHP 8.0 или новее.

Установка и первоначальная настройка

1. Загрузите архив через менеджер плагинов.
2. Установите дополнение Recipe Forums в панели управления.
3. При необходимости импортируйте входящий в комплект русский языковой XML-файл.
4. Создайте или измените узел «Форум» и выберите тип «Рецепты».
5. Назначьте форуму префиксы категорий и настройте доступные кухни, вид списка и число рецептов на странице.
6. Настройте права групп пользователей, особенно право создания новых полей продуктов.
7. При необходимости добавьте виджеты «Категории рецептов» и «Фильтр рецептов» в подходящие позиции.