![]() |
Help | ![]() |
![]() |
Format: <%[tag_name]:[tag_value]%>
Description: Variable tags will accept any value after the ‘:’ and try to process it.
Description: Prints any language variable to the screen. If the variable is not defined, prints a blank. The tag will read language variables from language.php in the current language set.
Valid values: Tag_value can be any variable (without the $) from language.php in the current language set. Invalid value will not affect the system.
Scope: Anywhere in the system
Result: language text or blank
Processing: Short
Example: <%language:lu_welcome%> Will display “Welcome”, if the default English language set is used.
Description: Includes a template file. The file will be included as is and in all cases – no conditions are available for this tag. It has built-in prevention from getting into a never-ending loop if you include the template itself.
Valid values: Any template in the current theme. Use the exact file name without .tpl extension. Invalid value will display error message “file not found [file name]” from the current language file.
Scope: Anywhere, but keep in mind that it will insert resulting HTML from the target template and account for it.
Result: processed template or text error
Processing: Short
Example: <%include:header%> Will include the HTML code from header.tpl
Description: Displays a choice of the number of results to display. Should be used to restrict the visitor on the number of links displayed per page. Useful on slow servers to avoid long download time.
Valid value: Tag_value can be any positive integer (Arabic) or “all” to display all results. Note that invalid value will cause system errors.
Scope: Within the HTML <Select> tag in sort_cats.tpl and sort_links.tpl
Result: Extra choice in the drop down for each tag. System errors if wrong value.
Processing: Short
Example: <%drop_results:5%> Will display 5 in the drop down menu.
Description: By default, it will provide a link to the template specified in the tag_value. Similar to <%include: %>, however it will not process the template. There are special cases. Returns
Valid value: Any template from the current theme set. Use the exact file name without .tpl extension. There are special values that will still load the appropriate templates, but they will also do some required processing:
add_link
link
registration
add_review
review
These templates and several others cannot be renamed.
Scope: Anywhere in the system.
Result: relative URL to be used within HTML <a> tag
Processing: Short/Medium
Example: <A href="<%nav:registration%>"> Click here to register </a> Will display a proper link to the registration page
Format: <%[tag_name] %>
Description: Fixed tags make up the majority of system tags. They have to be spelled exactly in order to work.
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
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
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
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
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
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
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
Description: Displays all favorite links belonging to the currently logged in user. Will use list_fav_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_fav_links %></UL> will display an HTML list of user’s favorite links
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
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.
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
Description: Displays the link reference from the URL field of the link record. This tag displays the actual URL of the link, as opposed to <%link_link%>, which sends the user through the In-Link redirector.
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: <%link_link%> will display the URL of the link.
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
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.
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
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
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
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.
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
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
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.
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
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.
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.
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.
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.
Description: Displays the URL for delete a link from the favorites list
Scope: Only used in list_fav_links.tpl
Result: URL
Processing: Short
Example: <A href="<%link_remove_fav%>"> Remove </A>.
Description: Displays the URL for adding a link to the favorites list
Scope: Same as <%link_link%>
Result: URL
Processing: Short
Example: <A href="<% link_add_fav %>"> Remove </A>.
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’.
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’.
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’.
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’.
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’.
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’.
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’.
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’.
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’.
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’.
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’.
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’.
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.
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.
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.
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>
Description: Displays the Name of the user who owns the link.
Scope: Same as <%link_link%>
Result: Text
Processing: Short
Example: <a href=”mailto:<% link_user_email %>”><%link_user_name %></a>
Description: Displays the email for the user who owns the link.
Scope: Same as <%link_link%>
Result: Text
Processing: Short
Example: <a href=”mailto:<% link_user_email %>”><%link_user_name %></a>
Description: Displays the list of categories for a sub-category or Home.
Scope: Any top-level template
Result: Pre-formatted table containing the categories. Admin has control over how many columns the table is broken up into.
Processing: Long
Example: <%insert_list_cats%> will produce the listing of categories using the list_cats.tpl for each category.
Description: Displays result of searching for categories.
Scope: Any top-level template
Result: Pre-formatted table containing the categories. Admin has control over how many columns the table is broken up into.
Processing: Long
Example: <%insert_search_cats%> will produce the listing of categories using the list_cats.tpl for each category.
Describe: Displays the number of categories displayed on the screen
Scope: Any top level template, where the <%insert_list_cats%> or similar tag is called
Result: Number
Processing: Short
Example: (<%insert_cat_count%>) will display (N), where N is the number of categories
Description: Displays the list of all related categories for the current category.
Scope: Any top-level template
Result: Pre-formatted table containing the related categories. Admin has control over how many columns the table is broken up into.
Processing: Long
Example: <% insert_rel_cats %> will produce the listing of related categories using the list_rel_cats.tpl for each category.
Describe: Displays the number of related categories displayed on the screen
Scope: Any top level template, where the <%insert_rel_cats%>
Result: Number
Processing: Short
Example: (<%insert_count_rel%>) will display (N), where N is the number of related categories
Description: Displays the total number of categories in the database (not including the pending categories)
Scope: Anywhere in the system
Result: Number
Processing: Short
Example: <%insert_cat_count%> will display N, where N is the number of categories in the system
Description: Displays number of links in a category, excluding pending links
Scope: In templates displaying categories
Result: Number
Processing: Short
Example: <%cat_num_links%> will display N, where N is the number of links in the category
Description: Displays category graphic or default image, to be used in the HTML <IMG> tag, SRC option.
Scope: Same as <%cat_num_links%>
Result: relative path to an image
Processing: Short
Example: <IMG SRC=”<%cat_image%>”> will display the category graphic from the image field in the category or default if blank.
Description: Displays the category name
Scope: Same as <%cat_num_links%>
Result: text
Processing: Short
Example: <%cat_name%> will print the category name
Description: Displays number of sub categories in a category, excluding pending categories
Scope: In templates displaying categories
Result: Number
Processing: Short
Example: <%cat_num_cats%> will display N, where N is the number of sub categories in the category
Description: Displays the category description
Scope: Same as <%cat_num_links%>
Result: text, advisable to place in a text area, since it could be long
Processing: Short
Example: <TEXTAREA> <%cat_desc%> </TEXTAREA> will print the category description
Description: Displays the date a category was created in the admin – specified format.
Scope: Same as <%cat_num_links%>
Result: text date, preformatted
Processing: Short
Example: <%cat_date%> displays “mm/dd/yyyy” - category creation date
Description: Displays the label “pick” for editor’s picks. The label comes from the current language file and is called lu_cat_pick.
Scope: Same as <%cat_num_links%>
Result: text
Processing: Short
Example: <%cat_pick%> will print “pick” for editor’s picks with default English language file.
Description: Displays internal database category id – unique in the system.
Scope: Same as <%cat_num_links%>
Result: Number
Processing: Short
Example: <%cat_id%> will print 7968 where 7968 is the internal cat id.
Description: Displays the meta keywords stored for each category or default if bank Should be used in category template in the <META> HTML keyword for search engine registration.
Scope: Same as <%cat_num_links%>
Result: text
Processing: Short
Example: <META name="keywords" content="<%meta_keywords%>"> will properly set the meta tag for the category page.
Description: Displays the meta description stored for each category or default if bank Should be used in category template in the <META> HTML keyword for search engine registration.
Scope: Same as <%cat_num_links%>
Result: text
Processing: Short
Example: <META name="description" content="<%meta_desc%>"> will properly set the meta tag for the category page.
Description: Displays the hierarchy path to the category.
Scope: Same as <%cat_num_link%>
Result: Text
Processing: Short
Example: <%cat_path%> will display “Computers > Internet” if cat is under the Internet category.
Description: Displays the custom cat field X, where X is a number 1-6.
Scope: Same as <%cat_num_link%>
Result: Text
Processing: Short
Example: <%cat_cust3%> will display the data from the third custom field of that category.
The tags above control the sorting of categories. Please see similar tags in Links section for more description. The tags are applicable within the Cat Sorting Form.
Description: Displays a list of all reviews related to the current link
Scope: Any link-detail template
Result: Output of all link’s reviews using list_reviews.tpl
Processing: Long
Example: <%insert_list_reviews%< will produce a list of all reviews of a link
Describe: Displays the number of reviews displayed on the screen
Scope: Any top level template, where the <%insert_list_reviews%> or similar tag is called
Result: Number
Processing: Short
Example: (<%insert_rev_count%>) will display (N), where N is the number of reviews
Description: Displays the review text
Scope: Review-detail template, list_reviews.tpl
Result: Text
Processing: Short
Example: <%review_text%> will produce: “this is a sample review” for a review with that body.
Description: Displays pre-formatted date of the review (can be changed by the admin)
Scope: Review-detail template, list_reviews.tpl
Result: Pre-formatted date
Processing: Short
Example: <%review_date%> will produce “mm/dd/yyyy” , if those are the admin date settings.
Description: Displays the email of the user who submitted the review. Can be used in the HTML <A> tag, HREF option, in conjunction with mailto:
Scope: Review-detail template, list_reviews.tpl
Result: email address
Processing: Short
Example: <A href="mailto:<%review_user_email%>">email me</a> willproduce a link, which will generate a new email message.
<%review_user%>
Description: Displays the user name of the user who submitted the review.
Scope: Review-detail template, list_reviews.tpl
Result: text, user name
Processing: Short
Example: <%review_user%> will display “intechnic” for a review submitted by a user “intechnic”.
Description: Displays the title of the site, set by administrator
Scope: Anywhere in the system
Result: Text
Processing: Short
Example: <TITLE><%insert_title%></TITLE> will properly name the pages
Description: This tag does not produce any output. It exists to indicate to the system that the current template is the top-level template. The sort order will be preserved in all other templates linked from the current one, until this tag is encountered again.
Scope: The first tag in top-level templates
Result: No output
Processing: Short
Example: <%preserve_order%> used in some.tpl will store the Cat Sort, Link Sort and Number of results variables, so when users rate links, review links and use other forms on the site, when they come back to some.tpl, all of them will be preserved. The live example can be observed in the index.tpl, top.tpl, etc., while the tag is not used in box_search.tpl and add_review.tpl.
Description: Displays the box_login.tpl if user is not logged in, or nothing if the user is logged in
Scope: Anywhere in the system
Result: box_login.tpl output (login form) or nothing
Processing: Short/Medium
Example: <%insert_login%> used on the front page will make the site interactive by showing the login box to new users, and not showing it to the logged in users. Should be used in conjunction with the <%msg_welcome%> tag.
Description: Displays a “welcome user” message, or “not logged in” message depending on whether the user is logged in or not.
Scope: Anywhere in the system
Result: lu_welcome language variable followed by user name or lu_not_logged_in language variable
Processing: Short
Example: <%msg_welcome%> will display “welcome intechnic” to a user with user name “intechnic” and default English language.
Description: Displays the sum of all clicks made on the links displayed by In-link. Not to be confused with the number of hits to the site itself, which is currently not tracked by the system.
Scope: Anywhere in the system
Result: Number
Processing: Short
Example: <%stats_hits%> will display 46321, where 46321 is the total clicks on all links in the system.
Description: Displays the navigation bar with the category tree.
Scope: Top-level templates
Result: String of text
Processing: Medium
Example: <%insert_navbar%> will display “Home > Business and Economy > Business to Business > Marketing and Advertising > Advertising > Outdoor Advertising >” with appropriate links in directory with above categories.
Description: Displays page navigation in chunks of 10. The links to first 10 pages are displayed at ones. If more pages are available, a sign “>>” will appear. If it is clicked, next 10 pages are displayed, and the sign “<<” appears to go back. Otherwise clicking on a page number will lead to that page.
Scope: Templates displaying lists of links such as <%insert_list_links%>
Result: Text with variable number of pages depending on the amount of output and “number or results to display” setting.
Processing: Medium
Example: <%insert_pagenav%> will display “Go To Page 1 2 3 4 5 6 7 8 9 10 >>” if the number of results exceeds 10 pages. The page you are currently on is not a link, the rest are links to appropriate pages.
Description: Logs out a user and navigates to Home. Should be used within a HTML <A> tag, HREF option
Scope: Anywhere in the system
Result: relative path to a script
Processing: Short
Example: <a href=”<action_logout%>”> Logout </a> - if the user clicks on the link, they will be logged out and the front page of the site will be displayed
Description: Displays the text message passed to the template
Scope: error.tpl
Result: text
Processing: Short
Example: <%error_message%> will show “Login Incorrect” on the error.tpl if the login fails under default English language.
Description: Resets the HTML base reference to the current theme. Enables usage of relative paths for theme-specific images, rating, style sheet, etc.
Scope: Any template, before any path is used
Result: base reference tag
Processing: Short
Example: <%insert_base_ref%> will produce <base href="http://www.yoursite.com/inlink/themes/default/"> on a domain ‘yoursite.com’ and default theme.
Description: Displays the code that other people can use on their sites to rate a link resource on your site. Should be included in <PRE> </PRE> tags or in a text area in order to escape HTML.
Scope: getting_rated.tpl
Result: HTML code
Processing: Medium
Example: <textarea rows="20" name="<%textarea_name%>" cols="60">
<%getting_rated_link%>
</textarea> will display the copy/paste ready HTML code.
Description: Displays the link to getting_rated.tpl, page that shows HTML code to rate your links on other sites. To be used in the HTML <A> tag, HREF option.
Scope: Anywhere in the system
Result: relative path
Processing: Short
Example: <a href=”<%link_getting_rated%>”> click here to get code </a> will go to the template that will display HTML code for getting rated.
Description: Displays the message at the confirm screen.
Scope: Only in the confirm template
Result: Text
Processing: Short
Example: <% confirm_message %> will return the message
<%confirm_action%>
Description: Form action tag for the confirm page.
Scope: Only in the confirm template
Result: URL
Processing: Short
Example: <form action=”<%confirm_action%>”>
<%confirm_action%>
Description: Form action tag for the confirm page.
Scope: Only in the confirm template
Result: URL
Processing: Short
Example: <form action=”action=../../index.php?<%confirm_ attach%>”>
<% confirm_attach%>
Description: Form hidden value for the confirm page.
Scope: Only in the confirm template
Result: Text
Processing: Short
Example: <input type="hidden" name="action" value="<%confirm_action%>">
<%insert_sid %>
Description: Returns the session ID in a form sid=$sid& for all links
Scope: In every link
Result: Text
Processing: Short
Example: <a href=”../../index.php?< %insert_sid %>”>
<%insert_current_cat_id %> and <%insert_cat_id%>
Description: Returns the category id you are in.
Scope: sub_pages.tpl
Result: Text
Processing: Short
Example: <%insert_current_cat_id%> will give you the value of the “cat” which was passed in the url.
<%getSearchKeyword %>
Description: Returns the keyword a user searched for.
Scope: display_ link _search.tpl and display_ cats_search.tpl
Result: Text
Processing: Short
Example: You search for <%getSearchKeyword %> return N results
Please note, that ‘method’ option in all front-end forms should be ‘post’: <FORM ACTION=”<%form_action_tag_goes_here%>” METHOD=”post”>
All tags used in forms have the following format:
<%form_[type]_[tpl name]_[item name]%>
Examples:
<%form_button_add_link_selcat%>
<%form_select_add_link_cat%>
<%form_action_search_advanced%>
These tags are required to be present in the “name” options of each processed <input> item, <form> tag and <select> tag.
For time-saving purposes we recommend to preserve the templates that are delivered with the system and making necessary changes to their HTML portions.
The following tags are required in order for the form to function properly:
<%form_action_add_link%> - main form tag
<%form_button_add_link_selcat%> - button that selects sub categories
<%form_button_add_link_addcat%> - button that adds selected category
<%form_button_add_link_addlink%> - button that submits the form
<%form_button_add_link_reset%> - button that resets the form
<%form_button_add_link_cancel%> - button that returns to the previous screen
Following are tags that control each <input> tag. They should be used in the following format:
<INPUT type="text" name="<%form_input_add_link_name%>" value="<%val_link_name%>">
<%err_link_name%> can be used anywhere on the form and will display an error in case of wrong entry
Text field names:
<%form_input_add_link_name%>
<%form_input_add_link_url%>
<%form_input_add_link_desc%>
<%form_input_add_link_image%>
<%form_input_add_link_cust1%>*
<%form_input_add_link_cust2%>*
<%form_input_add_link_cust3%>*
<%form_input_add_link_cust4%>*
<%form_input_add_link_cust5%>*
<%form_input_add_link_cust6%>*
Error output:
<%err_link_name%>
Text field values:
(required to pre-fill the values when an error occurs)
<%val_link_name%>
<%val_link_url%>
<%val_link_desc%>
<%val_link_image%>
<%val_link_cust1%>*
<%val_link_cust2%>*
<%val_link_cust3%>*
<%val_link_cust4%>*
<%val_link_cust5%>*
<%val_link_cust6%>*
Custom field labels:
(will substitute the actual field names as specified by admin, or if empty will use the labels defined in the current language file)
<%name_link_cust1%>*
<%name_link_cust2%>*
<%name_link_cust3%>*
<%name_link_cust4%>*
<%name_link_cust5%>*
<%name_link_cust6%>*
*- all custom fields are optional on the form and can be removed.
Special tags:
The tags be low are used to facilitate the cross-reference functionality. Each link can be added to multiple categories (with permissions specified by admin)
<%add_link_cat_name%> - must be inserted in add_link_cats.tpl and displays the name of each selected category
<%form_button_add_link_cats_delcat%>- must be inserted in add_link_cat.tpl . It is the name of the button that deletes each category from the link reference list in case of a user mistake.
<%insert_add_link_cats%> - Tag inserts the add_link_cats.tpl, specifies the location of the output of add_link_cat.tpl
<%form_select_add_link_cat%> - Name of the drop down that selects additional categories
<%insert_drop_add_link_cat%> - This tag produces the drop down that shows all available categories
Example of implementation:
<TABLE>
<FORM action="<%form_action_add_link%>" method="post">
<%insert_add_link_cats%>
<TR>
<TD>Additional Categories: </TD>
<TD> <SELECT name="<%form_select_add_link_cat%>">
<%insert_drop_add_link_cat%>
</SELECT>
</TD>
<TD> <INPUT type="submit" name="<%form_button_add_link_selcat%>" value="<%language:lu_select%>">
<INPUT type="submit" name="<%form_button_add_link_addcat%>" value="<%language:lu_add_cat%>">
</TD>
</TR>
</TABLE>
The following tags are required for the login form to work properly:
<%form_action_login%> - form name
<%form_input_login_username%> - ‘user name’ text field name
<%form_input_login_password%> - ‘password’ text field name
<%form_button_login_login%> - form submit button, logs the user in
This form will generate a custom email from the language template. The email can be used for any purpose, but primarily it is designed to suggest your site to a friend of the visitor. The following fields are required for this form to work:
<%form_action_suggestsite%> - form name
<%form_button_suggest_send%> - submit button that generates the email
<%form_input_suggest_email%> - input text field that accepts the email address
This form allows a visitor to register as a site user. The user is registered directly or as pending user, depending on admin permissions.
<%form_action_registration%> - form name
<%form_action_registration_no_password%>
<%val_form_button_registration_submit%> - submit button
<%val_form_button_registration_reset%> - reset button
<%val_form_button_registration_cancel%> - cancel button
Text field names:
<%form_input_registration_user_name%>
<%form_input_registration_user_pass%>
<%form_input_registration_re_pass%>
<%form_input_registration_first%>
<%form_input_registration_last%>
<%form_input_registration_email%>
<%form_input_registration_cust1%>*
<%form_input_registration_cust2%>*
<%form_input_registration_cust3%>*
<%form_input_registration_cust4%>*
<%form_input_registration_cust5%>*
<%form_input_registration_cust6%>*
Validation Errors:
(can be placed anywhere on the form)
<%error_username%>
<%error_password%>
<%error_first%>
<%error_last%>
<%error_re_pass%>
<%username_used%>
<%email_used%>
Text field values:
<%val_user_name%>
<%val_first%>
<%val_last%>
<%val_email%>
<%val_user_cust1%>*
<%val_user_cust2%>*
<%val_user_cust3%>*
<%val_user_cust4%>*
<%val_user_cust5%>*
<%val_user_cust6%>*
Custom field labels:
<%user_cust1%>*
<%user_cust2%>*
<%user_cust3%>*
<%user_cust4%>*
<%user_cust5%>*
<%user_cust6%>*
* - all custom fields are optional
This form allows logged in user to modify their profile information.
<%form_action_profile%> - form name
<%val_form_button_registration_submit%> - submit button
<%val_form_button_registration_reset%> - reset button
<%val_form_button_registration_cancel%> - cancel button
Text field names:
<%form_input_registration_user_name%>
<%form_input_registration_user_pass%>
<%form_input_registration_re_pass%>
<%form_input_registration_first%>
<%form_input_registration_last%>
<%form_input_registration_email%>
<%form_input_registration_cust1%>*
<%form_input_registration_cust2%>*
<%form_input_registration_cust3%>*
<%form_input_registration_cust4%>*
<%form_input_registration_cust5%>*
<%form_input_registration_cust6%>*
This form changes the way categories are sorted. It has two drop-downs, Sort and Sort Type. See sections above for description of the drop value tags.
<%form_action_sort_cats%> - form name
This form changes the way links are sorted and the number of links displayed per page. It has three drop-downs, Num of Results, Sort and Sort Type. See sections above for description of the drop value tags.
<%form_action_sort_links%>
Validation Errors:
(can be placed anywhere on the form)
<%error_username%>
<%error_password%>
<%error_first%>
<%error_last%>
<%error_re_pass%>
Text field values:
<%val_user_name%>
<%val_first%>
<%val_last%>
<%val_email%>
<%val_user_cust1%>*
<%val_user_cust2%>*
<%val_user_cust3%>*
<%val_user_cust4%>*
<%val_user_cust5%>*
<%val_user_cust6%>*
Custom field labels:
<%user_cust1%>*
<%user_cust2%>*
<%user_cust3%>*
<%user_cust4%>*
<%user_cust5%>*
<%user_cust6%>*
* - all custom fields are optional
This form is used to rate a link.
<%form_action_rate%> - form name
<%form_rate_radio_vote%> - input radio button with rating values 1-5
<%form_rate_button_rate%> - submit button that rates
<%form_rate_button_cancel%> - canel button
This form is used to perform a simple search
<%form_action_search%> - form name
<%form_input_search_keyword%> - input text name for keyword
<%form_button_search_submit%> - submit button to execute the search
<%select_links%> - returns option to search for links from the current language file
<%select_cats%> - returns option to search for categories from the current language file
This form is used to perform advanced search in the system.
<%form_action_search_advanced%> form name - required
All of these fields are not required and can be removed in order to limit the user:
<%form_input_search_cat_name%> - category name search
<%form_input_search_cat_desc%> - category description search
<%form_input_search_cat_fmonth%> - month from (all date fields are one block)
<%form_input_search_cat_fday%> - day from (all date fields are one block)
<%form_input_search_cat_fyear%> - year from (all date fields are one block)
<%form_input_search_cat_lmonth%> - month to (all date fields are one block)
<%form_input_search_cat_lday%> - day to (all date fields are one block)
<%form_input_search_cat_lyear%> - year to (all date fields are one block)
<%form_radio_search_cat_pick%> - category editor’s pick
<%form_input_search_cat_ccust1%> - category custom field 1
<%form_input_search_cat_ccust2%> - category custom field 2
<%form_input_search_cat_ccust3%> - category custom field 3
<%form_input_search_cat_ccust4%> - category custom field 4
<%form_input_search_cat_ccust5%> - category custom field 5
<%form_input_search_cat_ccust6%> - category custom field 6
<%form_input_search_link_name%> - link name
<%form_input_search_link_desc%> - link description
<%form_input_search_link_rating_f%> - rating from
<%form_input_search_link_rating_l%> - rating to
<%form_input_search_link_votes_f%> - number of votes from
<%form_input_search_link_votes_l%> - number of votes to
<%form_input_search_link_hits_f%> - number of hits from
<%form_input_search_link_hits_l%> - number of hits to
<%form_input_search_link_fmonth%> - month from (all date fields are one block)
<%form_input_search_link_fday%> - day from (all date fields are one block)
<%form_input_search_link_fyear%> - year from (all date fields are one block)
<%form_input_search_link_lmonth%>- month to (all date fields are one block)
<%form_input_search_link_lday%>- day to (all date fields are one block)
<%form_input_search_link_lyear%>- year to (all date fields are one block)
<%form_radio_search_link_pick%> - link editor’s pick
<%form_input_search_link_lcust1%> - link custom field 1
<%form_input_search_link_lcust2%> - link custom field 2
<%form_input_search_link_lcust3%> - link custom field 3
<%form_input_search_link_lcust4%> - link custom field 4
<%form_input_search_link_lcust5%> - link custom field 5
<%form_input_search_link_lcust6%> - link custom field 6
<%link_cust1%> - link custom field 1 label
<%link_cust2%> - link custom field 2 label
<%link_cust3%> - link custom field 3 label
<%link_cust4%> - link custom field 4 label
<%link_cust5%> - link custom field 5 label
<%link_cust6%> - link custom field 6 label
<%cat_cust1%> - category custom field 1 label
<%cat_cust2%> - category custom field 2 label
<%cat_cust3%> - category custom field 3 label
<%cat_cust4%> - category custom field 4 label
<%cat_cust5%> - category custom field 5 label
<%cat_cust6%> - category custom field 6 label
Search separator type, valid values are “AND” or “OR”. At least one of these options should be present in order for search to work correctly.
<%form_input_search_sep%>
Number of results displayed: is redundant, since the user can later select how many results to display from the result screen
<%form_input_search_num_result%>
<%form_button_search%> - search submit button
<%form_button_search_reset%> - reset button
<%form_button_search_cancel%> - cancel button
This form lets a visitor to submit a review (in accordance with the permissions set by admin)
<%form_action_add_review%> - form name
<%form_input_add_review_text%> - review text to be placed in the text area
<%form_button_add_review_add%> - submit button to add the review
<%form_button_add_review_reset%> - reset button
<%form_button_add_review_cancel%> - cancel button
Subscribe form consists of one button that changes its value between “Subscribe” and “Unsubscribe”.
<%form_action_subscribe%> - form name
<%form_button_name_subscribed%> - submit button name – subscribes or un-subscribes
<%form_button_subscribed%> - button value (‘Subscribe’ or ‘Unsubscribe’). The actual text comes from the current language file.
<%user_status%> - tag that displays user status: (‘Subscribed’ or ‘Unsubscribed’). The actual text comes from the current language file.
This form is similar to the Add Link form. The difference is that the end user cannot change the categories that the link belongs to, therefore there are no tags that control that portion of the form.
<%form_action_modify_link%> - form name
<%form_button_add_link_addlink%> - button that submits the form
<%form_button_add_link_reset%> - button that resets the form
<%form_button_add_link_cancel%> - button that returns to the previous screen
Following are tags that control each <input> tag. They should be used in the following format:
<INPUT type="text" name="<%form_input_add_link_name%>" value="<%val_link_name%>">
<%err_link_ name%> can be used anywhere on the form and will display an error in case of wrong entry
Text field names:
<%form_input_add_link_name%>
<%form_input_add_link_url%>
<%form_input_add_link_desc%>
<%form_input_add_link_image%>
<%form_input_add_link_cust1%>*
<%form_input_add_link_cust2%>*
<%form_input_add_link_cust3%>*
<%form_input_add_link_cust4%>*
<%form_input_add_link_cust5%>*
<%form_input_add_link_cust6%>*
Error output:
<%err_link_name%>
Text field values:
(required to pre-fill the values when an error occurs)
<%val_link_name%>
<%val_link_url%>
<%val_link_desc%>
<%val_link_image%>
<%val_link_cust1%>*
<%val_link_cust2%>*
<%val_link_cust3%>*
<%val_link_cust4%>*
<%val_link_cust5%>*
<%val_link_cust6%>*
Custom field labels:
(will substitute the actual field names as specified by admin, or if empty will use the labels defined in the current language file)
<%name_link_cust1%>*
<%name_link_cust2%>*
<%name_link_cust3%>*
<%name_link_cust4%>*
<%name_link_cust5%>*
<%name_link_cust6%>*
*- all custom fields are optional on the form and can be removed.
The following templates were configured for the demonstration purposes:
This is a template form for a adding a new link.
This is a template that is used by add_link.tpl to display all categories in which the link is referenced.
This is a template form for adding new link reviews.
This is a template form for a user login box.
This is a template form for a search box.
This is a template form for a mailing list subscribe box.
This is a template form for a box for suggesting the site to a friend.
This is a template for displaying the results of advanced category search.
This is a template for displaying the results of advanced link search.
This is a template for displaying miscellaneous errors.
This is a template to be included as footer in other templates for easy layout purposes.
This is a template to display the actual HTML code that a link owner can put on his site, in order for the user’s link to get rated from that site.
This is a template for the layout of the page where the getting rated code is displayed.
This is a template to be included as header in other templates for easy layout purposes.
This is a template file for the front (root category) page of the entire system.
This is a template to display an individual category listing (category results are maid out of these individual listings).
This is a template to display an individual link listing (link results are maid out of these individual listings).
This is a template to display an individual link listing for modifying by the link owner listing (results for user links are maid out of these individual listings)
This is a template to display an individual Editor Pick’s link listing (Editor Pick’s results are maid out of these individual listings)
This is a template to display an individual review listing (review results are maid out of these individual listings)
This is a template form for the user login page.
This template is for displaying top navigation menu containing the navigation items.
This template is for displaying user services menu containing the navigation items.
This template is reserved for future use.
This is a template to display a listing of links that a user owns, so he modify them.
This is a template form that is used for a user to modify his link.
This is a template to display a list of all links in the system that are marked as “NEW”.
This is a template to display a list of all Editor Pick’s links in the system.
This is a template to display a list of all links in the system that are marked as “POP”.
This is a template form that allows a user to update their personal information.
This is a template form to place a vote for a link.
This is a template form for a user registration.
This is a template to list reviews for a link.
This is a template form for searching links and categories.
This is a template form for performing advanced search on categories.
This is a template form for performing advanced search on links.
This is a template form allowing choosing sorting and ordering for the category results.
This is a template form allowing choosing sorting and ordering for the link results.
This is a template for displaying system-wide statistics.
This is a stylesheet file for the entire theme. All of the individual templates refer to this file.
This is a template to display all the subcategories other than root.
This is a template form for subscribing to a mailing list.
This is a template form for suggesting a category.
This is a template to display a list of all links in the system that are marked as “TOP”.
The following is a standard language set:
This is the main language file for all the system messages displayed in the front end.
This is the main language file for all the system messages displayed in the Administration Panel.
This is a template for the Administration Panel including eror reporting information.
This is a template for the Administration Panel including feedback information
This is a template for the Administration Panel including licensing information.
This is a template for the Administration Panel including the information about the In-link’s official site.
This is a template for the Administration Panel including support information.
This is an e-mail template for sending out e-mail to the specified Administrator in the event when an end user modifies an existing link. (Either pending or direct modification)
This is an e-mail template for sending out e-mail to the specified Administrator in the event when a new category (pending or direct) is suggested by an end user.
This is an e-mail template for sending out e-mail to the specified Administrator in the event when a new link (pending or direct) is added to the system by an end user.
This is an e-mail template for sending out e-mail to the specified Administrator in the event when a new link review (pending or direct) is added to the system by an end user.
This is an e-mail template for sending out e-mail to the specified Administrator in the event when a new user registers with the system.
This is an e-mail template for sending out e-mail for suggesting the site.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when the Administrator approves that user.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when the Administrator denies that user.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when the Administrator approves the link submitted by that user.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when the Administrator denies the link submitted by that user.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when that user modifies his link in the system.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when that user adds a link (pending or direct) to the system.
This is an e-mail template for sending out e-mail to the user (e-mail address specified in the user profile) in the event when that user registers with the system.
This is an e-mail template for sending out e-mail to the user when his links has been reviewed.