Este é um post de José Lopes.
Ao configurar um site com o Wordpress criei uma entrada author.php sobre os autores presentes no site, como se encontra definido em Author Templates, por modo a ter uma descrição sobre cada autor e uma lista dos artigos (posts) escritos no site.
Este Plugin possibilita apresentar uma lista completa de artigos do autor, incluíndo os artigos em que o autor foi co-autor.
O que me levou a fazer este Plugin foi uma série de problemas, que irei detalhar de seguida, e o facto de não ter encontrado nada já feito para os resolver.
Os problemas que me deparei residiam na lista de artigos do autor:
- Ao ter definido um número máximo de artigos a serem apresentados por página não conseguia mostrar todos os artigos do autor, quando a sua quantidade ultrapassava esse número máximo.
- Se o autor fosse co-autor de outros artigos a sua quantidade não era contabilizada nem esses artigos eram listados.
Download
Pode fazer o download de um dos ficheiros: author-complete-post-list.zip ou author-complete-post-list.tar.gz
Instalação
- Descomprimir o ficheiro para o directório wp-content/plugins
- Será criada a directoria author-complete-post-list aquando da descompressão, caso contrário criar manualmente e colocar os ficheiros do Plugin dentro dela.
- Activar o Plugin Author Complete Post List através do painel administrativo.
- O Plugin fica assim disponível para utilização.
Modo de Utilização
Este foi criado com o objectivo de ser aplicado em author.php mencionado atrás, pelo que o exemplo do modo de utilização vai ser neste âmbito.
Assim com base no exemplo do Wordpress para este php, basta as duas linhas de código seguintes para obter a lista de artigos do autor.
<?php total_posts($author, $curauth->user_login, 'pt_PT') ; ?>
<?php full_post_list($author, $curauth->user_login, 'pt_PT') ; ?>
Descrevendo o código:
- A primeira linha devolve o texto introdutório para a lista de artigos, com o total de artigos.
- A segunda linha devolve a lista de todos os artigos do autor, incluído aqueles que é co-autor, ordenada pelo mais recente.
- Quanto aos argumentos das funções:
- O primeiro é definido pelo Wordpress e representa o autor para a página em visionamento.
- O segundo é definido no início do ficheiro author.php do exemplo do Wordpress,
sendo seleccionado o login do autor do posto com o tag user_login.
- O terceiro é opcional, ele define qual a linguagem do output. Aceita 'pt_PT' para o português e 'en_GB' para o inglês.
Em caso de omissão é assumido o default que é o português.
Exemplo de output:
Este(a) autor(a) tem 3 artigo(s) neste site:
- Artigo 3 a 06/07/2007, arquivado em Sem Categoria
- Artigo 2 a 06/07/2007, arquivado em Sem Categoria
- Artigo 1 a 05/07/2007, arquivado em Sem Categoria
Notas finais
Este Plugin foi testado para a versão 2.2 do Wordpress, pelo que qualquer informação sobre a sua utilização em outras versões será bem vinda.
Não existem requesitos especiais para a intalação ou utilização deste Plugin, no entanto, uma vez que uma das coisas que se pretende é incluir os artigos de co-autoria será bom fazer atenção a como se regista o co-autor. Assim concluo esta exposição com os seguintes pontos:
- Para inserir um co-autor (ou mais) num artigo, utilizo o Plugin multiple-authors que permite incluir no Campo Personalizado uma chave de nome other_author cujo valor deve ser o nome de login do co-autor (uma chave por cada co-autor).
- O uso do Plugin multiple-authors permite incluir facilmente no artigo os nomes dos vários autores ou de um só se for o caso, assim como registar automaticamente um co-autor se o utilizador tiver o papel de Editor. Tem as suas vantagens e desvantagens pois ao adicionar automaticamente autores pode adicionar um que por engano editou e gravou o artigo, embora se possa posteriormente anular essa acção apagando a respectiva entrada no Campo Personalizado do artigo.
- Caso não utilize este Plugin, pode adicionar a chave manualmente desde que mantenha o nome other_author que o nosso Plugin funcionará. É importante que a chave tenha o nome other_author.
- Tem ainda de fazer atenção que o valor da chave tem de ser o nome de login do autor, caso contrário ele não será reconhecido.
- A internacionalização do Plugin não está feita nesta fase e ficará para uma ocasião futura. Contudo, a opção entre as duas línguas já cobre a maioria das necessidades.