EPrints Control Format

From EPrints Documentation
Revision as of 01:06, 23 May 2007 by Crowston (talk | contribs)
Jump to: navigation, search

EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects

XML Configuration: EPScript - Control Format (EPC) - Citation - Workflow - Phrase - Template - XPAGE (static pages)

EPrints Control

Output Tags


<epc:print expr='expression' opt='key=value;key2=value2'/>

<cite:citation xmlns="http://www.w3.org/1999/xhtml"
    <epc:print expr="$item.citation('default')" />

Outputs the result of the expression in the 'expr' attribute.

Expressions can include:

$config{xxx} - a value from the configuration.

$current_user - the current user. So you print $current_user{username}

$current_lang - the id of the current language eg 'en'

$item - the current item (usually an eprint, but not always, eg in citations or workflows for user objects). So you can print $item{eprintid}. If you just use {eprintid} it is a shortcut for {$item{eprintid}}

Rendering options may be passed in the opt attribute using a key=value form, with semicolons separating multiple options.


<epc:phrase ref='phraseid'>
  <epc:param name='somepin'>Content</epc:param>

Outputs the content of the phrase refered to by 'ref'. Any necessary parameters may be set using the <epc:param> tag, with the contents inserted into the pin with the name corresponding to the name attribute.

Conditional Tags


<epc:if test='expr'>

Outputs any XHTML content and evaluates any EPrints Control structures within the epc:if block if the expression in the test attribute is true.


  <epc:when test='expr'> 
  <epc:when test='expr2'> 

epc:choose allows for the construction of a complex conditional. Each epc:when block's 'test' attribute is evaluated, and the content of the block is returned if the result is true. If no expressions return true, the optional epc:otherwise block is returned. Note that no subsequent epc:when blocks are evaluated once the first block to return true is reached.