Schema Pro

Descripción general

Schema Pro es un módulo para PrestaShop diseñado para generar automáticamente datos estructurados Schema.org en JSON-LD limpios, completos y compatibles con Google. Mientras que el marcado nativo de PrestaShop suele ser limitado (y a veces produce JSON frágil), Schema Pro construye el JSON-LD del lado PHP con json_encode() para evitar errores de formato y garantizar coherencia en todas las páginas. El objetivo es simple: ayudar a los motores de búsqueda a entender tus contenidos y aumentar tus probabilidades de mostrar resultados enriquecidos (precio, disponibilidad, valoraciones, breadcrumbs, FAQ, etc.), mejorando visibilidad y CTR.

Puntos fuertes:

• JSON-LD completo y conforme (e-commerce + páginas de contenido)
• Soporte ProductGroup + variantes (especificación Google 2024)
• Políticas de envío y devoluciones (OfferShippingDetails, MerchantReturnPolicy)
• Auditoría integrada (puntuación, errores, avisos, exportación)
• Caché inteligente con invalidación automática

Por qué este módulo

Los datos estructurados son una palanca SEO real para tiendas PrestaShop: ayudan a Google a interpretar tus páginas de producto, categorías, identidad de marca (Organization/LocalBusiness) y elementos de navegación (BreadcrumbList). En la práctica, muchas tiendas tienen marcado incompleto, duplicado (varios módulos) o incoherente (variantes mal declaradas, ausencia de identificadores de producto, falta de información de envío/devolución). Schema Pro centraliza todo en un único marcado configurable y legible por Google, mejorando la calidad y reduciendo errores en validadores.

Funcionalidades

Datos estructurados de producto (Product)

Schema Pro genera un esquema Product enriquecido en tus fichas de producto: nombre, descripción, imágenes (todas las imágenes, no solo la portada), SKU/referencia, marca (fabricante), identificadores (EAN/GTIN, MPN, ISBN/UPC si están disponibles), categoría, URL, condición y Offers (precio, divisa, disponibilidad, vendedor, validez del precio). El objetivo es dar a Google una señal clara y completa de la oferta. El módulo también puede integrar valoraciones y reseñas (AggregateRating y Reviews) a través de una fuente compatible, reforzando la confianza cuando hay suficientes datos.

Productos con combinaciones (ProductGroup + variantes)

Para productos con tallas, colores u otros atributos, Schema Pro puede generar un ProductGroup conforme a las recomendaciones de Google (2024). Las variantes se declaran mediante hasVariant, cada una con sus propios datos (SKU, EAN, precio, stock, imagen, URL de la variante). El módulo detecta automáticamente los ejes de variación con variesBy (p. ej., color, talla) y permite limitar el número de variantes incluidas para mantener un JSON-LD eficiente y razonable. Es especialmente útil en moda, accesorios, mobiliario y catálogos con muchas combinaciones.

Marca y tienda (Organization / LocalBusiness)

Schema Pro genera un esquema Organization (o LocalBusiness, Store, OnlineStore, etc.) en todo el sitio: nombre comercial, razón social, descripción, email, teléfono, IVA, logo, dirección y perfiles sociales (sameAs). Para negocios con ubicación física, los campos LocalBusiness (horarios, coordenadas geo, rango de precios) refuerzan la coherencia entre tu tienda, presencia local y resultados de Google. Una configuración correcta también mejora la comprensión de tu entidad (Knowledge Graph) y la confianza del usuario.

WebSite + SearchAction, BreadcrumbList, FAQPage, CollectionPage

El módulo puede añadir:

• WebSite + SearchAction (sitelinks search box) para mejorar la integración con Google.
• BreadcrumbList dinámico (producto, categoría, CMS, fabricante) para breadcrumbs coherentes en las SERP.
• FAQPage mediante un gestor de FAQ en back-office, asociable a productos, categorías, páginas CMS o URLs personalizadas.
• CollectionPage + ItemList en categorías, listando productos de la página actual (respetando paginación) para ayudar a indexar listados sin sobrecargar el marcado.

Envío y devoluciones (OfferShippingDetails, MerchantReturnPolicy)

Schema Pro permite definir una política de envío y una política de devoluciones y referenciarlas en cada Offer mediante @id (evita duplicaciones masivas dentro del JSON-LD). Puedes configurar países de destino, costes, tiempos de preparación y tránsito, así como ventana de devolución, costes, método y URL de la política. Esto mejora la transparencia y puede ayudar a la elegibilidad para resultados enriquecidos y superficies Shopping, según criterios de Google.

Auditoría integrada y rendimiento (caché)

La pestaña Auditoría escanea tu catálogo (productos, categorías, organización) y muestra datos faltantes (imágenes, precio, EAN/GTIN, marca, SKU, descripciones, etc.) con una puntuación y una clasificación (error, aviso, info). En rendimiento, Schema Pro incluye caché de JSON-LD con invalidación automática cuando cambian elementos relevantes (producto, categoría, CMS, reseñas, configuración), manteniendo el sitio rápido incluso con catálogos grandes.

Requisitos

Schema Pro está pensado para versiones modernas de PrestaShop y un stack de servidor actualizado para garantizar compatibilidad y rendimiento.

• PrestaShop: mínimo 8.0.0 (compatible con 8.x y 9.x)
• PHP: mínimo 8.1 (compatible 8.1–8.4 según configuración)
• MySQL 5.7+ o MariaDB 10.3+
• HTTPS recomendado (buenas prácticas SEO y seguridad)

No se requiere CRON: el JSON-LD se genera al vuelo y la caché (si se activa) mejora los tiempos de respuesta en producción.

Instalación

Instalación desde el back-office (recomendada)

1. Ve a Módulos > Gestor de módulos
2. Haz clic en Subir un módulo
3. Selecciona el ZIP del módulo (p. ej., wepresta_schema_pro.zip)
4. Espera a que termine la instalación
5. Haz clic en Configurar

Instalación por FTP

1. Descomprime el archivo
2. Sube la carpeta del módulo a /modules/
3. En el back-office, busca el módulo
4. Haz clic en Instalar, luego Configurar

Qué hace la instalación

El módulo crea sus tablas (FAQ, mapeo de atributos, caché), registra sus hooks (inyección en front, invalidación de caché), añade su entrada de menú en back-office y puede desactivar el marcado nativo de PrestaShop para evitar duplicados. Tras instalar, se recomienda configurar la Organización y activar los tipos de schema necesarios antes de lanzar una auditoría.

Inicio rápido

Para obtener un marcado limpio en menos de 10 minutos:

1. Instala el módulo y abre Configurar
2. En General, activa al menos: Product, Organization, WebSite, BreadcrumbList
3. Activa la desactivación del marcado nativo si no usas otro generador JSON-LD
4. En Organization, rellena: nombre, logo, email, teléfono, dirección, perfiles sociales
5. En Products, activa ProductGroup si tienes variantes y revisa el mapeo (Color → color, Talla → size)
6. (Opcional) Añade políticas de envío y devoluciones para enriquecer las Offers
7. Ejecuta una Auditoría y corrige datos faltantes (imágenes, EAN, marca, descripciones)
8. Prueba una página de producto con Google Rich Results Test y verifica que no existan duplicados

Configuración

Pestaña General

Centraliza ajustes globales: activación de tipos de schema, desactivación del marcado nativo de PrestaShop (para evitar duplicación) y activación de caché. Durante la puesta en marcha, suele ser mejor dejar la caché desactivada para ver cambios al instante. Una vez estable, activa la caché en producción para reducir el coste de generación.

Pestaña Organization

Elige el tipo de entidad (Organization, OnlineStore, LocalBusiness, Store, etc.) y rellena la información esencial: nombre, razón social, descripción, logo, IVA, dirección completa y URLs de redes sociales. Para LocalBusiness, añade si es posible horarios, coordenadas geo y rango de precios. Los campos vacíos no se incluyen en JSON-LD (mejor omitir que publicar valores vacíos).

Pestaña Products

Activa ProductGroup si tu catálogo incluye variantes, define un límite si es necesario y configura la condición por defecto. Verifica la fuente de reseñas y establece un umbral mínimo para evitar un AggregateRating débil (práctica habitual). Luego configura el mapeo de atributos de PrestaShop a propiedades Schema.org (color, talla, material, patrón, género) para alimentar variesBy y enriquecer variantes.

Pestaña FAQ

Crea pares Pregunta/Respuesta en back-office y asígnalos a productos, categorías, páginas CMS o URLs personalizadas. Las FAQ son multilenguaje y ordenables. El schema FAQPage solo se genera cuando existen FAQ activas para la página actual, evitando marcado innecesario. Las preguntas deben ser naturales y útiles: Google suele ignorar FAQ artificiales.

Pestaña Auditoría

La auditoría identifica errores bloqueantes (p. ej., producto sin imagen, precio a cero), avisos (EAN/GTIN faltante, sin marca, descripciones pobres) e información (sin reseñas, ProductGroup desactivado, etc.). Úsala para priorizar correcciones, exporta el informe si hace falta y vuelve a escanear para medir mejoras en la puntuación.

Multitienda y multilenguaje

Schema Pro soporta multitienda: cada tienda puede tener su propia configuración (tipos activos, organización, políticas de envío/devolución, FAQ, caché). En modo multitienda, selecciona primero la tienda en el selector de contexto de PrestaShop antes de editar ajustes. El multilenguaje es nativo: el JSON-LD se genera en el idioma del visitante (productos, categorías, FAQ, organización), evitando señales incoherentes (p. ej., FAQ en francés en una página en inglés).

Compatibilidad

Versiones de PrestaShop

• PrestaShop 8.0.x: compatible
• PrestaShop 8.1.x: compatible
• PrestaShop 8.2.x: compatible
• PrestaShop 9.0.x: compatible

Versiones de PHP

• PHP 8.1: compatible
• PHP 8.2: compatible
• PHP 8.3: compatible
• PHP 8.4: compatible

Bases de datos

• MySQL 5.7+
• MySQL 8.0
• MariaDB 10.3+

FAQ

¿El módulo ralentiza la tienda?

No. El JSON-LD se inyecta en el <head> y es ligero. Con la caché activada, el impacto típico ronda 1–2 ms por página. Sin caché, depende de la complejidad del producto (variantes, reseñas), pero suele ser despreciable. La invalidación automática evita datos obsoletos manteniendo el front rápido.

¿Puedo usarlo con otro módulo SEO?

Sí, pero hay que evitar duplicados. Si otro módulo también genera JSON-LD de Product/Organization/Breadcrumb/FAQ, Google puede ignorarlo o degradar la interpretación. La buena práctica es desactivar la parte de “datos estructurados” en el otro módulo, o activar la desactivación del marcado nativo y asegurarse de que solo quede un generador JSON-LD activo.

¿Los datos estructurados garantizan rich snippets?

No. Aumentan mucho las probabilidades, pero Google decide. Una tienda con marcado válido, completo, sin duplicación y datos de producto sólidos (imágenes, precio, stock, identificadores, reseñas reales) maximiza la elegibilidad y suele mejorar el CTR incluso sin resultados enriquecidos garantizados.

Solución de problemas

No se ve ningún JSON-LD

• Verifica que el módulo está instalado y activo
• Activa al menos un tipo de schema en General
• Comprueba que el hook de inyección en front esté activo (p. ej., displayHeader)
• Vacía la caché de PrestaShop (Smarty) y, si hace falta, la caché del módulo

Marcado duplicado

• Activa la desactivación del marcado nativo si es necesario
• Desactiva otros generadores JSON-LD
• Revisa el código fuente y vuelve a probar con Google Rich Results Test

Errores en validadores de Google

• Añade al menos una imagen por producto
• Verifica precio/divisa/disponibilidad
• Usa la auditoría para corregir EAN/GTIN, marca, SKU, descripciones
• Revisa configuración de envío/devoluciones si está activada

Changelog

Versión 1.0.0

• Generación JSON-LD completa: Product, ProductGroup, Organization/LocalBusiness, WebSite, BreadcrumbList, FAQPage, CollectionPage
• Soporte ProductGroup + variantes (hasVariant, variesBy, productGroupID)
• Políticas de envío (OfferShippingDetails) y devoluciones (MerchantReturnPolicy) referenciadas por @id
• Mapeo de atributos PrestaShop a propiedades Schema.org
• Auditoría integrada con puntuación y exportación CSV
• Caché inteligente con invalidación automática
• Back-office moderno (controladores Symfony), soporte multitienda y multilenguaje

Soporte

El soporte está disponible a través de tu área de cliente / canal de soporte de WePresta. Para acelerar el diagnóstico, envía:

• Versiones de PrestaShop y PHP
• URL afectada + resultado de Rich Results Test
• Código fuente de la página (buscar application/ld+json)
• Informe de auditoría exportado (CSV)
• Logs de PrestaShop si están disponibles

Licencia

Distribuido bajo Academic Free License (AFL 3.0).
Copyright © WePresta (ADAMAS GROUP SA). Todos los derechos reservados.