Skip to main content

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.

Prerequisites

Present

Starting from django-admin-timeline 1.7:

  • Django 1.8, 1.9, 1.10

  • Python 2.7, 3.4, 3.5

Past

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

  • Django 1.4, 1.5, 1.6, 1.7, 1.8, 1.9, 1.10

  • Python >=2.6.8, 2.7, 3.3, 3.4, 3.5

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.

Installation

  1. Install in your virtual environment

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 https://github.com/barseghyanartur/django-admin-timeline/archive/stable.tar.gz
  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
  1. 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).

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

Live demo

See the live demo app on Heroku.

Credentials:

  • 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 the latest django_admin_timeline_example_app_installer.sh:

wget https://raw.github.com/barseghyanartur/django-admin-timeline/stable/examples/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.

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 https://github.com/barseghyanartur/django-admin-timeline/archive/stable.tar.gz

Usage

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

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

An example application is available. See the example directory.

Testing

Simply type:

./runtests.py

or use tox:

tox

or use tox to check specific env:

tox -e py35

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>

Screenshots

https://github.com/barseghyanartur/django-admin-timeline/raw/master/docs/_static/admin_timeline.png

Project details


Download files

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

Source Distribution

django-admin-timeline-1.6.tar.gz (86.7 kB view details)

Uploaded Source

Built Distribution

django_admin_timeline-1.6-py2.py3-none-any.whl (92.0 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-admin-timeline-1.6.tar.gz.

File metadata

File hashes

Hashes for django-admin-timeline-1.6.tar.gz
Algorithm Hash digest
SHA256 6e7cb86ea67a11c941e529722392a4fed4e9ab0ae6d154eb594423d0bc4caa44
MD5 8f134631ea481b690215f7741912ac11
BLAKE2b-256 1e2b2c831676800fc666b001066c824e7936be5871e06141745bdc5fa721bcc1

See more details on using hashes here.

File details

Details for the file django_admin_timeline-1.6-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_admin_timeline-1.6-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8dabc44bc5ad31f26206cabcaff5cbdbece09c24995d04e318505f9ada7fee45
MD5 5de7800a881d8953e2127a99413f9cd9
BLAKE2b-256 91c73a0ecd3104e828b981b071bec0aae73cfe602ca2eaf89b32604c3c9bc4e6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page