Returns back/next/first/last and page links, both as ordered and associative array.
NB: in original PEAR::Pager this method accepted two parameters, $back_html and $next_html. Now the only parameter accepted is an integer ($pageID), since the html text for prev/next links can be set in the factory. If a second parameter is provided, then the method act as it previously did. This hack was done to mantain backward compatibility only.
useful for letting the user choose how many items per page should be displayed. If parameter useSessions is TRUE, this value is stored in a session var. The string isn't echoed right now so you can use it with template engines.
Return: xhtml select box
starting value for the select menu
ending value for the select menu
step between values in the select menu
If true, perPage is set equal to totalItems.
(or string $optionText for BC reasons)
'optionText': text to show in each option.
Use '%d' where you want to see the number of pages selected.
'attributes': (html attributes) Tag attributes or
HTML attributes (id="foo" pairs), will be inserted in the