Você já teve um tempo em que você queria adicionar algum conteúdo especializado à sua postagem ou página do WordPress, mas não tinha certeza de como? Talvez você quisesse incorporar um widget do Twitter ou algum conteúdo chamado de volta de algum site ou API. Como você pode facilmente adicionar esse tipo de conteúdo à sua postagem do WordPress? Felizmente, o WordPress fornece algo chamado shortcode para tornar esse tipo de tarefa extremamente fácil. Este tutorial o levará ao processo de construção, instalação e uso de um shortcode na sua instalação do WordPress. Vamos começar por ver o que é um shortcode.
O que é um Shortcode do WordPress?
Resumidamente, um código curto é uma tag especial que você pode inserir em uma postagem que seja substituída por conteúdo diferente quando realmente visualiza a publicação no site. Se você já incorporou uma galeria do WordPress no seu blog, então você já viu o código curto incorporado.
Quando você carrega uma página de blog com o
shortcode, WordPress substitui o
shortcode com todo o código que realmente exibe uma galeria de suas imagens.
Como você pode ver no exemplo acima, um código curto parece semelhante a uma tag HTML, mas é fornecido com colchetes em vez de colchetes angulares. Este código é substituído por algum outro código quando a página é realmente carregada em um navegador da Web. A coisa realmente legal é que o WordPress permite que você crie seus próprios códigos curtos personalizados para exibir praticamente qualquer coisa! Você poderia usá-lo para produzir um vídeo do Youtube, mostrar seus tweets mais recentes, ou até mesmo personalizá-lo como quiser.
Caso não faça sentido, vejamos um exemplo. Digamos que eu quero exibir um anúncio do AdSense na minha postagem. Eu poderia entrar no modo HTML do editor de conteúdo do WordPress e copiar e colar o bloco de código Adsense nele, mas isso seria tedioso e potencialmente perturbador com toda a marcação extra na minha postagem. Além disso, se eu quisesse mudar o bloco de anúncios, eu teria que voltar para cada publicação para mudá-lo para o novo. Uma maneira mais fácil e mais confiável de adicionar o bloco do Adsense onde quer que eu desejei seria usar um shortcode do adsense. O shortcode poderia ser assim:
[adsense]
Quando estiver olhando para o post em seu site, o shortcode seria substituído pelo bloqueio do anúncio Adsense. Então, como você cria esse shortcode? Obviamente, você precisa dizer ao WordPress o que substituir o código curto de alguma forma. Vejamos isso em seguida.
Como faço para criar um código curto?
Felizmente, o WordPress torna bastante simples fazer seus próprios códigos curtos, então vamos realmente implementar o shortcode [adsense]. A primeira coisa que precisamos fazer é definir uma função que emita o código Adsense real. Todo o código a seguir entrará em functions.php no seu tema (também pode entrar em um arquivo de plugin autônomo). Consegui? Ok, então vejamos essa função.
função get_adsense ($ atts) {
Retorna '
';
}
Esta função é bastante direta – ele apenas retorna meu código do Google Adsense como uma string. Qualquer que seja a função retornada é o que meu shortcode será substituído, então eu poderia potencialmente ter retornado o html para um widget do Twitter, ou uma lista das mensagens secundárias deste ou qualquer outra coisa.
Agora que temos uma função que retorna o que queremos, como podemos ligar isso a um shortcode? Agora, é aí que entra a API do WordPress. Mais uma vez, vejamos como o fazemos e depois explicamos o que está acontecendo. Aqui está a chamada para configurar o shortcode do adsense.
add_shortcode ('adsense', 'get_adsense');
É isso aí! O primeiro parâmetro passado é o nome do shortcode, então, no nosso caso, “adsense” diz ao WordPress que crie o shortcode [adsense]. O segundo parâmetro designa a função que será chamada quando o novo shortcode for encontrado. Mais uma vez, no nosso caso, ‘get_adsense’ diz ao WordPress que substitua [adsense] pelos resultados do nosso método get_adsense.
Não é tão ruim assim? Agora, este é um shortcode muito simples, o WordPress permite que você faça muito mais com seus códigos curtos, incluindo a adição de parâmetros (talvez você queira escolher entre os blocos adsense?). A API completa pode ser vista no WordPress Codex.
Como faço para usar meu código curto?
Esta última parte é simples, basta adicionar o shortcode [adsense] nas visualizações HTML ou Visual do editor de conteúdo Post ou Page. É isso aí! Você criou seu primeiro shortcode.