PS PrestaShop Principiante

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.

Actualizado Versión del módulo 2.0.0

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

  1. Descargue el ZIP desde su cuenta de cliente DataFirefly.
  2. En el back office, vaya a Módulos > Gestor de módulos > Subir un módulo y envíe el ZIP.
  3. 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.
  4. Si el módulo nativo Google sitemap (gsitemap) está activo, desactívelo y elimine sus archivos *_sitemap.xml de la raíz: el panel lo indica mientras siga activo.
  5. 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.

Panel del sitemap: índice publicado, número de URL, imágenes, vídeos y archivos, última y próxima generación
Panel del sitemap: índice publicado, número de URL, imágenes, vídeos y archivos, última y 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.

Contenido incluido por tipo y comprobaciones de estado: carpetas, URL amigables, módulo gsitemap, robots.txt y tarea programada
Contenido incluido por tipo y comprobaciones de estado: carpetas, URL amigables, módulo gsitemap, robots.txt y 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.

Control de calidad: archivos validados y 20 URL probadas como un visitante (estado HTTP, noindex, URL canónica)
Control de calidad: archivos validados y 20 URL probadas como un visitante (estado HTTP, noindex, URL canónica)

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.

Archivos publicados: URL por archivo, tamaño y fecha real del último cambio de contenido
Archivos publicados: URL por archivo, tamaño y fecha real del último cambio de contenido

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.

Visor integrado: URL, imágenes, vídeos, idiomas hreflang y fecha de modificación de un archivo de sitemap
Visor integrado: URL, imágenes, vídeos, idiomas hreflang y fecha de modificación de un archivo de sitemap

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.
Ajustes de contenido: tipos de páginas, páginas estáticas, visibilidad de productos y exclusión del contenido reservado
Ajustes de contenido: tipos de páginas, páginas estáticas, visibilidad de productos y exclusión del contenido reservado

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.
Idiomas y hreflang: códigos idioma-región, anotaciones recíprocas e idioma x-default
Idiomas y hreflang: códigos idioma-región, anotaciones recíprocas e idioma x-default

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.
Etiquetas y archivos: lastmod real, visualización XSLT, compresión gzip y división de archivos
Etiquetas y archivos: lastmod real, visualización XSLT, compresión gzip y división de archivos

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.

Reglas de exclusión: por texto de URL, por ID, productos sin imagen, por tienda
Reglas de exclusión: por texto de URL, por ID, productos sin imagen, por tienda
  • 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.
Creación de una regla de exclusión: URL que contiene un texto, un valor por línea, todas las tiendas
Creación de una regla de exclusión: URL que contiene un texto, un valor por línea, todas las tiendas

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.

Vídeos de producto añadidos al sitemap de vídeos, con miniatura, título y duración
Vídeos de producto añadidos al sitemap de vídeos, con miniatura, título y duración
Ficha de un vídeo: producto, título y descripción por idioma, miniatura, URL del reproductor y duración
Ficha de un vídeo: producto, título y descripción por idioma, miniatura, URL del reproductor y duración

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.

Automatización: URL cron protegida por token, comando CLI, buscadores e IndexNow
Automatización: URL cron protegida por token, comando CLI, buscadores e IndexNow

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.

robots.txt: vista previa del bloque dfsitemap, añadido o quitado solo a petición
robots.txt: vista previa del bloque dfsitemap, añadido o quitado solo a petición

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.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte