− Table of content
All template modifiers bundled with Jelix.
gravatar ¶
this modifier permits to display an avatar from the website http://gravatar.com/
To do so, you just need to provide the email in the template as follow :
{gravatar 'foo@bar.com'}
Thus, your gravatar will be displayed at wanted place in the template.
hook ¶
Introduction ¶
The Hook system permits to add in the templates of his choice, the fonctionnalities that we wish.
To exploit the hooks we will write in the template :
{hook 'event', $params}
where event is the event name triggered the grabbing of all the functionalities and $params is the array of parameters given to the listener answering to event.
Example :
{hook 'SampleBannerAnnouncement'}
will display a banner of announcement in the template of your choice by answering to the event SampleBannerAnnouncement.
Hooks naming convention ¶
this will permit you to understand, by reading the event name, to which page / template the hook is linked. It's not a rule written in the stone, but a way to organize your futur hooks.
- BeforeTemplateName
- TemplateName
- AfterTemplateName
where :
- TemplateName is the name of the template where the hook is used
- BeforeTemplateName is the name of the hook called at the beginning of the template TemplateName
- TemplateName is also the place where the hook is called (in the middle of the template)
- AfterTemplateName is the name of the hook called at the end the template TemplateName
How to respond to hooks ? ¶
We have to produce a module :
- a listener
- a zone
- a template
- the Listener will be in charge of responding to the event in calling a zone
class hookListener extends jEventListener{
function onhfbSampleBannerAnnouncement ($event) {
$event->add( jZone::get('hook~samplebanner_accouncement') );
}
}
- file events.xml to define the listener which will respond to the event
<?xml version="1.0" encoding="iso-8859-1"?>
<events xmlns="http://jelix.org/ns/events/1.0">
<listener name="hook">
<event name="hfbSampleBannerAnnouncement" />
</listener>
</events>
- the zone will exploit the data of your choice and will provide them to the template
class samplebanner_accouncementZone extends jZone {
protected $_tplname='zone.samplebanner_accouncement';
protected function _prepareTpl(){
$this->_tpl->assign('text',jLocale::get('hook~main.welcome'));
}
}
- the template will display the data
<div class="grid_16">
<div class="box">
<h2>Banner</h2>
{$text}
</div>
</div>
<div class="clear"></div>
all of this will be returned to the Hook in the wanted template at the place you want
jdatetime ¶
The jdatetime modifier permit to convert a date string in a format to another one. This modifier use the jDateTime class. Without parameter, this modifier expect a database string format(jDateTime::BD_DTFORMAT) and return a date in selected language format (jDateTime::LANG_DTFORMAT).
<p>this date are {$myDate|jdatetime}.</p>
if $myDate='2006-04-12 01:05:26' an if language are en, then it display
this date are 12/04/2006 01h05mn26s.
To use another formats, you have to use one of this string in modifier parameter :
| parameter | constant in jDateTime class | format |
|---|---|---|
| 'lang_date' | jDateTime::LANG_DFORMAT | date format of current application lang (with en, this is mm/dd/yyyy) |
| 'lang_datetime' | jDateTime::LANG_DTFORMAT | date and time format of current application lang |
| 'lang_time' | jDateTime::LANG_TFORMAT | time format of current application lang |
| 'db_date' | jDateTime::DB_DFORMAT | date of classic database style : "YYYY-MM-DD" |
| 'db_datetime' | jDateTime::DB_DTFORMAT | date and time of classic database style : "YYYY-MM-DD HH:mm:SS" |
| 'db_time' | jDateTime::DB_TFORMAT | timeof classic database style : "HH:mm:SS" |
| 'iso8601' | jDateTime::ISO8601_FORMAT | format ISO8601 |
| 'timestamp' | jDateTime::TIMESTAMP_FORMAT | integer, number of seconds since 1/1/1970 (timestamp) |
| 'full_lang_date' | jDateTime::FULL_LANG_DATE | full format date (i.e. day of week and month in letter) respecting language conventions (ex: thursday, may 27th 2010) |
The first parameter is the format of date string to convert, the second one, the format to display.
<p>this date are {$myDate|jdatetime:'db_date':'timestamp'}.</p>
if $myDate='2006-04-15' then it display
this date are 1145052000.
mailto ¶
this modifier permits to display a link to the user's email in the form of your choice :
several options can be used for that:
- displaying an email in a classic form
{mailto array('address'=>'me@domain.com')}
- displaying an email encoded in javascript
{mailto array('address'=>'me@domain.com', 'encode'=>'javascript')}
- displaying an email encoded in hexa
{mailto array('address'=>'me@domain.com', 'encode'=>'hex')}
- displaying an email following by the subject of this onejavascript
{mailto array('address'=>'me@domain.com', 'subject'=>'Hello to you!')}
- displaying an email with 'cc' on severals email
{mailto array('address'=>'me@domain.com', 'cc'=>'you@domain.com,they@domain.com')}
- additionals options are available, like a CSS class
{mailto array('address'=>'me@domain.com', 'extra'=>'class="mailto"')}
number_format ¶
this modifier format a number to be displayed like explains in the PHP doc http://uk.php.net/number_format
for example :
{number_format $number, 2, '.', ''}
truncate ¶
Modifier that truncates a string to a certain length if necessary, optionally splitting in the middle of a word, and appending the $etc string.
{$mytext|truncate}
{$mytext|truncate:40}
{$mytext|truncate:45:'...'}
{$mytext|truncate:60:'...':true}
truncatehtml ¶
Modifier that cuts a html formated string and close all opened tags so that it doesn't inpact on the rest of the page. You should use this modifier in a zone so that the return value is cached
{$mytext|wordwrap}
{$mytext|truncatehtml:150:"\n<a href="...">read full article</a>"}
{$mytext|truncatehtml:45}
