Filtro the_content — Modificar o conteúdo do post
Causa
Alterar conteúdo diretamente nos templates de tema cria dependência e dificulta atualizações. O filtro garante que a modificação ocorra de forma desacoplada.
Como resolver
Sempre retorne o $content modificado, nunca faça echo. Verifique o contexto com is_singular() ou is_main_query() para evitar modificações indesejadas em widgets e excerpts.
<?php
add_filter('the_content', function (string $content): string {
// Aplica apenas em posts singulares do tipo "artigo"
if (!is_singular('artigo') || !is_main_query()) {
return $content;
}
// Adiciona CTA ao final do conteúdo
$cta = '<div class="cta-box">
<h3>Gostou deste artigo?</h3>
<a href="' . esc_url(home_url('/newsletter')) . '" class="btn-primary">
Assine nossa newsletter
</a>
</div>';
return $content . $cta;
}, 20);Filtro wp_nav_menu_items — Adicionar itens ao menu
Permite injetar itens HTML customizados em menus de navegação registrados pelo tema sem precisar editar o template ou o banco de dados.
Filtro upload_mimes — Permitir tipos de arquivo extras
Controla quais tipos MIME são permitidos no uploader de mídia do WordPress. Por padrão, vários formatos são bloqueados por segurança.
Filtro body_class — Adicionar classes ao
Permite adicionar classes CSS customizadas à tag gerada pelo WordPress, facilitando a estilização contextual sem sobrescrever templates.
Filtro pre_get_posts — Modificar consultas antes da execução
Permite alterar argumentos do WP_Query principal (e outras queries) antes que a consulta SQL seja gerada, sem criar uma nova instância de WP_Query.