Installation

To install the dasf-broker-django package for your Django project, you need to follow two steps:

1. Install the package

2. Add the app to your Django project

Installation from PyPi

The recommended way to install this package is via pip and PyPi via:

pip install dasf-broker-django

Or install it directly from the source code repository on Gitlab via:

pip install git+https://gitlab.hzdr.de/hcdc/django/dasf-broker-django.git

The latter should however only be done if you want to access the development versions.

Install the Django App for your project

To use the dasf-broker-django package in your Django project, you need to add the app to your INSTALLED_APPS, configure your urls.py, run the migration, add a login button in your templates. Here are the step-by-step instructions:

1. Add the dasf_broker app to your INSTALLED_APPS

2. in your projects urlconf (see :setting:`ROOT_URLCONF`), add include dasf_broker.urls via:

   from django.urls import include, path
   
   urlpatterns += [
       path("dasf-broker-django/", include("dasf_broker.urls")),
    ]
   

3. Run python manage.py migrate to add models to your database

4. Configure the app to your needs (see Configuration options).

That’s it! For further adaption to you Django project, please head over to the Configuration options. You can also have a look into the testproject in the source code repository for a possible implementation.

Installation for development

Please head over to our contributing guide for installation instruction for development.