Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Facebook-like timeline for Django admin

Project 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.



Starting from django-admin-timeline 1.7:

  • Django 1.8, 1.9, 1.10, 1.11, 2.0
  • Python 2.7, 3.4, 3.5, 3.6


Current version of django-admin-timeline (1.6.x) has the following prerequisites:

  • Django 1.4, 1.5, 1.6, 1.7, 1.8, 1.9, 1.10, 1.11, 2.0
  • Python 2.7, 3.3, 3.4, 3.5, 3.6

Dropping support of Django 1.4, 1.5, 1.6 and 1.7 has been announced in version 1.6. As of 1.6 everything is still backwards compatible with versions 1.4, 1.5, 1.6 and 1.7, but in future versions compatibility with these versions will be wiped out.

Dropping support of Python 2.6 and 3.3 has been announced in version 1.6. As of 1.6 everything is still backwards compatible with Python 2.6 and 3.3, but in future versions compatibility with these versions will be wiped out.


  1. Install in your virtual environment

    Latest stable version from PyPI:

    pip install django-admin-timeline

    Latest stable version from BitBucket:

    pip install

    Latest stable version from GitHub:

    pip install
  2. Add admin_timeline to your INSTALLED_APPS in the global

        # ...
       # ...
  3. Collect the static files by running (see the Troubleshooting section in case of problems):

    ./ collectstatic
  4. 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 displayed per page (for both non-AJAX and AJAX requests).

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

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


Live demo

See the live demo app on Heroku.


  • username: admin
  • password: test

Run demo locally

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 and run the latest

wget -O - | bash

Open your browser and test the app.

If quick installer doesn’t work for you, see the manual steps on running the example project.


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


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

An example application is available. See the example directory.


Project is covered by test (functional- and browser-tests). To test with all supported Python/Django versions type:


To test against specific environment, type:

tox -e py36-django111

To test just your working environment type:


It’s assumed that you have all the requirements installed. If not, first install the test requirements:

pip install -r examples/requirements/testing.txt

Browser tests

For browser tests you may choose between Firefox, headless Firefox and PhantomJS. PhantomJS is faster, headless Firefox is fast as well, but normal Firefox tests tell you more (as you see what exactly happens on the screen). Both cases require some effort and both have disadvantages regarding the installation (although once you have them installed they work perfect).

Latest versions of Firefox are often not supported by Selenium. Current version of the Selenium for Python (2.53.6) works fine with Firefox 47. Thus, instead of using system Firefox you could better use a custom one.

For PhantomJS you need to have NodeJS installed.

Set up Firefox 47

  1. Download Firefox 47 from this location and unzip it into /usr/lib/firefox47/

  2. Specify the full path to your Firefox in FIREFOX_BIN_PATH setting. Example:

    FIREFOX_BIN_PATH = '/usr/lib/firefox47/firefox'

    If you set to use system Firefox, remove or comment-out the FIREFOX_BIN_PATH setting.

After that your Selenium tests would work.

Set up headless Firefox

  1. Install xvfb package which is used to start Firefox in headless mode.

    sudo apt-get install xvfb
  2. Run the tests using headless Firefox.


    Or run tox tests using headless Firefox.


Setup PhantomJS

You could also run tests in headless mode (faster). For that you will need PhantomJS.

  1. Install PhantomJS and dependencies.

    curl -sL -o
    sudo bash
    sudo apt-get install nodejs
    sudo apt-get install build-essential libssl-dev
    sudo npm -g install phantomjs-prebuilt
  2. Specify the PHANTOM_JS_EXECUTABLE_PATH setting. Example:


    If you want to use Firefox for testing, remove or comment-out the PHANTOM_JS_EXECUTABLE_PATH setting.


GPL 2.0/LGPL 2.1


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


Artur Barseghyan <>


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django_admin_timeline-1.6.2-py2.py3-none-any.whl (94.3 kB) Copy SHA256 hash SHA256 Wheel 3.6 Jan 8, 2018
django-admin-timeline-1.6.2.tar.gz (88.7 kB) Copy SHA256 hash SHA256 Source None Jan 8, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page