This project contains the CMS to provide the OIM Extranet site, which is based upon the Wagtail CMS.

The recommended way to set up this project for development is using Poetry to install and manage a virtual Python environment. With Poetry installed, change into the project directory and run:

poetry install

To run Python commands in the virtualenv, thereafter run them like so:

poetry run python manage.py

Manage new or updating project dependencies with Poetry also, like so:

poetry add newpackage==1.0

This project uses environment variables (in a .env file) to define application settings. Required settings are as follows:

DATABASE_URL="postgis:https://USER:PASSWORD@HOST:PORT/DATABASE_NAME"
SECRET_KEY="ThisIsASecretKey"

Use runserver to run a local copy of the application:

poetry run python manage.py runserver 0:8080

Run console commands manually:

poetry run python manage.py shell_plus

To build a new Docker image from the Dockerfile:

docker image build -t dbcawa/oim-cms .