Test the site here!

• http://146.168.166.228/

HOW TO RUN

PREREQUISITES:

• you need to have Python3 installed. If you are on debian you also need python3-venv.

SETTING UP THE VIRTUAL ENVIRONMENT:

• you will also need to recreate the venv folder. you can do this by running (in the project folder):

[in terminal (linux)]

    source venv/bin/activate

[in cmd.exe (windows)]

    venv\Scripts\activate.bat

[in PowerShell (windows)]

    venv\Scripts\activate.ps1

• once you are in the virtual environment, you will then need to run the following command:

    pip install flask flask_sqlalchemy flask_login flask_dance flask_migrate python-dotenv

• once all of the prerequisites are installed, you will need to set up the .env file.

SETTING UP THE .ENV FILE

• first you will need to set up a discord bot, you can do this from the discord developer portal:

  • https://discord.com/developers/applications/

• in the oauth2 tab once the bot is created, you will need to add the following url to redirects:

  • http://localhost:5001/login/discord/authorized

you will then need to fill in the .env file (rename .env.example to .env) parameters with the following information:

FLASK_SECRET_KEY=
    - this should be a randomly generated key, it can be whatever you'd like.

DISCORD_CLIENT_ID=
    - the client ID of your discord bot.

DISCORD_CLIENT_SECRET=
    - the client secret for your discord bot.

OAUTHLIB_INSECURE_TRANSPORT=1
    - leave this at 1 for testing, this allows the discord bot to authorize requests coming from an insecure domain

MODERATOR_IDS=
    - the discord ID's for any user you want to have moderator permissions. this allows the specified users to remove, restore, and permanently delete posts.

RUNNING THE SITE

• once all of the other steps are complete, run the following command in the project folder (and while still in the virtual environment):

    python app.py

• once it's all initialized, go to the following page to test the site:

  • http://localhost/

OTHER NOTES

• To initialize flask migration run:

    flask db init

• To migrate databases (if a major change in the python code is done) run in the project folder:

    flask db migrate -m "whatever message you want"

    flask db upgrade

• To migrate databases (if a major change in the python code is done) run in the project folder:

    flask db migrate -m "whatever message you want"

    flask db upgrade

that should be it! if you have any issues contact me on discord. my username is coo29.