tqExpert Help


You use an album tqTag to enable a tqAdmin (with suitable permissions) to display a collection of pictures.

album - Syntax

<tqtag name="album0type="albumtitle="Album title" [maxItems="100"] [itemsPerRow="4"] [rowDelimiter="tr"] >

album - Parameters

Parameter Name Type Mandatory Strict | Transitional Case Sensitive Description
type Text + S + must be album
name Text + S + should be unique tqtag name in the template. no spaces/commas/single quote/double quotes allowed
title Alpha Numeric + S - The title of the tqtag. This title will be presented only at the back-end system.  no spaces/commas/single quote/double quotes allowed
alternativeTag Text + S + Specify a case declared within the alternative tqTag.
alternativeCondition Text + S + (optional, if the condition is specified within the alternative tqTag) Indicate a condition for the case that you are specifying. Use one of the values described for this field under alternative, for example, isSlideShow.
itemsPerRow Number - S   Number of pictures to show before adding the rowDelimiter
maxItems Number - S   The max number of pictures to display in a page
rowDelimiter Text - S   HTML tag to  add after itemsPerRow (e.g. rowDelimiter="tr" or rowDelimiter="ul") the system will close and open the rowDelimiter tag everytime itemsPerRow reached.

album - Local Variables

Name Type Size Description
addDate datetime   The datetime the album was created or last modified. can be formated using 2009-01-09 08:34:47df:[format]!
albumDescription text 65535 The description of the album
albumID number 12 The album database id
albumName text 100 The name of the album
author text 1024 The ezadmin3 userID that created/uploaded the album. the syntax to get the author information is :[property name]! (e.g. :fName! )
bigPic1 text 200 Picture large image url
content text 65535  The content of the picture
counter number  6 Running number from 1 to n represent the place of the picture in the retrieved album pictures (e.g. 4th picture in the retrieved list of pictures will have the number 4)
id number  6 Picture database id
link text ~100 href link to the picture page
linkToAlbum text ~100 link to the  album currently viewing
mainPic text 200  Picture big image url
mainPicHeight number 6 Picture big image height in pixels
mainPicWidth number 6 Picture big image width in pixels
numPicsInAlbum number 6 Number of active pictures in album
numRaters number 6 Number of users rated the picture
numResponses number 6 Number of users provided talkback on the picture
numViews number 6 Number of users viewed the picture
redirectTo text 1024 href to external/internal url 
showOrder number 5 Represent the order number of the picture in the album, this number is not a running number. if you are looking for the running numbers of pictures in the album use @counter@
smallPic text 200  Picture small image url
mediumPic text 200 Picture medium image url
sumRaters number 6 the total sum of the raters scores. to get average rating use @:sumRates@ / @numRaters@ 
title text 30 Picture title

album - Examples

Example 1 - album simple use (based on template t342
<tqtag name="album0type="albummaxItems="1title="Album title" >
    <p class="blueELK13N">@albumName@</p>
    <p class="norm11">
        <a href="@link@"><img src="@smallPic@" alt="img" width="50" height="50" class="float5px" />@albumDescription@</a>

Example 2 - album width row delimiter to fit to tables, divs etc... (based on template t517)
<tqtag name="album0type="albummaxItems="999itemsPerRow="4rowDelimiter="tr" >
    <td align="center" valign="top">
        <img src="@smallPic@" border="0" alt="" width="80" height="80" onclick="showFile('@link@','@mainPicWidth@','@mainPicHeight@')" style="cursor:pointer;" />

album - tqOptions

Within the album tqtag you can use the following tqoptions: head, if, lastItemInRow, tail.
Related tqoptions used in other tqtags: albumsListOfPages, galleryInfo, nextAlbumPage, prevAlbumPage.

album - Templates

The templates below implement this tqTag.  After you click a link, use your browser commands to view the page source.

User Notes

  Add Note

Topic: album