Generador de FAQ Schema.org — Documentación

Presentación

DfFaqSchema añade bloques de preguntas y respuestas editables a las fichas de producto, las páginas de categoría y los layouts de Shopping Experiences en Shopware 6. Cada bloque se muestra como un acordeón Bootstrap acompañado de marcado Schema.org FAQPage en JSON-LD, inyectado automáticamente en la página. El plugin es compatible con Shopware 6.5, 6.6 y 6.7 y no requiere ninguna modificación de tu tema.

Instalación

Desde la administración

1. Abre Extensiones, luego Mis extensiones, y sube el archivo ZIP del plugin.
2. Haz clic en Instalar y activa el plugin.

Desde la consola

bin/console plugin:refresh
bin/console plugin:install --activate DfFaqSchema
bin/console cache:clear

Compilación de la administración

El módulo de administración y el elemento CMS requieren una compilación única de los assets:

./bin/build-administration.sh

Configuración

Abre Extensiones, Mis extensiones, y luego la configuración de DfFaqSchema. Hay dos opciones disponibles, globales o por canal de venta:

• Mostrar las FAQ en las fichas de producto: activa el acordeón y el JSON-LD en las páginas de producto (activado por defecto).
• Mostrar las FAQ en las páginas de categoría: activa el acordeón y el JSON-LD en las páginas de navegación (activado por defecto).

Crear entradas de FAQ

Abre Contenidos y luego FAQ Schema.org. El listado muestra todas las entradas con su pregunta, asignación, posición y estado.

Campos de una entrada

• Pregunta: el texto de la pregunta (campo traducido).
• Respuesta: la respuesta en texto enriquecido mediante el editor integrado (campo traducido).
• Posición: el orden de visualización en el acordeón, ascendente.
• Activo: solo las entradas activas se muestran y se marcan.
• Asignación: producto, categoría o página CMS. El selector de tipo muestra el campo de búsqueda correspondiente.

Traducir una entrada

Usa el selector de idioma en la parte superior de la página de detalle para cambiar de idioma, e introduce la pregunta y la respuesta traducidas. Cada idioma del storefront muestra su propio contenido y el JSON-LD lo sigue automáticamente.

Visualización en producto y categoría

Las entradas asignadas a un producto se muestran bajo el contenido principal de la ficha de producto. Las entradas asignadas a una categoría se muestran bajo el listado de la página de navegación. En ambos casos, el JSON-LD FAQPage correspondiente se inyecta en el head del documento. La primera pregunta del acordeón está abierta por defecto.

Elemento CMS para las Shopping Experiences

1. Crea tus entradas en el módulo sin asignarlas a un producto o categoría (asignación página CMS).
2. Abre Contenidos, luego Experiencias de compra, y edita un layout.
3. Añade un bloque de texto y sustituye su elemento por el elemento FAQ (Schema.org).
4. En la configuración del elemento, selecciona las entradas a mostrar.

El acordeón y su JSON-LD se renderizan exactamente donde colocas el elemento. Puedes usar varios elementos FAQ en un mismo layout.

Marcado JSON-LD y validación

El plugin genera un objeto FAQPage con una entidad Question por cada entrada mostrada, con la respuesta en HTML en el campo text de la entidad Answer, lo cual Google acepta. El marcado solo cubre el contenido realmente visible en la página, conforme a las directrices de rich results.

Para validar una página, usa la prueba de resultados enriquecidos de Google: pega la URL de tu ficha de producto y comprueba que el elemento FAQ se detecta sin errores.

Resolución de problemas

• El menú FAQ Schema.org no aparece: ejecuta la compilación de la administración y vacía la caché del navegador.
• El acordeón no se muestra en una ficha de producto: comprueba que la entrada está activa, asignada a ese producto y que la opción de visualización en producto está activada para el canal de venta correspondiente.
• Falta el JSON-LD: el marcado solo se genera cuando al menos una entrada activa se muestra en la página. Busca application/ld+json en el código fuente de la página.
• El elemento CMS no muestra nada: comprueba que hay entradas seleccionadas en la configuración del elemento y que están activas.

Desinstalación

La desinstalación elimina las tablas del plugin y su configuración. Marca la opción de conservar los datos durante la desinstalación para preservar tus preguntas y respuestas de cara a una reinstalación.