Blog

Como adicionar um Shortcode no WordPress

Shortcode WordPress
Tutoriais

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.

Deixe seu comentário aqui...

O seu endereço de e-mail não será publicado.

Esse site utiliza o Akismet para reduzir spam. Aprenda como seus dados de comentários são processados.

Nosso site usa cookies e, portanto, coleta informações sobre sua visita para melhorar nosso site (por meio de análise), mostrar a você conteúdo de mídia social e anúncios relevantes. Por favor, consulte nossa página Termos & Políticas para mais detalhes ou concorde clicando no botão 'Aceitar'. OBS: Ao continuar a navegação, você, automaticamente, concorda.

Configurações de Cookies

Abaixo, você pode escolher os tipos de cookies que quer permitir neste site. Clique no botão "Salvar Configurações de Cookies" para aplicar sua escolha.

FuncionalNosso site usa cookies funcionais. Esses cookies são necessários para permitir que nosso site funcione.

AnalíticoNosso site usa cookies analíticos para permitir a análise de nosso site e a otimização para o propósito de a.o. a usabilidade.

Mídia SocialNosso site coloca cookies de mídia social para mostrar conteúdo de terceiros, como YouTube e Facebook. Esses cookies podem rastrear seus dados pessoais.

PublicidadeNosso site coloca cookies de publicidade para mostrar anúncios de terceiros com base em seus interesses. Esses cookies podem rastrear seus dados pessoais.

OutrosNosso site coloca cookies de terceiros de outros serviços que não são analíticos, mídia social ou publicidade.