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 = """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 :doc:`digg_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 :doc:`templatetags_reference` for information about writing custom callables. ------------------------------------------------- ----------- ---------------------------------------------- ``EL_PAGINATION_DEFAULT_CALLABLE_EXTREMES`` 3 Default number of *extremes* displayed when :doc:`digg_pagination` is used with the default callable. ------------------------------------------------- ----------- ---------------------------------------------- ``EL_PAGINATION_DEFAULT_CALLABLE_AROUNDS`` 2 Default number of *arounds* displayed when :doc:`digg_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 :doc:`digg_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*.