gas/readme.md

1.2 KiB

GAS

Generic Administration Sistem, an alternative to django admin with a set of generic views.

Instalation

  1. Install django-gas package:

    pip install django-gas

  2. Add 'gas' to INSTALLED_APPS

  3. Add gas urls to project's urls.py:

    import gas.sites

    urlpatterns = [ path('control-panel/', include(gas.sites.site.urls)), ]

  4. Run python manage.py migrate

Configuration

Project settings can customize the gas control panel:

  • GAS_TITLE: Name of the control panel.
  • GAS_LOGO: Icon for the control panel.
  • GAS_MEDIA: A django form's Media like dict with css and js files.

The default values of those settings can be viewed in the gas/gas_settings.py file.

Integration

Create a submodule gas.config in your django app.

    -\ yourapp
        \gas
            __init__.py
            config.py
        admin.py
        models.py
        ...

Edit this config.py file to register your code into gas. For examples look at gas.gas.config and gas.gas.users modules.

Licenses

The license of the code is GPLv3, but in the gas/static/vendor folder there is some external code with different licenses.