Como enfileirar scripts e estilos com wp_enqueue_scripts
Forma correta de carregar CSS e JS no front-end sem conflitar com o tema ou outros plugins.
Causa
Inserir <script> e <link> diretamente no template ignora o gerenciamento de dependências do WordPress, causando duplicação, conflitos de versão e carregamento na ordem errada.
Como resolver
Registre e enfileire os assets dentro do hook wp_enqueue_scripts, declarando dependências e versão para aproveitar o cache busting e o carregamento condicional.
PHP
add_action( 'wp_enqueue_scripts', function () {
wp_enqueue_style(
'meu-tema-estilo',
get_stylesheet_directory_uri() . '/assets/css/estilo.css',
[],
'1.0.0'
);
wp_enqueue_script(
'meu-tema-script',
get_stylesheet_directory_uri() . '/assets/js/script.js',
[ 'jquery' ],
'1.0.0',
true
);
} );