[ShowNext Parameters]<a href="..">[/ShowNext]

Creates a list of hyperlinks or buttons that display more found items.

To display a list of hyperlinks that will display more items found in a search, put one or more [ShowNext] contexts inside a [Search] context. This context is only valid inside a [Search] context, and will only be used if the search specified a max=N, and the number of found items is greater than max.

Example (normally you would put the following text into a .tpl file on your server and use a web browser to link to it):

[ShowNext position=begin]
<a href="SearchResults.tpl?command=search&[SearchString]">Show items [start]-[end]</a><br>
[/ShowNext]
 
[foundItems]
[/foundItems]
 
[ShowNext position=end]
<a href="SearchResults.tpl?command=search&[SearchString]">Show items [start]-[end]</a><br>
[/ShowNext]

Try It!

If a search returns 50 found items, and max is set to 10, then [ShowNext] loops through all the "chunks" of 10 necessary to create hyperlinks for each set of 10 items not displayed inside the [FoundItems] loop:

 
Show Items 1-10 (this comes from position=beginning)
Show Items 11-20
(Items 21-30 are displayed) (this comes from [foundItems]
Show Items 31-40 (this comes from position=end)
Show Items 41-50

The following parameters can be used to modify the [ShowNext] context:
 Parameter  Description

position

Optional, one of
  • Beginning - loop through "chunks" of indices preceding the ones displayed inside the [foundItems] loop
  • Middle - Display range of indices that are inside [foundItems] loop (rarely, if ever, used)
  • End - loop through "chunks" of indices after the ones displayed inside the [foundItems] loop
If no position is specified, the default is to loop through both beginning and end "chunks", thus displaying all possible "Show Next" hyperlinks.

 method

Optional, one of
  • GET - [SearchString] will display HREF-style (hyperlink) parameters for the search
  • POST - [SearchString] will display FORM METHOD=POST style parameters for the search. Use this only if your search is so complex that it requires more than 255 characters worth of search parameters.
If no method is specified, then "GET" is assumed, which means that HREF-style links are generated.

max

Optional, maximum number of "Next" links to show at one time. Useful if you want to simply show a single "More" button, rather than showing a long list of "Show 1-10", "Show 11-20" links.

The following tags are available inside a [ShowNext] context:
Tag Description

 [SearchString]

All search parameters necessary to find this "chunk" of items in the range [Start] - [End]

[Start]

A number indicating the index of the first item that will be displayed in this range of found items

[End]

A number indicating the index of the last item that will be displayed in this range of found items