# 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