Summary of some CMS tags and a subset of their parameters to use on your CMS pages
Link to another page or URL {cms_selflink }
ext - For external links, will add class="external and info text. warning: only text, target and title parameters are compatible with this parameter
page - Page ID or alias to link to.
dir anchor (internal links) - New option for an internal page link. If this is used then anchorlink should be set to your link.
text - Text to show for the link. If not given, the Page Name is used instead.
menu 1/0 - If 1 the Menu Text is used for the link text instead of the Page Name
class - Class for the <a> link. Useful for styling the link.
id - Optional css_id for the <a> link.
more - place additional options inside the <a> link.
title - Text to use in the title attribute. If none is given, then the title of the page will be used for the title.
example: {cms_selflink ext="http://www.digitalfundi.com/help/cms_tags.html" text="Link to this page" title="Digital Fundi CMS Tags Help page"}
Image {image }
src - Image filename within your images directory.
alt - Defaults to filename. (seems to dislike use of ! and round brackets () in the alt tag - maybe more unwelcome characters)
title - Defaults to Alt text.
class - CSS class for the image. **
addtext - Additional text to put into the tag
height and width default to image size
** Check which CSS classes are defined for your site. Classes like imgright and imgcenter should be defined . Default for an image will be left placement.
example: {mailto address="david@digitalsafaris.com" text="email me" encode="javascript"}
Advanced tags
Menu {menu}
start_page="home" - shows that element and it's children only. Takes a page alias.
start_element="1.2" - shows that element and it's children only. Takes a hierarchy position (e.g. 5.1.2).
start_level="2" - only display items starting a the given level. An easy example would be if you had one menu on the page with number_of_levels='1'. Then as a second menu, you have start_level='2'. Now, your second menu will show items based on what is selected in the first menu.
show_root_siblings="1" - This option only becomes useful if start_element or start_page are used. It basically will display the siblings along side of the selected start_page/element.
show_all="0" - show all nodes even if they are set to not show in the menu. It will still not display inactive pages however.
number_of_levels="1" - display a certain number of levels deep.
items="contact,home" - select a list of pages that this menu should display. list of page aliases separated with commas.
collapse="1" - set to 1 to have the menu hide items not related to the current selected page.
Sitemap {sitemap}
class - A css_class for the ul-tag which includes the complete sitemap.
start_element - The hierarchy of your element (ie : 1.2 or 3.5.1 for example). This parameter sets the root of the menu. You can use the page alias instead of hierarchy.
number_of_levels - An integer, the number of levels you want to show in your menu. Should be set to 2 using a delimiter.
delimiter - Text to separate entries not on depth 1 of the sitemap (i.e. 1.1, 1.2). This is helpful for showing entries on depth 2 beside each other (using css display:inline).
initial 1/0 - If set to 1, begin also the first entries not on depth 1 with a delimiter (i.e. 1.1, 2.1).
relative1/0 - We are not going to show curre29 August, 2007
showall1/0 - We are going to show all pages if showall is enabled, else we'll only show pages with active menu entries.
add_elements - A comma separated list of alias names which will be added to the shown pages with active menu entries (showall not enabled).