Base técnica: enqueue, dependencias y versión
Si no usas el sistema de enqueue de WordPress, pierdes control de orden, duplicados y compatibilidad.
wp_enqueue_style() y wp_enqueue_script() permiten registrar handles claros y respetar dependencias entre archivos.
Versionar con filemtime() en desarrollo evita peleas con caché cuando cambias CSS/JS muchas veces al día.
En release, fijar versión semántica facilita soporte: sabes exactamente qué paquete está en producción.
- Nada de etiquetas hardcodeadas en header.php.
- Un handle por asset y nombres consistentes.
- Dependencias reales (no por intuición).
- Scripts no críticos en footer cuando sea posible.
Enqueue limpio en functions.php
add_action('wp_enqueue_scripts', function () {
$theme_version = wp_get_theme()->get('Version');
$main_css = get_theme_file_path('/assets/css/main.css');
$main_css_ver = file_exists($main_css) ? (string) filemtime($main_css) : $theme_version;
wp_enqueue_style(
'mi-tema-main',
get_theme_file_uri('/assets/css/main.css'),
[],
$main_css_ver
);
wp_enqueue_script(
'mi-tema-navigation',
get_theme_file_uri('/assets/js/navigation.js'),
[],
$theme_version,
true
);
});