Руководство по плагину Lot Toggler

Lot Toggler массово выключает и включает ваши лоты на FunPay. Уходите спать, в отпуск или делаете ревизию — выключите все лоты или только одну игру одной кнопкой, а потом так же верните их в продажу. Плагин запоминает, какие лоты выключил сам, поэтому включает обратно только их: то, что вы сняли с продажи вручную, он не трогает.

Ещё у плагина есть расписание продаж: в рабочие часы (например, с 9 до 23) лоты включены, а на ночь плагин выключает их сам и утром включает обратно.

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

1. Вас нет на месте: ночью или в отпуске заказы висят без ответа, покупатели злятся и ставят плохие отзывы. Лоты выключены — некому и заказывать.
2. Ревизия или смена цен: можно снять с продажи одну игру, не трогая остальные.
3. Не нужно ничего записывать: плагин сам хранит список выключенных лотов и возвращает в продажу ровно их.

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

• Выключить все: снимает с продажи все активные лоты аккаунта, после подтверждения «✅ Да».
• Выключить категорию: список ваших разделов с числом активных лотов в каждом — выключается только выбранный.
• Включить обратно: все выключенные плагином лоты сразу или только одну категорию.
• Игровая валюта: раздел валюты — одна строка в списке. Плагин выключает его активные предложения (серверы, стороны), а при включении возвращает только их.
• Перепроверка: FunPay иногда отвечает «сохранено», а лот остаётся прежним. Плагин перечитывает лот после сохранения и пробует до 3 раз.
• Ошибки не теряются: лот, который не удалось включить, остаётся в списке выключенных, а бот присылает пронумерованный список ссылок на такие лоты.
• Расписание продаж: окно часов и часовой пояс; окно через полночь (например, 22:00–06:00) тоже работает.
• Выгрузка: список выключенных лотов файлом lots_off.txt — дата, категория, название и ссылка на редактирование.

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

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. Отправьте боту /lots_off — откроется меню.
3. Выключайте и включайте лоты кнопками 🔴 и 🟢.
4. Нужно расписание — задайте часы кнопкой «✏️ Часы продаж» и включите «⏰ Расписание».

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

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

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

ШАГ 2. Выключите лоты

1. Отправьте боту /lots_off.
2. Все сразу: «🔴 Выключить все» → «✅ Да».
3. Одну игру: «🔴 Категорию» → выберите раздел из списка (в скобках — сколько в нём активных лотов).
4. Бот напишет «⏳ Выключаю…», а в конце — «✅ Готово.» и список лотов, которые выключить не удалось, если такие были.

💡 В меню видно, сколько лотов выключено плагином и из каких категорий.

ШАГ 3. Включите лоты обратно

1. «🟢 Включить все (N)» — вернёт в продажу все N лотов, которые выключил плагин.
2. «🟢 Категорию» — список категорий, где есть выключенные плагином лоты; включится только выбранная.
3. Не включился лот — он останется в списке, а бот пришлёт на него ссылку: откройте её и проверьте лот на FunPay.

ШАГ 4. Настройте расписание продаж (по желанию)

1. «✏️ Часы продаж» → пришлите окно, когда лоты должны быть включены: 09:00-23:00 3 — с 9:00 до 23:00 по UTC+3 (Москва).
2. Часовой пояс можно не писать — останется прежний (по умолчанию UTC+3).
3. Нажмите «⏰ Расписание: ❌» — станет ✅.
4. Плагин проверяет время раз в минуту: вне окна выключает активные лоты, в начале окна включает их обратно и каждый раз присылает уведомление.

💡 Окно через полночь тоже работает: 22:00-06:00 3 — лоты включены ночью, а днём выключены.

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

Меню /lots_off

Сверху — сколько лотов выключено плагином, расписание и часы продаж; ниже — по категориям.

• 🔴 Выключить все — выключить все активные лоты аккаунта; бот сначала спросит подтверждение
• 🔴 Категорию — выключить лоты одного раздела: список ваших категорий с числом активных лотов
• 🟢 Включить все (N) — включить все лоты, которые выключил плагин; N — сколько их
• 🟢 Категорию — включить выключенные плагином лоты только одной категории
• 📎 Список .txt — прислать файл lots_off.txt: когда выключен, категория, название, ссылка на лот
• ⏰ Расписание: ✅ / ❌ — включить или выключить расписание продаж
• ✏️ Часы продаж — окно, когда лоты включены, и часовой пояс, например 09:00-23:00 3
• ⬅️ Назад — к карточке плагина

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

1. Вы нажимаете кнопку или наступает время по расписанию.
2. Плагин берёт ваши активные лоты с профиля FunPay и по очереди меняет их статус — с небольшой паузой, чтобы не упереться в лимиты FunPay.
3. Каждый лот перечитывается после сохранения: если FunPay не применил статус, плагин пробует ещё раз (до 3 попыток).
4. Выключенный лот записывается в список плагина вместе с категорией и временем.
5. При включении лот убирается из списка, только если он действительно включился; остальные остаются, а бот присылает на них ссылки.
6. Одновременно идёт только одна операция: пока она не закончилась, бот ответит «⏳ Уже идёт другая операция».

💬 Как это выглядит

Уведомление в Telegram вечером

🌙 Расписание: продажи закрыты, лоты выключены.

Уведомление в Telegram утром

🟢 Расписание: продажи открыты, лоты включены.

Если часть лотов не включилась

✅ Готово.
⚠️ Не удалось (1):
1. https://funpay.com/lots/offerEdit?offer=12345678

⌨️ Команды

• /lots_off — меню выключения и включения лотов, список .txt, расписание
• /lots_schedule — часы продаж и часовой пояс: /lots_schedule 09:00-23:00 3

💡 Важно знать

• Плагин включает только те лоты, которые выключил сам. Лоты, выключенные вручную на FunPay, остаются выключенными.
• ⚠️ Расписание в начале окна включает все лоты из списка выключенных плагином — в том числе выключенные кнопкой «🔴 Выключить все». Если какую-то игру нужно оставить выключенной, выключите её вручную на FunPay.
• Включили расписание вне рабочего окна — в течение минуты плагин выключит активные лоты.

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

Лоты игровой валюты тоже выключаются?

Да. Раздел валюты — одна строка в списке: плагин выключает его активные предложения (серверы, стороны), а при включении возвращает только их.

Я выключил лот вручную на FunPay — плагин его включит?

Нет, плагин включает только те лоты, которые выключил сам.

Лот не включился обратно?

FunPay иногда «сохраняет» лот, не меняя его, — плагин пробует до трёх раз. Не вышло — лот остаётся в списке выключенных, а бот присылает ссылку, чтобы включить его вручную.

В каком часовом поясе работает расписание?

В том, что указан в /lots_schedule: число после часов — сдвиг от UTC (3 — Москва, 5 — Екатеринбург). Текущий пояс показан в меню /lots_off.

Как остановить расписание?

В /lots_off нажмите «⏰ Расписание: вкл» — станет «выкл». Уже выключенные лоты останутся в списке: включите их кнопкой «🟢 Включить все».