Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/barszczmm/django-wpadmin

WordPress look and feel for Django administration panel
https://github.com/barszczmm/django-wpadmin

css django django-admin python wordpress

Last synced: about 1 month ago
JSON representation

WordPress look and feel for Django administration panel

Host: GitHub
URL: https://github.com/barszczmm/django-wpadmin
Owner: barszczmm
License: other
Created: 2013-01-09T02:18:35.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2020-05-01T18:46:52.000Z (over 4 years ago)
Last Synced: 2024-04-12T22:30:09.589Z (5 months ago)
Topics: css, django, django-admin, python, wordpress
Language: Python
Homepage: http://django-wpadmin.dev.barszcz.info/
Size: 1.87 MB
Stars: 265
Watchers: 21
Forks: 79
Open Issues: 16
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt

Awesome Lists containing this project

README

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

----------------------------------------------------------------------------------------------------------------------
`WordPress `_ look and feel for `Django `_ 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 `_ 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 `_.