Manual:Pager.php/pt-br

A classe IndexPager fornece funções úteis para resultados de paginação dos resultados do 'query fieldset', para o MySQL. A classe IndexPager é utilizada, por exemplo, na página especial Special:Categories.

Exemplo de uso
The first step to use the IndexPager in your special page extensions is creating a class named for example  that extends one of these three classes:


 * é usado quando você deseja listar os itens em ordem alfabética
 * é usada quando você deseja listar os itens em uma ordem cronológica inversa
 * é usada quando você deseja exibir itens em linhas da tabela

Cada uma destas três classes (,  e  ) estende a classe.

Normalmente, você só deve ter que substituir alguns métodos em sua classe:


 * deixar o pager conhecer a consulta SQL que você deseja executar. Ele deve retornar um array associativo com os seguintes elementos:
 * tabela(s) usada(s) na consulta
 * campo(s) a passar para Database::select, pode ser * (todos os campos na tabela)
 * um array que contém as condições para a cláusula WHERE
 * um array que contém outras opções (tais como GROUP BY)
 * obtém um argumento,, que é um objeto de linha do fieldset de resultado. A função deve retornar uma string que contém o item formatado como você precisa.
 * deve retornar o nome do campo da tabela usada para indexar e ordenar resultados.

Por exemplo, se você deseja listar todas as páginas do NS0 utilizando um pager, você deve fazer algo assim:

No corpo de sua página especial, então você tem que:
 * criar uma nova classe
 * usar o método  para colocar a barra de navegação na parte superior e na parte inferior da página
 * usar o método  para colocar a lista dos itens

Por exemplo: