Home «Appendix B: All Template Tags
« Appendix a: List of all Hidden Settings | Home | Appendix b-1: Tagcloud related Template Tags »

Appendix B: All Template Tags

archive_list

Example 1:

[[archive_list  
unit='week'  
order='desc'  
format='<a href="%url%">%st_day% %st_monname% -   
%en_day% %en_monname% %st_year% </a><br />'  
]]

Example 2:

<ul>  
[[archive_list  
unit='month'  
order='asc'  
format='<li><a href="%url%">%st_monname% %st_year%</a></li>'  
]]  
</ul>

You can also make a 'jumpmenu': A dropdown selector, with the archives in it. When the user selects one, the browser immediately goes to that page. If you use this, it's a good idea to also include a version of the list, for users who don't have javascript, and to keep the site easy to index by Searchengines. The complete code could look like this:

<!-- Javascript enabled Jumpmenu for the archives -->  
<select id="archivemenu" style='display:none;'>  

[[archive_list  
unit='month'  
order='desc'  
format='<option value="%url%">%st_monname% %st_year%</option>'  
]]  

</select>  

<script type='text/javascript'>  
jQuery(document).ready(function() {  
jQuery("#archivemenu").show();  
jQuery("#archivemenu").bind("change", function(){  
document.location = jQuery("#archivemenu").val();  
});  
});  
</script>  

<!-- Accessible version, for users without Javascript -->  
<noscript>  
<ul>  
[[archive_list  
unit='month'  
order='desc'  
format='<li><a href="%url%">%st_monname% %st_year%</a></li>'  

]]  
</ul>   
</noscript>

The format uses PivotX Date Formatting, so please see that section for details on how to change the dates.

You can use the 'seperator' attribute to add a seperator between the different archives. E.g. separator='|'

atombutton

Inserts a graphical button with a link to the Atom XML feed. If the Atom and RSS feeds have been disabled in the configuration, this tag will have no output.

backtrace

Outputs a backtrace of the called PHP functions. Useful for when you're debugging, and wondering what parts of the code have been executed to get to this point in the templates.

You can also call this function from your own PHP code, by calling smarty_bactrace(), although it might be better to use debug_printbacktrace(), since then the output will show up in the debug log only.

See also: [[ print_r ]]

body

Outputs the 'body' part of an entry or page. The main difference of using this instead of [[ $entry.body ]] or [[ $page.body ]] is that [[ body ]] will also parse smarty tags that are placed inside the content, whereas the former output the contents as-is.

Optional parameter:

category

List the categories of the current entry. Optionally links them to the matching pages with entries in that category.

[[ category link=true ]]

Optional parameters:

Create a link to the archive page for any given category. For example

[[ category_link name='music' ]]

category_list

Output a linked list, leading to the different archivepages for the different categories.
Example:

<ul>  
[[category_list format='<li><a href="%url%">%display%</a></li>']]  
</ul>

Optional parameters:

commcount

Output the number of comments for the current entry. You can provide the labels, if you want to override the defaults.

Example:

[[ commcount text0='No comments' text1='One comment' textmore='%num% comments' ]]

You can use %num% to output the number as a localised value, like 'seven', or %n% to output as numbers, like '7'.

commentform

Displays a commentform if commenting is allowed and the user's remote IP isn't blocked.

This displays the _sub_commentform.html template by default, but you can override it to use another template:

[[commentform template='_sub_mycommentform.html' ]]

Inserts a link to the comments for an entry with the number of comments as the default link text. Example: One comment.

To change this, use for example something like:

[[commentlink text0='Nothing' text1='One' textmore='Many']]

comments

Using the [[comments]]-tag, you can display all comments for the current entry.

Example 1:

[[comments]]  
<div class='comment'>  
%anchor%  
<img class='gravatar' src='%gravatar%' alt='%name%' />  
<div class='comment-text'>  
%comment%  
<cite><strong>%name%</strong> %email% %url% - %date% %editlink%</cite>  
</div>  
</div>  
[[/comments]]

The following parameters can be used in the [[comments]] tag:

The HTML content of the block is used for formatting. The following formatting tags are recognized:

content

This tag is used to output the search results or the tag cloud. Currently there are no options to configure the output.

count

Display the number of elements a given array has.

Example:

[[ count array=$entry.comments ]]

date

Outputs a date, using the given formatting.

[[ date format='%day% %month% %ye% - %hour24%:%minute%' date=$entry.publish_date ]]

This function uses the date formatting options as described in Appendix d: Date formatting options

download

Insert a link to a downloadable file. Usually this tag is generated by using the 'insert download' option when writing an Entry or Page.

Example:

[[ download file='my_report.pdf' title='Download my report' ]]

Insert a link to edit the current Entry or Page, directly from your website. These link are only shown to users who are logged in.

Example: [[ editlink format='Edit me!' ]]

Optional parameters:

emotpopup

Insert the link to the popup window with the emoticons. This is only displayed if the visitor is allowed to use emoticons in the comments of the current weblog.

explode

Outputs or returns an exploded string. Works pretty much the same as PHP's explode() function. Valid parameters are 'glue', 'string' and 'return'.

The example below will split string $string by commas and return the result into array $array

[[ explode array=$string glue=',' return='array' ]]

feed (RSS / Atom)

Using the [[feed]]-tag, you can fetch and display any RSS or Atom feed from the Interwebs. It uses caching internally, to speed up display.

Example 1:

[[ feed url='http://webtwee.net/atom.xml' amount=8 ]]   
<p><strong><a href='%link%'>%title%</a></strong><br/>  
%description%  
</p>   
[[ /feed ]]

Example 2:

[[ feed url='http://webtwee.net/atom.xml' dateformat='%dayname% %day% %monthname%' ]]   
<p><strong><a href='%link%'>%title%</a></strong><br/></p>  

%content% (%author% - %date%)  
[[ /feed ]]

The following attributes can be used in the [[feed]] tag:

allowtags - Set this to allow certain tags in the HTML in %title%, %content%, %description%. This option is off by default, since it requires you to trust the source of the Feed. If this option is set, the 'trimlength' attribute is ignored. Examples: * allowtags='*' - Allow all common HTML tags (but no javascript)

Note that [[feed]] is a block function, so you will need to use both the [[feed]] and [[/feed]] tags in your template. The HTML that is between the tags is used for formatting. The following formatting tags are recognized:

getpage

Get a Page, referenced by its URI. You can use this to include a page (or part of it) in a template, Entry or other Page. The fetched Page is stored in the [[$page]] template variable. Use the [[print_r]] tag to see the contents of [[$page]]

[[ getpage uri='about']]  

[[ print_r var=$page ]]  

[[ resetpage ]]

getpagelist

Retrieves a list of pages. Useful in combination with [[getpage]]. You can use this To get an array with the URIs of all pages in a chapter, and then iterate through them with [[foreach]].

The 'var' attribute determines the variable in the template that will have the results. Defaults to 'pagelist'. Note: do not include the $ in the variablename: var=pagelist is correct, var=$pagelist is not. This is because the 'var' attribute is used a string to set the variable, if you use $pagelist, the value of $pagelist is used, insted of the string 'pagelist'.

Example 1: Get a list of URIs, and print them:

[[ getpagelist var="pagelist" ]]  

[[ print_r var=$pagelist ]]

You can use the 'onlychapter' attribute to choose a chapter to get the pages from. If omitted, it will return all pages.

Example 2: Get a list of URI's, and use [[foreach]] to iterate the list.

[[ getpagelist var="pagelist" onlychapter="pages" ]]  

[[ foreach from=$pagelist item="pageuri" ]]  

item: [[ $pageuri ]]<br />  

[[ /foreach ]]

The real power of this tag shows, when combined with [[getpage]]. Let's suppose you want to display a list of pages, but you need more data than [[pagelist]] provides, or you require the use of smarty tags. You can use the [[getpagelist]] tag to get the pages, iterate over them, and pass them one at a time to [[getpage]].

Example 3: Get a list of URI's, and use [[getpage]] on them.

[[ getpagelist var="pagelist" onlychapter="pages" ]]  

[[ foreach from=$pagelist item="pageuri" ]]  

[[ getpage uri=$pageuri ]]  

<h2><a href="[[ $page.link ]]">[[ $page.title ]]</a></h2>   
[[ $page.introduction ]]  

[[ resetpage ]]  

[[ /foreach ]]

By default, the Pagelist comes sorted in the order in which it is in the PivotX backend (i.e. in the 'sorting order' that you gave it. If you pass an extra parameter sort='title', PivotX will sort the pages alphabetically by title instead.

home

Returns the URL to the homepage of the website.

hook

Executes a hook from within a template. The parameters are 'name' and 'value'.

id_anchor

Inserts an anchor for the current entry (needed for permalink). Takes one optional parameter 'name' which sets the prefix before the entry uid.

image

Inserts an image. Valid parameters are 'file', 'alt', 'align', 'class', 'id', 'width' and 'height'.

[[ image file='somedirectory/somefile.jpg' ]]

The 'file' parameter is mandatory and should be the relative path from the PivotX 'images' directory. The 'alt' parameter is optional, but should always be given since the XHTML standard requires an alternative text. The inserted image will have CSS class 'pivotx-image' unless the 'class' parameter is set. If 'align' is set to left or right, the image will also get CSS class 'align-left' og 'align-right' respectively.

implode

Outputs or returns an imploded array. Works pretty much the same as PHP's implode() function. Valid parameters are 'glue', 'array' and 'return'.

The example below will join the pieces of array $aArray with commas and return them into the string $string

[[ implode array=$aArray glue=',' return='string' ]]

include

Includes a file from the templates folder of your site. It takes one parameter: 'file'.

[[ include file='testfile.html' ]]

The 'file' parameter is mandatory and should be the relative path from the PivotX 'templates' directory.

introduction

Outputs the 'introduction' part of an entry or page. The main difference of using this instead of [[ $entry.introduction ]] or [[ $page.introduction ]] is that [[ introduction ]] will also parse Smarty tags that are placed inside the content, whereas the former output the contents as-is.

Optional parameter:

lang

Outputs the current language, like 'en' or 'nl'.

The optional type='..' attribute can be either 'html' or 'xml'. The output will then be suitable to use in templates, in the html tag, to set the correct language.

Note: If you are using XHTML 1.0 (which is the default for PivotX) you should use both [[lang type='html']] and [[lang type='xml']].

Example:

<html xmlns='http://www.w3.org/1999/xhtml' [[lang type="xml"]] [[lang type="html"]]>

last_comments

Inserts a list of the latest comments that where left by visitors.

Note: As of PivotX 2.1 this function will be deprecated. Use [[latest_comments]] instead.

latest_comments

Inserts a list of the latest comments that where left by visitors.

[[ latest_comments  
format='<a href="%url%" title="%date%"><b>%name%</b></a>: %comm%<br />'  
length=100  
trim=16  
count=8  
]]

The 'length' attribute determines the maximum length that is shown. The 'count' attribute determines the maximum amount of comments shown. The 'trim' attribute is used to trim long titles and names. For example, trim=8 will make it so that 'personwithlongname' is shown as 'personw..'.

There is also an optional 'category' attribute (which takes a comma separated list of categories) used to get the latest comments for specific categories in stead of the categories in the current weblog. Use category='*' to display all the latest comments, regardless of category.

Note: This is a new tag, as of PivotX 2.1.

Inserts a link to a page, an entry or a weblog.

[[ link page='someuri' ]]

It tries to detect automatically what kind of link you want depending of where the tag is inserted. However, you can force

Other valid parameters are 'title' and 'text' to set the link title and text, 'hrefonly' if you only want to insert the URL and 'query' if you need to add a query to the generated URL.

log_dir

Returns the local absolute URL to the (current) weblog.

Note: *In PivotX 2.1 you may prefer to use [[webloghome]] in stead of [[log_dir]].

log_url

Returns the global absolute URL to the (current) weblog.

more

Inserts the link to the body (more-link) for the current entry. If the entry has only an introduction, nothing will be inserted. Valid parameters are 'title' and 'text' to set the link title and text, and 'prefix' and 'postfix' to add something before and after the actual link. Example:

[[ more text='Continue reading' ]]

The optional parameter 'anchorname' specifies the name of the anchor, which shows up at the end of the link, after the hashmark (the '#'-sign). If you don't use any anchors, just set an empty anchorname. If you use this, be sure to add it to [[body]] as well.

nextentry

Inserts a link to the next entry either in the current weblog or category. Valid parameters are 'text' which specifies the HTML code for the link, 'cutoff' which sets the maximum length of the link text and 'incategory' to select an entry in the current category. Example:

[[ nextentry text='<a href="%link%">The entry called "%title%"</a>' ]]

nextpage

Inserts a link to the next page in the chapter (of the current page). Valid optional parameters are:

The following formatting tags are recognized inside text:

Example:

[[ nextpage text='<a href="%link%">The page called "%title%"</a>' ]]

Note: This is a new tag, as of PivotX 2.1

pagelist

Inserts a list of all chapters and their pages. Valid parameters are:

The following formatting tags are recognized inside pages:

The following formatting tags are recognized inside chapterbegin and chapterend:

Example:

[[ pagelist  
chapterbegin='<ul>'  
pages='<li %active%><a href="%link%" title="%subtitle%">%title%</a></li>'  
chapterend='</ul>'  
isactive='id="active"'  
sort='title'  
]]

paging

The paging tag provides links to the next or previous pages from your frontpage, making it easy for your visitors to read on/navigate your entries. It can tell you which entries you are reading, how many previous/next entries, and how many in total.

Some examples. Basic navigation to display where you are:

<p class="entrynavigation">  
[[ paging action='prev' ]] |  
[[ paging action='curr' ]] |  
[[ paging action='next' ]]  
</p>

Or display navigation in a style like on the Digg.com website:

[[ paging action='digg' ]]

With this tag the action attribute is either digg, next, prev or curr. PivotX displays its own default text, unless you specify it yourself:

For example:

[[ paging action='prev' format='&laquo; Previous page (%num_from% - %num_to%)' ]] |  
[[ paging action='curr' format='Displaying %num_from% - %num_to% of %num_tot%' ]] |  
[[ paging action='next' format='Next page (%num_from% - %num_to%) &raquo; ' ]]

or:

[[ paging action='digg' format_prev='Previous' format_next='Next' ]]

For the other (single) link styles the optional link text can contain the following format tags:

%num% - The number of next/prev/current entries.  
%num_tot% - The total number of entries.  
%num_from% - Start number of entries.  
%num_to% - End number of entries.

Example/typical usage: In your frontpage template add [[ paging action='next' ]] or [[ paging action='digg' ]] after the closing [[subweblog]] tag.

Note: The notion of next and previous is adopted from Pivot - meaning 'next' will give you older entries. This make sense when you look at the frontpage and you want to see the next entries (as in 'not on the frontpage'). Anyway, if you dislike this, just use the optional link text like this:

[[paging action='next' format='Previous %num% entries' ]]

Extra Digg style info

If you select Digg style paging, you keep the templates/pivot_essentials.css in your templates. If you want other colors and so on, you can override the styles in that file. Alternatively, you can create your own styles for it, by giving the <ul> that makes the navigation its own id:

[[ paging action='digg' id='mystyle' ]]

If you just select the plain 'digg' action a lot of links/pages are listed. If you have 1000 entries and 10 entries on each page, the most you could have is 100 links (numbered from 1 to 100) - which looks ugly. You can use the maxpages attribute to limit the maximum number of pages - for example

[[ paging action='digg' maxpages=7 ]]

to display only 7 links/pages centered around the current page.

parse (modifier)

Parse is a modifier, that parses a variable or the output of a smarty function, just like the 'introduction' and 'body' are parsed.

For example: if you have a smarty variable $foo containing [[image ..]] tags, these tags will be output as-is if you use [[$var]]. To parse them, and output the results, use:

[[ $foo|parse ]]

Inserts a permanent link to the current entry (in the archives). Valid parameters are 'unit', 'title' and 'text' (which set the link title and text).

[[ permalink unit='week' text='&para;' title='Permanent link to "%title%" in the archives' ]]

pivotxbutton

Inserts a nice button with a link to the PivotX website.

pivotx_dir

Returns the local absolute URL to the pivotx directory.

pivotx_path

Returns the (file system) path to the pivotx directory. (Normally not used in templates.)

pivotx_url

Returns the global absolute URL to the pivotx directory.

popup

Inserts a popup - a thumbnail that when clicked opens the full-size image. Valid parameters are 'file', 'description', 'alt' and 'align'.

[[ popup file='somedirectory/somefile.jpg' ]]

The 'file' parameter is mandatory and should be the relative path from the PivotX 'images' directory. The 'alt' parameter is optional, but should always be given since the XHTML standard requires an alternative text. The inserted thumbnail will have CSS class 'pivotx-popup'. If 'align' is set to left or right, the image will also get CSS class 'align-left' og 'align-right' respectively.

previousentry

Inserts a link to the previous entry either in the current weblog or category. Valid parameters are 'text' which specifies the HTML code for the link, 'cutoff' which sets the maximum length of the link text and 'incategory' to select an entry in the current category. Example:

[[ previousentry text='<a href="%link%">The entry called "%title%"</a>' ]]

previouspage

Inserts a link to the previous page in the chapter (of the current page). Valid optional parameters are:

The following formatting tags are recognized inside text:

Example:

[[ previouspage text='<a href="%link%">The page called "%title%"</a>' ]]

Note: This is a new tag, as of PivotX 2.1

print_r

Outputs the content of a variable (string, object, array). It works like PHP's print_r() function. Use the var attribute to pass the variable you wish to output.

[[ print_r var=$page ]]

This function is useful for when you're debugging, and wondering what a given variable contains. If you want to see all defined variables in the templates, you can use the following:

<pre>  
[[ php ]] print_r($this->_tpl_vars); [[/php]]  
</pre>

See also: [[ backtrace ]]

Inserts a link to the 'comment user'/'registered visitor' page. The valid parameters are 'linktext' and 'linktext_logged_in' (which is the link text displayed to a logged in visitor).

registered

Returns the text 'registered' if the current visitor is (logged in and) registered..

remember

Inserts previously filled fields when commenting. The values can come from either a previous submit (when previewing, or when an error in the form occurred) or from the cookie.

resetpage

If you've used [[getpage]] to set the [[$page]] variable, you can use [[resetpage]] to reset it to what it was before. Useful if you use [[getpage]] from inside another Page.

[[ getpage uri='about']]   
[[ print_r var=$page ]]  
[[ resetpage ]]

rssbutton

Inserts a graphical button with a link to the RSS XML feed. If the Atom and RSS feeds have been disabled in the configuration, this tag will have no output.

Inserts a searchbox and button, to search for words in your Entries and Pages.

[[ search ]]

There are several options to configure it, and to determine the output.

[[ search fieldname='Search for stuff here' placeholder='searchterms' ]]

You can hide the button, forcing users to press 'enter' when the searchbox has focus. While this may look nice, you should consider that this decreases the usability of the form for less experienced users, or those with disabilities.

[[ search button=false ]]

PivotX always outputs a <fieldset> and <legend> tag. This is good for the usability of the form, but it might look unattractive when they're not styled (or hidden). The pivotx_essentials.css include fixes this by default. You can override them like this:

.pivotx-search fieldset,  
.pivotx-search-result fieldset {  
border: 0;  
padding: 0;  
margin: 0;  
}  

.pivotx-search label,   
.pivotx-search legend,   
.pivotx-search-result label,   
.pivotx-search-result legend {  
display: none;  
visibility: hidden;  
}

self

Returns the local absolute URL to the current page. If the parameter 'includehostname' is set to 1, it will include the host name and return a global absolute URL.

sitename

Returns the sitename for the PivotX installation..

spamquiz

To protect your comments against spam, you can configure PivotX to ask a (silly/easy) question that has to be answered to accept a comment. Use this tag to place the question in the comment form. The valid parameters are 'intro' and 'format'. 'intro' is the leading text explaining the concept. The default value is:

<div id='spamquiz'>  
<div class='commentform_row'>  
<small>%intro%</small><br />

'format' is the question and the default value is:

<label for='spamquiz_answer'><b>%question%</b></label>  
<input type='text' class='commentinput' name='spamquiz_answer'   
id='spamquiz_answer'  %name_value% />  
</div>  
</div>

For maximum flexibility you can (as of PivotX 2.1) specify both introduction and question in the 'format' parameter.

subtitle

Returns the current subtitle (whether it's used for an entry or a page).

subweblog / weblog

The [[ subweblog ]] tag is a block tag, which means that it always has to have an accompanying [[ /subweblog ]] tag. What's inside the tag is used to render the entries in that weblog. In fact, the contents can be seen as the template that is used for each entry. PivotX loops over the entries, and renders each one, using this 'sub template'.

A representative example of what a [[ subweblog ]] block might look like is:

<!-- begin of weblog "standard" -->   
[[ subweblog name='standard' ]][[ literal ]]   

<!-- entry "[[title]]" -->   
<div class='entry'>   
<h2>   
<a href='[[entrylink hrefonly=1]]'>[[title]]</a>   
</h2>   


<p class='date'>   
[[ date format='%dayname% %day% %monthname% %year% at %hour12%:%minute% %ampm%' ]]   
[[ editlink format='Edit' prefix=' - ' ]]   
</p>   


[[introduction]]   

[[more]]   

<p class='entryfooter'>   
<span class='meta'>   
[[ user field=emailtonick ]] |   
[[ singlepermalink text='&para;' title='Permanent link to entry "%title%"' ]] |   
[[ category link=true ]] |   
</span>   
<span class='comments'>   
[[commentlink]]   
</span>   
[[tags prefix='<span class="tags">' postfix='</tags>' ]]   
</p>   


</div>   

[[ /literal ]][[ /subweblog ]]   
<!-- end of weblog "standard" -->

The [[ literal ]]-tags are there to make sure the contents aren't parsed too early. Don't remove them!

The [[subweblog]]-tag takes the following arguments:

The most commonly used tags inside [[subweblog]] are: [[entrylink]], [[title]], [[subtitle]], [[date]], [[editlink]], [[introduction]], [[body]], [[more]], [[user]], [[singlepermalink]], [[permalink]], [[category]], [[commentlink]] and [[tags]]

You can use the [[subweblog]] tag inside pages. For example, if you have a page on each author, you can use [[ subweblog author='name' ]] tho show his or her latest entries.

A few extra variables are set, for keeping track of where PivotX is in the loop of entries. These are:

tagcloud

Returns a list of tags. You can set extra parameters to adjust the amount of tags shown and add minium and maximum font sizes.

Example

[[ tagcloud  
amount='50'  
minsize='10'  
maxsize='30'  
]]

tags

To be written.

tt

Used in the introduction and body of an entry, to add a tag to the entry. Outputs a link to the tag page for the given tag. It takes the following arguments:

If the optional parameter link is set, the generated link will point there instead. Examples:

[[ tt tag='sometopic' ]]  
[[ tt tag='php' link='http://delicious.com/tag/php' ]]

template_dir

Returns the local absolute URL to the template directory..

textilepopup

Adds the textile editor header to the comments form. It's somewhat confusingly named for backwards compatibility...

title

Returns the current title (whether it's used for an entry or a page).

trackcount

Output the number of trackbacks for the current entry. You can provide the labels, if you want to override the defaults.

Example:

[[ trackcount text0='No comments' text1='One comment' textmore='%num% comments' ]]

You can use %num% to output the number as a localised value, like 'seven', or %n% to output as numbers, like '7'.

Note: This is a new tag, as of PivotX 2.1

Inserts the trackback URL for the current entry. It takes one optional parameter 'format'.

Example:

[[ tracklink format='<p>Trackback URL: %url% </p>']]

Note: This is a new tag, as of PivotX 2.1

Inserts a link to the trackbacks for an entry with the number of trackbacks as the default link text. Example: One trackback.

To change this, use for example something like:

[[trackbacklink text0='Nothing' text1='One' textmore='Many']]

Note: This is a new tag, as of PivotX 2.1

trackbacks

Using the [[trackbacks]]-tag, you can display all trackbacks for the current entry.

Example 1:

[[trackbacks]]  
<div class='comment'>  
%anchor%  
<div class='comment-text'>  
<strong>%title%</strong><br />%excerpt%  
<cite class="comment">Sent on %date%, via %url% %editlink%</cite>  
</div>  
</div>  
[[/trackbacks]]

The following parameters can be used in the [[trackbacks]] tag:

The HTML content of the block is used for formatting. The following formatting tags are recognized:

Note: This is a new tag, as of PivotX 2.1

uid

Returns the uid (code) for the current entry.

upload_dir

Returns the local absolute URL to the upload directory..

user

Returns information about the author of the current entry or page. It takes one optional parameter 'field' to select what information to return. There is one special value 'emailtonick' that will produce an encoded link to the e-mail address. Example

[[ user field=emailtonick ]]

via

Returns the 'via' information from the extended entry form as a link with a title. It takes one optional parameter 'format' with default value

[[<a href="%link%" title="%title%">via</a>[]

webloghome

Returns the local absolute URL to the (current) weblog.

Note: This is a new tag, as of PivotX 2.1

weblogid

Returns the ID/internal name of the current weblog.

weblogsubtitle

Returns the subtitle (payoff) of the current weblog. It takes one optional parameter 'strip' which if equal to one, will remove all HTML tags from the output.

weblogtitle

Returns the title of the current weblog. It takes one optional parameter 'strip' which if equal to one, will remove all HTML tags from the output.

widgets

Inserts a block with the enabled widgets.

yesno

Returns localised 'Yes' or 'No'. 'Yes' is retuned if the 'value' parameter is one.

weblog_list

Displays a list of the weblogs in PivotX. Weblog_list takes the following arguments:

Example 1:

[[ weblog_list format='<a href="%link%">%title%</a><br />' ]]

Example 2:

<ul>  
[[weblog_list  
format='<li %active%><a href="%link%" title="%payoff%">%display%</a>   
<small>(%internal%)</small></li>'  
current='class="activepage"'  
]]  
</ul>

By default, the Weblog list comes sorted in the order in which it is in the PivotX backend. If you pass an extra parameter sort='title', PivotX will sort the pages alphabetically by title instead.

« Appendix a: List of all Hidden Settings | Home | Appendix b-1: Tagcloud related Template Tags »