Tags:
create new tag
view all tags
---+ Search Results Pagination When a =%<nop>SEARCH{...}%= returns many results, you may want to paginate the results. ---++ Overview You can achieve search results pagination by tweaking a =%<nop>SEARCH{...}%= as follows. (New lines are inserted for readability in =$SET(searchparams, ...)=. Please don't copy-paste it for real use.) As you can see, this is using the SpreadSheetPlugin. <verbatim> ... %INCLUDE{"%SYSTEMWEB%.SearchResultsPagination" section="preamble"}%<nop> %SEARCH{ "%URLPARAM{"search" encode="quote"}%" ... start="%CALCULATE{$GET(start)}%" limit="%CALCULATE{$GET(limit)}%" footer="$percntCALCULATE{$SET(ntopics, $tntopics)$SET(nwebs, $nwebs)}$percnt" }% %CALCULATE{$SET(searchparams, search=%URLPARAM{"search" encode="url"}%; type=%URLPARAM{"type" encode="url" default="%SEARCHDEFAULTTYPE%"}%; scope=%URLPARAM{"scope" encode="url"}%; web=%URLPARAM{"web" encode="url"}%; nosearch=%URLPARAM{"nosearch" encode="url"}%;)}%<nop> %INCLUDE{"%SYSTEMWEB%.SearchResultsPagination" section="postamble"}%<nop> ... </verbatim> This tweaking adds pagination link rows before and after the search results as follows: [[#A][«Previous]] [[#A][1]] *2* [[#A][3]] [[#A][4]] [[#A][5]] [[#A][Next»]] The =section="preamble"= and =section="postamble"= also support a =style=""= parameter to set the style of the pagination link row =<div>= tag. For example, to disable the pagination link row on top, write:%BR% =%<nop>INCLUDE{"%<nop>SYSTEMWEB%.SearchResultsPagination" section="preamble" style="display:none;"}%<nop>= Maximum 16 page links are shown — the "Next" link can be used to paginate beyond 16 pages if there are more than that. The pagination link rows are not shown if the number of results is below a one page threshold. WebChanges, WebSearch, and WebSearchAdvanced are using this technique. ---++ Results per page By default, each page shows %SEARCHRESULTSPERPAGE% results, which is defined by the SEARCHRESULTSPERPAGE preferences setting. To change it to 10, change the initial part as follows. (The second line is inserted.) <verbatim> %INCLUDE{"%SYSTEMWEB%.SearchResultsPagination" section="preamble"}%<nop> %CALCULATE{$SET(limit, %URLPARAM{"limit" default="10" encode="entity"}%)}%<nop> %SEARCH{... </verbatim> If you specify =limit=20= URL parameter manually, that's observed. If you specify =limit=all= URL parameter, all results are shown without pagination. ---++ Where in the topic you go afer clicking a pagination link By default, clicking a pagination link leads you to the top of the current set of search results. In other words, you see "«Previous 1 2 3 4 5 Next»" at the top of the web browser window followed by search results. If a topic has little other than search results, you may prefer seeing the top of the page after clicking pagination link. You can achieve that by the following lines. <verbatim> %INCLUDE{"%SYSTEMWEB%.SearchResultsPagination" section="preamble"}%<nop> %CALCULATE{$SET(plinkanchor, )}%<nop> %SEARCH{... </verbatim> I cannot imagine a real use but if you want to see the bottom of the search results after clicking a pagination link, put the following lines on the topic. <verbatim> %INCLUDE{"%SYSTEMWEB%.SearchResultsPagination" section="preamble"}%<nop> %CALCULATE{$SET(plinkanchor, #SearchPaginationBottom)}%<nop> %SEARCH{... </verbatim> ---++ URL parameters All hyper links in the pagination apparatus point to the same page with some URL parameters. The parameters are %CALCULATE{$GET(searchparams)}% plus pagination parameters (namely =start= and =limit=). You need to =$SET(searchparams, ...)= having this in mind. ---++ Multiple webs =%<nop>SEARCH{...}%= may take the =web= parameter to have multiple webs specified. In that case, it's strange to do pagination hence suppressed. ---++ !SpreadSheetPlugin variables This feature uses the following SpreadSheetPlugin variables. Please beware of variable clashes if you use SpreadSheetPlugin for your own use on a page doing search result pagination * limit * linksText * npages * ntopics * numlimit * nextText * nwebs * paginate * prevText * searchparams * start * stepsText __Related Topics:__ UserDocumentationCategory, SearchHelp, VarSEARCH, FormattedSearch, SearchPatternCookbook <!-- %STARTSECTION{"preamble"}% %CALCULATE{$SET(start, %URLPARAM{"start" default="0" encode="entity"}%)}%<nop> %CALCULATE{$SET(limit, %URLPARAM{"limit" default="%SEARCHRESULTSPERPAGE%" encode="entity"}%)}%<nop> %CALCULATE{$SET(ntopics, 0)}%<nop> %CALCULATE{$SET(nwebs, 1)}%<nop> #SearchPaginationTop <div id="searchTopNav%INCLUDINGTOPIC%" style="margin-bottom: 1em; %IF{ "defined 'style'" then="%style%" }%"></div> %CALCULATE{$SET(plinkanchor, #SearchPaginationTop)}%<nop> %ENDSECTION{"preamble"}% %STARTSECTION{"postamble"}% #SearchPaginationBottom <div id="searchBottomNav%INCLUDINGTOPIC%" style="%IF{ "defined 'style'" then="%style%" }%"> %CALCULATE{$SET(gray, <span style='color: gray;'>)}%<nop> %CALCULATE{$SET(numlimit, $IF($VALUE($GET(limit)) > 0, $GET(limit), 100000))}%<nop> %CALCULATE{$SET(npages, $INT($GET(ntopics)/$GET(numlimit)+1))}%<nop> %CALCULATE{$SET(paginate, $AND($IF($GET(npages) > 1, 1, 0), $IF($GET(nwebs) < 2, 1, 0)))}%<nop> %CALCULATE{$SET(prevText, $IF($GET(start) >= $GET(numlimit), <a href='%SCRIPTURL{view}%/%BASEWEB%/%BASETOPIC%?$GET(searchparams)start=$INT($GET(start)-$GET(numlimit));limit=$GET(limit)%CALCULATE{$GET(plinkanchor)}%'>«%MAKETEXT{"Previous"}%</a>, $GET(gray)«%MAKETEXT{"Previous"}%</span>))$IF($GET(paginate), $GET(prevText)$SET(linksText, $GET(prevText)))}% %CALCULATE{$SET(stepsText, )$SET(pages, $INT(($GET(ntopics) - 1)/$GET(numlimit)+1))$SET(maxpages, $MIN($GET(pages), 16))$SET(i, 0)$WHILE($counter<=$GET(maxpages), $SET(stepsText, $GET(stepsText)$IF($GET(i)==$GET(start), <b>$counter</b>, <a href='%SCRIPTURL{view}%/%BASEWEB%/%BASETOPIC%?$GET(searchparams)start=$GET(i);limit=$GET(limit)%CALCULATE{$GET(plinkanchor)}%'>$counter</a>))$SETM(i, +$GET(numlimit)))$IF($GET(paginate), $GET(stepsText)$SET(linksText, $GET(linksText)$GET(stepsText)))$SET(linksText, $GET(linksText) )}% %CALCULATE{$SET(nextText,$IF($INT($GET(start)+$GET(numlimit))<$GET(ntopics), <a href='%SCRIPTURL{view}%/%BASEWEB%/%BASETOPIC%?$GET(searchparams)start=$INT($GET(start)+$GET(numlimit));limit=$GET(limit)%CALCULATE{$GET(plinkanchor)}%'>%MAKETEXT{"Next"}%»</a>, $GET(gray)%MAKETEXT{"Next"}%»</span>))$IF($GET(paginate), $GET(nextText)$SET(linksText, $GET(linksText)$GET(nextText)))}% </div> <script type="text/javascript"> %CALCULATE{$IF($GET(paginate), <nop>, $('#searchTopNav%INCLUDINGTOPIC%').hide(); $('#searchBottomNav%INCLUDINGTOPIC%').hide();)}% $('#searchTopNav%INCLUDINGTOPIC%').html("%CALCULATE{$GET(linksText)"}%); </script> %ENDSECTION{"postamble"}% -->
E
dit
|
A
ttach
|
Watch
|
P
rint version
|
H
istory
: r2
<
r1
|
B
acklinks
|
V
iew topic
|
Ra
w
edit
|
M
ore topic actions
Topic revision: r2 - 2015-06-08
-
TWikiContributor
Log In
or
Register
TWiki Web
Users
Groups
Index
Search
Changes
Notifications
RSS Feed
Statistics
Preferences
User Reference
ATasteOfTWiki
TextFormattingRules
TWikiVariables
FormattedSearch
QuerySearch
TWikiDocGraphics
TWikiSkinBrowser
InstalledPlugins
Admin Maintenance
Reference Manual
AdminToolsCategory
InterWikis
ManagingWebs
TWikiSiteTools
TWikiPreferences
WebPreferences
Categories
Admin Documentation
Admin Tools
Developer Doc
User Documentation
User Tools
Webs
TWiki
Home
Site map
TWiki web
TWiki Web
User registration
Users
Groups
Index
Search
Changes
Notifications
RSS Feed
Statistics
Preferences
View
Raw View
Print version
Find backlinks
History
More topic actions
Edit
Raw edit
Attach file or image
Edit topic preference settings
Set new parent
More topic actions
User Reference
ATasteOfTWiki
TextFormattingRules
TWikiVariables
FormattedSearch
QuerySearch
TWikiDocGraphics
TWikiSkinBrowser
InstalledPlugins
Admin Maintenance
Reference Manual
InterWikis
ManagingUsers
ManagingWebs
TWikiSiteTools
TWikiPreferences
WebPreferences
Categories
Admin Documentation
Admin Tools
Developer Doc
User Documentation
User Tools
Account
Log In
Register User
Български
Cesky
Dansk
Deutsch
English
Español
_Français_
Italiano
日本語
한글
Nederlands
Polski
Português
Русский
Svenska
简体中文
簡體中文
E
dit
A
ttach
Copyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki?
Send feedback
Note:
Please contribute updates to this topic on TWiki.org at
TWiki:TWiki.SearchResultsPagination
.