django-wpadmin 1.8.0
WordPress look and feel for Django administration panel.
License: MIT License
Keywords: wordpress django admin

===============
Django WP Admin
===============

----------------------------------------------------------------------------------------------------------------------
`WordPress <http://wordpress.org/>`_ look and feel for `Django <http://www.djangoproject.com/>`_ administration panel.
----------------------------------------------------------------------------------------------------------------------

.. image:: https://raw.github.com/barszczmm/django-wpadmin/master/docs/images/django-wpadmin.png


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 <http://fontawesome.io/>`_ 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
----
* 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 <https://github.com/sehmaschine/django-filebrowser>`_ or `django-filer <https://github.com/stefanfoulis/django-filer>`_ support
* `django-mptt <https://github.com/django-mptt/django-mptt>`_ support
* Optional templates for `django-rosetta <https://github.com/mbi/django-rosetta>`_


Demo
----
Try ``test_project`` `here <http://django-wpadmin.dev.barszcz.info>`_ or download `django-wpadmin <https://github.com/barszczmm/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 <https://pypi.python.org/pypi/django-wpadmin>`_::

    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 <https://docs.djangoproject.com/en/dev/ref/templates/api/#django-core-context-processors-request>`_ to `TEMPLATE_CONTEXT_PROCESSORS <https://docs.djangoproject.com/en/dev/ref/settings/#std:setting-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 <http://django-wp-admin.readthedocs.org>`_ for details (there is also **changelog** there).


Translations
------------

`Many translations are already available <http://django-wp-admin.readthedocs.org/en/master/translations.html>`_ 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/ <https://www.transifex.com/projects/p/django-wp-admin/>`_


Troubleshooting
---------------

Please create an `issue on GitHub <https://github.com/barszczmm/django-wpadmin/issues>`_ if you have any problems or requests.


Credits
-------

Python code is based on `django-admin-tools <https://bitbucket.org/izi/django-admin-tools/wiki/Home>`_ app.

WordPress look and feel is of course inspired by `WordPress <http://wordpress.org/>`_.

Included icons comes from `Font Awesome <http://fontawesome.io/>`_.



Changelog
---------

v1.8.0 (2020-04-15)
~~~~~~~~~~~~~~~~~~~

* merged template changes from Django 1.8
* testing project updated for Django 1.8


v1.7.4 (2015-05-08)
~~~~~~~~~~~~~~~~~~~

* small updates in styles
* typo fixed in one translation
* requirements in test project updated


v1.7.3 (2015-04-20)
~~~~~~~~~~~~~~~~~~~

* another fix for small visual regression


v1.7.2 (2015-03-24)
~~~~~~~~~~~~~~~~~~~

* fixed small visual regression
* added Dutch translation (thanks to Rico Moorman)


v1.7.1 (2015-03-23)
~~~~~~~~~~~~~~~~~~~

* change list page template modified to include object-tools and object-tools-items blocks
* styles modified to style added blocks
* small cleanup in some templates
* added new translations: Bulgarian (thanks to Metodi Dejanov), French (thanks to qmarlats), Portuguese (Brazil) (thanks to Kaio Henrique).
* updated docs about translations
* Font Awesome updated to version 4.3.0
* Less updated to version 2.4.0


v1.7.0 (2014-11-24)
~~~~~~~~~~~~~~~~~~~

* merged template changes from Django 1.7
* using new features (site_header and site_title) of AdminSite from Django 1.7
* testing project updated for Django 1.7
* small updates in styles


v1.6.3 (2014-11-20)
~~~~~~~~~~~~~~~~~~~

* fix for tabular inlines
* added sample tabular and stacked inlines in test project
* added new translations: German (thanks to Silasoa), Indonesian (thanks to Al Firdaus), Italian (thanks to Giuseppe Pignataro), Russian (thanks to Eugene MechanisM).
* updated docs about translations
* Font Awesome updated to version 4.2.0
* Less updated to version 2.0.0
* jQuery Cookie plugin updated to version 1.4.1
* added 2 new color themes: milo and milo-light


v1.6.2 (2014-03-21)
~~~~~~~~~~~~~~~~~~~

* fix for top menu hover colors in themes
* added color theme chooser on user panel in test project


v1.6.1 (2014-03-13)
~~~~~~~~~~~~~~~~~~~

* Python3 compatibility
* updated templates for password reset and change (from /registration template path)
* updated template for login page to make it more consistent with rest of the pages
* fixed bug with submenu when left menu is folded
* more fixes for small resolutions screens
* proper login forms in test project used


v1.6.0 (2014-03-11)
~~~~~~~~~~~~~~~~~~~

* **backward compatibility breaking release!**
* most of things was rewritten
* from now on there will be separate branch for each major Django version and Django WP Admin will be versioned according to Django version it supports...
* ...so this version is compatible only with Django 1.6.x
* all JavaScript libraries updated
* FontAwesome updated to version 4.0.3
* new WordPress admin look
* styles for selector widget
* styles for calendar widget
* styles for timepicker widget
* styles for delete confirmation page
* styles for history page
* collapsible fieldsets can be opened by default
* support for nested submenus
* 7 additional color themes added
* added licenses for all included external files (fonts and JS)


v0.2.0 (2013-04-02)
~~~~~~~~~~~~~~~~~~~

* styled object's editing pages


v0.1.2 (2013-03-23)
~~~~~~~~~~~~~~~~~~~

* **Django 1.3 support dropped!** (there's too much differences between Django 1.3 and 1.4)
* installation process slightly changed (there's no need to copy or symlink base.html file for specific Django version)
* added WordPress look and feel for objects lists (change_list.html)
* CHANGELOG added


v0.1.1 (2013-03-19)
~~~~~~~~~~~~~~~~~~~

* installation scripts
* README and LICENSE files added


v0.1.0 (2013-03-19)
~~~~~~~~~~~~~~~~~~~

* top and left menu