WP-PageNavi: um plugin essencial

November 17th, 2006, 11:44 am Rodrigo P. Ghedin Plugins

A navegação padrão entre os posts no WordPress é bem precária. Geralmente, temos aquele “Older posts”, para retroceder uma página, e quando numa antiga, o “Newer posts”, para avançar à seguinte. Há variações, mas o sentido é sempre o mesmo, e você só pode avançar para as páginas contíguas à que está sendo exibida.

Veja como era o BlogAjuda, como mero exemplo:

Usabilidade zero, concordam? Isso sem falar na confusão que os termos “novas” e “antigas” geram. Nunca acerto de primeira qual é o termo correto, qual a tag correta, qual a ordem correta… Em suma, esta parte do tema sempre dá dor de cabeça.

WP-PageNavi: a solução do problema

Felizmente, o GaMerZ, que criou alguns dos plugins abordados num outro texto já publicado por aqui, também arquitetou um que resolve essa parte confusa de navegação entre posts. Trata-se do WP-PageNavi.

Instalação

A instalação é aquela de sempre: upload do arquivo pagenavi.php para a pasta /wp-content/plugins, e ativação no painel administrativo. A diferença é que, neste caso, você precisará incluir uma tag especial num determinado local do tema. Para ser sincero, são em vários locais: na página inicial, nos resultados da pesquisa, nas categorias… Onde houver paginação de posts.

A tag é a seguinte:

<?php if(function_exists('wp_pagenavi')) { wp_pagenavi(); } ?>

Para facilitar, basta você localizar as tags da navegação padrão do WordPress, e substituí-las pelo código acima. São elas:

<?php next_posts_link('« Entradas antigas') ?>

<?php previous_posts_link('Entradas recentes »') ?>

Geralmente elas vêm acompanhadas de algumas DIVs, que auxiliam no posicionamento. No caso do Barthelme, tema atual do BlogAjuda, está assim:

<div class="navigation">
<div class="nav-left"><?php next_posts_link('« Entradas antigas') ?></div>
<div class="nav-right"><?php previous_posts_link('Entradas recentes »') ?></div>
</div><!-- END NAVIGATION -->

Apague tudo, e insira a tag especial, mostrada acima. É preferível colocá-la entre uma DIV, assim:

<div id="navegacao">
<?php if(function_exists('wp_pagenavi')) { wp_pagenavi(); } ?>
</div>

Agora, no CSS, insira a seguinte linha:

#navegacao { text-align:center; margin-top:50px; }

Isso fará com que o texto fique alinhado horizontalmente (no meio da página), e a uma distância de 50 pixels do último post.

Repita o procedimento acima nas outras páginas que propiciam a navegação entre posts. Em geral, são os arquivos: archive.php, search.php, e, se existir, o category.php.

Veja o resultado:

Menu drop down

O plugin permite, ainda, exibir a paginação através de um menu drop down. Para tal, basta substituir o código mostrado acima por este:

<?php if(function_exists('wp_pagenavi')) { wp_pagenavi_dropdown(); } ?>

Traduzindo o plugin

Falta algo, não? Sim, a tradução. São apenas cinco termos a serem traduzidos, sendo três da paginação convencional, e dois da em formato de menu drop down.

Abra o arquivo pagenavi.php no seu editor favorito. Veja, abaixo, uma lista das linhas onde estão os termos a serem traduzidos:

• Linha 49: Pages vira Páginas;
• Linha 51: First vira Primeira;
• Linha 65: Last vira Última.
• Linha 98: Page vira Página;
• Linha 100 Page vira Página.

Vale lembrar que estou usando a versão 2.03 do WP-PageNavi; em futuras versões, os números das linhas citadas podem ser diferentes.

Salve o arquivo, e reenvie-o para o servidor.

Conclusão

Este plugin provê uma funcionalidade que deveria existir nativamente no sistema. Trata-se de algo simples e trivial, porém muito útil. Espero que na versão 2.1 do WordPress algo neste sentido apareça. Seria uma mão na roda (e um plugin a menos para se instalar).

wp-pagenavi, paginação, navegação, páginas, ordenar, wordpress, wp, plugin