django-smart-lists

from smart_lists.mixins import SmartListMixin

class AccountListView(LoginRequiredMixin, SmartListMixin, ListView):
    model = Account
    paginate_by = 100
    ordering_allowed_fields = ['company_name', 'code', 'created_date']
    list_display = ['company_name', 'code', 'created_date', 'balance']

This will give you a click-to-sort table with pagination. All you have to do is to make a template like this:

{% extends "base.html" %}
{% load smart_list %}

{% block content %}
    {% smart_list %}
{% endblock %}

The built-in templates are bootstrap 3 compatible - but override them easily (by positioning the apps in INSTALLED_APPS) to fit your own needs

Other features

In case:

You need custom column name you can pass tuple with two strings. First string will indicate the name of the field second custom column label (see example below)
You need column that is not bound to any model field then you can pass tuple with callable and string (column name). Callable need to take one argument (model object) and it must return instance of django.utils.safestring.SafeString Then it will be embedded into your smart list.(see example below)

You can use render_column_template helper which takes template name and render it with context that contains obj for you.

from smart_lists.mixins import SmartListMixin
from smart_lists.helpers import render_column_template
from django.template.loader import get_template


def render_menu(obj):
    # Do sth with object
    context = {
        'obj': obj,
        'other_context': 'Lorem ipsum' * obj.count 
    }
    template = get_template('menu_template.hmtl')
    return template.render(context)
    

class AccountListView(LoginRequiredMixin, SmartListMixin, ListView):
    model = Account
    paginate_by = 100
    ordering_allowed_fields = ['company_name', 'code', 'created_date']
    list_display = [
        'company_name',
        'code',
        'created_date',
        ('balance', 'Custom Balance Label'), # Custom label
        (render_column_template('user_actions_template.html'), 'Actions') ,
        (render_menu, ''), # You can pass any callable
    ]

Development

Setup

To set up the project locally run the below commands from the repository root:

$ python3 -m venv .venv  # if you're on Python 2 create virtualenv in another, appropriate way
$ source .venv/bin/activate
$ pip install -r testproject/requirements.txt
$ ./manage.py seed_data  # this will create objects for list view
$ ./manage.py runserver

Afterwards go to http://localhost:8000 and see an example of smart list usage.

NOTE: package versions in requirements.txt file are not pinned. If you wish to install specific versions you need to edit the file accordingly.

Contributing

To contribute to this project fork the repository and make a pull request against the master branch.

Remember to write tests for your changes!

License

MIT License

tadeoos / django-smart-lists Goto Github PK