Antville Macros

<% site.membercounter %>

robert — Sat, 04 Jan 2003 17:23:16 GMT

This macro returns the sum of all subscribers, contributors, content managers and admins of a weblog. Nothing more.

<% site.loginstatus %>

robert — Sat, 04 Jan 2003 17:20:08 GMT

also available as [Macro not allowed in sandbox: root.loginstatus]

This macro checks if the user currently viewing a page is logged in or not. Depending on that it either renders the skin for authenticated or anonymous users.

You find these skins named "Logged in user" and "Logged out user" in the skin editor of your site under "Site Layout" in the section "Navigation".

<% site.title %>

robert — Sat, 04 Jan 2003 17:12:49 GMT

This macro will basically display the title of a weblog that was defined in the preferences. All HTML-tags included in the title will be stripped off, so it doesn't make much sense to do that.

The only available option is linkto, using it will turn the title into a link, eg:

<% site.title linkto="main" %><% site.title linkto="stories/12345" %><% site.title linkto="topics/about" %>

<% site.searchbox %>

robert — Tue, 31 Dec 2002 14:32:17 GMT

This macro will be replaced by the rendered skin "searchbox" which contains the input field for entering the search-terms plus the button for submitting the search-request. If you don't modify the searchbox-skin it will look like this:

<% site.navigation %>

robert — Tue, 31 Dec 2002 14:19:58 GMT

This macro works hand in hand with three skins to build the navigation depending on the user's status:

<% site.navigation for="users" %>DEPRECATED. Since version 1.1pre2 the navigation bar for users is not supported by the site.navigation macro anymore. Navigation items for all users should be directly included in the site's main.skin. This macro call won't be supported in the final release so it's a good idea to update the user navigation now.

<% site.navigation for="contributors" %>will be replaced with the navigation-bar for contributors (which in most cases will contain links for creating a new story etc.). if the user doesn't belong to the contributors of a weblog nothing will be displayed. If you enabled "Allow contributions" in your weblog-preferences this navigation-skin will be displayed for all logged in users.

<% site.navigation for="admins" %>same as above, but antville will check if the user belongs to the administrators of a weblog and either render the navigation bar for admins or nothing.

To change the skins simply go to the skin editor of your weblog and scroll down to the section "navigation skins". In antville's default skinset you can find this macro in the skin "main page".