Django-maintenancemode allows you to temporary shutdown your site for maintenance work
Project description
django-maintenancemode is a middleware that allows you to temporary shutdown your site for maintenance work.
Logged in users having staff credentials can still fully use the site as can users visiting the site from an ip address defined in Django’s INTERNAL_IPS.
Installation
Download django-maintenancemode from http://pypi.python.org/pypi/django-maintenancemode or https://github.com/shanx/django-maintenancemode
Install using: python setup.py install or your prefered installer
In your Django settings file add maintenancemode to your MIDDLEWARE_CLASSES. Make sure it comes after Django’s AuthenticationMiddleware. Like so:
MIDDLEWARE_CLASSES = ( 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.middleware.doc.XViewMiddleware', 'maintenancemode.middleware.MaintenanceModeMiddleware', )django-maintenancemode works the same way as handling 404 or 500 error in Django work. It adds a handler503 which you can override in your main urls.py or you can add a 503.html to your templates directory.
In your Django settings file add a variable called MAINTENANCE_MODE. Setting this variable to True activates the middleware.
Configuration
If you do not configure the settings below in your own project settings.py, they assume default values:
MAINTENANCE_MODE
- Default:
False
Boolean. Enable/disable maintenance mode.
MAINTENANCE_IGNORE_URLS
- Default:
()
Sequence of URL path regexes to exclude from the maintenance mode.
Example:
MAINTENANCE_IGNORE_URLS = (
r'^/docs/.*',
r'^/contact'
)
Some observations
If user is logged in and staff member, the maintenance page is not displayed.
If user’s IP is in INTERNAL_IPS, the maintenance page is not displayed.
To override the default view which is used if the maintenance mode is enabled you can simply define a handler503 variable in your ROOT_URLCONF, similar to how you would customize other error handlers, e.g.:
handler503 = 'mysite.views.maintenance_mode'
Changes
0.10
Got rid of dependency on setuptools
Added ability to exclude specific paths from maintenance mode with the MAINTENANCE_IGNORE_URLS setting.
Use RequestContext when rending the 503.html template.
Use tox for running the tests instead of buildout.
Made sure the app runs on Django 1.4.
0.9.3
Minor documentation updates for the switch to github, expect more changes to follow soon.
0.9.2
Fixed an issue with setuptools, thanks for reporting this ksato9700
0.9.1
Tested django-maintenancemode with django-1.0 release (following the 1.0.X release branch)
Bundled buildout.cfg and bootstrap with the source version of the project, allowing repeatable buildout
The middleware now uses its own default config file, thanks to a patch by semente
Use INTERNAL_IPS to check for users that need access. user.is_staff will stay in place for backwards incompatibility. Thanks for the idea Joshua Works
Have setup.py sdist only distribute maintenancemode itself, no longer distribute tests and buildout stuff
Use README and CHANGES in setup.py’s long_description, stolen from Jeroen’s djangorecipe :)
Updated the documentation and now use pypi as the documentation source (link there from google code)
0.9
First release
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-maintenancemode-0.10.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c211a951606420de2f397eb5cded991ba09f4056fb0b98a9f683899c191990bd |
|
| MD5 | 11f4ceddf439f0ecd3e30d1cc6c2c4ce |
|
| BLAKE2b-256 | 33e3aa4c8cda4c4e8cfe6455f79797b8ff79a5d09d8cbe6f586cf6f573548ef5 |
