Gestor de FAQ: configuración y ayuda
Inicio rápido
- Sube el archivo ZIP de mprfaq en Módulos > Gestor de módulos e instala el módulo.
- Abre FAQ > Settings > Configuration. En Page Settings, configura FAQ Page Slug y traduce Page Title y Page Description.
- En General, elige el modo Question pages y revisa Show Search Bar. Guarda los ajustes.
- Abre FAQ > Categories y crea o modifica una categoría activa con el nombre y la URL amigable traducidos.
- Abre FAQ > Questions. Añade una pregunta y una respuesta traducidas, elige su categoría y activa la pregunta.
- Asígnala a un producto si necesitas la pestaña FAQ en la página del producto y guarda.
- Abre la página principal de FAQ y el producto asignado en la tienda. Comprueba la respuesta y la búsqueda, y envía una pregunta de prueba con Ask a Question.
Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.
Manual de configuración
Instalación y configuración
Sigue los pasos de Inicio rápido.
Configurar las pantallas de FAQ
Abre FAQ > Settings > Configuration. Guarda los ajustes después de editar cada sección. Los valores predeterminados que se indican a continuación corresponden a una instalación nueva. Concede a los empleados acceso a los controladores de FAQ que necesiten para editar o moderar.
General
- Enable legacy Schema.org FAQ markup. Controla si se puede generar JSON-LD FAQPage/QAPage cuando la política SEO de la página permite datos estructurados; valor predeterminado:
0. Configúralo en FAQ → Settings → Configuration → General. - Include in Sitemap. Añade las URL de FAQ que cumplen los requisitos al sitemap XML mediante
gSitemapAppendUrls; valor predeterminado:1. Configúralo en General. - Allow FAQ landing page indexing. Permite que la página principal de FAQ utilice
index,follow, hreflang, la inclusión en el sitemap y datos estructurados cuando estén permitidos; valor predeterminado:1. Configúralo en General. - Allow FAQ category page indexing. Interruptor global para las páginas de categoría; cada categoría también debe tener activado Index this category page; valor predeterminado:
0. Configúralo en General. - Allow FAQ tag page indexing. Permite que las páginas de etiquetas FAQ utilicen
index,followy hreflang; las páginas de etiquetas siguen excluidas del sitemap; valor predeterminado:0. Configúralo en General. - Allow individual question pages to be indexed. Interruptor global para las páginas de preguntas individuales; cada pregunta también debe tener activado Index this question page; valor predeterminado:
0. Configúralo en General. - Show Search Bar. Muestra la interfaz de búsqueda de FAQ en la tienda; valor predeterminado:
1. Configúralo en General. - Show Category Description. Muestra las descripciones de categoría en las tarjetas y páginas de categoría de FAQ; valor predeterminado:
1. Configúralo en General. - Show Question Count. Muestra el número total de preguntas en las tarjetas y encabezados de categoría; valor predeterminado:
1. Configúralo en General. - Compact Related Products. Utiliza tarjetas de producto compactas para los productos relacionados en las páginas de preguntas FAQ; valor predeterminado:
1. Configúralo en General. - Expand First Question. Abre automáticamente la primera pregunta en las páginas de categoría/etiqueta con acordeón; valor predeterminado:
0. Configúralo en General. - Allow Multiple Open Questions. Permite mantener abiertas varias respuestas del acordeón a la vez; valor predeterminado:
1. Configúralo en General.
Revisa también estos ajustes en General:
| Ajuste | Valor predeterminado | Cuándo cambiarlo |
|---|---|---|
| Question pages | Páginas individuales (pages) |
Elige Sections on product and category pages (sections) para mostrar las respuestas desplegadas con un índice de contenidos. Este ajuste afecta a todas las tiendas. |
| Questions on the Product Page | 0 | En el modo Individual pages, establece un límite para las listas FAQ de los productos. Cero significa todas. La pestaña enlaza a las páginas FAQ de las demás preguntas. |
En el modo sections, no se aplican los campos SEO de las preguntas individuales ni el límite de preguntas por producto. Los enlaces entrantes a preguntas llevan al primer producto asignado disponible por orden de ID, o a la categoría FAQ cuando no hay ningún producto disponible. Las páginas de preguntas individuales no son indexables en este modo.
Ajustes de la página
- FAQ Page Slug. Define la URL base de FAQ para el idioma predeterminado; valor predeterminado:
faq. Configúralo en Page Settings y vacía la caché después de cambiarlo. - Page Title. Define el encabezado visible de la página principal de FAQ; valor predeterminado:
Frequently Asked Questions. Configúralo por idioma en Page Settings. - Page Description. Define el texto introductorio visible de la página principal de FAQ; valor predeterminado:
Find answers to frequently asked questions about our products and services.Configúralo por idioma en Page Settings. - Meta Title (SEO). Sustituye el metatítulo de la página principal de FAQ; valor predeterminado: vacío, en cuyo caso se utiliza Page Title. Configúralo por idioma en Page Settings.
- Meta Description (SEO). Sustituye la metadescripción de la página principal de FAQ; valor predeterminado: vacío, en cuyo caso se utiliza Page Description. Configúralo por idioma en Page Settings.
| Ajuste adicional | Valor predeterminado | Cuándo cambiarlo |
|---|---|---|
| Category and question URL suffix | Vacío | Si lo necesitas, introduce una extensión que empiece por punto, como .html. Las URL existentes de categorías y preguntas se redirigen tras el cambio. Las URL de la página principal, etiquetas, paginación y búsqueda conservan su formato. |
| Show computed FAQ facts | Sí | Oculta el número de respuestas publicadas y las fechas calculadas Created, Reviewed y Latest answer si no quieres mostrarlos. Este ajuste es por tienda. |
| Byline label | Vacío | Introduce tu propio encabezado multilingüe para los autores de FAQ. |
| Byline text | Vacío | Introduce tu propia descripción multilingüe de los autores. Si lo dejas vacío, se oculta la mención de autoría. |
| Published answers supporting text | Vacío | Explica tu proceso de publicación. Si lo dejas vacío, se muestra el recuento calculado sin texto explicativo. |
Los tres ajustes de texto editorial son por tienda y por idioma. Selecciona la tienda adecuada antes de editarlos. Vacía la caché tras cambiar una ruta y comprueba que los enlaces antiguos redirijan al nuevo destino previsto.
Hacer una pregunta
- Enable "Ask a Question" Form. Muestra el formulario de preguntas de clientes en las páginas FAQ y en las pestañas FAQ de los productos; valor predeterminado:
1. Configúralo en Ask a Question. - Section Title. Define el título del bloque Ask a Question; valor predeterminado:
Still have questions?. Configúralo por idioma en Ask a Question. - Section Description. Define la descripción del bloque Ask a Question; valor predeterminado:
Can't find what you're looking for? Send us your question and we'll get back to you.Configúralo por idioma en Ask a Question. - Button Text. Define la etiqueta del botón Ask a Question; valor predeterminado:
Ask a Question. Configúralo por idioma en Ask a Question. - Success Message. Define el mensaje que aparece después de enviar una pregunta; valor predeterminado:
Thank you! Your question has been submitted successfully. We will respond as soon as possible.Configúralo por idioma en Ask a Question. - Max Pending Questions per Category. Limita las preguntas pendientes por visitante y por categoría de productos de primer nivel; valor predeterminado:
2, y0significa sin límite. Configúralo en Ask a Question. - Show Pending Questions. Muestra en las listas FAQ/producto las preguntas enviadas que todavía esperan respuesta; valor predeterminado:
1. Configúralo en Ask a Question.
Respuestas públicas
- Enable Public Replies. Permite que los visitantes envíen respuestas adicionales a preguntas FAQ existentes; valor predeterminado:
0. Configúralo en Public Replies. - Require Login. Exige una cuenta de cliente para que los visitantes puedan enviar respuestas públicas; valor predeterminado:
0. Configúralo en Public Replies. - Success Message. Define el mensaje que aparece después de enviar una respuesta pública; valor predeterminado:
Thank you! Your answer has been submitted for review and will appear once approved.Configúralo por idioma en Public Replies.
Las nuevas respuestas públicas quedan pendientes de revisión en FAQ > Additional Replies. Apruébalas para que puedan mostrarse públicamente. Los votos útil/no útil usan un hash con clave de la dirección IP y del agente de usuario del visitante para evitar votos duplicados durante 30 días después de un voto aceptado. No están vinculados a una cuenta de cliente. El servicio de votación actual no almacena los valores originales de la IP ni del agente de usuario.
Estilos del tema
Usa Theme styles para heredar o sobrescribir los colores, bordes, radios y estilos de campos detectados para FAQ. Los valores predeterminados dependen del tema activo.
Crear categorías y respuestas
- Abre FAQ > Categories. Crea una categoría como Envíos. Traduce su nombre, descripción, URL amigable, metatítulo y metadescripción. Actívala.
- Vincula la categoría FAQ a categorías de la tienda PrestaShop si quieres mostrar preguntas relacionadas en la barra lateral de categorías. Esta ubicación utiliza
displayLeftColumn. - Abre FAQ > Questions y crea una respuesta en esa categoría FAQ. Traduce Question, Answer, la URL amigable y los campos SEO. Añade etiquetas mediante el editor y gestiónalas en FAQ > Tags.
- Usa el selector de productos para asignar la pregunta a productos concretos. Las respuestas publicadas y asignadas aparecen mediante
displayProductExtraContent. - Deja vacía la selección de grupos de clientes para que la respuesta sea visible para todos los grupos, o selecciona los que pueden verla.
- Configura Publish Date si quieres retrasar la publicación. Configura Answer Reveal Date si la respuesta debe aparecer después de la pregunta. Activa la pregunta y guarda.
- Si usas páginas individuales y quieres que se indexe esta respuesta, activa Index this question page y el ajuste global Allow individual question pages to be indexed.
Para un tema como Envíos, puedes usar el slug de categoría shipping y el slug de pregunta how-long-does-delivery-take. Escribe la respuesta sobre la entrega en cada idioma y asígnala a los productos correspondientes. Usa los campos del editor en lugar de pegar ejemplos de claves de configuración en la base de datos.
El texto de las preguntas, las respuestas, los slugs y los campos SEO tienen valores específicos para cada idioma. Las nuevas preguntas se asocian a todas las tiendas en las que está instalado FAQ Manager; crear una pregunta en el contexto de una tienda no la hace exclusiva de esa tienda. Comprueba su disponibilidad en cada tienda afectada antes de publicarla.
Abre Manage Product Q&A para comprobar el estado de las preguntas y respuestas a nivel de producto si la interfaz de preguntas de un producto no está disponible. Revisa los envíos de clientes en Pending Questions. Puedes aprobarlos, rechazarlos o responder desde el back office. El límite predeterminado de Ask a Question es de dos envíos pendientes por visitante y por categoría de productos de primer nivel; cero elimina ese límite.
Comprobar la tienda y las rutas
Abre la página principal de FAQ, una categoría y una pregunta sin iniciar sesión. Comprueba la búsqueda, las descripciones de categoría, el número de preguntas, el comportamiento del acordeón, las preguntas relacionadas, los productos relacionados y los votos. Envía una pregunta de prueba desde la página FAQ y desde una página de producto. Confirma que llegan a Pending Questions.
Estas son algunas rutas habituales en inglés sin sufijo:
/faq
/faq/page/2
/faq/shipping
/faq/shipping/how-long-does-delivery-take
/faq/tag/installation
/faq/search
/faq/search/returns
/faq/search/returns/page/2
Los segmentos base localizados integrados incluyen el inglés faq, el alemán haeufige-fragen, el francés questions-frequentes, el polaco najczesciej-zadawane-pytania, el italiano domande-frequenti y el español preguntas-frecuentes. Usa los enlaces generados en la tienda para tu idioma, la ruta base de tu tienda y tu configuración reales.
Las respuestas específicas de un producto pueden estar presentes en el HTML inicial del producto. Las respuestas compartidas pueden cargarse al abrirlas. El módulo también ofrece búsqueda AJAX y sugerencias. La integración con MPR Search Revolution es opcional y requiere que esté presente esa integración independiente.
Configurar la indexación y la generación del sitemap
| Tipo de página | Valor predeterminado | Requisitos para la indexación o inclusión en el sitemap |
|---|---|---|
| Página principal de FAQ | Indexación activada | Allow FAQ landing page indexing. Include in Sitemap también debe estar activado para incluirla en el sitemap. |
| Categoría FAQ | Indexación desactivada | Allow FAQ category page indexing e Index this category page en la categoría. |
| Pregunta individual | Indexación desactivada | Modo Individual pages, indexación global de preguntas e Index this question page en la pregunta. |
| Páginas de etiquetas | Indexación desactivada | Allow FAQ tag page indexing. Las páginas de etiquetas siguen excluidas del sitemap. |
| Páginas de búsqueda | Noindex | Usa la búsqueda para explorar el contenido. |
Las páginas que cumplen los requisitos pueden emitir señales canonical y hreflang según la política SEO del módulo. El generador del sitemap debe llamar a gSitemapAppendUrls. Enable legacy Schema.org FAQ markup está desactivado de forma predeterminada. Actívalo solo si necesitas la salida opcional FAQPage/QAPage y has comprobado la política de la página correspondiente. Los motores de búsqueda eligen el formato del resultado.
Personalizar plantillas y CSS
La ubicación en productos utiliza displayProductExtraContent. Actualmente no hay ningún shortcode FAQ para páginas CMS/producto que configurar. Tu tema debe mostrar el hook de contenido adicional del producto y la columna izquierda de categorías para que estas ubicaciones funcionen.
Usa estas rutas para sobrescribir las plantillas:
themes/your-theme/modules/mprfaq/views/templates/front/faq.tpl
themes/your-theme/modules/mprfaq/views/templates/front/category.tpl
themes/your-theme/modules/mprfaq/views/templates/front/question.tpl
themes/your-theme/modules/mprfaq/views/templates/hook/product-tab.tpl
themes/your-theme/modules/mprfaq/views/templates/hook/category-sidebar.tpl
Coloca el CSS en la hoja de estilos personalizada de tu tema, por ejemplo:
.mprfaq-cat-card { border-color: #d8dde6; }
.mprfaq-detail-answer { font-size: 15px; line-height: 1.7; }
.mprfaq-vote-btn--yes:hover { border-color: #16a34a; color: #16a34a; }
#left-column .mprfaq-sidebar__widget.mpr-sidebar-section { margin-top: 24px; }
Solución de problemas
- Si falta contenido, comprueba que la categoría y la pregunta estén activas, así como el idioma de la tienda, la fecha de publicación, la fecha de revelado de la respuesta y las asignaciones de grupos de clientes.
- Si falta la pestaña del producto, comprueba las asignaciones explícitas a productos, Manage Product Q&A y la ubicación de
displayProductExtraContenten el tema. - Si faltan preguntas de categoría, comprueba las asignaciones a categorías de la tienda y si el tema tiene una columna izquierda en esa página.
- Si una pregunta abre una sección de producto en lugar de una página independiente, comprueba Question pages.
- Si los campos SEO parecen no tener efecto, comprueba el modo y los interruptores de indexación tanto globales como de cada elemento. Las páginas noindex se excluyen intencionadamente del sitemap cuando la política lo exige.
- Si faltan respuestas públicas, comprueba Enable Public Replies, Require Login y su aprobación en Additional Replies.
- Después de cambiar slugs o sufijos, vacía la caché y comprueba las URL actuales e históricas. El módulo conserva un historial de URL y redirige las antiguas.
Desactivar o desinstalar
Desactiva el módulo en el Gestor de módulos para detener su integración conservando los datos. Haz una copia de seguridad de categorías, preguntas, respuestas, etiquetas, votos, asignaciones y configuración antes de elegir Desinstalar. La desinstalación elimina su menú de administración, la configuración del módulo, el esquema de base de datos declarado y los metadatos de rutas del módulo.
Capturas de pantalla de referencia




Preguntas
2
¿Qué datos guardan las preguntas enviadas, las respuestas y los votos?
Las preguntas pendientes guardan nombre, correo, pregunta, contexto de producto o categoría, estado y fechas.
Las respuestas de la comunidad guardan los datos del autor y el texto para moderación.
Los votos usan un hash con clave de la dirección IP y el user-agent para evitar duplicados durante 30 días desde un voto aceptado. El servicio de votación no guarda esos valores originales.
¿Las preguntas FAQ están separadas por tienda e idioma?
En FAQ Manager, el texto de las preguntas, las respuestas, los slugs y los campos SEO tienen valores específicos para cada idioma.
Los textos se guardan en las tablas _lang. Las preguntas nuevas se asocian a todas las tiendas donde está instalado el módulo.
Crear una pregunta en el contexto de una tienda no la limita a esa tienda. Las consultas de la tienda comprueban las asociaciones con las tiendas.
Problemas conocidos
29
Textos de administración en inglés
Crear una pregunta sin éxito dejaba registros incompletos
Un voto registrado podía parecer fallido
La reparación de pestañas FAQ cambiaba etiquetas traducidas
Visibilidad FAQ anónima con grupo de visitantes incorrecto
El mantenimiento FAQ cambiaba las ubicaciones del comerciante
URL de preguntas perdían letras al actualizarse
Guardar y permanecer omitía la validación de ajustes
Errores de compatibilidad en la detección del tema
Visibilidad programada de FAQ obsoleta
Selectores de asignación guardaban elecciones inesperadas
FAQ fallaba en PHP 7.1
El sitemap ignoraba las opciones de indexación de preguntas
El enrutamiento FAQ localizado podía fallar
Ubicaciones FAQ eliminadas reaparecían
Páginas de preguntas cargaban demasiados productos relacionados
Refuerzo de la seguridad
Las páginas FAQ podían fallar en PrestaShop 8 y 9
Votos anteriores mal restaurados
Nuevas preguntas sin asignación a la tienda
Direcciones FAQ desconocidas sin respuesta de página no encontrada
Enlaces de preguntas redirigidos a sí mismos
Acordeón FAQ sin respuesta con scripts combinados
Marcado FAQ obsoleto seguía activado
Productos mostraban preguntas FAQ ajenas
Instalaciones antiguas no gestionaban preguntas pendientes
La ordenación por utilidad podía fallar
Confirmación de envío de pregunta oculta
Votos repetidos de utilidad aceptados
Solicitudes de funcionalidades
25
Implementado
Preguntas de clientes sobre productos con aprobación
Preguntas sobre productos y votos de utilidad
Categorías de FAQ y preguntas de visitantes
Respuestas de la comunidad y publicación programada
Barra lateral de FAQ por categoría con búsqueda
Etiquetas de FAQ
Enlaces de FAQ localizados
Integración con la búsqueda de la tienda
Integración con la base de conocimientos
Preguntas pendientes en las listas de FAQ
Respuestas útiles primero
Controles de indexación de preguntas
Actualizaciones con un clic
Ajustes de preguntas por producto
Bloques de código en las respuestas
Redirecciones de URL antiguas de preguntas
Política de indexación por tipo de página
Sufijo de URL de FAQ configurable
Límite de preguntas mostradas por producto
Actualización selectiva de la caché de FAQ
Variables dinámicas en el contenido FAQ
Reparación de URL con vista previa
Votos sin cookies de FAQ
Formulario de preguntas bajo demanda
Respuestas agrupadas en secciones de página
Registro de cambios
v1.20.142026-05-27
- AddedReduce shared FAQ duplication in product tabs
- AddedAdd selective FAQ question indexing
- AddedAdd FAQ question indexability policy
- AddedOverhaul FAQ category and search pages
- AddedPaginate FAQ category pages
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedRender FAQ resource lists with shared component
- ImprovedExpose knowledge base CTA in FAQ
- FixedPrevent FAQ question self-redirects
- FixedNofollow nonindexable FAQ detail links
- FixedEnforce FAQ noindex upgrade policy
- FixedRequire product-specific FAQ for inline answers
Versiones anteriores
v1.3.02026-04-20
- AddedCenter modal, add translations for product tab and rate limiter
- AddedRate limit ask-a-question to max 2 pending per email per product
- AddedShow pending questions at top of product tab accordion
- AddedShow date and reactions in product tab headers, sort by helpfulness
- AddedLicense management tab with key management and renewal options
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedcomplete FR/DE/ES/IT/PL translations
- ImprovedUnified KPI component, modal ask form, monochrome vote icons
- ImprovedLeft-align hero intro, add category tiles heading, improve FR description
- Improvedadmin list columns with visual badge indicators and multiselect filters
- ImprovedSEO handling with proper canonical URLs and meta tags on all front pages
- FixedUse ProductAssembler for related products on question page
- FixedReplace hardcoded French source strings with English across all templates
- FixedSwap related questions before products, use theme product grid
- Fixedvarious stability and compatibility improvements (23 fixes total)
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.2.02026-01-15
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- AddedFAQ Schema (FAQPage structured data) for Google rich results on all FAQ pages
- Improvedaccordion animation — uses CSS transitions instead of jQuery for smoother UX
- Fixedcategory ordering not respected on the front-end when categories were reordered via drag-and-drop
- Addedsearch/filter bar to quickly find questions within a long FAQ page
v1.0.02025-12-12
- Initialrelease: accordion FAQ management with unlimited questions and categories
- InitialConfigurable hook placement — works on any controller via back-office hook selector
- InitialClean, accessible HTML5 markup with ARIA attributes for screen readers
- InitialMulti-language support for questions, answers, and category names
v1.1.02025-07-24
- Addedcategory grouping — questions can now be organised under collapsible category headings
- Improvedadmin list with sortable drag-and-drop for both categories and questions
- Fixedduplicate IDs on pages with multiple FAQ widgets on the same hook
- Addedoption to show FAQ widget on product pages with product-specific question sets
Demo
Prueba el módulo completo antes de comprar
Compra la licencia más tarde y conserva tus ajustes.
- Tu demo de 30 días Pruébalo en tu propia tienda durante 30 días desde la primera instalación.
- Tienda demo lista Explora una tienda demo lista en tu navegador.
- Sin registro Sin cuenta, correo ni dominio de tienda.
Al descargar, aceptas las condiciones de la demo y la política de privacidad.
Al abrir esta demo, acepta los términos de la demo y la política de privacidad.