Инструкция по плагину FTS-Plugin

Привет, это подробная инструкция по плагину FTS-Plugin.

Что надо знать перед установке плагина?

Плагин использует API сайта Fragment-API, лично я пользуюсь им уже с весны и у меня ничего не было, но гарантий за него не даю. Для использованию плагина, нужен FunPay Cardinal и верификация на сайте Fragment. Также для покупки звезд нужен кошелек версии V4R2 или W5(V5R1), другие не подойдут.

Как установить плагин и поставить на Cardinal?

Для начала скачиваете плагин с репозитория на Github. После скачивания заходите в вашего бота Cardinal, заходите в меню, потом в "Плагины", выбираете "+ Добавить плагин" и скидываете в бота файл, который вы скачали на Github, плагин если что называется FTS-Plugin. Самое главное после установки в Cardinal напишите команду /restart.

Что нужно сделать после установки?

Зайдите опять в "Плагины" и выберите "FTS-Plugin". После этого вы попадает в меню плагина, далее выбираете "Настройки" и вы попадаете в меню настройки плагина, выбираете "Токен", нажимаете потом "Создать токен", после всего вы выполняете все что у вас просит плагин, а точнее вас попросят данные Fragment API и другие. Главное что после вы должны подтвердить вход в телеграмм после написания всех данных.
Если есть вопросы, вот еще инструкция к сайту Fragment-API

Пройдемся по главному меню плагина.

После создания токена, я считаю надо пройтись по самому плагину и что как вообще там работает.

Начнем с главного меню (Фото 1). Кнопки:
"Плагин: вкл/выкл" - отвечает за вкл/выкл плагина.
"Лоты: вкл/выкл" - отвечает за вкл/выкл лотов, точнее после ее нажатия лоты деактивируются или активируется, ну или еще проще они могут пропасть дял обычного покупателя или появиться.
"Автовозврат: вкл/выкл" - отвечает за возвраты, если ее вкл, то после неудачной отправки звезд, плагин сам сделает возврат, если ее выключить, то даже при неудачной отправки звезд он не будет делать возврат.
"Автодеактивация: вкл/выкл" - отвечает за деактивацию лотов, если у вас не будет хватать на звезды, то он сам деактивирует их (вот прям, как на фото).
"Команда !бэк: вкл/выкл" - отвечает за то что покупатель мог вернуть деньге себе сам пор команде !бэк, она работает до того пока покупателю звезды не отправились.
"Ник из заказа: вкл/выкл" - отвечает за то что будет ли плагин сразу отправлять звезд, если в заказе есть ник или нет. Если в заказе ник есть, то если эта функция включена, то он сразу отправит звезды, если не включена, то он спросит хотите на этот ник или нет.

Далее пройдемся по другим настройкам:
"Токен" - тут вы уже были, если создавали токен, там прост создается токен для плагина.
"Настройка лотов" - тут вы можете должны будете настроить ваши лоты.
"Мини-настройки" - тут тоже настройки, но не сильно важные и нужны более для точной настройки.
"Логи" - при нажатии вы получаете все логи от плагина. Они нужны чтобы понимать более четка, что за проблема и как работает плагин.
"Статистика" - тут вы можете посмотреть ваш статистику, как неожиданно.

Ну и 3 последние кнопки мне кажется и так понятно за что отвечают.

Как настроить лоты?

Заходите в "Настройка лотов" и вы попадаете а меню настройки лотов (фото 2).
После того, как вы зашли у вас ничего не будет (на фото один лот есть, но является тестовым, поэтому забейте на него).

Чтобы добавить лоты, вам нужно нажать "+ Добавить лот", далее у вас попросит сколько звезд будет выдаваться при продаже и id лота (фото 3).

Сразу еще помогу некоторым людям, которые вообще не знают, что такое LOT_ID, это id, который вам выдает FunPay при создании лота. Его можно найти когда вы уже создали лот, он находится в ссылке (фото 4).

После чего у вас появится ваш лот. Далее вы можете настроить: цену лота, наценку, удалить его из плагина, вкл/выкл, вкл/выкл вообще все лоты, вообщем можете делать почти все, что захотите. Объяснять все остальные пункты не вижу смысла ведь все в принципе понятны и также все расписано в плагине.

Что вообще в "Мини-настройках"?

Там настройки, которые нужны для более точной настройки плагина для продавца (фото 5), ну давайте пройдемся по ним.

"Приоритет !бэк" - нужна вообще если авто возврат вкл/выкл, типо приоритет от него идет, но если команда выключена, то тогда вообще неважно.

"Очередь" - появилась в обновление 1.6.1 и отвечает за сценарии/варианты/логику очереди, то есть вы сами можете выбрать как очередь будет работать. Вот варианты и как что рабоатет:
1. Простой (обычный, как и в 1.6.0).
2. Пропуск готовых (если человек стоит в очереди раньше, но по каким-то причинам не отвечает/не пишет то, что просит бот, то заказ после него может быть выполнен раньше — если следующий пользователь сделал всё быстрее. После этого бот вернётся к предыдущему).
3. Таймаут в конец (если первый покупатель не отвечает на запрос бота, то через 5 минут он переносится в конец очереди, и бот продолжает принимать заказы дальше по тому же принципу).

"Мин. баланс" - нужна для настройки автодеаквации, если баланс меньше определенного, то плагин деактивирует лоты, если выше, то все круто и хорошо.

"LiteServer-ретрай" - появилась в обновлении 1.6.0 и нужна для того, чтобы делать повторную отправку звезд, если вылезла ошибка "liteserver", которая является ошибкой Fragment, а не плагина.

"Автоотправка без '+' " - появилась в обновлении 1.6.0 и нужна для того, чтобы настроить хотите ли вы, чтобы покупатель должен был писать + перед отправкой звезд и или нет.

"Проверка @username" - появилась в обновлении 1.6.0 и нужна для того, чтобы настроить хотите ли вы, чтобы была проверка ника на его существование или нет через Fragment API.

"Сообщения" - ну там вы можете настроит вид сообщений, как захотите.
Кнопку назад даже не вижу смысла обсуждать.


Про настройку сообщений еще уделим пару моментов. Нажимая на кнопку "Сообщения" вы попадает в меню где вы можете настроить сообщения (фото 6). Я думаю там тоже ничего трудного нету.

Как удалить плагин?

Заходите в самое начало где было название плагина, версия, создатель и там будет кнопка "Удалить плагин" (фото 7), она тоже недавно появилась с обновлением 1.6.0. Ну дальше там уже все напишется, как удалить и что после надо сделать будет.

На этом инструкция закончена, возможно в будущем она будет обновляться, если что-то изменится.

Ссылки если нужна помощь и тд:
Telegram Chat
Telegram Channel
Telegram (100 звезд за сообщение или срочно важный вопрос напишите в чате и я уберу плату за сообщение)