Como adicionar um Shortcode no WordPress

Já houve algum momento em que você queria acrescentar algum conteúdo específico para o seu post ou página no WordPress, mas não tinha certeza sobre como fazer isso? Talvez você gostaria de inserir um widget do Twitter, algum conteúdo ou alguma API. Como você pode adicionar este tipo de conteúdo para o seu post ou página do WordPress? Felizmente, o WordPress oferece algo chamado “Shortcode” que torna este tipo de tarefa extremamente fácil. Neste artigo, vamos mostrar a você como adicionar um Shortcode no WordPress, mas não só isso, vamos ver todo processo de criação e utilização de um Shortcode, ou na tradução literal, simplemente, código curto.Vamos começar por ver o que é um Shortcode.

O que é um Shortcode do WordPress?

Resumidamente, um shortcode ou código curto, é uma tag especial que você pode inserir em um post que é substituída por um conteúdo diferente quando o post for realmente exibido no site. Se você já incorporou uma galeria WordPress em seu blog, então você já deve ter percebido o Shortcode que WordPress insere no conteúdo do post ou página.

Quando você carrega uma página do blog com o Shortcode “[galery]”, o WordPress substitui este código curto por todo o código que realmente mostra uma galeria de imagens.

Como você pode ver no exemplo acima, um Shortcode é semelhante a uma tag HTML, mas é criado com “[ ]” em vez de “< >”. Este código curto é substituído por algum outro código quando a página é de fato carregada em um navegador web. O legal é que o WordPress permite que você crie seus próprios Shortcodes personalizados para exibir praticamente qualquer coisa! Você poderia usá-lo para exibir um vídeo do Youtube, mostrar seus últimos tweets, ou até mesmo personalizá-lo como quiser.

Digamos que eu queira exibir um anúncio do AdSense dentro do meu post. Eu poderia ir para o modo HTML/Texto do editor de conteúdo do WordPress, copiar o bloco de código AdSense e colar nele, mas isso seria o modo mais ineficiente, além de mais trabalhoso. Além disso, se eu quisesse mudar o bloco de anúncios, eu teria que voltar a cada post e alterá-los para o novo. Uma maneira mais fácil e mais confiável para adicionar o bloco do AdSense, onde quer que eu queira, seria a utilização de um Shortcode “adsense”. O shortcode poderia ficar assim:

[adsense]

Quando o post fosse de fato exibido em seu site, o Shortcode seria substituído pelo bloco de anúncios de AdSense. Então, como você deve criar este Shortcode? Obviamente, você precisa dizer para o WordPress substituir o shortcode por alguma coisa. Vamos ver isso no próximo tópico.

Como faço para criar um Shortcode?

Felizmente, o WordPress torna a tarefa de fazer seus próprios Shortcodes muito simples. Então, vamos ver como devemos criar nosso Shortcode “[adsense]”. A primeira coisa que precisamos fazer, é definir uma função que gera o código real do AdSense. O seguinte código deve ser inseirdo no arquivo functions.php do seu tema (mas, recomendado inseri-lo no Plugin Específico do Site). Bem, então vamos olhar para essa função:

function wp24h_get_adsense($atts) {
	return '<script type="text/javascript"><!--
google_ad_client = "pub-12345678921589";
/* 468x60, created 9/13/10 */
google_ad_slot = "54321123456";
google_ad_width = 468;
google_ad_height = 60;
//-->
</script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>
';
}

Esta função é bastante simples – ela só retorna um código do Google AdSense como uma string. O que quer que esta função retorne, é pelo que meu shortcode será substituído, então eu poderia ter retornado o html para um widget de Twitter, uma lista de posts, ou qualquer outra coisa.

Agora que temos uma função que retorna o que queremos, como vamos fazer um hook que substitui o Shortcode? Aqui, é o ponto onde a API do WordPress atua mais uma vez. Então, vamos ver como fazer isso e, em seguida, explicar o que está acontecendo. Aqui está a chamada para configurar o shortcode [adsense]:

add_shortcode('adsense', 'wp24h_get_adsense');

O primeiro parâmetro passado é o nome do Shortcode, portanto, no nosso exemplo, ‘adsense’, que diz para o WordPress criar o shortcode [adsense]. O segundo parâmetro designa a função que será chamada quando o novo shortcode for encontrado. No nosso caso, ‘wp24h_get_adsense’ diz ao WordPress para substituir [adsense] com os resultados da nossa função wp24h_get_adsense.

Não é tão dificil, é? Agora este é um shortcode muito simples, o WordPress permite que você faça muito mais coisa com os seus Shortcodes, incluindo a adição de parâmetros (talvez você queira escolher entre os blocos do AdSense?)

[leia]Sobre a API completa no WordPress Codex.[/leia]

Como posso usar meu Shortcode?

Esta última parte é simples, basta adicionar o shortcode [adsense] na guia visual ou de texto do editor de conteúdo do Post ou Página.

É isso aí! Você criou seu primeiro shortcode.

Deixe um comentário abaixo para sabermos como foi sua experiência ou seus pensamentos sobre a criação de shortcodes.