Location: PHPKode > scripts > Block template > block-template/template.php
put this file in ./template/default/

# COMMENTS
All text before the first section won't be parse and will be consider as comments.
You can comment any line in the file by starting it with a '#'

# BASICS
section are declared on a new line starting with @#SECTIONAME 
section end at the start of the next section or at the end of the file
they can contain some vars like this @=var/=@ or like this @=var=@ var content @=/var=@
Vars can contain parameters like this: @=var param='value' /=@ and param values must be protected with single or double quotes.

Vars can be the name of a section in which case the section will be include in place of the tag
@=SECTIONAME/=@ you can add a '*' to the end of the sectioname (ie: @=SECTIONAME*/=@)  to made it optionnal,
this mean that the section will be include only if at least one of its vars is filled else it won't.

A common use is to declare section in UPPERCASE, be aware that block template is case sensitive!
# PREDEFINED PARAMETERS
default :   this param is used to set a default value for var replacement like this
            @=var default='default replacement value'/=@
tagcontent: is a special parameter that contain the var content for example:
            @=var=@ this is the tagcontent parameter value @=/var=@
parameter values can also be a sectioname!
require: name of minimal vars needed to include a section (used for optionnal section only), @=SECTIONINCLUDED require='var1,var2' /=@ 
# ADVANCED USED
- you can point any parameter to another by adding an '@' before the section name you want to point on it like this:
  @=var default='@tagcontent'=@ doing this the default value of var will be the tagcontent @=/var=@
- the default behaviour when parsing a template is to leave parameter untouch so if you have something like this:
  @=var default='@tagcontent'/=@ this is a tagcontent with a @=othervar default='test'/=@ in it@=/var=@
  it will be replaced by : "this is a tagcontent with a @=othervar default='test'/=@ in it" and @=othervar/=@ won't be replace.
  If you want to force the parameter parsing you can use the special 'preparse' parameter for this.
  @=var preparse='tagcontent,you,can,add,other,param,to,preparse,by,separating,them,with,coma' default='@tagcontent'/=@ 
    this is a tagcontent with a @=othervar default='test'/=@ in it
  @=/var=@
  this will be replaced by : 'this is a tagcontent with a test in it'

# BASIC TEMPLATE FILE:
#- The BODY section is the only absolutely REQUIRED one!
@#BODY
<body @=bodyparams/=@
<div class='main'>
  <div class='header'>
    @=title/=@
  </div>
  <div class='pagecontent'>
    #- content will contain all previoulsy added content (using methods add_*_content())
    @=content/=@
  </div>
</div>
</body>

#- section starting by BOX are specials ones look box and add_box_content method for more details
@#BOX
<div class='box'>
  #- we want optionnal title for box section so we create a BOX_TITLE section to optionnaly include
  @=BOX_TITLE*/=@
  #- you may optionnaly include BOX_TITLE like this too
  # @=BOX_TITLE require='boxtitle'/=@
  @=boxcontent/=@
</div>
#- this section will be include only if a boxtitle is given
@#BOX_TITLE
<h1 class='title'>@=boxtitle/=@</h1>
  
@#MENU
<div class='menu'>
  <ul>
    @=menuentrys/=@
  </ul>
</div>
@#MENU_ENTRY
<li><a href='@=url/=@'>@=label/=@</a></li>

@#NEWS_BOX
@=BOX boxtitle='news' boxcontent='@newscontent'/=@
@#NEWS_INTROS
<p>
<a href='@=url/=@'>@=title/=@</a><br />
@=intro/=@
</p>
Return current item: Block template