Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress

Adicionando Ganchos de Ação à Sua Framework para Temas de WordPress

by
Difficulty:IntermediateLength:ShortLanguages:
This post is part of a series called How Theme Frameworks Actually Work.
Creating the Starting Files for Your WordPress Theme Framework
Adding Functions to Your WordPress Theme Framework

Portuguese (Português) translation by Erick Patrick (you can also view the original English article)

Se você seguiu os capítulos iniciais dessa série, você já:

Nesse tutorial, você adicionará alguns ganchos de ação (action hooks) aos arquivos do seu modelo, aos quais anexará funções no próximo tutorial. E, depois, adicionará alguns ganchos de filtro (filter hooks).

A vantagem em criar filtros de ações em sua framework é que qualquer conteúdo que anexar a eles, pode ser sobrescrito por funções em um tema filho ou por plugins. Isso ajuda a evitar arquivos duplicados dentro dos temas filhos além de prover mais flexibilidade.

Nota: Se quiser saber mais sobre ganchos de ação e de filtro antes de dar continuidade a esse tutorial, esse outro artigo ajudará.

O Que Você Precisará

Para acompanhar esse tutorial, você precisará de:

  • Um ambiente para desenvolvimento com o WordPress;
  • Seu próprio tema ou os arquivos do tema criados na Parte 3 dessa série, os quais você pode encontrar no repositório do GitHub que acompanha a série;
  • Um editor de código

Adicionando Ganchos ao Cabeçalho

Adicionaremos dois ganchos ao cabeçalho: um antes e um dentro dele.

No arquivo header.php, logo abaixo da tag <body> de abertura, adicione o primeiro gancho de ação:

Esse gancho pode ser útil para a adição de conteúdo, menus ou links acima do cabeçalho do site.

Adicione outro gancho dentro do cabeçalho, à direita. Seus temas filhos podem usar esse gancho para adicionar conteúdo customizdo, como um formulário de busca ou widgets.

Perceba que envolvi esse gancho em uma div com algumas classes aplicadas, que funcionam dentro do padrão orientado a objetos de estilização do meu tema - se estiver fazendo isso em seu tema, precisará usar algo diferente, mas o gancho em si será o mesmo.

Adicionando Ganchos ao Conteúdo

O tema incluirá dois ganchos para conteúdo - um logo antes e outro logo após o loop, ambos dentro de #content div. Por sorte, pelo modo que meu tema está organizado, precisarei adicionar cada gancho apenas uma vez, já que começo a #content div no arquivo header.php e termino no arquivo sidebar.php. No arquivo page-full-width.php ele esse último é adicionado à parte, porque o arquivo não chama a sidebar, logo, é preciso adicionar aqui também.

Comecemos com o que vem logo antes do loop.

Ao final do arquivo header.php, adicione o trecho de código abaixo, logo no começo de #content:

Isso proverá um gancho para qualquer coisa dentro da área do conteúdo, contudo, logo antes do loop.

Já no arquivo sidebar.php, antes da tag de fechamento da div #content, adicione o trecho abaixo:

Por fim, adicionaremos esse código ao arquivo page-full-width.php do modelo, assim como fizemos com o arquivo sidebar.php, logo antes da tag de fechamento da div #content.

Adicionando Ganchos à Sidebar

O próximo passo é substituir a área de widget na sidebar por um gancho, que será usado para adicionar a área de widget de volta, em um passo posterior, entretanto, também pode ser usado para adicionar código customizado ou sobrescrever a área de widget.

Substitua todo o código da área de widget por esse novo gancho:

Isso quer dizer que, se você quiser substituir a área de widget por um código próprio seu em um plugin ou em um tema filho, será capaz de fazê-lo, anexando o novo código a esse gancho e sobrescrevendo o gancho que anexa a área de widget.

Adicionando Ganchos ao Rodapé

Finalmente, podemos adicionar alguns ganchos ao rodapé: um dentro dele e outro logo abaixo, que será usado para o cólofon.

Dentro do elemento footer, substitua todo o código existente pelo gancho abaixo:

Agora, adicionemos outro gancho para o cólofon, após a tag de fechamento do elemento footer:

Nota: O código que você removeu será substituído, mais para frente. Contudo, ao invés de adicioná-los diretamente nos arquivos do modelo, eles serão inseridos usando uma função que é ativada através de um gancho apropriado. Também adicionaremos ganchos de filtro para algumas funções.

Conclusão

Usar ganchos de ação em seus arquivos de modelo dá a você e aos usuários da sua framework, muito mais flexibilidade. Você pode usá-los para inserir qualquer tipo de conteúdo que quiser, ou mesmo sobrescrever ou remover o conteúdo, tudo sem criar ou modificar arquivos de modelo.

Na continuação dessa série, mostrarei como criar funções que adicionarão áreas de widget e outros conteúdos, tudo ativado através desses ganchos.

Seja o primeiro a saber sobre novas traduções–siga @tutsplus_pt no Twitter!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.