Filtro body_class — Adicionar classes ao
Causa
Estilizar páginas específicas via CSS exige identificadores no elemento body. Editar o template diretamente acopla o plugin ao tema.
Como resolver
Adicione suas classes ao array $classes e retorne-o. Nunca retorne apenas o array com suas classes — isso remove todas as classes padrão do WordPress.
<?php
add_filter('body_class', function (array $classes): array {
// Classe para usuários logados
if (is_user_logged_in()) {
$classes[] = 'usuario-logado';
$user = wp_get_current_user();
foreach ($user->roles as $role) {
$classes[] = 'role-' . sanitize_html_class($role);
}
}
// Classe para página específica
if (is_page('contato')) {
$classes[] = 'pagina-contato';
}
// Remove classe gerada pelo WP que causa conflito
$classes = array_diff($classes, ['page-template-default']);
return array_unique($classes);
});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 the_content — Modificar o conteúdo do post
Permite filtrar e modificar o conteúdo HTML de um post antes de ser exibido. Amplamente usado para adicionar banners, chamadas para ação ou formatar conteúdo.
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.