======================
Django Range Paginator
======================

This Django app provides a templatetag to render pagination widgets which
include a range of pages around the current active one.

.. image:: /_static/example.png


Installation
============

.. code-block:: shell

   pip install django_rangepaginator


Update your Django settings:

.. code-block:: python


    INSTALLED_APPS += [
        'django_rangepaginator'
    ]


Usage
=====
.. code-block:: django

    {% load rangepaginator %}
    {% paginate page distance=2 edge=2 request=request %}

The following options are available:

- distance: number of pages around current active one (default = 2) 
- edge: number of pages at the start and end (default = 1)
- extra_class: add extra css classes to the pagination div (default = '')
- text_labels: use strings for previous/next instead of symbols (default = True)
 
Demo
====
A sandbox environment is available in the repository, run the following:
 
.. code-block:: shell
   
   ./sandbox/manage.py migrate
   ./sandbox/manage.py runserver

Bugs/features
=============

Let me know! :-)