Extracted from Django 1.4 since databrowse deprecation
Databrowse is a Django application that lets you browse your data.
As the Django admin dynamically creates an admin interface by introspecting your models, Databrowse dynamically creates a rich, browsable Web site by introspecting your models.
django-databrowse is available on pypi
So easily install it by pip
$ pip install django-databrowse
Or by easy_install
$ easy_install django-databrowse
Another way is by cloning django-databrowse's git repo
$ git clone git://github.com/Alir3z4/django-databrowse.git
Then install it by running:
$ python setup.py install
Point Django at the default Databrowse templates. There are two ways to do this:
- Add 'django_databrowse' to your INSTALLED_APPS setting. This will work if your TEMPLATE_LOADERS setting includes the app_directories template loader (which is the case by default). See the template loader docs for more.
- Otherwise, determine the full filesystem path to the django_databrowse/templates directory, and add that directory to your TEMPLATE_DIRS setting.
Register a number of models with the Databrowse site:
import django_databrowse from myapp.models import SomeModel, SomeOtherModel, YetAnotherModel django_databrowse.site.register(SomeModel) django_databrowse.site.register(SomeOtherModel, YetAnotherModel)
Note that you should register the model classes, not instances.
it is possible to register several models in the same call to django_databrowse.site.register.
It doesn't matter where you put this, as long as it gets executed at some point. A good place for it is in your URLconf file (urls.py).
Change your URLconf to import the ~django_databrowse module:
...and add the following line to your URLconf:
The prefix doesn't matter -- you can use databrowse/ or db/ or whatever you'd like.
Run the Django server and visit /databrowse/ in your browser.
You can restrict access to logged-in users with only a few extra lines of code. Simply add the following import to your URLconf:
from django.contrib.auth.decorators import login_required
Then modify the URLconf so that the django_databrowse.site.root view is decorated with django.contrib.auth.decorators.login_required:
The final step is to create the login form required by django.contrib.auth.views.login. The user authentication docs provide full details and a sample template that can be used for this purpose.