ella-listingex 0.2

这是什么？

此包允许Ella用户更改类别列表页面的默认行为。默认情况下，每页都有相同数量的对象（如果数量足够的话）。

有时，这不符合网站的要求。通常需要，第一页应该有所不同，例如，列出更多一篇文章，以不同的样式渲染（如引导文章）。遗憾的是，在默认的Ella中，不可能不使用黑客式的方法来实现这一点。

如何使用

设置相当简单。首先，使用pip或setuptools安装包

pip install ella-listingex

将应用添加到您的 INSTALLED_APPS

INSTALLED_APPS = (
    ...,
    'ella_listingex',
    ...
)

配置 ella_listingex 以满足您的需求。内部，该应用通过覆盖Ella的 CUSTOM_VIEWS 来工作。这意味着我们告诉Ella使用我们的视图而不是内置的视图。 ella_listingex 应用程序重新定义了Ella的 ListContentType 视图以提供额外的功能。因此，我们需要允许 CUSTOM_VIEWS 并将 VIEWS 变量设置为 ella_listingex.views 的路径，如下所示

# Use custom views to support different number of items on the first and
# next pages of category listings.
CUSTOM_VIEWS = True
VIEWS = 'ella_listingex.views'

下一步是设置分页

LISTINGEX_PAGINATE_BY = 10        # Default number of objects per page
LISTINGEX_FIRST_PAGE_COUNT = 11   # Number of objects on first page

ella_listingex 在所有未列入黑名单的类别列表上工作。如果您需要在某些页面上关闭特殊行为，请使用 LISTINGEX_BLACKLIST 配置选项提供要匹配类别 tree_path 属性的正则表达式列表。如果匹配，第一页将按正常方式分页

LISTINGEX_BLACKLIST = (           # Blacklist categories, whose tree_path
    r'^blogs',                    # matches '^blogs'
)