{"id":42929,"date":"2024-03-19T16:14:14","date_gmt":"2024-03-19T19:14:14","guid":{"rendered":"\/tutoriais\/?p=42929"},"modified":"2024-03-19T16:22:05","modified_gmt":"2024-03-19T19:22:05","slug":"add-filter-wordpress","status":"publish","type":"post","link":"\/br\/tutoriais\/add-filter-wordpress","title":{"rendered":"O que s\u00e3o filtros do WordPress e como utilizar o add_filter"},"content":{"rendered":"

Um filtro WordPress é um hook<\/strong> <\/strong>que opera sobre dados internos antes de exibi-los no navegador de internet. Para criar um filtro, basta adicionar a função add_filter <\/strong>no arquivo  functions.php <\/strong>do seu site.<\/p>

No universo do desenvolvimento de sites WordPress, os usuários utilizam esse filtro para modificar algum plugin, tema ou funcionalidade específica do site. Por exemplo, você pode alterar o comprimento dos trechos textuais das prévias dos seus posts ou adicionar uma nota de rodapé nas publicações. <\/p>

Neste tutorial WordPress<\/strong>, vamos explicar como utilizar a função add_filter <\/strong>para criar um hook de filtro. Além disso, também vamos explorar os parâmetros desta função e apresentar os usos mais comuns desse elemento. <\/p>

\n\n\n\n\n\n\n\n\n<\/p>

<\/p>

\n\n\n

\n

O Que É Um Filtro WordPress?<\/h2>\n

Um filtro WordPress é um hook, ou gancho, que modifica certos dados antes deles serem processados pelo banco de dados e exibidos aos usuários. Consequentemente, você pode personalizar plugins, temas ou funcionalidades do seu site sem precisar mexer nos arquivos estruturais do WordPress (core files<\/em>). <\/p>

Por exemplo, adicione uma nota de rodapé em todos os posts do site ou altere o tamanho da descrição exibida nas miniaturas de artigos e publicações. Há quatro funções comuns do hook de filtro: add_filter<\/strong>, remove_filter<\/strong>, has_filter<\/strong> e doing_filter<\/strong>.<\/p>\n <\/div>\n\n\n\n<\/p>

Como o WordPress Filtra os Dados<\/strong><\/h2>

Resumidamente, os filtros interceptam os dados que o WordPress envia aos navegadores de internet. Eles modificam essas informações de acordo com a função determinada e então as apresentam aos dispositivos dos usuários. Para te ajudar a entender melhor, confira este snippet:<\/p>

\/\/ Specify the filter and the callback function\n   add_filter( 'example_filter', 'example_callback' );\n   \/\/ Define the callback function\n   function example_callback( $example ) {\n      \/\/ alter $example by concatenating on it\n      $example . ‘ add a text at the end ’;\n      return $example;\n   }<\/pre>
Agora vamos explicar cada linha de código do exemplo:<\/p>
    \n
  1. Configure um filtro utilizando a função add_filter <\/strong>– que irá modificar os dados. No nosso exemplo, o nome do filtro é example_filter<\/strong>.<\/li>\n\n\n\n
  2. Defina a função de callback<\/strong><\/a> que irá rodar quando o WordPress encontrar tal filtro. No exemplo acima, utilizamos a função example<\/strong>_callback<\/strong>.<\/li>\n\n\n\n
  3. Especifique como a função callback deverá modificar os dados que o argumento $example <\/strong>representa. No snippet de exemplo, nós utilizamos o ponto final para concatenar o argumento com uma frase. <\/li>\n\n\n\n
  4. Através do método return<\/strong>, você fará a exibição dos dados modificados no navegador de internet dos usuários. <\/li>\n<\/ol>
    Para aplicar um filter hook em seu site WordPress, escreva o código indicado no arquivo functions.php <\/strong>contido na pasta do tema que está ativo em seu site. Caso você utilize o serviço de hospedagem WordPress da Hostinger<\/strong><\/a>, basta acessar o Gerenciador de Arquivos<\/strong> no seu painel de controle e navegar até o diretório public_html\/wp-content\/themes\/pastadoseutema<\/strong>.<\/p>
    \n
    \"abrindo<\/figure><\/div>
    Além disso, recomendamos que você também adicione o código no tema-filho, ou child theme<\/strong><\/a>, para evitar que ele desapareça depois de alguma atualização. Alternativamente, você pode criar um arquivo separado para os hoooks de filtro na pasta raiz do tema, e então escrever o seguinte código no arquivo functions.php:<\/p>
    include _once( get_template_directory(), ‘\/nomedoarquivo.php’:’<\/pre>
    Se você não consegue acessar o diretório raiz do seu tema, instale um plugin<\/strong><\/a> para poder adicionar o código personalizado diretamente a partir do seu painel de administração do WordPress. Um plugin popular para essa tarefa é o Code Snippets<\/strong><\/a>.<\/p>
    \n\n\n
    Importante! <\/strong>Modificar o arquivo functions.php<\/strong> do tema pode levar a erros no seu site ou deixá-lo inacessível. Para evitar problemas, faça um backup<\/strong><\/a> antes de seguir com o processo.<\/p><\/div>\n\n\n\n<\/p>
    Parâmetros do WordPress add_filter <\/strong><\/h2>
    A função WordPress add_filter <\/strong>possui quatro parâmetros. São eles:<\/p>