Pager

Data paging class

It takes an array of data as input and pages it according to various parameters. It also builds links within a specified range, and allows complete customization of the output (it even works with front controllers and mod_rewrite). Two operating modes available: "Jumping" and "Sliding" window style. quipo Lorenzo Alberton l.alberton@quipo.it lead richard Richard Heyes richard@phpguru.org lead 2.3.6 2006-02-03 BSD License stable - fixed bug #6680: error with fileName parameter having an extra "%" character 2.3.6 2006-02-03 stable - fixed bug #6680: error with fileName parameter having an extra "%" character 2.3.5 2006-01-20 stable - remove flicker (caused by href="#") during POST requests (request #6005) - added "formID" option to reuse an existing form in POST requests (thanks to Marc Veldman) - fixed bug #6529: problem with fields with quotes during POST requests 2.3.4 2005-09-28 stable - changed license to BSD - fixed bug #4897 (multibyte chars not handled correctly) 2.3.3 2005-07-04 stable - improved Pager_Wrapper and added tests - urlencoded square brackets (bug #4337) NB: We recommend that users of Pager < 2.3.0 immediately upgrade the package, otherwise they might be susceptible to XSS attacks 2.3.2 2005-06-03 stable - autodetect HTTP method used, when not specified, instead of forcing "GET" (bug #4277) - added "altFirst" and "altLast" options to set the "title" attribute of the first and last page links 2.3.1 2005-05-02 stable - fixed various issues with __http_build_query() and escaped entities - if the value of "arg_separator.output" in php.ini is "&amp;", don't encode it again - tweaked Pager_Wrapper query rewriting function, now it is fully case insensitive 2.3.0 2005-04-22 stable - tweaked Pager_Wrapper query rewriting function 2.3.0RC2 2005-04-06 beta - fixed possible querystring duplication with front controllers 2.3.0RC1 2005-04-01 beta - internal refactoring: added POST support: set the preferred http method ('GET' or 'POST') with the 'httpMethod' option. - used $_GET instead of reparsing the querystring [thanks to Nikolas 'Atrus' Coukouma] (fixed bugs #3450, #3878 and #3451) - added 'importQuery' boolean option to ignore the url vars entirely (bug #3449) - added 'excludeVars' array option to selectively exclude some url vars (bug #2461) - countless code optimizations - added many new test cases to the testsuite 2.2.7 2005-03-18 stable - added Pager_Wrapper_Eclipse() function in the /examples/Pager_Wrapper example (thanks to Matte Edens) - added support for statements with subqueries in the Pager Wrappers (thanks to Tobias Kuckuck) - fixed bug #3451 (arrays in extraVars not handled correctly) 2.2.6 2005-02-04 stable - better 'currentPage' option support (thanks to Andrew Nagy) - fixed typo (thanks to Massimiliano Arione) 2.2.5 2005-01-17 stable - allowed use of a javascript function in the fileName [bugs #2555 and #2754] - added Pager_Wrapper_DBDO() function in the /examples/Pager_Wrapper example (thanks to garak AT studenti DOT it) - replaced urlencode() with htmlentities() because it was too aggressive [bugs #2908, #3043 and #3212] - added 'currentPage' option (patch by Kendrick Vargas) 2.2.4 2004-11-20 stable - fixed "Notice: Undefined property: _totalPages" [bug #2714] - enforce errors (which weren't displayed at all) - fixed Pager_Wrapper (examples dir) with GROUP BY queries - changed $_GET to $_REQUEST. POST values should be valid too, now. - Pager can be used on a DirectoryIndex script, now (patch by ieure) [bug #2617] 2.2.3 2004-08-17 stable - just the last one of a set of array values given as GET parameters (i.e. site.php?foo[]=1&foo[]=2&foo[]=3) was carried on (bug #1904). - make 4th parameter of getPerPageSelectBox() an array, and add an "attribute" parameter to allow extra attributes for the select tag. - added an example to show how this class can be used with big database resultsets efficiently. - prevent XSS attacks (bug #2131), thanks to sou_sk at nifty dot com 2.2.2 2004-05-18 stable - set correct selected value for getPerPageSelectBox even when "useSession" option is false (bug #1263). - added two parameters to getPerPageSelectBox(): * $showAllData (if true, an <option> to show all the data is displayed in the generated <select>); * $optionText (text to show in each <option>; use '%d' where you want to see the number of pages selected) - added showAllText option for alternate text in the $showAllData <option> (the default is the number of total items). - fixed getPageData() when $pageID is specified (bug #1377) (thanks to Ian Eure) - added tests for getPageData() - avoid duplicate vars in querystring when using 'extraVars' option (bug #1383) (thanks to pauluz at gazeta dot pl) 2.2.1 2004-04-15 stable - PHP5 compatibility (fixed bug #812) - Forced ucfirst() on filename too 2.2.0 2004-01-23 stable - Fixed handling of errors raised in common base class - Added an 'extraVars' option to add vars to the querystring - Added <link> tags building (patch by Joerg Bruckmann) - Fixed Bug #589 (common.php raise a notice if the querystring has no '=' character) - Use '&amp;' instead of '&' in urls for better XHTML conformance 2.1.0 2003-12-22 BSD stable - Added getPageRangeByPageId() - Fix getOffsetByPageId() in Pager_Jumping when totalItems == 0. - Fix getOffsetByPageId() in Pager_Sliding for BC with Pager 1.x and Pager_Jumping. N.B.: its previous (not-indended) behaviour is now provided by the new getPageRangeByPageId() method. - Fix isFirstPage() when totalItems == 0 - Added test suite. 2.0 2003-09-10 BSD stable - New major version. - Pager and Pager_Sliding are now merged in the same package. Every option available in Pager_Sliding is now also available in Pager. The API is the same as the old one, BC is kept 100%. - Switch between "Jumping" and "Sliding" window mode just setting an option. - Improved error handling. 1.0.8 2003-09-10 BSD stable - Minor patch for script_name vs php_self (not included in v.1.0.7) - Prevent URL modification 1.0.7 2002-12-01 BSD stable Minor patch for script_name vs php_self 1.0.6 2002-09-08 BSD stable Updated to no longer require an array of data. Now can be used with just a number of items. Thanks to Christian Dickmann for the patch. 1.0.5 2002-07-27 PHP stable Changed getCurrentPage() to getCurrentPageID() and added getNextPageID() and getPreviousPageID() 1.0.4 2002-06-29 stable Changed getCurrentPage() to getCurrentPageID() and added getNextPageID() and getPreviousPageID() 1.0.3 2002-05-31 stable Couple of minor bugs 1.0.2 2002-05-31 stable Applied patch from Christian Dickmann adding getCurrentPage(), numItems() and optional CSS class for links. 1.0.1 2002-05-27 stable o No longer barfs with no querystring o Now works with associative data array 1.0 2002-02-09 stable This is the initial release of the Pager package.