InterJinn

Development Framework For PHP

Tag: <jinn:link/>

Abstract

Alias: <jinn:url/>

Use this tag to create a hyperlink. The advantages of using this versus using a the regular <a> tag is that the value of the href attribute will be subject to the usual path criteria and to language expansion.

Attribute - href

Destination page to which you want to link. If the link path begins with // then the path will be considered relative to the pageBase that you set in the project configuration. If the path is preceded by / then the link will be considered relative to pageBase that you set in the project configuration. Last, if neither of the former two cases are true then the path will be treated as relative to the current target page.

Attribute - external

If set to true then the the link will be considered to be linking off-site. This will result in a new window being opened when the link is clicked to prevent users from disappearing to other sites and forgetting about yours.

Attribute - caption (aka status)

Display the value of this attribute in the status field of the window when the mouse is over the link. If this is left empty then the default is browser specific, but is usually the URL of the target page.

The following example outlines the syntax used to create a link.

Example:
<jinn:link
    href="http://www.wocmud.org"
    external="true"
    caption="Worlds of Carnage"
/>