WordPress: como usar shortcodes na theme, em widgets ou nos artigos

O WordPress oferece uma forma simples, segura e bastante ‘clean’ (limpa ) de misturar pedaços códigos PHP dentro de artigos (‘posts’) ou páginas por meio da Shortcode API.

A Shortcode API (Application Programming Interface) está disponível desde a versão 2.5 e foi um grande ganho para os desenvolvedores de plugins e temas.

Para que possamos usar shortcodes no WordPress, devemos criar uma função no arquivo functions.php do tema ou através de um plugin. Depois devemos evocar a função registada no nosso artigo dentro de ‘[ ]’ (colchetes), o WordPress substituirá o shortcode pelo retorno da função. Exemplo:

WordPress: criando shortcodes

<?php
function fn_templates(){
   return get_bloginfo('template_url');
}
add_shortcode('templates','fn_templates');
?>

Chamamos o shortcode criado da seguinte forma:

[templates]

No próximo exemplo vamos criar um shortcode para inserir um mapa navegável, do Google Maps diretamente em nosso artigo. Vamos usar alguns parâmetros para refinar o mesmo. A função vai estar preparada para receber os parâmetros latitude/longitude, altura e largura do mapa.

function mapa($atributos) {
    extract(
    shortcode_atts(array(
    	'll'        => '-15.570624,-56.087179',
    	'altura'    => 300,
    	'largura'   => 300
    	), $atributos));
return '<iframe width="'.$largura.'" height="'.$altura.'" frameborder="0" scrolling="no" marginheight="0" marginwidth="0" src="https://maps.google.com/?ie=UTF8&ll='.$ll.'&spn=0.014469,0.018239&z=15&output=embed"></iframe>';
}
add_shortcode('Gmap', 'mapa');

A nossa função mapa receberá um parâmetro que equivale a um array com os valores vindos do post. Devemos então perceber que a primeira coisa que fazemos é tratar os parâmetros com as funções ‘extract’ e ‘shortcode_atts’.

A funções ‘extract’ é usada para converter as chaves de um array em nome de variável ($ll, $altura, $largura). A funções ‘shortcode_atts’ garante que os parâmetros não declarados no post terão um valor padrão, sendo assim, nenhum parâmetro é obrigatório.

Vamos chamar o shortcode com o nosso mapa no artigo para se entender mais facilmente. Para tal usaremos o seguinte:

[Gmap ll='41.156686,-8.623924']

O mapa vai aparecer no artigo com altura e largura de 300px, como não declaramos nenhum valor, será assumido o valor padrão. Já a latitude/longitude (ll) terá o valor que declaramos (-15.570624,-56.087179).

Podemos utilizar os shortcodes de varias formas, não só nos artigos como diretamente em qualquer arquivo do tema em uso, basta que utilizes o seguinte código onde quer que o mesmo apareça:

<?php echo do_shortcode("[Gmap ll='41.156686,-8.623924']"); ?>

Também podemos adicionar os shortcodes nas widgets do tipo ‘Texto’ da mesma forma que são utilizados nos artigos. Para tal, adicionamos no arquivo ‘functions.php’ do tema em uso o seguinte código :

add_filter('widget_text', 'do_shortcode');

Agora já pode utilizar shortcodes no WordPress facimente, tanto em widget, como em artigos ou em qualquer arquivo do tema em uso.

E você costuma usar shortcodes no WordPress? Conhecia esta forma? Comente!

Um abraço e até breve!

---

---