O que é: Filtro

No desenvolvimento do WordPress, um filtro pode ser usado para alterar ou ampliar a funcionalidade do WordPress. Ele faz isso pegando alguns dados fornecidos pelo WordPress, transformando-os em outra coisa e, em seguida, passando-os de volta.

Os filtros são um dos grandes recursos que tornam o WordPress tão personalizável. Eles são partes de código PHP que são “conectadas” a um evento do WordPress. Quando o evento é acionado, o filtro é aplicado à saída de dados gerada pelo gancho do evento.

Eles são amplamente usados por desenvolvedores de plugins e temas. Entretanto, se você não for um desenvolvedor, poderá colar trechos de código da Web para adicionar novos recursos ao seu site. Muitos deles incluem filtros.

O que é um filtro no WordPress?

Um filtro modificará o comportamento padrão de uma função específica em seu site WordPress. Ele faz isso manipulando os dados que recebe e, em seguida, retornando esses dados ao WordPress antes de serem exibidos no navegador.

Por exemplo, os filtros podem ser usados para truncar texto, alterar a formatação do conteúdo, anexar links a postagens, modificar blocos em uma página e alterar opções recuperadas do banco de dados. Eles também podem alterar o tamanho de um trecho, colocar posts relacionados abaixo do conteúdo principal ou alterar um preço no WooCommerce.

Os filtros são adicionados usando a função add_filter(). O WordPress tem várias funções que permitem que você use ações, mas essas são as mais comumente usadas:

• add_filter(): anexa uma função a um gancho
• remove_filter(): remove uma função anexada a um gancho de filtro especificado
• doing_filter(): detecta qualquer filtro que esteja sendo executado no momento
• has_filter(): verifica se um filtro foi registrado

Os filtros são usados por desenvolvedores de plugins e temas para adicionar funcionalidades extras ao WordPress. Você também pode usar filtros para personalizar seu tema adicionando trechos de código de tutoriais on-line.

Antes de editar qualquer código em seu site do WordPress, recomendamos que você faça um backup do site, caso ocorra um erro de codificação. Se você não tiver um plug-in de backup, não deixe de ler nosso artigo em que comparamos os melhores plug-ins de backup do WordPress.

Também recomendamos que você não adicione o código diretamente aos arquivos do tema, ou perderá suas personalizações na próxima vez que atualizar o tema.

Em vez disso, você deve usar um plug-in de trechos de código para adicionar código personalizado no WordPress, criar um plug-in específico para o site ou criar um tema filho e modificá-lo em vez do tema pai.

Consulte nosso guia sobre como atualizar um tema do WordPress sem perder a personalização.

Qual é a diferença entre ganchos, ações e filtros?

Para entender melhor os filtros no WordPress, é útil ver como eles se relacionam com outros dois termos, hooks e ações. Compreender esses três termos juntos tornará o termo “filtro” um pouco mais fácil de entender.

Os ganchos são a base do desenvolvimento de plug-ins e temas do WordPress. Eles são locais onde os desenvolvedores podem “enganchar” seu código personalizado no WordPress em locais específicos e alterar a forma como o WordPress opera sem editar os arquivos principais.

Há dois tipos de ganchos.

• Os hooks de filtro permitem que você altere algo. Eles interceptam os dados que estão sendo processados e permitem que você os modifique e, em seguida, os passe de volta. São usados para filtrar a saída quando ela é enviada para um banco de dados ou para o navegador do usuário.
• Os ganchos deação permitem que você faça algo. Eles permitem que você adicione funcionalidades extras e são executados quando ocorrem eventos como a ativação de um tema ou plug-in ou a publicação de um post. Depois que a ação é executada, eles não precisam passar nenhuma informação de volta.

Esses ganchos de ação e filtro são a base do funcionamento do núcleo, dos temas e dos plug-ins do WordPress. Eles trabalham juntos para permitir que os desenvolvedores tenham grande flexibilidade para modificar eventos, filtros e ações padrão do WordPress.

Os desenvolvedores também podem criar suas próprias ações e filtros personalizados para que outros desenvolvedores possam ampliar seus plug-ins ou temas.

Exemplos de filtros do WordPress

Qual é a aparência de um filtro? Aqui estão alguns exemplos.

Digamos que desejemos exibir um ícone de imagem quando uma postagem pertencente a uma determinada categoria for exibida. Nesse cenário, criamos uma função que verifica se uma postagem está nessa categoria específica. Se estiver, exibiremos a imagem.

Em seguida, conectamos essa função ao evento the_content. Agora, sempre que o evento the_content ocorrer, nossa função será automaticamente acionada para filtrar a saída do evento the_content.

// First we hook our own function with the_content event
add_filter( 'the_content', 'wpb_content_filter' );
 
// Now we define what our function would do.
// In this example it displays an image if a post is in news category.
function wpb_content_filter( $content ) {
    if ( in_category('news') )
        $content = sprintf('<img class="news-icon" src="%s/images/news_icon.png" alt="News icon" title="" />%s', get_bloginfo( 'stylesheet_directory' ), $content);
 
    // Returns the content.
    return $content;
}

Aqui está outro exemplo de uso de um filtro do WordPress.

Esse código de exemplo adiciona uma função wpb_custom_excerpt ao filtro get_the_excerpt.

function wpb_custom_excerpt( $output ) {
  if ( has_excerpt() && ! is_attachment() ) {
    $output .= wpb_continue_reading_link();
  }
  return $output;
}
add_filter( 'get_the_excerpt', 'wpb_custom_excerpt' );

Você pode aprender mais estudando nossos guias do WordPress que usam filtros. Por exemplo, aqui estão alguns guias que mostram como obter algo prático usando os filtros do WordPress:

• Como mostrar menus diferentes para usuários conectados
• Como desativar a barra de administração para todos os usuários, inclusive os administradores
• Como atualizar automaticamente os plug-ins do WordPress
• Como desativar as dicas de login no WordPress
• Como desativar as notificações por e-mail sobre atualizações automáticas

O WordPress tem muitos filtros predefinidos que permitem que os desenvolvedores adicionem seu próprio código em pontos específicos do núcleo do WordPress. A API de plug-ins do WordPress fornece uma extensa lista de ganchos de filtro disponíveis.

Esperamos que este artigo tenha ajudado você a saber mais sobre filtros no WordPress. Talvez você também queira ver nossa lista de Leitura adicional abaixo para obter artigos relacionados sobre dicas, truques e ideias úteis do WordPress.

Se você gostou deste guia, considere a possibilidade de se inscrever em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Leitura adicional

• Ação
• functions.php
• Ganchos