django-admin-timeline 1.5.1

Facebook-like timeline for Django admin
===================================
django-admin-timeline
===================================
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.4, 1.5, 1.6, 1.7, 1.8
- Python >=2.6.8, 2.7, 3.3

Installation
===================================
1. Install in your virtual environemnt

Latest stable version from PyPI:

.. code-block::

    $ pip install django-admin-timeline

Latest stable version from bitbucket:

.. code-block::

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

Latest stable version from github:

.. code-block::

    $ pip install -e git+https://github.com/barseghyanartur/django-admin-timeline@stable#egg=django-admin-timeline

3. Add `admin_timeline` to your `INSTALLED_APPS` in the global settings.py.

.. code-block:: python

    INSTALLED_APPS = (
        # ...
        'admin_timeline',
       # ...
    )

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

.. code-block::

    $ ./manage.py collectstatic

5. 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).

6. Add the following lines to the global ``urls`` module:

.. code-block:: python

    # 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
<https://django-admin-timeline.herokuapp.com/admin/timeline/>`_ 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`:

.. code-block::

    $ 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`:

.. code-block::

    $ chmod +x django_admin_timeline_example_app_installer.sh

    $ ./django_admin_timeline_example_app_installer.sh

Open your browser and test the app.

- URL: http://127.0.0.1:8001/admin/timeline/
- Admin username: admin
- Admin password: test

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>`_.

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.

.. code-block::

    $ 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
`django-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>

Screenshots
===================================

.. figure:: https://github.com/barseghyanartur/django-admin-timeline/raw/master/docs/_static/admin_timeline.png
    :align: center
    :width: 900px
GPL 2.0/LGPL 2.1

Author

Artur Barseghyan

Pip

django-admin-timeline==1.5.1

Classifiers

  • Development Status :: 5 - Production/Stable
  • Environment :: Web Environment
  • Framework :: Django
  • Intended Audience :: Developers
  • Operating System :: OS Independent
  • Programming Language :: Python
  • Programming Language :: Python :: 2.6
  • Programming Language :: Python :: 2.7
  • Programming Language :: Python :: 3
  • Programming Language :: Python :: 3.3
  • License :: OSI Approved :: GNU General Public License v2 (GPLv2)
  • License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
File Type Python Version Uploaded On Downloads
django_admin_timeline-1.5.1-py2.py3-none-any.whl Wheel 2.7 March 15, 2015 658
django-admin-timeline-1.5.1.tar.gz Source March 15, 2015 652
Version Release Date
1.5.1 March 15, 2015
1.5 March 15, 2015
1.4 Oct. 31, 2014
1.3 Nov. 22, 2013
1.2 Oct. 9, 2013
1.1 Oct. 7, 2013
1.0 Sept. 9, 2013
0.9 Aug. 1, 2013
0.8 July 4, 2013
0.7 July 4, 2013
0.6 June 22, 2013
Date Package Version Action
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 0.9 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 0.8 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 0.6 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 0.7 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.5.1 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.3 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.2 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.1 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.0 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.5 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline 1.4 Release Created
Aug. 24, 2015, 10:58 p.m. django-admin-timeline Package Created