README.rst

Django WP Admin

WordPress look and feel for Django administration panel.

Features

• WordPress look and feel
• New styles for selector, calendar and timepicker widgets
• More responsive (admin panel should look fine and be usable on displays with minimum 360px width)
• Editable top menu
• Optional fully configurable left menu
• Left menu can be pinned (fixed CSS position) or unpinned and collapsed or expanded
• Awesome Font Awesome icons supported in both menus
• Multiple AdminSite's support with possibility to have different menus, colors and titles for each one
• 9 additional color themes included
• Collapsible fieldsets can be opened by default
• Python3 compatible

Django compatibility

On GitHub there is specific branch of Django WP Admin for each major Django version and master branch is always for current stable Django. Releases on PyPI have numbering matching proper Django versions, so for instance for Django 1.7.x you should install Django WP Admin 1.7.y (pip install "django-wpadmin>=1.7,<1.8"). Branches of Django WP Admin for Django older than current stable usually will not have new features added, only bugs will be fixed. Only version for current stable Django will have new features, but any pull requests for older branches are welcome.

TODO

• Add support (in 3.0.x branch) for Django 3.0
• Host test project on PythonAnywhere or Heroku
• Add support (in 2.2.x branch) for Django 2.2
• Add support (in 1.11.x branch) for Django 1.11
• Add support (in 1.9.x branch) for Django 1.9
• Make sure everything works fine with GeoDjango
• Do not rely on Django admin styles, move everything to Django WP Admin styles.
• Better documentation
• django-filebrowser or django-filer support
• django-mptt support
• Optional templates for django-rosetta

Demo

Try test_project here or download django-wpadmin from GitHub and run it on your own machine. test_project contains SQLite database file with prepopulated sample data.

Installation

• Install django-wpadmin from PyPI:

  pip install django-wpadmin
  

• Or from GitHub:

  pip install git+https://github.com/barszczmm/django-wpadmin.git#egg=django-wpadmin
  

Basic configuration

• Add wpadmin to your INSTALLED_APPS before django.contrib.admin:

  INSTALLED_APPS = (
      # Django WP Admin must be before django.contrib.admin
      'wpadmin',
  )
  

• Add django.core.context_processors.request to TEMPLATE_CONTEXT_PROCESSORS setting.

Documentation

Basic configuration above will only change look of Django's admin page, but there's much more you can do with Django WP Admin. Check out documentation on Read the Docs for details (there is also changelog there).

Translations

Many translations are already available thanks to good people that helped. If you want to help to translate this software, please join me on Transifex: transifex.com/projects/p/django-wp-admin/

Troubleshooting

Please create an issue on GitHub if you have any problems or requests.

Credits

Python code is based on django-admin-tools app.

WordPress look and feel is of course inspired by WordPress.

Included icons comes from Font Awesome.