django-simple-admin-overlay 0.2

Lightweight Django app which displays simple overlay with admin links on the frontend pages.

# Django Simple Admin Overlay

**Lightweight Django app which displays simple overlay with admin links on the frontend pages.**

Django Simple Admin Overlay replaces the need to manually append `/admin` to the browser's URL bar or to bookmark the administration link during the development of Django projects.

Version: 0.2

# Screenshots

### Position: top, state: open


### Position: top, state: closed


# Requirements

* Python (3.5)
* Django (1.10)

Currently tested only on the above noted versions of Python and Django. Will test further with older versions and update the list.

# Installation

Install using `pip`

pip install django-simple-admin-overlay

Add `'simple_admin_overlay'` to your `INSTALLED_APPS` setting

INSTALLED_APPS = (
...
'simple_admin_overlay',
)

Enable `simple_admin_overlay` middleware

MIDDLEWARE = [
...
'simple_admin_overlay.middleware.SimpleAdminOverlayMiddleware',
]

# Configuration

You can change a limited number of options by adding `SIMPLE_ADMIN_OVERLAY_CONFIG` dictionary to your `settings.py`.

Default values are:

SIMPLE_ADMIN_OVERLAY_CONFIG = {
'OVERLAY_POSITION': 'top',
'DEFAULT_STATE': 'open',
'SHOW_APPS_ONLY': False,
'EXCLUDE_APPS': [],
'EXCLUDE_MODELS': {},
}

#### `OVERLAY_POSITION (default='top')`
Defines the display positioning of the fixed overlay.

Available values: `top`, `right`, `bottom`, `left`

#### `DEFAULT_STATE (default='open')`
Defines the default state of the overlay, i.e. will it be shown or hidden on page load.

Available values: `open`, `closed`

#### `SHOW_APPS_ONLY (default=False)`
If set to `True` only the application links will be shown, i.e. model links will be hidden.

#### `EXCLUDE_APPS (default=[])`
Applications defined within this list will not be listed in the overlay. Use the same application name format as used in the `INSTALLED_APPS` setting.

#### `EXCLUDE_APPS (default={})`
Models defined within this dictionary will not be listed in the overlay. Use the same model name format as the name of the classes within `models.py`.

Example:

EXCLUDE_MODELS': {
'spam_app': ['spamAppModel', 'AnotherSpamAppModel'],
'eggs_app': ['EggsAppModel'],
}


# Common issues

Make sure that you're logged in as an authenticated user and have access to the admin interface, i.e. that your `User` instance has `is_authenticated=True` and `is_staff=True`

# To-do list

- Add `DEVELOPMENT_MODE` option which would depend on the `DEBUG` setting
- Persist toolbar state (open, closed) via cookie or local storage