¿Qué práctica es correcta en un tema clásico mantenible?

La carga contextual con enqueue reduce peso, evita conflictos y mejora mantenibilidad del tema.

WordPress Themes Pro

Tema clásico 03: enqueue de assets sin conflictos

Implementa una carga de CSS/JS sólida en temas clásicos con dependencias, versionado y activación por contexto.

¿Cuánto sabes de WordPress Themes Pro?

📘 Teoría

Principios de carga en tema clásico

enqueue no es opcional: es la capa que coordina assets entre núcleo, plugins y tema.

Cada archivo debe tener un handle único y descriptivo para facilitar depuración y mantenimiento.

Declara dependencias explícitas en scripts para que WordPress gestione el orden correcto sin hacks manuales.

Versiona assets con filemtime en desarrollo para invalidar caché al instante y usa versión fija en release.

Nunca hardcodees etiquetas en header.php.
Un módulo, un handle, una responsabilidad.
Scripts no críticos en footer cuando aplique.
Nombra recursos con convención estable del tema.

Implementación base en functions.php

Carga CSS principal y JS de navegación con versión coherente y sin duplicados.

Enqueue recomendado

<?php
add_action('wp_enqueue_scripts', function () {
  $theme_version = wp_get_theme()->get('Version');

  $css_path = get_theme_file_path('/assets/css/main.css');
  $css_ver = file_exists($css_path) ? (string) filemtime($css_path) : $theme_version;

  wp_enqueue_style(
    'mi-tema-main',
    get_theme_file_uri('/assets/css/main.css'),
    [],
    $css_ver
  );

  wp_enqueue_script(
    'mi-tema-navigation',
    get_theme_file_uri('/assets/js/navigation.js'),
    [],
    $theme_version,
    true
  );
});

Carga contextual por plantilla

No cargues módulos avanzados en páginas que no los usan.

Si una funcionalidad solo existe en una landing o en un CPT, actívala con is_page_template o is_singular.

Esto reduce transferencias innecesarias y mejora métricas de render en vistas simples.

Mantén un inventario de assets por feature para que el equipo sepa dónde se activa cada archivo.

Script exclusivo para plantilla de contacto

<?php
add_action('wp_enqueue_scripts', function () {
  if (!is_page_template('templates/contacto.php')) {
    return;
  }

  wp_enqueue_script(
    'mi-tema-contacto',
    get_theme_file_uri('/assets/js/contacto.js'),
    [],
    '1.0.0',
    true
  );
});

1 Principios de carga en tema clásico 2 Implementación base en functions.php 3 Carga contextual por plantilla