steffo/greed
steffo/greed
1
Fork 0
mirror of https://github.com/Steffo99/greed.git synced 2024-11-21 21:44:19 +00:00
Code Activity
Customizable, multilanguage Telegram shop bot with Payments support
150 commits 13 branches 4 tags 1,006 KiB
Python 99.6%
Dockerfile 0.4%
Find a file
Stefano Pigozzi 788163458e Offer refill only if the credit_required is between the min_amount and max_amount range
2020-04-08 15:02:19 +02:00
config Clarify how to disable credit card payments in the template config 2020-04-07 23:52:17 +02:00
strings add russian language support 2020-04-05 00:18:45 +03:00
.gitignore Add transaction file 2018-04-19 09:37:42 +02:00
configloader.py #45: Load config files with UTF8 encoding 2020-04-07 02:27:03 +02:00
CONTRIBUTING.md Add CONTRIBUTING.md 2018-05-03 09:00:58 +02:00
core.py Accept any commands starting with /start to start the bot 2020-03-31 01:52:44 +02:00
database.py #18: Recalculate credit on every new transaction 2020-03-27 18:14:37 +01:00
LICENSE.txt Rename LICENSE 2018-05-03 08:51:44 +02:00
README.md #43: Improve README.md 2020-04-08 00:03:33 +02:00
requirements.txt Create requirements and update README 2018-05-03 08:48:31 +02:00
utils.py #46: Don't crash if Sentry is enabled and greed isn't being run in a git repository 2020-04-07 23:54:24 +02:00
worker.py Offer refill only if the credit_required is between the min_amount and max_amount range 2020-04-08 15:02:19 +02:00

README.md

greed

A customizable, multilanguage Telegram shop bot with Telegram Payments support!

Requirements

  • Python 3.6 (or higher)
  • The packages specified in requirements.txt (install with pip install -r requirements.txt)
  • An Internet connection
  • A Telegram bot token (obtainable at @Botfather)
  • A payment provider token (obtainable by connecting a provider with your bot)
  • Optional: a sentry.io token

Installation

  1. Download the project files through git clone https://github.com/Steffo99/greed.git (recommended) or this link.
  2. Install the project requirements with pip install -r requirements.txt
  3. Run python -OO core.py to generate the configuration file.
  4. Open the config folder and edit the config.ini file following the contained instructions.
    Ensure the is_template field is set to no.
  5. Run python -OO database.py to generate the database tables.
  6. Optional: customize the strings.py file
  7. Run python -OO core.py again to run the bot.
  8. Open Telegram, and send a /start command to your bot to be promoted to administrator.

Usage

All the bot features are available through Telegram. As the administrator, you can add new products, check the placed orders, create new transactions and generate .csv log files.
Users will be able to add credit to their wallet, place orders and contact you in case they require assistance.

Updating

Through git

If you downloaded greed through git, you can update it by running:

git stash
git pull
git stash pop

By redownloading the zip file

If you downloaded greed through the zip archive, you can update it by redownloading the latest version and by moving your config.ini and database.sqlite (if applicable) files to the new folder.

Documentation

greed currently does not have a documentation page, but you can try to read the paper (in Italian) I wrote for my final Scuola Superiore exam about it.

Help!

If you find a bug, have an idea for a new feature or just require help with greed, please post an issue on GitHub, or, if GitHub is blocked in your country, join our Telegram group and send a message there.

Forks

Please note that @Steffo99, the developer of greed, does not endorse any of these forks.

Bitcoin - Blockonomics

DarrenWestwood is currently maintaining a greed fork with Bitcoin support through Blockonomics.