Help
Fixed Tags

Format:            <%[tag_name] %>
Description:     Fixed tags make up the majority of system tags. They have to be spelled exactly in order to work.

Links-related tags

<%insert_list_links%>

Description:     Inserts all links in the current category or in ‘Home’. This tag will include a template ‘list_links.tpl’ for every link to be displayed, or ‘list_pick_links.tpl’ if the appropriate option is checked.
Scope:             Should be used within main top-level templates, where a category is defined. Will produce unpredictable results if used within form templates such as add_review, register, etc.
Result:             Displays all appropriate links
Processing:      Long – depends on the # of links
Example:         <UL><%insert_list_links%></UL> will display an HTML list of links

<%insert_top_links%>

Description:     Displays all links marked “top”. Top is a value calculated based on the visitor ratings and is controlled by the admin.
Scope:             Same as <%insert_list_links%>
Result:             Same as <%insert_list_links%>
Processing:      Same as <%insert_list_links%>
Example:         <UL><% insert_top_links %></UL> will display an HTML list of top links

<%insert_pop_links%>

Description:     Displays all links marked “pop”. Pop is a criterion based on the number of hits (or clicks) and is controlled by the admin.
Scope:             Same as <%insert_list_links%>
Result:             Same as <%insert_list_links%>
Processing:      Same as <%insert_list_links%>
Example:         <UL<%insert_pop_links%></UL> will display an HTML list of pop links

<%insert_new_links%>

Description:     Displays all links marked “new”. New is a criterion based on date the link was created and is controlled by the admin.
Scope:             Same as <%insert_list_links%>
Result:             Same as <%insert_list_links%>
Processing:      Same as <%insert_list_links%>
Example:         <UL<%insert_new_links%></UL> will display an HTML list of new links

<%insert_pick_links%>

Description:     Displays all links marked “pick”. Pick is a criterion based on flag “editor’s pick’ and is controlled by the admin.
Scope:             Same as <%insert_list_links%>
Result:             Same as <%insert_list_links%>
Processing:      Same as <%insert_list_links%>
Example:         <UL<% insert_pick_links %></UL> will display an HTML list of picked links

<%insert_search_links%>

Description:     Displays all links resulting from a search, either basic or advanced.
Scope:             Same as <%insert_list_links%>
Result:             Same as <%insert_list_links%>
Processing:      Same as <%insert_list_links%>
Example:         <UL<% insert_search_links %></UL> will display an HTML list of resulting links from the previous search

<%insert_mod_links%>

Description:     Displays all links belonging to the currently logged in user. Will use list_mod_links.tpl to display each individual link. If user is not logged in, will produce an empty list.
Scope:             Same as <%insert_list_links%>
Result:             Same as <%insert_list_links%>
Processing:      Same as <%insert_list_links%>
Example:         <UL<% insert_mod_links %></UL> will display an HTML list of user links

<%insert_link_count%>

Description:     Displays the number of links displayed by one of the <%insert_xxx_links%> tags.
Scope:             Same as <%insert_list_links%>, however is does not have to be used in the top-level templates.
Result:             Number
Processing:      Short
Example:         (<%insert_link_count%>) will display (N) where N is the number of links

<%stats_links%>

Description:     Displays the total number of links in the system. Please note, that it will display the number of physical links and may not be equal to the sum of links in all categories due to the fact that one link can be in multiple categories.
Scope:             Anywhere in the system
Result:             Number
Example:         <SPAN class="stats_small"><%stats_hits%></SPAN> will display N, where N is the # of links in the database.

<%link_link%>

Description:     Displays the link reference from the URL field of the link record, to be used in HTML <a> tag, href option.
Scope:             Any template that is related to a single link (versus templates that display a list of links, where it will not be applicable)
Result:             a reference to system script action.php that will record the hit and redirect the browser to the destination, specified in the URL field of the link record.
Processing:      Short
Example:         <A class="link" href="<%link_link%>">Click here</A> will display a Click here link to the destination, specified in the URL field of each link

<%link_desc%>

Description:     Displays the description of the link
Scope:             Same as <%link_link%>
Result:             Displays the contents of the Description field of each link
Processing:      Short
Example:         <SPAN class="link_desc"> - <%link_desc%></SPAN> will display “- N” where N is the description of the link

<%link_image%>

Description:     Displays the images associated with each link
Scope:             Same as <%link_link%>
Result:             Displays the contents of the Graphic field of the link. If the field is blank, will display the Default value specified by admin to avoid “broken” image in the browser
Processing:      Short
Example:         <IMG SRC=”<%link_image%> ALT=”image”> will display the image associated with the link or default. Always returns a value unless disabled by admin.

<%link_date%>

Description:     Displays the date of link creation (can be modified by admin) formatted in accordance to the system date format specified by the admin
Scope:             Same as <%link_link%>
Result:             Date field contents of each link, formatted
Processing:      Short
Example:         <%link_date%> will display mm/dd/yyyy where mm is month, dd is day and yyyy is year if admin specifies the m/d/Y format

<%link_hits%>

Description:     Displays the number of hits of each link
Scope:             Same as <%link_link%>
Result:             Number
Processing:      Short
Example:         <%link_hits%> will display N, where N is the hits of each link

<%link_rating_txt%>

Description:     Displays the rating of each link in numeric format (0.00)
Scope:             Same as <%link_link%>
Result:             Number in the format N.MM (min 0, max 5)
Processing:      Short
Example:         <%link_rating_txt%> will display 1.23 if the rating of the link is 1.23

<%link_rating_img%>

Description:     Displays an image corresponding to the each link’s rating. The tag will look for 11 image files in directory ‘rating’ under the current theme. The file names have to be 0.gif, 0_half.gif, 1.gif, 1_half.gif … 5.gif
Scope:             Same as <%link_link%>
Result:             Relative path to the image. Does not check for file presence
Processing:      Short
Example:         If link’s rating is 3.6, will <IMG src="<%link_rating_img%>"> will produce <IMG src="rating/3_half.gif"> and the browser should display the appropriate image, if the file is found.

<%link_votes%>

Description:     Displays the number of votes of each link
Scope:             Same as <%link_link%>
Result:             Number
Processing:      Short
Example:         <%link_votes%> will display N, where N is the number of times somebody voted for (rated) that specific link

<%link_reviews%>

Description:     Displays the number of reviews of each link
Scope:             Same as <%link_link%>
Result:             Number
Processing:      Short
Example:         <%link_reviews%> will display N, where N is the number of reviews (not including pending) of that specific link

<%link_review_link%>

Description:     Displays a link reference to be used in HTML <a> tag, href option to the reviews.tpl that will display the reviews for that link.
Scope:             Same as <%link_link%>
Result:             relative path (link) that will display appropriate template
Processing:      Short
Example:         <A href="<%link_review_link%>"> Click here </A> will produce a link ‘Click here’ to the review page of that link.

<%link_rate_link%>

Description:     Displays a link reference to be used in HTML <a> tag, href option to the rate.tpl that will display the rating screen for that link.
Scope:             Same as <%link_link%>
Result:             relative path (link) that will display appropriate template
Processing:      Short

<%link_top%>

Description:     Displays the “top” marker for each top link
Scope:             Same as <%link_link%>
Result:             Text, content of the language variable lu_link_top or blank
Processing:      Short
Example:         Name<span class=”small”><%link_top%></span> will display “top” or nothing, where “top” is the value of the language variable.

<%link_pop%>

Description:     Displays the “pop” marker for each pop link
Scope:             Same as <%link_link%>
Result:             Text, content of the language variable lu_link_pop or blank
Processing:      Short
Example:         Name<span class=”small”><%link_ pop %></span> will display “pop” or nothing, where “pop” is the value of the language variable.

<%link_new%>

Description:     Displays the “new” marker for each new link
Scope:             Same as <%link_link%>
Result:             Text, content of the language variable lu_link_new or blank
Processing:      Short
Example:         Name<span class=”small”><%link_ new%></span> will display “new” or nothing, where “new” is the value of the language variable.

<%link_id%>

Description:     Displays the internal database id of each link. Has no meaning to the end user.
Scope:             Same as <%link_link%>
Result:             Unique number
Processing:      Short
Example:         <%link_id%> will display 5647, where 5647 is the unique identifier of that specific link.

<%link_drop_name%>

Description:     Displays the sorting by name choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by name for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>name</option> tag, where name is the value of language variable lu_drop_name
Processing:      Short
Example:         <SELECT><%link_drop_name%></SELECT> will produce the drop down with the choice ‘name’.

<%link_drop_date%>

Description:     Displays the sorting by date choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by date for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected> date </option> tag, where date is the value of language variable lu_drop_date
Processing:      Short
Example:         <SELECT><%link_drop_date %></SELECT> will produce the drop down with the choice ‘date’.

<%link_drop_description%>

Description:     Displays the sorting by description choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by description for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>description</option> tag, where description is the value of language variable lu_drop_description
Processing:      Short
Example:         <SELECT><%link_drop_description %></SELECT> will produce the drop down with the choice ‘description’.

<%link_drop_user%>

Description:     Displays the sorting by link owner choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by link owners for end-users. Note that it will not sort by link owner name, but by link owner internal id (due to performance-related system restrictions). It can be used to display links grouped by their owners, rather than sorted.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>user</option> tag, where user is the value of language variable lu_drop_user
Processing:      Short
Example:         <SELECT><%link_drop_user%></SELECT> will produce the drop down with the choice ‘user’.

<%link_drop_editors_pick%>

Description:     Displays the sorting by editor’s pick choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by editor’s pick for end-users. Note that if the forcing of editor’s pick is enabled by the admin, the picked links will be displayed at the top overriding any sorting option. In that case this option becomes mute.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>pick</option> tag, where pick is the value of language variable lu_drop_pick
Processing:      Short
Example:         <SELECT><%link_drop_editors_pick%></SELECT> will produce the drop down with the choice ‘pick’.

<%link_drop_image%>

Description:     Displays the sorting by image choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by image for end-users. If link’s graphic file name has any meaning, sorting by it could provide additional value to the end user.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>image</option> tag, where image is the value of language variable lu_drop_image
Processing:      Short
Example:         <SELECT><%link_drop_image%></SELECT> will produce the drop down with the choice ‘image’.

<%link_drop_url%>

Description:     Displays the sorting by URL choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by URL for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected> URL </option> tag, where URL is the value of language variable lu_drop_url
Processing:      Short
Example:         <SELECT><%link_drop_url%></SELECT> will produce the drop down with the choice ‘URL’.

<%link_drop_rating%>

Description:     Displays the sorting by rating choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by rating for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected> rating </option> tag, where rating is the value of language variable lu_drop_ rating
Processing:      Short
Example:         <SELECT><%link_drop_rating %></SELECT> will produce the drop down with the choice ‘rating’.

<%link_drop_votes%>

Description:     Displays the sorting by the number of votes choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by votes for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>votes</option> tag, where votes is the value of language variable lu_drop_votes
Processing:      Short
Example:         <SELECT><%link_drop_votes%></SELECT> will produce the drop down with the choice ‘votes’.

<%link_drop_hits%>

Description:     Displays the sorting by hits choice in the link sort drop down. Used to allow (by including) or disallow (by removing) sorting by hits for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>hits</option> tag, where hits is the value of language variable lu_drop_hits
Processing:      Short
Example:         <SELECT><%link_drop_hits%></SELECT> will produce the drop down with the choice ‘hits’.

<%link_drop_ascending%>

Description:     Displays the sorting type option in a separate drop down. Will sort any option selected in the Sort drop down ascending. Used to allow (by including) or disallow (by removing) ascending sorting for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>Asc</option> tag, where Asc is the value of language variable lu_drop_ascending
Processing:      Short
Example:         <SELECT><%link_drop_ascending%></SELECT> will produce the drop down with the choice ‘Asc’.

<%link_drop_descending%>

Description:     Displays the sorting type option in a separate drop down. Will sort any option selected in the Sort drop down descending. Used to allow (by including) or disallow (by removing) descending sorting for end-users.
Scope:             <SELECT> statement in sort_links.tpl or similar template
Result:             <option value”xx” selected>Desc</option> tag, where Desc is the value of language variable lu_drop_ descending.
Processing:      Short
Example:         <SELECT><%link_drop_ descending%></SELECT> will produce the drop down with the choice ‘Desc’.

<%link_id%>

Description:     Displays the internal database id of each link. Has no meaning to the end user.
Scope:             Same as <%link_link%>
Result:             Unique number
Processing:      Short
Example:         <%link_id%> will display 5647, where 5647 is the unique identifier of that specific link.

<%link_path%>


Description:     Displays the hierarchy path to the link.
Scope:             Same as <%link_link%>
Result:             Text
Processing:      Short
Example:         <%link_path%> will display "Computers > Internet" if link is in Internet category.

<%link_custX%>

Description:     Displays the custom link field X, where X is a number 1-6.
Scope:             Same as <%link_link%>
Result:             Text
Processing:      Short
Example:         <%link_cust3%> will display the data from the third custom field of that link.

<%report_dead_link%>

Description:     Outputs the url for reporting dead link. When clicked, will send email to all admin reporting the dead link.
Scope:             Same as <%link_link%>
Result:             URL
Processing:      Short
Example:         <a href="<%report_dead_link%>">Report This Link</a>

continue >>