skip to navigation
skip to content

Not Logged In

django-admin-timeline 1.3

Facebook-like timeline for Django admin

Package Documentation

Package

django-admin-timeline

Description

A Facebook-like timeline app for Django admin. It's very similar to built-in feature Daily progress, but then has a nicer templates and infinite scroll implemented. Actions are broken up by day, then by action. Filtering by user (multiple select) and content type (multiple select) is implemented.

Prerequisites

  • Django 1.5.+, 1.6.+
  • Python 2.6.8+, 2.7.+, 3.3.+

Installation

  1. Install in your virtual environemnt

Latest stable version from PyPI:

$ pip install django-admin-timeline

Latest stable version from bitbucket:

$ pip install -e hg+http://bitbucket.org/barseghyanartur/django-admin-timeline@stable#egg=django-admin-timeline

Latest stable version from github:

$ pip install -e git+https://github.com/barseghyanartur/django-admin-timeline@stable#egg=django-admin-timeline
  1. Add admin_timeline to your INSTALLED_APPS in the global settings.py.
>>> INSTALLED_APPS = (
>>>     # ...
>>>     'admin_timeline',
>>>     # ...
>>> )
  1. Collect the static files by running (see the Troubleshooting section in case of problems):

    $ ./manage.py collectstatic

  2. Override app settings in your global settings module (see the apps.admin_timeline.defaults for the list of settings). As for now, most important of those is NUMBER_OF_ENTRIES_PER_PAGE - number of entries displayer per page (for both non-AJAX and AJAX requests).

  3. Add the following lines to the global urls module:

>>> # Admin timeline URLs. Should be placed BEFORE the Django admin URLs.
>>> (r'^admin/timeline/', include('admin_timeline.urls')),
>>> url(r'^admin/', include(admin.site.urls)),

Demo

In order to be able to quickly evaluate the django-admin-timeline, a demo app (with a quick installer) has been created (works on Ubuntu/Debian, may work on other Linux systems as well, although not guaranteed). Follow the instructions below for having the demo running within a minute.

Grab the latest django_admin_timeline_example_app_installer.sh:

$ wget https://raw.github.com/barseghyanartur/django-admin-timeline/stable/example/django_admin_timeline_example_app_installer.sh

Assign execute rights to the installer and run the django_admin_timeline_example_app_installer.sh:

$ chmod +x django_admin_timeline_example_app_installer.sh

$ ./django_admin_timeline_example_app_installer.sh

Open your browser and test the app.

If quick installer doesn't work for you, see the manual steps on running the example project (https://github.com/barseghyanartur/django-admin-timeline/tree/stable/example).

Screenshots

Screenshots are available in documentation:

Troubleshooting

If somehow static files are not collected properly (missing admin_timeline.js and admin_timeline.css files), install the latest stable version from source.

$ pip install -e hg+http://bitbucket.org/barseghyanartur/django-admin-timeline@stable#egg=django-admin-timeline

Usage

After following all installation steps, you should be able to access the admin-timeline by:

http://127.0.0.1:8000/admin/timeline/

An example application is available. See the following directory: https://github.com/barseghyanartur/django-admin-timeline/tree/stable/example

License

GPL 2.0/LGPL 2.1

Support

For any issues contact me at the e-mail given in the Author section.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>

 
File Type Py Version Uploaded on Size
django-admin-timeline-1.3.tar.gz (md5) Source 2013-11-22 47KB
  • Downloads (All Versions):
  • 57 downloads in the last day
  • 285 downloads in the last week
  • 814 downloads in the last month