Documentación del módulo Sitemap XML avanzado para PrestaShop (dfsitemap)
Instalar y configurar dfsitemap 2.0.0: panel, control de calidad, contenido, hreflang, imágenes y vídeos, reglas de exclusión, cron, robots.txt, IndexNow y multitienda.
El módulo Sitemap XML avanzado (dfsitemap) genera los sitemaps XML de PrestaShop 1.7.8, 8 y 9: un índice por tienda, un archivo por idioma y por tipo de contenido, con imágenes, vídeos y etiquetas hreflang recíprocas. La versión 2.0.0 añade un nuevo back office, un control de calidad, un visor integrado y la compresión gzip. Esta página cubre la instalación, los ajustes, las reglas de exclusión, la programación y la resolución de problemas.
Instalación
- Descargue el ZIP desde su cuenta de cliente DataFirefly.
- En el back office, vaya a Módulos > Gestor de módulos > Subir un módulo y envíe el ZIP.
- Abra Parámetros de la tienda > Tráfico y SEO > Sitemap XML avanzado. La barra del módulo da acceso al panel, los ajustes, la automatización, las reglas de exclusión y los vídeos de producto.
- Si el módulo nativo Google sitemap (gsitemap) está activo, desactívelo y elimine sus archivos
*_sitemap.xmlde la raíz: el panel lo indica mientras siga activo. - Pulse Generar ahora y envíe la URL del índice en Google Search Console y Bing Webmaster Tools.
El mismo ZIP funciona de PrestaShop 1.7.8 a 9.x, en multitienda y multiidioma. El módulo escribe sus archivos dfsitemap-*.xml en la raíz de la tienda y sus archivos temporales en modules/dfsitemap/var/tmp/.
Actualización desde la 1.1.0
Envíe el ZIP 2.0.0 como en una instalación: PrestaShop ejecuta la actualización. Se conservan los ajustes, las reglas, los vídeos, la cola IndexNow y los sitemaps publicados. Si la 1.1.0 había escrito su bloque en robots.txt, la opción que lo mantiene al día sigue activa; si no, queda desactivada.
Panel
Para cada tienda del contexto, el panel muestra el estado de los sitemaps (en línea, regeneración con retraso, última generación con error, nunca generado), la URL del índice con los botones Copiar, Explorar y XML sin formato, el número de URL, imágenes, vídeos y archivos, y las fechas de la última y la próxima generación.

Más abajo, el contenido incluido por tipo y la tarjeta Estado comprueban las carpetas con permiso de escritura, las URL amigables, la presencia de gsitemap o de un sitemap.xml físico, el modo mantenimiento, la declaración en robots.txt y la última llamada de la tarea programada.

Control de calidad
El botón Ejecutar el control lee en flujo cada archivo publicado: elemento raíz, espacios de nombres, límites de 50.000 URL y 50 MB, URL absolutas, codificadas y en el dominio de la tienda. Después abre 20 URL al azar como un visitante no identificado: estado HTTP sin seguir redirecciones, cabecera X-Robots-Tag, meta robots y URL canónica. Las peticiones solo van a los dominios de la tienda.

Una URL «por revisar» suele venir de una redirección añadida por otro módulo o de una página reservada a un grupo de clientes. Exclúyala con una regla si no debe indexarse.
Los archivos
Para cada tienda, el módulo publica un índice dfsitemap-{id tienda}-index.xml que apunta a archivos nombrados por idioma y tipo, por ejemplo dfsitemap-1-es-product-1.xml. Cuando un archivo alcanza el número de URL fijado, o antes de 45 MB, el resto pasa a -2, -3, etc. Con la compresión gzip, los archivos se publican en .xml.gz y el índice queda sin comprimir.
La fecha lastmod de cada archivo en el índice es la del último cambio de su contenido: un archivo idéntico a la generación anterior conserva su fecha.

El botón Explorar abre un visor en el back office: URL, número de imágenes y vídeos, idiomas hreflang y fecha de modificación, 100 por página, con un filtro. Sustituye la visualización XSLT que Chrome está retirando.

Con las URL amigables activadas, el índice también se sirve en /sitemap.xml en el dominio de cada tienda. Los archivos se crean en una carpeta temporal y se publican tienda por tienda: los sitemaps anteriores siguen en línea durante la generación.
Ajustes
Los ajustes siguen el contexto multitienda: en el contexto de una tienda, los valores guardados solo se aplican a esa tienda. Un indicador señala los cambios sin guardar.
Contenido
- Tipos de contenido: páginas estáticas, productos, categorías, páginas CMS, categorías CMS, marcas, proveedores, URL personalizadas. Solo se incluye el contenido activo.
- Páginas estáticas: inicio, más vendidos, novedades, ofertas, listas de marcas y proveedores, tiendas, contacto, mapa del sitio. Se omite una página desactivada en las preferencias de la tienda (marcas, proveedores, más vendidos).
- Productos visibles solo en la búsqueda: por defecto solo se incluyen los productos con visibilidad En todas partes o Solo catálogo.
- Excluir el contenido reservado a grupos de clientes (activado por defecto): no se incluyen los productos y categorías que un visitante no identificado no puede abrir y que responderían 403.

Una página CMS con la opción Indexación por los motores de búsqueda desactivada se sirve con noindex. El módulo no la incluye y muestra cuántas páginas están afectadas.
Idiomas y hreflang
- Idiomas: deje todo marcado para seguir los idiomas activos de cada tienda. Se muestra el código hreflang de cada idioma.
- Alternativas hreflang: cada URL enumera todas sus traducciones, incluida ella misma, para que las anotaciones sean recíprocas.
- Código hreflang: idioma y región (
es-ES, tomado del código de idioma de Internacional > Idiomas) o solo idioma (es). Dos idiomas que compartirían un código conservan su región. - Idioma x-default: idioma por defecto de la tienda, un idioma concreto o ninguno.

Imágenes y vídeos
- Sitemap de imágenes y todas las imágenes del producto (si no, solo la portada), en el tamaño de imagen elegido.
- Imágenes de categorías, marcas y proveedores.
- Sitemap de vídeos y detección de YouTube y Vimeo en las descripciones de producto y las páginas CMS. Para Vimeo, el título y la miniatura se leen una vez del servicio público oEmbed de Vimeo y se guardan en caché.
Etiquetas y archivos
- lastmod: fecha real de la última actualización de productos, categorías, categorías CMS, marcas y proveedores. Las páginas sin fecha fiable no tienen lastmod.
- changefreq y priority: desactivadas por defecto, Google las ignora.
- Visualización legible en el navegador (XSLT): hoja de estilos en el idioma de cada archivo. Desactivada por defecto en las nuevas instalaciones porque Chrome está retirando XSLT; use el visor del back office.
- Comprimir los sitemaps (gzip) y URL por archivo: 10.000 por defecto, entre 100 y 50.000, con división antes de 45 MB.

URL adicionales
- URL personalizadas: una por línea; una ruta relativa como
/blog/se añade a la URL de la tienda. Solo se conservan las URL del dominio de la tienda, como exige el protocolo. - Sitemaps adicionales: URL absolutas de sitemaps generados en otro lugar, añadidas al índice. Un sitemap de otro dominio solo se lee si ambos sitios están verificados en la misma cuenta de Search Console.
Generación
- Frecuencia: de cada hora a una vez por semana, usada por el cron.
- Elementos por lote (50 por defecto) y tiempo máximo por petición (20 segundos, limitado a 15 segundos desde el back office).
- Regenerar cuando cambia el contenido: tras guardar un producto, una categoría, una página CMS, una marca o un proveedor, la siguiente llamada cron regenera sin esperar a la frecuencia, como mucho una vez por hora.
Reglas de exclusión
El contenido inactivo, los productos ocultos del catálogo y las páginas reservadas a algunos grupos de clientes nunca se incluyen. Las reglas quitan contenido en línea que no debe indexarse. Cada regla se aplica a todas las tiendas o a una, a partir de la siguiente generación.

- Productos: por ID, en una categoría (subcategorías incluidas), de una marca, de un proveedor por defecto, sin stock, con precio cero, sin imagen.
- Categorías: por ID, o una categoría y todas sus subcategorías.
- Páginas CMS: por ID, o una categoría CMS con sus páginas. Marcas y proveedores: por ID.
- La URL contiene un texto y la URL coincide con una expresión regular: un valor por línea, sin distinguir mayúsculas. Una expresión no válida se rechaza al guardar.

Una URL excluida por una regla también desaparece de las alternativas hreflang de sus traducciones.
Vídeos de producto
La pestaña Vídeos de producto sirve para los vídeos alojados fuera de YouTube y Vimeo, o cuando quiere un título y una descripción concretos. Para cada vídeo: el producto (búsqueda por nombre, referencia o ID), el título y la descripción por idioma, la URL de la miniatura, la URL del archivo de vídeo o del reproductor, la duración en segundos y la tienda.


Lanzar la generación
Desde el back office
Generar ahora lanza la generación para las tiendas del contexto, con una barra de progreso. Si cierra la página, la tarea queda guardada: Reanudar en esta ventana la continúa, o lo hace el cron. Cancelar detiene la tarea y deja intactos los sitemaps en línea.
Con el cron
La pestaña Automatización muestra una URL del tipo https://su-tienda.es/module/dfsitemap/cron?token=..., protegida por un token secreto. Llámela cada 5 minutos desde el gestor cron de su alojamiento. Cada llamada trabaja durante el tiempo máximo y la siguiente continúa. Parámetros opcionales: force=1 e id_shop=1,2. La tarjeta muestra la última llamada recibida (HTTP o CLI); Generar un nuevo token invalida la URL anterior.

Por línea de comandos
php /ruta/a/prestashop/modules/dfsitemap/cron.php
php /ruta/a/prestashop/modules/dfsitemap/cron.php --force --shop=1
El script procesa toda la tarea de una vez. Rechaza las llamadas web y devuelve el código de salida 1 en caso de error.
Si una petición se corta en plena generación, la tarea continúa desde la última posición guardada y los archivos en curso se reparan. El bloqueo de la petición cortada caduca tras el tiempo máximo más 90 segundos.
robots.txt
El módulo nunca modifica robots.txt por su cuenta. La tarjeta robots.txt de la pestaña Automatización muestra las líneas que añadiría, entre # BEGIN dfsitemap y # END dfsitemap, y permite añadir, actualizar o quitar ese bloque. El resto del archivo se conserva tal cual y se guarda una copia de la versión anterior en modules/dfsitemap/var/. La opción Mantener las líneas Sitemap cuando PrestaShop regenera robots.txt (desactivada por defecto) reescribe el bloque cada vez que se genera el archivo desde Tráfico y SEO. La desinstalación solo quita este bloque.

Buscadores e IndexNow
Google (desde 2023) y Bing (desde 2022) ya no aceptan el ping anónimo de sitemaps: el módulo no envía ninguno. Declare el índice una vez en Google Search Console, en Bing Webmaster Tools o con una línea Sitemap: en robots.txt. Un sitemap ayuda a los buscadores a descubrir URL, no garantiza su indexación.
IndexNow, desactivado por defecto, notifica las páginas creadas o modificadas a Bing y a los demás buscadores del protocolo. Google no lo usa. Una vez activado, el módulo crea un archivo de clave en la raíz, pone en cola cada producto, categoría, página CMS, marca o proveedor guardado y envía sus URL en la siguiente llamada cron, solo para el contenido incluido en el sitemap. La tarjeta IndexNow muestra la cola, el archivo de clave y el último envío; ante una respuesta 429 o 5xx, la cola se conserva.
Multitienda
Cada tienda tiene su índice en su propio dominio, sus idiomas y sus ajustes. Seleccione una tienda en el menú multitienda para darle valores propios. En el contexto Todas las tiendas, el panel muestra una tarjeta por tienda.
Para desarrolladores: añadir URL
Un módulo puede añadir sus páginas enganchándose al hook actionDfSitemapUrls. El hook recibe id_shop, languages (id_lang => código ISO) y link, y devuelve una lista de entradas:
public function hookActionDfSitemapUrls($params)
{
$loc = [];
foreach ($params['languages'] as $idLang => $iso) {
$loc[$idLang] = $params['link']->getBaseLink($params['id_shop']) . $iso . '/blog/mi-articulo';
}
return [
['loc' => $loc, 'lastmod' => '2026-09-01 10:00:00', 'images' => ['https://.../imagen.jpg']],
];
}
Una entrada indexada por idioma recibe las etiquetas hreflang como una página nativa. Se ignoran las URL de otro dominio y las entradas no válidas.
Preguntas frecuentes
El control de calidad indica una redirección
Otro módulo redirige esa página (por ejemplo, a una página de configuración). Incluya la URL final o excluya esta con una regla La URL contiene un texto.
Falta un producto
Compruebe que está activo, con visibilidad En todas partes o Catálogo, y en al menos una categoría abierta a los visitantes no identificados. Revise también las reglas de exclusión.
El sitemap no contiene ninguna página CMS
Active la opción Indexación por los motores de búsqueda en las páginas que deben indexarse.
La generación se queda en «Otro proceso está trabajando en la tarea»
Otra petición tiene el bloqueo, a menudo el cron. Si se cortó, el bloqueo caduca tras el plazo indicado y la generación se reanuda sola.
IndexNow responde 403 o 422
El buscador no encuentra el archivo de clave o rechaza el host. Abra la URL del archivo de clave que aparece en la tarjeta IndexNow: debe mostrar la clave.