Go to file
Ales (Shagi) Zabala Alava 312987410b chore: Bump version 0.8.13 2023-12-19 10:57:43 +01:00
gas fix: set html email template 2023-12-19 10:55:42 +01:00
.drone.yml Drone integration fix 2020-12-21 19:01:13 +01:00
.gitignore feat: Add reset password (#5) 2023-12-14 17:53:08 +01:00
LICENSE.txt Initial Commit 2020-12-21 18:51:59 +01:00
MANIFEST.in Add locale files to package 2021-04-14 17:42:21 +02:00
changelog.md chore: Bump version 0.8.13 2023-12-19 10:57:43 +01:00
collaborators.md chore: Bump version 0.8.11 2023-12-14 17:54:11 +01:00
readme.md Make user admin section optional 2021-05-11 16:20:01 +02:00
requirements.txt chore: support Django 4.2 2023-10-26 15:40:59 +02:00
runtests.py Allow overriding home url 2022-09-01 11:24:01 +02:00
setup.cfg chore: Bump version 0.8.13 2023-12-19 10:57:43 +01:00
setup.py Initial Commit 2020-12-21 18:51:59 +01:00
test_requirements.txt Initial Commit 2020-12-21 18:51:59 +01:00

readme.md

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. Overrides default css and javascript.
  • GAS_EXTRA_MEDIA: A django form's Media like dict with css and js files. Extends current css and javascript instead of overriding.

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.

Gas comes with a basic user management. To enable this section, import gas.gas.users_config from any gas.config of your installed apps.

To enable the urls but keep the section out of the menu, just add this to your gas.config:

site.register_urls('users', 'gas.gas.users.urls')

Licenses

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