Начало работы v200.3.1
Что такое TagsAdd: предложение тегов к новостям, модерация, настройки и подключение в теме.
Описание плагина
TagsAdd (пользовательские теги) — сателлит DevCraft Admin для DataLife Engine. Читатель на полной новости предлагает теги; предложения попадают в очередь. Модератор в админке одобряет, отклоняет или правит запись — при одобрении теги пишутся в теги новости или в выбранное доп. поле.
Модуль: devcraft/src/modules/TagsAdd/, вход админки ?mod=tags_add. Публичная отправка идёт через общий AJAX DevCraft (controller=public), без отдельных engine/ajax скриптов модуля. Версия 200.3.1 — ветка 200.* для DLE 20+ и Admin ≥ 200.4.1.
- Страница загрузки: devcraft.club
- Репозиторий: DevCraftClub/tagsadd
Возможности
- Кнопка и окно на полной новости (шаблоны темы).
- Предложения от гостей (если разрешено в настройках) и от авторизованных.
- Очередь в админке: одобрить / отклонить с причиной / удалить / массовые действия.
- Вставка при одобрении в
tagsновости или в доп. поле (xfield), опционально в xfsearch. - ЛС админу и автору предложения (шаблоны с плейсхолдерами новости и модуля).
- Предпочтения уведомлений через доп. поле профиля (список).
- Локали XLIFF (
ru_RUи др.), changelog в панели модуля.
Для кого
Владельцы сайта и модераторы
Ставите Admin, затем TagsAdd, сохраняете настройки (получатель ЛС, куда писать теги), подключаете includes в fullstory.tpl. Дальше работаете в очереди ?mod=tags_add&action=suggestions.
Разработчики темы
Копируете templates/Default/devcraft/tags_add/ в свой скин и правите button.tpl / modal.tpl, не ломая имена полей формы и AJAX. Стили и скрипт сайта — в Public/ (siteAssets), не в теме. См. Подключение в теме.
Почему не старый TagsAdd 2.x (maharder). Пакет 200.x — другой каркас: DevCraft, Metro, Cycle ORM. Поверх engine/inc/maharder/ не ставится — сначала снимите legacy, потом Admin и TagsAdd 200.3.x.
Требования
| Что | Минимум |
|---|---|
| DataLife Engine | 20.0+ |
| PHP | 8.3+ |
| DevCraft Admin | ≥ 200.4.1 (dc_public.js, публичный AJAX) |
Полный чеклист: Установка.
Дерево структуры
Корень сайта после установки. В скобках — зачем папка.
Кратко:
devcraft/src/modules/TagsAdd/— админка, бизнес-логика и публичный Controller.Controller/show_tags_add.php— канон include в теме (от корня сайта).Public/— CSS/JS сайта (siteAssets) и JS админки (assets).templates/…/tags_add/— разметка кнопки и окна.
Быстрый старт
Поставьте Admin и TagsAdd
Сначала DevCraft Admin, затем ZIP TagsAdd через менеджер плагинов. В devcraft/ выполните composer dump-autoload. Подробности: Установка.
Настройки
Откройте ?mod=tags_add, сохраните получателя ЛС, текст кнопки и куда вставлять теги при одобрении. См. Настройки.
Тема
В main.tpl поставьте {devcraft}. В fullstory.tpl — includes с focus=button и focus=modal. Скопируйте шаблоны в свой скин при необходимости. См. Подключение в теме.
Модерация
Очередь: ?mod=tags_add&action=suggestions. Одобрение пишет теги в новость; отклонение может с причиной (или стандартной из настроек).
Руководства и разделы
| Страница | О чём |
|---|---|
| Установка | ZIP, Composer, первый запуск, отличие от legacy |
| Настройки | PM, xfield prefs, куда писать теги, шаблоны ЛС |
| Подключение в теме | Includes в fullstory, теги button/modal |
| Очередь | Одобрение, отклонение, массовые действия |
| Справочник | Классы PHP и AJAX |
| История изменений | 200.3.1 и ранее |
Установка
Admin, ZIP, dump-autoload, таблица
Настройки
Уведомления, вставка тегов, PM
Тема
fullstory.tpl и шаблоны кнопки
Очередь
Одобрить, отклонить, массово
Справочник
Классы и AJAX
История изменений
Что изменилось в 200.3.1
Дальше
- Установить плагин.
- Пройти быстрый старт.
- Настроить шаблоны ЛС и вставку, проверить кнопку на новости.