django-cool-pagination

django-cool-pagination is simple pagination app that saves your time.

Prerequisites

Currently it supports Bootstrap 4.x only. So that you have to add Bootstrap 4 to your project.

Features

Dynamic query string creation
Length auto control
Fully customizable (aspiring)

Installation

Installing

pip

pip install django-cool-pagination

setup.py

git clone https://github.com/joe513/django-cool-pagination.git
cd django-cool-pagination
python setup.py install

Setting up

Add to `INSTALLED_APPS`

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    
    'django_cool_paginator'

Make sure `request` is in `context_processors`

    'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',

Using

View

FBV (Function based view)

def listing(request):
    contact_list = Contact.objects.all()
    paginator = Paginator(contact_list, 25)

    page = request.GET.get('page')
    page_obj = paginator.get_page(page)
    return render(request, 'list.html', {'page_obj': page_obj})

CBV (Class based view)

class Listing(ListView):
    model = Item
    paginate_by = 5

Template

{% load cool_paginate %}

{% for contact in page_obj %}
    ...
{% endfor %}

{% cool_paginate page_obj=ENTER HERE YOUR PAGE OBJECT! %}

Note: You don't have to specify page if its name is page_obj as default.

Customization

You can customize it so that it works as you want. Customize it by defining settings either in setting.py or inside of {% cool_paginate %}

setting.py

COOL_PAGINATOR_NEXT_NAME - Name for "next" button in pagination bar. COOL_PAGINATOR_PREVIOUS_NAME - Name for "previous" button in pagination bar COOL_PAGINATOR_SIZE - Size of pagination bar (choose: "LARGE" or "SMALL") COOL_PAGINATOR_ELASTIC - What page width is elastic mode enabled from?

{% cool_paginate page_obj next_name previous_name size elastic %}

page_obj - Type here your page object. next_name - Name for "next" button in pagination bar. previous_name - Name for "previous" button in pagination bar size - Size of pagination bar (choose: "LARGE" or "SMALL") elastic - What page width is elastic mode enabled from?