Zinnia provides several template tags based on inclusion_tag system to create some widgets in your Web site’s templates.
Note
The presence of the template argument in many template tags allow you to reuse and customize the rendering of a template tag in a generic way. Like that you can display the same template tag many times in your pages but with a different appearance.
To start using any of the following template tags you need to load them first at the top of your template:
{% load zinnia_tags %}
Display the latest entries.
Return the most recent entries
Usage examples:
{% get_recent_entries %}
{% get_recent_entries 3 %}
{% get_recent_entries 3 "custom_template.html" %}
Display the featured entries.
Return the featured entries
Usage examples:
{% get_featured_entries %}
{% get_featured_entries 3 %}
{% get_featured_entries 3 "custom_template.html" %}
Display the latest entries marked as draft.
Return the latest draft entries
Usage examples:
{% get_draft_entries %}
{% get_draft_entries 3 %}
{% get_draft_entries 3 "custom_template.html" %}
Display random entries.
Return random entries
Usage examples:
{% get_random_entries %}
{% get_random_entries 3 %}
{% get_random_entries 3 "custom_template.html" %}
Display popular entries.
Return popular entries
Usage examples:
{% get_popular_entries %}
{% get_popular_entries 3 %}
{% get_popular_entries 3 "custom_template.html" %}
Display entries similar to an existing entry.
Return similar entries
Usage examples:
{% get_similar_entries %}
{% get_similar_entries 3 %}
{% get_similar_entries 3 "custom_template.html" %}
Display an HTML calendar with date of publications.
If you don’t set the year or the month parameter, the calendar will look in the context of the template if one of these variables is set in this order : (month, day, object.creation_date).
If no one of these variables is found, the current month will be displayed.
Return an HTML calendar of entries
Usage examples:
{% get_calendar_entries %}
{% get_calendar_entries 2011 4 %}
{% get_calendar_entries 2011 4 "custom_template.html" %}
Display the archives by month.
Return archives entries
Usage examples:
{% get_archives_entries %}
{% get_archives_entries "custom_template.html" %}
Display all the archives as a tree.
Return archives entries as a Tree
Usage examples:
{% get_archives_entries_tree %}
{% get_archives_entries_tree "custom_template.html" %}
Display all the published authors.
Return the published authors
Usage examples:
{% get_authors %}
{% get_authors "custom_template.html" %}
Display all the categories available.
Return the categories
Usage examples:
{% get_categories %}
{% get_categories "custom_template.html" %}
Store in a context variable a queryset of all the published tags.
{% get_tags as var %}
Usage example:
{% get_tags as entry_tags %}
Display a cloud of published tags.
Return a cloud of published tags
Usage examples:
{% get_tag_cloud %}
{% get_tag_cloud 9 %}
{% get_tag_cloud 9 "custom_template.html" %}
Display the latest comments.
Return the most recent comments
Usage examples:
{% get_recent_comments %}
{% get_recent_comments 3 %}
{% get_recent_comments 3 "custom_template.html" %}
Display the latest linkbacks.
Return the most recent linkbacks
Usage examples:
{% get_recent_linkbacks %}
{% get_recent_linkbacks 3 %}
{% get_recent_linkbacks 3 "custom_template.html" %}
Display a Digg-like pagination for long list of pages.
Return a Digg-like pagination, by splitting long list of page into 3 blocks of pages
Usage examples:
{% zinnia_pagination page_obj %}
{% zinnia_pagination page_obj 2 2 %}
{% zinnia_pagination page_obj 2 2 3 3 %}
{% zinnia_pagination page_obj 2 2 3 3 "custom_template.html" %}
Display the breadcrumbs for the pages handled by Zinnia.
Return a breadcrumb for the application
Usage examples:
{% zinnia_breadcrumbs %}
{% zinnia_breadcrumbs "News" %}
{% zinnia_breadcrumbs "News" "custom_template.html" %}
Display the statistics about the contents handled in Zinnia.
Return statistics on the content of Zinnia
Usage examples:
{% zinnia_statistics %}
{% zinnia_statistics "custom_template.html" %}