Руководство по плагину Chat Gallery

Одна и та же картинка в каждом приветствии быстро приедается. Chat Gallery собирает галереи картинок — и бот отправляет картинки из них по очереди. Тег $photo=ИМЯ работает в любом тексте бота: в приветствии, автоответе, ответе на подтверждение заказа и на отзыв, в автовыдаче. Для каждого случая — своя галерея.

🎯 Для чего это нужно

1. Живые сообщения: покупатели видят разные картинки, а не одну и ту же.
2. Своя галерея для каждого случая: приветствие, подтверждение заказа, ответ на отзыв.
3. Быстро: картинки загружаются прямо из Telegram, альбомом.

✨ Что умеет плагин

• Тег $photo=ИМЯ: в любом тексте бота — следующая картинка из галереи, по кругу.
• Сколько угодно галерей: greeting, orderconfirm, review, chat или свои имена.
• $photo без имени: картинка из общей галереи default.
• Загрузка из Telegram: можно альбомом; каждая картинка загружается на FunPay один раз, дальше бот шлёт её по номеру.
• Кнопки в экранах бота: «🖼 Галерея фото» в приветствии ($photo=greeting), ответе на подтверждение ($photo=orderconfirm) и ответах на отзывы ($photo=review).
• Пустая галерея: тег убирается, текст уходит без картинки.
• Обычный $photo=номер картинки работает как раньше.

⚡ Быстрый старт

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. /gallery → «➕ Новая галерея» → имя, например greeting → пришлите картинки → «✅ Готово».
3. Впишите $photo=greeting в приветствие или другой текст бота.

🛠️ Пошаговая настройка

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Chat Gallery.
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Создайте галерею

1. /gallery (или «⚙️ Открыть настройки» в карточке плагина) → «➕ Новая галерея» → пришлите имя, например greeting. Бот 10 минут принимает картинки в эту галерею.
2. Пришлите картинки (можно альбомом) — на каждую бот ответит «✅ +1 в «greeting», всего N».
3. Закончили — нажмите «✅ Готово» под сообщением бота.
4. Или кнопкой: 🤖 Автоматизация → 👋 Приветствия → «🖼 Галерея фото» → «📥 Добавить картинки».

💡 Имя галереи — латиницей, с буквы: greeting, review, chat… Можно цифры, _ и -.

ШАГ 3. Впишите тег в текст

1. Впишите $photo=greeting в приветствие, автоответ или ответ на отзыв — бот подставит следующую картинку.
2. Просто $photo — картинка из общей галереи default.

ШАГ 4. Управляйте галереями

1. /gallery — все галереи кнопками, у каждой — сколько в ней картинок.
2. Нажмите на галерею: «📥 Добавить картинки» — дополнить, «🗑 Очистить» — удалить все картинки.

🕹️ Меню и кнопки

Панель /gallery

Все галереи и сколько в каждой картинок.

• 🖼 имя — N шт. — открыть галерею
• ➕ Новая галерея — пришлите имя; такая уже есть — картинки добавятся к ней
• ⬅️ Назад — к карточке плагина

Экран галереи

Открывается из /gallery или кнопкой «🖼 Галерея фото ($photo=…)» в экранах приветствия, ответа на подтверждение и на отзывы.

• 📥 Добавить картинки — бот 10 минут принимает картинки в эту галерею; закончили — «✅ Готово»
• 🗑 Очистить — удалить все картинки галереи
• ⬅️ К галереям / ⬅️ Назад — к списку галерей или обратно в экран бота

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

1. Бот собирается отправить покупателю сообщение с тегом $photo=ИМЯ.
2. Плагин заменяет тег номером следующей картинки галереи и запоминает, на какой остановился.
3. После последней картинки — снова первая.
4. Галерея пустая или её нет — тег убирается, сообщение уходит без картинки.

⌨️ Команды

• /gallery ИМЯ — загрузить картинки в галерею
• /gallery_done — закончить загрузку
• /gallery — список галерей
• /gallery_clear ИМЯ — очистить галерею

💡 Важно знать

• Числовой $photo=1234567 — это номер одной картинки FunPay, плагин его не трогает.
• После /gallery ИМЯ картинки принимаются 10 минут — потом отправьте команду снова.

❓ Частые вопросы

Каким может быть имя галереи?

Латинские буквы, цифры, _ и -, начинается с буквы. Числовой $photo=1234567 — это номер одной картинки, бот его не трогает.

В каком порядке идут картинки?

По очереди, по кругу: после последней — снова первая.

Сколько времени принимаются картинки после /gallery?

10 минут — потом отправьте /gallery ИМЯ снова. Каждая картинка загружается на FunPay один раз, дальше бот отправляет её по номеру.

Просто $photo без имени?

Это общая галерея default.