Como adicionar uma Sidebar no WordPress

Escrito por Gustavo Bordoni em Desenvolvimento, Wordpress no dia 20 de setembro, 2009

Como usar Widgets no WordPress

Como usar Widgets no WordPress

Mais um artigo sobre WordPress, dessa vez vou falar um pouco sobre um tópico muito recorrente em relação a criação de Temas para o WordPress.

Bom todos devem estar cientes que é possível adicionar complementos a sua barra lateral com uma ferramenta chamada Widget, porém para que você ou o cliente possa usufruir de tal facilidade você deve preparar seu Tema para aceitar o dito cujo.

Contudo normalmente a galera não sabe realmente como Implementar da maneira correta nos Temas, e o artigo tem este propósito, explicar como fazer seu tema aceitar os Widgets da maneira correta.

Vamos começar acessando o arquivo functions.php do tema que desejamos implementar, e devemos acessar este arquivo pois nele iremos encontrar todas as funções que o nosso tema vai abrir antes de ser interpretado pelo sistema, assim sendo podemos declarar funções ali e usar em uma página qualquer por exemplo.

Após aberto o arquivo, adicione antes de tudo o seguinte código e leia o que vem em seguida para entender como configurar:

<?php if ( function_exists('register_sidebar') )
    register_sidebar(array(
		'name'=>'Barra lateral Direita',
		'before_widget' => '<div id="%1$s" class="%2$s">',
		'after_widget' => '</div>',
		'before_title' => '<h3 class="title">',
		'after_title' => '</h3>',
    )); ?>

Vamos por partes, primeiramente estamos verificando se a função usada para o registro de Sidebar está disponível, caso tal fato seja verdadeiro, iremos ativar a função declarando um array com os algumas variáveis, que definem algumas opções.

  • name - Define o nome que você vai dar para sua barra lateral, lembre-se de dar um nome indicativo do que ela contém
  • before_widget – Define o que vem antes de cada um dos Widgets, assim usamos duas variáveis [%1$s e %2$s] para poder identificar qual widget esta dentro desta div, assim podemos adicionar classes exclusivas de estilo dependendo do conteúdo.
  • after_widget – Basicamente define o término da caixa de um Widget, por exemplo </div>
  • before_title – Define o que vem antes do título do Widget, isso é importante para fazer o estilo do título, é bom usar por exemplo um <h3>
  • after_title – Define o final do título, apenas feche a tag aberta antes, que no meu caso foi a <h3>

Então após feito a configuração da sua Barra Lateral, vamos implementar no arquivo sidebar.php o código que importa a Barra Lateral. Para isso adicione o seguinte código:

	<?php if ( !function_exists('dynamic_sidebar') || !dynamic_sidebar('Barra lateral Direita') ) : ?>
	<!-- Aqui você coloca algo que deve aparecer quando não tem nenhum Widget -->
	<?php endif; ?>

Bom não esqueça de colocar ali onde eu coloquei ‘Barra lateral Direita’, você coloca o nome da barra que deseja importar. E não se esqueça que você deve sempre deixar uma opção, para caso não tenha nenhum widget, não fique sem nada.

Em suma para fazer com que a sua Sidebar aceite os famosos Widgets da maneira correta e não deixe erros. Eu vou responder qualquer dúvida, e caso tenha algo a adicionar também comentem, pois ai eu adiciono para tornar o artigo mais completo.

Dê para mim um dos maiores pagamentos pelo meu artigo, deixe um comentário, seja ele uma crítica construtiva ou apenas um elogio.

Decodifique seus pensamentos abaixo