Go to file
Ales (Shagi) Zabala Alava 3a89537a0c Allow overriding home url 2022-09-01 11:24:01 +02:00
gas Allow overriding home url 2022-09-01 11:24:01 +02:00
.drone.yml Drone integration fix 2020-12-21 19:01:13 +01:00
.gitignore Initial Commit 2020-12-21 18:51:59 +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 Bumb version 0.8.5 2022-07-26 09:10:08 +02:00
collaborators.md Add Shakarina to collaborators, thanks! 2021-05-12 19:12:56 +02:00
readme.md Make user admin section optional 2021-05-11 16:20:01 +02:00
requirements.txt Updgrade django version in requirements.txt 2022-07-01 09:31:31 +02:00
runtests.py Allow overriding home url 2022-09-01 11:24:01 +02:00
setup.cfg Bumb version 0.8.5 2022-07-26 09:10:08 +02: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.