Metadata-Version: 2.1
Name: django-fhadmin
Version: 2.2.2
Summary: Modifies the stock Django-Administration interface to fit our ideas a little bit better.
Home-page: http://github.com/feinheit/django-fhadmin/
Author: Matthias Kestenholz
Author-email: mk@feinheit.ch
License: BSD-3-Clause
Platform: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: Django (>=3.2)
Provides-Extra: tests
Requires-Dist: coverage ; extra == 'tests'

Django-FHAdmin
==============

Modifies the stock Django-Administration interface to fit our ideas a little
bit better.


Dashboard and global navigation extension
-----------------------------------------

Allows grouping of apps on the dashboard and offers the same view on each
admin page when clicking the main title of the Django admin interface.

App label entries without a matching app are ignored. A configuration example
follows:

.. code-block:: python

    from fhadmin import FHADMIN_GROUPS_REMAINING
    _ = lambda x: x

    FHADMIN_GROUPS = [
        (_('Main content'), ('page', 'medialibrary', 'blog')),
        (_('Modules'), ('links', FHADMIN_GROUPS_REMAINING)),
        (_('Preferences'), ('auth', 'rosetta', 'external', 'sites')),
    ]


The extension is activated by inserting ``fhadmin`` before
``django.contrib.admin`` in ``INSTALLED_APPS``.


Merging apps
------------

Merging apps is possible as follows:

.. code-block:: python

    FHADMIN_MERGE = {"accounts": "auth"}

This example moves all models from the ``accounts`` app to the ``auth``
heading. Both app labels have to exist. Note that this only changes the start
page of the Django admin panel and of course the global navigation. Note that
strange things (or worse) may happen if the user has access to only one or the
other app.


