Usage¶
Assigning tags to pages / titles¶
Tags can be assigned from the admin interface or the toolbar.
In the toolbar you will find a Tags
submenu in the Page
menu, with two
or more sub-items:
Common: it allows to edit page-wide (language independent) tags;
One entry per active language to edit language dependent tags.
Retrieving tags in the template¶
djangocms-page-tags
provides both a tag and an inclusion tag for each object.
include_page_tags and include_title_tags¶
These templatetags retrieve the tags for the given object and render them
according to the relative template
(djangocms_page_tags/template/page_tags.html
and
djangocms_page_tags/template/title_tags.html
) respectively.
You can override the template using the standard django mechanism.
Tags are available in the context variable tags_list
.
Arguments:
page_lookup
(see page_lookup for more information)language
(optional)site
(optional)
For performance reason is advisable to always use a Page object as
page_lookup
parameter.
page_tags and title_tags¶
These templatetags pulls the tags for the given object and save them in
the varname
context variable.
Arguments:
page_lookup
(see page_lookup for more information)language
(optional)site
(optional)varname
(required)
For performance reason is advisable to always use a Page object as
page_lookup
parameter.