django-sorter 0.2

快速启动

1. 使用您喜爱的python打包工具获取应用程序，例如：

   pip install django-sorter
   

2. 在INSTALLED_APPS设置中列出此应用程序。 您的设置文件可能类似于：

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

3. 如果尚未添加到您的设置中，请添加request模板 设置TEMPLATE_CONTEXT_PROCESSORS的上下文处理器 （您可能需要add it）：

   TEMPLATE_CONTEXT_PROCESSORS = (
       # ...
       'django.core.context_processors.request',
   )
   

4. 指定允许的排序条件，至少为默认值 'sort'排序查询字符串参数：

   SORTER_ALLOWED_CRITERIA = {
       'sort': ['first_name', 'creation_date', 'title'],
   }
   

5. 在模板顶部添加此行以加载排序标记：

   {% load sorter_tags %}
   

6. 决定要排序的变量，并使用 在遍历变量之前对其进行排序。

   {% sort objects as sorted_objects %}
   

7. 也可以显示不同的排序链接或表格：

   <tr>
      <th>{% sortlink by "first_name" %}By first name{% endsortlink %}</th>
      <th>{% sortlink by "creation_date,-title" %}By creation date and title{% endsortlink %}</th>
       ...
   </tr>
   

   模板标记采用逗号分隔的排序语句列表。 它也是一个块标记，允许您设置生成的 链接。前面的片段将呈现如下：

   <tr>
       <th><a href="/?sort=first_name" title="Sort by 'first_name' (asc)">By name</a></th>
       <th><a href="/?sort=creation_date,-title" title="Sort by 'creation_date' (asc) and 'title' (desc)">By creation and title</a></th>
       ...
   </tr>
   

   类似地，{% sortform %}template标记呈现一个表单，而不是 一个简单的链接。