Theme Tags

From XOMBO Documentation

Introduction

This document will give a brief overview of the XOMBO Platform theme tags. The system has it's own custom markup language that can be used to insert user-appropriate links and vendor-specific icons. This greatly simplifies creating customizable themes without being subjected to the hassle of detecting the proper files, values, and permissions yourself.

Please note the space before the closure of any self-closing tags (" />", as-per XHTML 1.0 spec).

<view /> - Embeds the XHTML code output by the current view/action.

<messages /> - Embeds the XHTML code to display errors or alerts generated by the code.

<site /> - Embeds the site name.

<style /> - Embeds the stylesheet CSS code.

<jscript /> - Embeds JavaScript tags to load all scripts required by the application.

<viewname /> - Embeds the current view's class name (not case-corrected).

<viewlabel /> - Embeds the current view's display name (case-corrected).

<themedir /> - Current theme's skin directory.

<auth /> - Embeds true or false depending on the visitor's auth status.

<fname /> - Embeds a logged-in user's first name.

<lname /> - Embeds a logged-in user's last name.

<email /> - Embeds a logged-in user's e-mail address.

<uid /> - Embeds a logged-in user's ID (zero if not logged in).

<group /> - Embeds a logged-in user's group name (Guest, Member, etc...).

<timestamp /> - Embeds the current UNIX timestamp.

<view:viewname>title</view> - Adds a link to a specific view of the user has access to it. Use “icon” as the title to have it show the view's menu icon as the link content.

<view:viewname/action>title</view> - Adds a link to a specific view's action.

<view:viewname?param=value>title</view> - Same as above, allows you to pass parameters to a view's main function.

<view:viewname/action?param=value>title</view> - same as above, passes an action and parameters.

<auth>xhtml content</auth> Embeds the enclosed html content if the user is logged in.

<auth:viewname>xhtml content</auth> - Embeds the enclosed XHTML content if the user has access to the view name.

<icon:name.png /> - Adds an IMG tag with the appropriate icon for your theme.

<icon:name.png! /> - Same as above, returns only the URL-- not the IMG tag.