Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pydanny/dj-paginator

Django + Pagination made easy.
https://github.com/pydanny/dj-paginator

Last synced: 3 months ago
JSON representation

Django + Pagination made easy.

Awesome Lists containing this project

README

        

=============================
dj-paginator
=============================

.. image:: https://badge.fury.io/py/dj-paginator.png
:target: https://badge.fury.io/py/dj-paginator

.. image:: https://travis-ci.org/pydanny/dj-paginator.png?branch=master
:target: https://travis-ci.org/pydanny/dj-paginator

A super-simple set of pagination tools for Django 1.8+

Documentation
------------------

The full documentation will soon be at https://dj-paginator.readthedocs.io.

Features
--------

* Super simple code base.
* Easy to create and switch themes.
* Really good documentation! (coming soon)
* Really good tests! (coming soon)
* Class-Based View mixin so you don't need to load template tags (coming soon)

Quickstart
----------

Install dj-paginator::

pip install dj-paginator

In your installed apps::

INSTALLED_APPS = [
'paginator'
]

In your list view::

class MyListView(ListView):
model = MyModel
paginate_by = 10

In your list view template::

{% load paginator_tags %}

{% paginator %}

Done!

Switching to a new theme method 1
---------------------------------

::

# Currently defaults to bootstrap.
# I'll add foundation soon.
PAGINATOR_THEME = 'foundation'

Switching to a new theme method 2
---------------------------------

::

{% load paginator_tags %}

{# Is the default #}
{% bootstrap_paginator %}

{# For when I add the foundation theme#}
{% foundation_paginator %}