samakovuluk/FunPayCardinal

Консольное приложение с мощнейшим инструментарием для автоматизации рутинных действий на FunPay.

FunPay Cardinal

Консольное приложение для автоматизации рутинных действий на FunPay

Перед началом настоятельно рекомендую залететь в наш Telegram чат (клик). Тут и поможем чем сможем и посидеть можно.

📋 Содержание

• Возможности

  • FunPay
  • Уведомления в Telegram
  • Дополнительные возможности

• Преимущества

  • Для пользователей
  • Для разработчиков

• Плагины

• Установка

  • Windows
  • Linux (Ubuntu)

• Настройка конфигов

• Установка плагинов

• Мне нужна помощь

• Star it!

🤖 Возможности

🛒 FunPay

• Авто-выдача товаров.
• Авто-поднятие лотов.
• Авто-ответ на заготовленные команды.
• Авто-восстановление лотов после продажи.
• Вечный онлайн.
• Уведомления в телеграм.

🗨️ Уведомления в Telegram

• Возможность установки нескольких чатов для уведомлений.
• Уведомления о поднятии лотов.
• Уведомления о новых заказах.
• Уведомления о выдаче товара.
• Уведомления о новых сообщениях
• Возможность отвечать на сообщения прямо из Telegram.

⚙️ Дополнительные возможности

• Использование переменных в тексте для авто-ответа / авто-выдачи.
• Создание плагинов для кастомизации функционала без редактирования исходного кода самого Кардинала.

🥇 Преимущества

😀 Для пользователей

• Больше, чем наличие самого нужного функционала.
• Оптимизация. 20 МБ свободного места на диске, до 50 МБ ОЗУ, доступ в интернет - все что нужно для работы.
• Возможность установить на любую платформу, которую поддерживает Python: Windows, Linux, IOS, Android и т.д.
• Возможность установки плагинов дает огромную вариативность модификации стандартного функционала под самые разные нужды.
• Гибкие и при этом простые конфиги, написанные в INI-формате.
• Постоянные обновления, быстрое реагирования на баги / предложения о новом функционале.

💻 Для разработчиков

• Выбран самый простой и при этом один из самых мощных языков для такого рода приложений - Python.
• Полная документация кода. Все классы / методы / функции имеют док-строки, type-хинты.
• Широкое использование ООП. Почти каждый эвент / сообщение / заказ и т.д. представляют собой экземпляр соответствующего класса, а не просто набор данных в JSON.
• Возможность легкого создания плагинов.
• Сконфигурированный логгер. Никаких принтов!
• Собственный Python-пакет FunPayAPI, который никак не привязан к FunPay Cardinal.
• Поддержка лично от меня :)

🔌 Плагины

• FPC Newbie Greetings Plugin (отправляет приветственное сообщение пользователям, которые написали впервые)
• FPC Lot Deactivate Plugin (деактивирует лот, если для него закончились товары)

⬇️ Установка

🔷 Windows

1. Скачайте и установите Python.
   1. При установке поставьте галочку у Add python.exe to PATH на первом экране установки.
2. Скачайте FunPay Cardinal
3. Перенести папку FunPayCardinal-master в нужное вам место.
4. Перейдите в папку FunPayCardinal-master.
5. В адресной строке введите cmd и нажмите Enter.
6. В открывшейся командной строке введите python setup.py. Дождитесь окончания загрузки пакетов.
7. Закройте командную строку, настройте конфиги и запустите файл Start.bat.

♨️ Linux (Ubuntu)

1. Введите следующие команды для установки Python 3.11.

   1. sudo apt update
   2. sudo apt install software-properties-common
   3. sudo add-apt-repository ppa:deadsnakes/ppa
   4. sudo apt update
   5. sudo apt install python3.11 python3.11-dev python3.11-gdbm python3.11-venv
   6. sudo apt install curl
   7. sudo apt install gcc
   8. curl -sS https://bootstrap.pypa.io/get-pip.py | python3.11

2. Скачайте git с помощью команды sudo apt install git.

3. Скачайте FunPayCardinal с помощью команды git clone https://github.com/woopertail/FunPayCardinal.

4. Перейдите в папку FunPayCardinal с помощью команрды cd FunPayCardinal.

5. Установите нужные пакеты с помощью команды python3.11 setup.py.

6. Настройте конфиги и запустите FunPay Cardinal с помощью команды python3.11 main.py.

🛠️ Настройка конфигов

1. Все конфиги находятся в папке configs
2. Все инструкции по настройке конфигов находятся внутри самих конфигов.
3. Основной конфиг со всеми переключателями: configs/_main.cfg
4. Конфиг авто-ответчика: configs/auto_response.cfg
5. Конфиг авто-выдачи: configs/auto_delivery.cfg

🔌 Установка плагинов

Установка плагинов крайне проста. Просто скопируйте файл плагина (с расширением .py) в папку plugins.

❓ Мне нужна помощь

Если у вас остались какие-либо вопросы, мы с радостью ответим на них в нашем Telegram чате. Там же вы сможете найти больше плагинов для FunPay Cardinal.

⭐ Star it!

Если вам удобно пользоваться FunPay Cardinal, не забудьте поставить ⭐ звезду ⭐ данному проекту :)