Customization

Settings

You can customize the application using settings.py.

Name	Default	Description
EL_PAGINATION_PER_PAGE	10	How many objects are normally displayed in a page (overwriteable by templatetag).
EL_PAGINATION_PAGE_LABEL	‘page’	The querystring key of the page number (e.g. http://example.com?page=2).
EL_PAGINATION_ORPHANS	0	See Django Paginator definition of orphans.
EL_PAGINATION_LOADING	‘loading’	If you use the default show_more template, here you can customize the content of the loader hidden element. HTML is safe here, e.g. you can show your pretty animated GIF EL_PAGINATION_LOADING = """<img src="/static/img/loader .gif" alt="loading" />""".
EL_PAGINATION_PREVIOUS_LABEL	‘<’	Default label for the previous page link.
EL_PAGINATION_NEXT_LABEL	‘>’	Default label for the next page link.
EL_PAGINATION_FIRST_LABEL	‘<<’	Default label for the first page link.
EL_PAGINATION_LAST_LABEL	‘>>’	Default label for the last page link.
EL_PAGINATION_ADD_NOFOLLOW	False	Set to True if your SEO alchemist wants search engines not to follow pagination links.
EL_PAGINATION_PAGE_LIST_CALLABLE	None	Callable (or dotted path to a callable) that returns pages to be displayed. If None, a default callable is used; that produces Digg-style pagination. The applicationt provides also a callable producing elastic pagination: EL_pagination.utils.get_elastic_page_numbers. It adapts its output to the number of pages, making it arguably more usable when there are many of them. See Templatetags reference for information about writing custom callables.
EL_PAGINATION_DEFAULT_CALLABLE_EXTREMES	3	Default number of extremes displayed when Digg-style pagination is used with the default callable.
EL_PAGINATION_DEFAULT_CALLABLE_AROUNDS	2	Default number of arounds displayed when Digg-style pagination is used with the default callable.
EL_PAGINATION_DEFAULT_CALLABLE_ARROWS	False	Whether or not the first and last pages arrows are displayed when Digg-style pagination is used with the default callable.
EL_PAGINATION_TEMPLATE_VARNAME	‘template’	Template variable name used by the page_template decorator. You can change this value if you are going to decorate generic views using a different variable name for the template (e.g. template_name).
EL_PAGINATION_PAGE_OUT_OF_RANGE_404	False	If True on page out of range, throw a 404 exception, otherwise display the first page. There is a view that maintains the original functionality but sets the 404 status code found in el_pagination\views.py
EL_PAGINATION_USE_NEXT_PREVIOUS_LINKS	False	Add is_previous & is_next flags for previous and next pages

Templates and CSS

You can override the default template for show_more templatetag following some rules:

• more link is shown only if the variable querystring is not False;

• the container (most external html element) class is endless_container;

• the more link and the loader hidden element live inside the container;

• the more link class is endless_more;

• the more link data-el-querystring-key attribute is {{ querystring_key }};

• the loader hidden element class is endless_loading.