
Exemplo de citação.
E lá vamos nós fazer mais um jabá do meu blog mostrar mais um recurso oriundo do meu blog! No caso, atendo à solicitação de um leitor, o Adauto de Andrade, que quer saber como eu mostro citações aleatórias na sidebar do blog (veja na imagem ao lado).
É mais simples do que parece, o que não quer dizer, porém, que o plugin responsável pela mágica seja ruim, ou simplório. Pelo contrário! O Stray Random Quotes, que utilizo para o gerenciamento e exibição de citações, é bem feito e cheio de opções. Bem mais que o finado WP-Quotes, que utilizei antes do mesmo parar no tempo, e deixar de ser compatível com o WordPress, mais precisamente, a partir da versão 2.5.
Configuração
Mas vamos ao que interessa. A instalação do Stray Random Quotes é bem simples. Faça o download, descompacte a pasta stray_quotes, e envie-a inteira para a pasta /wp-content/plugins/ do seu blog. Por fim, ative o plugin no painel administrativo do WordPress.
Ativado o plugin, é hora de configurá-lo. A página de configurações fica no menu Settings, item Stray Random Quotes. Ele já vem bem configurado por padrão, mas é possível mudar praticamente tudo, e o que é melhor (para quem não entende bolhufas de WP), sem precisar mexer numa linha de código sequer.
Nessa tela de configuração, há várias opções. Confira o que cada uma quer dizer:
- Widget Title & Sidebar element Title: define o título do widget (primeira opção), e o título para quem não usa widgets (segunda opção). Na segunda, pode-se colocar tags de título, como
<h2></h2>; - Author, Quote and Source: o que aparece antes (primeiro campo) e depois (segundo) de toda a citação. Este e os campos seguintes podem ficar em branco, se quiser;
- Quote only: o que aparece antes e depois da citação em si (da frase);
- Author only: o que aparece antes e depois do autor da citação;
- Source only: o que aparece antes e depois da fonte da citação;
- Link to: uma das funções mais legais. Marcando Google ou Wikipedia, o nome do autor, na citação, aparece linkado para esses sites, na página do autor em questão. Se não quiser links, basta marcar No link.
- Other options: são duas checkboxes, a saber:
- Primeira opção: define a ordem de autor e frase. Se marcada, aparece primeiro a frase, depois o autor; se desmarcada, ocorre o inverso;
- Segunda opção: se marcada, muda o status de todas as citações para “visível”.
Para auxiliar iniciantes e perdidos, tirei uma screenshot da minha configuração. Vejam (clique para ampliar):
Implantação do código
Feitos esses ajustes, vamos “implantar” o plugin no blog. Se você usa widgets, é fácil: vá à área deles, e coloque o do Stray Random Quotes na sua lista. Se você é um blogger old school, e mexe no código com a mesma familiaridade com que escova os dentes, entre no Theme Editor, selecione o arquivo sidebar.php (ou qualquer outro, dependendo de onde quer que as frases apareçam), e cole o seguinte código no local desejado:
<?php if (function_exists('stray_random_quote')) stray_random_quote(); ?>
Quer publicar uma única citação? Pegue a ID dela no gerenciador (leia abaixo), e munido dele, cole o seguinte:
<?php if (function_exists('stray_a_quote')) stray_a_quote(xx);?>
Lembre-se de substituir o “xx” pelo número da frase desejada.
Caso queira inserir uma frase aleatória dentro de um post, copie e cole, num post, obviamente, o código abaixo:
[random-quote]
Se seu desejo é publicar uma frase específica dentro de um post, o código é o seguinte (lembre-se de alterar o “xx” para o ID da frase desejada):
[quote id=xx]
Por fim, se quiser exibir todas as citações cadastradas num post ou página, digite o seguinte:
[all-quotes]
Cadastrando citações
Tudo pronto nos bastidores, vamos ao que interessa: as frases. Vá no menu Manage, e clique em Quotes. Lá, há um formulário no topo, e na parte inferior, as citações já cadastradas. Para publicar uma nova frase, escreva-a no campo Quote, em seguida, escreva o nome do autor (Author) e a fonte (Source) caso queira, já que ambos os campos são opcionais, marque Yes na opção Visible, e clique em Save quote ».
Espero que tenham gostado do tutorial. Quaisquer dúvidas, usem os comentários, ok?

