[ShowNext Parameters]<a href="..">[/ShowNext]
Creates a list of hyperlinks or buttons that display more found items.

To display a list of hyperlinks displaying more items found in a search, place 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]

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] displays HREF-style (hyperlink) parameters for the search.
  • POST - [SearchString] displays FORM METHOD=POST style parameters for the search. Use this only if your search is so complex 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," etc. 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 position of the first item that will be displayed in this range of found items.
[End]
A number indicating the index position of the last item that will be displayed in this range of found items.