pBlog

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?