Cuándo utilizar plantillas nativas o un motor adicional, cómo preparar sus dependencias y qué comprobar al integrarlo en WordPress.
Una plantilla es más fácil de mantener cuando se ocupa de presentar datos que ya están preparados. Si mezcla consultas, reglas del negocio, llamadas a servicios externos y HTML, cambiar el diseño puede terminar afectando al funcionamiento de la aplicación.
Conocí Smarty al trabajar con CMS Made Simple, que lo traía incorporado, y con PrestaShop, que también lo utilizaba. Al comenzar con WordPress eché de menos esa separación explícita y me pareció una buena idea explorar su integración. Sin embargo, en el trabajo cotidiano no he necesitado incorporar Smarty a mis desarrollos en WordPress.
Preparar los datos antes de presentarlos
La lógica de la aplicación obtiene y valida la información, comprueba permisos y aplica las reglas del negocio. La vista recibe los campos que necesita y decide cómo mostrarlos. Por ejemplo, una tarjeta puede recibir un título y un resumen, sin conocer cómo se consultaron o qué sistema los proporcionó.
Utiliza una estructura de datos explícita y estable. No entregues a la plantilla objetos con credenciales, información de otros clientes o métodos que no necesita. Las condiciones de presentación, como mostrar un bloque cuando hay texto, son diferentes de las reglas que autorizan su acceso.
Una plantilla no sustituye el control de permisos: los datos restringidos deben filtrarse antes de llegar a ella. Tampoco conviene lanzar una consulta o una petición externa por cada elemento de una lista si puedes preparar el conjunto antes de renderizarlo.
Aprovechar primero las herramientas de WordPress
En temas clásicos puedes dividir el marcado en plantillas y partes reutilizables. get_template_part() admite un array de argumentos desde WordPress 5.5, que permite pasar los datos de una vista sin crear variables globales propias.
También puedes separar responsabilidades con una buena distribución de funciones y archivos PHP: unas funciones obtienen y preparan los datos, y otras partes del código se ocupan de presentarlos. Lo importante es que las consultas y las reglas del negocio no queden dispersas por el marcado. En temas de bloques, las plantillas, partes y bloques tienen su propio funcionamiento. Elige el mecanismo que encaja con el editor y con quienes van a mantener el proyecto. No cambies todo el sistema de presentación para resolver un pequeño fragmento.
Mantén las integraciones, los tipos de contenido y las reglas del negocio en un plugin cuando deban seguir funcionando al cambiar de tema. La plantilla puede permanecer en el tema o en el componente responsable de su presentación, con un procedimiento claro para personalizarla.
Cuándo puede aportar un motor como Smarty
Un motor de plantillas aporta un lenguaje específico para expresar el marcado y sus variables. Puede resultar práctico cuando el equipo ya lo conoce o cuando hay muchas vistas complejas que comparten componentes. A cambio, incorpora una dependencia, una sintaxis y un proceso de mantenimiento adicionales.
Las expresiones entre llaves no son necesariamente texto estático: Smarty dispone de variables, condiciones, bucles y otras construcciones. El diseñador necesita conocer ese lenguaje y el acuerdo sobre los datos disponibles; separar archivos no elimina la coordinación entre diseño y programación.
Como ejemplo de una alternativa para quienes ya trabajan con este motor, utilizaremos Smarty 5 para presentar una tarjeta con dos campos de texto. El objetivo es ilustrar la separación entre datos y presentación, no establecer una dependencia necesaria para WordPress. Consulta su instalación y uso para comprobar los requisitos de la versión que adoptes.
Preparar la dependencia y sus directorios
Trabaja primero en una copia del proyecto. Con Composer disponible y ejecutándose desde el directorio del componente, instala la rama de Smarty utilizada en el ejemplo:
composer require smarty/smarty:^5.0El resultado incluye vendor/autoload.php, composer.json y composer.lock. Conserva el archivo de bloqueo para reproducir las dependencias y prepara las actualizaciones como parte del despliegue. No descargues una versión antigua fija solo porque aparece en un tutorial anterior.
rjc-card/
├── composer.json
├── composer.lock
├── vendor/
├── render-card.php
└── templates/
└── card.tplPrepara aparte un directorio privado para los archivos compilados, fuera de la raíz pública y con escritura únicamente para las cuentas que lo necesiten. Su ruta debe proceder de la configuración del proyecto, no de un parámetro enviado por el visitante. No utilices permisos 777 para resolver un error.
Compilar una plantilla y cachear su resultado son cosas distintas. La compilación evita volver a traducir la plantilla; la caché de salida reutiliza HTML generado y exige considerar usuarios, permisos y datos variables. En este ejemplo la caché de salida está desactivada.
Renderizar una tarjeta con texto escapado
Guarda esta función en render-card.php, junto al directorio vendor. Recibe title y text como cadenas y devuelve el HTML, en lugar de imprimirlo directamente:
<?php
require_once __DIR__ . '/vendor/autoload.php';
function rjc_render_card(array $view, string $compile_dir): string
{
foreach (['title', 'text'] as $field) {
if (!isset($view[$field]) || !is_string($view[$field])) {
throw new InvalidArgumentException('La vista requiere title y text como cadenas.');
}
}
if (!is_dir($compile_dir) || !is_writable($compile_dir)) {
throw new RuntimeException('El directorio de compilación no está preparado.');
}
$smarty = new \Smarty\Smarty();
$smarty->setTemplateDir(__DIR__ . '/templates');
$smarty->setCompileDir($compile_dir);
$smarty->setCaching(\Smarty\Smarty::CACHING_OFF);
$smarty->assign('card', [
'title' => $view['title'],
'text' => $view['text'],
]);
return $smarty->fetch('card.tpl');
}
La plantilla se elige mediante un nombre fijo y recibe únicamente los dos campos previstos. Crea templates/card.tpl con este contenido:
<article class="rjc-card">
<h2>{$card.title|escape:'html':'UTF-8'}</h2>
<p>{$card.text|escape:'html':'UTF-8'}</p>
</article>
El modificador escape trata ambos valores como texto dentro de HTML. Una etiqueta incluida en el título no se ejecuta como marcado. No vuelvas a escapar previamente esos mismos valores como HTML si quieres evitar dobles codificaciones.
Esto no autoriza cualquier uso de los datos: una URL requiere validar sus protocolos y atributos; JavaScript y CSS tienen reglas diferentes. Consulta el escape según el contexto. Si la vista necesita HTML enriquecido, define qué marcado admite y cómo se filtra; no desactives el escape de todas las variables para conservar unas etiquetas.
Invocarlo desde una plantilla del proyecto
Si colocas el componente en includes/rjc-card dentro de tu tema activo o hijo, puedes invocarlo desde una plantilla PHP clásica, dentro del bucle de WordPress y donde quieras mostrar la tarjeta:
require_once get_stylesheet_directory() . '/includes/rjc-card/render-card.php';
echo rjc_render_card(
[
'title' => wp_strip_all_tags(get_the_title()),
'text' => wp_strip_all_tags(get_the_excerpt()),
],
'/ruta/privada/smarty-compile'
);Sustituye la ruta de compilación por el directorio preparado para tu entorno. El título y el extracto se pasan como texto; el escape final lo realiza la plantilla. Este fragmento no registra un plugin ni debe pegarse automáticamente en functions.php: necesita el contexto y las dependencias descritos.
La página debe conservar el encabezado, el pie y los puntos de integración del tema. wp_head() y wp_footer() ejecutan hooks; no generan por sí solos toda la cabecera y el pie del documento. Mantén también el contenido, los comentarios y la paginación mediante los mecanismos adecuados si amplías el ejemplo a una página completa.
Si reutilizas el renderizador desde un shortcode, devuelve su resultado en el callback en lugar de emitirlo fuera de posición. Si lo integras como bloque o en una API, respeta el contrato de esa interfaz. No confundas devolver una cadena con imprimirla en cualquier fase de WordPress.
Comprobar el componente y la integración
- Prueba textos normales, vacíos, caracteres internacionales y etiquetas introducidas como datos.
- Comprueba el comportamiento ante campos ausentes o con tipos inesperados.
- Verifica rutas, permisos y despliegue de dependencias con el usuario real del servicio.
- Si habilitas caché de salida, evita compartir resultados privados entre usuarios o contextos.
- Revisa la página completa, sus recursos, navegación y funciones del tema después de integrar la vista.
Las comprobaciones del ejemplo cubren el renderizado de la tarjeta, los tipos de entrada y el escape del texto. Adapta las rutas, la estructura de datos y la integración a tu proyecto, y prueba el resultado completo: un componente correcto no convierte su integración en una receta universal.
¿Tienes alguna pregunta?