Home > Truques & Dicas, Tutoriais, Wordpress > Como criar Shortcodes para Wordpress

Como criar Shortcodes para Wordpress

Shortcodes são “funções de atalho” para serem usados dentro do conteúdo no Wordpress. Um simples exemplo de um poderia ser:

[ads-1]

Que , por exemplo, inseriria um anúncio no meio do seu conteúdo. Eles também aceitam atributos no estilo:

[ads-1 size="125"]

Que poderia, por exemplo, inserir um anúncio com tamanho de 125 pixels. Porém uma das grande vantagem no seu uso está na automatização no uso de padrões e/ou formatações comumente usados nos seus posts.


Para exemplificar como criar seus próprios irei usar um que criei.

Scrollbox

Entrando em qualquer uma das páginas dos meus projetos você irá notar que as versões no Changelog estão dentro de uma pequena caixa com barra de rolagem vertical, evitando assim que a grande altura da lista aumente muito a altura da página. Essa “Caixa de Rolagem” nada mais é que uma div estilizada criada por um shortcode que “envolve” a lista de versões, segue o código:

add_shortcode('scrollbox', 'func_scrollbox');
function func_scrollbox($atts, $content=null) {
	extract(shortcode_atts(array(
		'height' => '220px',
		'width' => '98%',
		'padding' => '3px',
		'border-color' => '#999999',
		), $atts));
	return '<div style="height:'.$height.';width:'.$width.';overflow:auto;padding:'.$padding.';border:thin solid '.$bordercolor.';">' . do_shortcode($content) . '</div>';
}

O Código

Explicando cada linha:

1 – “Avisa” o Wordpress que sempre que o shortcode [scrοllbox] for usado a função func_scrollbox será executada
2 – A função do shortcode em si, que recebe os atributos ($atts) e o conteúdo ($content), o conteúdo é tudo aquilo que fica entre as tags do shortcode, ex:

[scrollbοx]conteúdo do shortcode[/scrollbοx]

3 à 8 – Os atributos do shortcode e seu valores pré-definidos, caso nenhum atributos for passado todos eles terão, respectivamente, estes valores.

10 – O que ele irá retornar, note que é um simples código HTML de uma div com estilo para mostrar barras de rolagem quando houver overflow de conteúdo, com variáveis no lugar dos respectivos valores:

'<div style="height:'.$height.';width:'.$width.';overflow:auto;padding:'.$padding.';border:thin solid '.$bordercolor.';">' . do_shortcode($content) . '</div>'

Obs: a função do_shortcode() serve para garantir que outros shortcodes possam ser executados dentro deste.

O melhor lugar para colocar o código é no arquivo functions.php do seu tema, você pode facilmente edita-lo de dentro do próprio Wordpress em Aparência > Editor, selecionar Funções do Tema e colar o código em qualquer lugar entre <?php e ?>.

Atenção: cuidado para não alterar nada pré-existente no arquivo functions.php com o perigo de “quebrar” seu layout.

Agora ponha sua criatividade para trabalhar e crie seus próprios!

Posts Similares:

Compartilhe:

  • Twitter
  • Digg
  • del.icio.us
  • StumbleUpon
  • Technorati
  • Tumblr
  • Live
  • Google Bookmarks
  • Facebook
  • Identi.ca
  • FriendFeed
  • Ping.fm
  • Yahoo! Bookmarks
  1. January 10th, 2010 at 00:57 | #1

    Ótimo! Acho que era isso que eu precisava!

  2. kika
    May 21st, 2009 at 06:16 | #2

    “Agora ponha sua criatividade para trabalhar e crie seus próprios! ”
    Adorei esse final, bem na linha daqueles programas pra dona de casa iuhasddusa

  1. No trackbacks yet.