Post actualizado el día octubre 29, 2026 by DeiviSanzPlay
Si trabajas con XAMPP desarrollo tema WordPress en local, tarde o temprano chocas con el mismo muro: el tema funciona en producción pero en tu máquina se ve roto, los enlaces apuntan a localhost o el editor te lanza un error de permisos. No es un fallo de tu código. Casi siempre es el entorno.
XAMPP no es un servidor de producción recortado. Es una pila Apache + MySQL + PHP pensada para pruebas, con valores por defecto que no coinciden con un hosting real. Ahí está la raíz de la mayoría de los problemas al desarrollar un tema de WordPress en local.
El problema de las rutas absolutas en tu entorno local
Cuando instalas WordPress en XAMPP, la URL del sitio queda como http://localhost/tu-tema o http://localhost:8080. Si luego exportas la base de datos o cambias el puerto, todos los enlaces internos apuntan a una dirección que ya no existe. El resultado: el tema carga, pero el CSS y las imágenes no.
La solución exacta no es reinstalar. Es revisar las tablas wp_options y buscar siteurl y home. Cámbialos a mano o usa WP-CLI con wp search-replace. En un proyecto mío, un tema con más de 40 llamadas a get_template_directory_uri() dejó de romperse solo cuando ajusté esas dos filas.
Permisos y el usuario root de MySQL
XAMPP arranca MySQL con el usuario root sin contraseña. Eso acelera la instalación, pero tu tema puede fallar al escribir archivos si usas funciones como WP_Filesystem o si pruebas actualizaciones desde el panel. WordPress en local espera permisos de escritura que en Windows no siempre existen.
Un caso típico: el tema intenta crear un archivo de caché en wp-content/uploads y devuelve un error silencioso. No es un bug del tema, es que la carpeta no tiene permisos. En Linux o macOS basta con chmod, en Windows revisa las propiedades de la carpeta. No hay atajo universal.
PHP local no es PHP del hosting
XAMPP trae una versión de PHP que puede ir por delante o por detrás de la que usa tu cliente. Si desarrollas un tema con funciones nuevas de PHP 8.2 y el hosting corre PHP 7.4, el tema se rompe al subirlo. Esto no funciona para validar compatibilidad real.
La solución práctica: cambia la versión de PHP desde el panel de XAMPP o usa un archivo .htaccess con directivas específicas. Y antes de dar un tema por terminado, prueba en un entorno con la misma versión de PHP que el servidor final. La documentación oficial de WordPress y los foros de XAMPP lo confirman: el entorno local es una aproximación, no una réplica exacta.
El error del editor de bloques y las rutas de assets
Otro problema frecuente: el editor de bloques carga el CSS del tema pero no los estilos del editor. Ocurre porque el tema registra add_editor_style() con una ruta relativa que XAMPP interpreta distinto. El editor muestra el contenido sin formato y parece que el tema está mal hecho.
Revisa que la ruta coincida con la ubicación real del archivo dentro del tema. En XAMPP, la ruta base puede incluir subcarpetas que no existen en producción. Un ejemplo concreto: un tema con add_editor_style(‘assets/css/editor.css’) funcionaba en el hosting pero en local buscaba localhost/tema/assets/css/editor.css y devolvía 404. Ajustar la ruta con get_template_directory_uri() lo resolvió.
Cuándo XAMPP no es la herramienta adecuada
XAMPP desarrollo tema WordPress sirve para pruebas rápidas, pero no para proyectos con dependencias de servidor como Redis, cron real o correos salientes. Si tu tema envía emails con wp_mail(), en XAMPP no saldrán. Si depende de tareas programadas, el cron de WordPress se dispara con visitas, no con el reloj del sistema.
Para esos casos, considera entornos como LocalWP o Docker con una imagen de WordPress. No es una verdad absoluta: para un tema simple con pocas dependencias, XAMPP sigue siendo rápido y suficiente. La clave está en saber qué estás probando y qué no.
Checklist antes de dar el tema por bueno
Antes de mover el tema a producción, verifica que las rutas no apunten a localhost, que la versión de PHP coincida, que los permisos de escritura funcionen y que el editor cargue los estilos. Si algo falla en local, no siempre fallará en el servidor, pero si falla en el servidor, casi siempre es por algo que no probaste en local.
Desarrollar un tema de WordPress en XAMPP es cómodo, pero exige disciplina. No prometas resultados garantizados a tu cliente basándote solo en cómo se ve en tu máquina. Prueba en un entorno lo más parecido posible al hosting final. Ahí está la diferencia entre un tema que funciona y uno que se rompe al primer clic.
Perfiles verificables: Sitio web
Publicado el 29 de October de 2026. Última revisión: 29 de October de 2026.
