Search:
tqExpert Help
| 
forumBunch
For the forum tqTag to display effectively, you also need to define a forumBunch tqTag, specifying one or more of forumShowResponses or forumShowBunch.
forumBunch - Syntax
<tqtag name="bunch0" type="forumBunch" title="bunchesInForum" maxItems="5" [forumShowResponses] [forumShowBunch] >
...
</tqtag>
...
</tqtag>
forumBunch - Parameters
| Parameter Name | Type | Mandatory | Strict | Transitional | Case Sensitive | Description |
|---|---|---|---|---|---|
| type | Text | + | S | + | must be forumBunch |
| 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 |
| filterCustomer | |||||
| forumShowBunch | - | T | + | Retrieves bunch info including the bunch's opening message | |
| forumShowResponses | - | T | + | Tells the system to retrieve maxItems responses for each bunch | |
| maxItems | Number | - | S | The max number of bunches or responses to display in a page |
forumBunch - Local Variables
If, as tqAdmin or tqSuperAdmin, you are creating additional fields for a forumBunch implementation, you can treat these like any of the variables in the following table.
| Name | Type | Size | Description |
|---|---|---|---|
| addDate | datetime | The datetime the section was created or last modified. can be formated using 2009-01-09 11:38:54df:[format]! | |
| bunchAuthor | text | 100 | Bunch creator name |
| bunchCount | number | 8 | Running number from 1 to n |
| bunchDate | datetime | Same as addDate | |
| bunchStatus | number | 1 | Returns the status of the bunch - 1 for new, 2 for hot, 3 for recommemnded. not functional yet |
| bunchSubject | text | 350 | The subject of the bunch |
| content | text | 65535 | Bunch content |
| customerID | number | 12 | Website customer id who created the bunch or the response |
| fileName | text | 1024 | Url to download file attached |
| filterCustomer | number | filterCustomer="someID" | |
| forumID | number | 5 | Bunch's forum database id |
| hot | text | 3 | not functional yet |
| id | number | 12 | bunch database number |
| lastResponse | datetime | The datetime the cu bunch response was created can be formated using 2009-01-09 11:38:54df:[format]! | |
| lastResponseAuthor | text | 100 | The name of the person last responded to this bunch |
| lastResponseDate | date | same as lastResponse | |
| link | text | ~100 | Url to the bunch page |
| linkToAuthor | links to the author's customer profile | ||
| linkToLastResponder | links to the customer profile of the last responder | ||
| locked | text | 3 | not functional yet |
| numResponses | number | 5 | The number of responses to the current bunch |
| numViews | number | 12 | The number of times the bunch was viewed |
| sticky | text | 3 | not functional yet |
| title | text | 350 | same as bunchSubject |
forumBunch - Examples
Example 1 - basic use of forumBunch tqtag
<table>
<tr>
<th>Subject</th><th># views</th><th>Last Response Author</th><th>Last Response date</th><th># responses</th>
</tr>
Example 2 - show only the first message of the bunch
example 3 - show only the responses of the bunch
example 4 - forum, forumBunch and forum responses. One example with al forum's tqtags
<table>
<tr>
<th>Subject</th><th># views</th><th>Last Response Author</th><th>Last Response date</th><th># responses</th>
</tr>
<tqtag name="bunch0" type="forumBunch" maxItems="5" title="bunchesInForum" >
<tr>
<td><a href="@link@">@bunchSubject@</a></td>
<td>@numViews@</td>
<td>@lastResponseAuthor@</td>
<td>@lastResponseDate@</td>
<td>@numResponses@</td>
</tr>
</tqtag>
</table><tr>
<td><a href="@link@">@bunchSubject@</a></td>
<td>@numViews@</td>
<td>@lastResponseAuthor@</td>
<td>@lastResponseDate@</td>
<td>@numResponses@</td>
</tr>
</tqtag>
Example 2 - show only the first message of the bunch
<tqtag name="bunch0" type="forumBunch" maxItems="20" title="bunchesInForum" forumShowBunch >
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td>
<strong>@bunchSubject@</strong><br />
@content@
</td>
</tr>
</tqtag>
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td>
<strong>@bunchSubject@</strong><br />
@content@
</td>
</tr>
</tqtag>
example 3 - show only the responses of the bunch
<tqtag type="forumBunch" maxItems="999" forumShowResponses >
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td >
<strong>@bunchSubject@</strong><br />
@content@
</td>
</tr>
</tqtag>
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td >
<strong>@bunchSubject@</strong><br />
@content@
</td>
</tr>
</tqtag>
example 4 - forum, forumBunch and forum responses. One example with al forum's tqtags
<tqtag name="forum0" type="forum" maxItems="10" title="forum place holder" >
<h2>@mainPic@ - @title@</h2>
<a href="@newBunchLink@">new bunch</a> | <a href="@newResponseLink@">new response</a>
<tqtag name="bunch0" type="forumBunch" maxItems="20" title="bunchesInForum" forumShowBunch >
<div># of views for this bunch: @numViews@ | # responses for this bunch: @numResponses@</div>
<table>
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td>
<div >@bunchSubject@</div>
@content@
<div><a href="@newResponseLink@" class="addBunchLink">@bunchAddResponse@</a></div>
</td>
</tr>
</tqtag>
<tqtag type="forumBunch" maxItems="999" forumShowResponses >
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td >
<div>@bunchSubject@</div>
<br />
@content@
<div><a href="@newResponseLink@" class="addBunchLink">@bunchAddResponse@</a></div>
</td>
</tr>
</tqtag>
</table>
</tqtag>
<h2>@mainPic@ - @title@</h2>
<a href="@newBunchLink@">new bunch</a> | <a href="@newResponseLink@">new response</a>
<tqtag name="bunch0" type="forumBunch" maxItems="20" title="bunchesInForum" forumShowBunch >
<div># of views for this bunch: @numViews@ | # responses for this bunch: @numResponses@</div>
<table>
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td>
<div >@bunchSubject@</div>
@content@
<div><a href="@newResponseLink@" class="addBunchLink">@bunchAddResponse@</a></div>
</td>
</tr>
</tqtag>
<tqtag type="forumBunch" maxItems="999" forumShowResponses >
<tr>
<td>@bunchDate@df:%d/%m/%Y %H:%i!</td>
<td >
<div>@bunchSubject@</div>
<br />
@content@
<div><a href="@newResponseLink@" class="addBunchLink">@bunchAddResponse@</a></div>
</td>
</tr>
</tqtag>
</table>
</tqtag>
forumBunch - tqOptions
Within the forumBunch tqtag you can use the following tqoptions: head, if, lastItemInRow, tail.
Related tqoptions used in other tqtags: forumPrevPage, forumNextPage, isNewBunch.
Related tqoptions used in other tqtags: forumPrevPage, forumNextPage, isNewBunch.
forumBunch - Templates
The templates below implement this tqTag. After you click a link, use your browser commands to view the page source.
