Knowledge Base: configuración y ayuda

Sube el ZIP de Knowledge Base desde la página de módulos del back office e instálalo. Usa la acción "Configure" de la ficha del módulo para abrir Configuración. Gestiona las guías en "Knowledge Base" > Artículos y "Knowledge Base" > Categorías. Las etiquetas del menú siguen el idioma del back office.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.

Usa URL amigables que funcionen y la dirección segura de la tienda. PHP DOM es necesario para generar el índice de los artículos. PHP ZIP es necesario para el actualizador del módulo incluido. Tú proporcionas los artículos y las traducciones. No necesitas una cuenta externa de base de conocimiento.

Selecciona la tienda cuyo contenido quieres gestionar. Los artículos y categorías se guardan para una tienda. Tu perfil de empleado necesita permiso para ver las pantallas correspondientes, añadir o editar contenido y guardar ajustes. La importación CMS requiere permisos tanto de adición como de edición.

1. Abre Configuración. Comprueba Slug URL de la base de conocimiento y Slug URL de búsqueda en cada idioma.
2. Introduce Título de cabecera, Texto de cabecera, Meta título y Metadescripción. Guarda.
3. Abre Categorías y añade una categoría. Introduce Nombre, revisa URL amigable y mantén Activo habilitado.
4. Abre Artículos y añade una guía. Selecciona Categoría. Rellena Título, Extracto y Contenido en los idiomas de tu tienda.
5. Añade al menos dos encabezados adecuados de segundo nivel al contenido si quieres un índice. Revisa URL amigable.
6. Mantén Activo habilitado y deja Fecha de publicación vacía para publicar de inmediato. Revisa Escrito por el personal como se explica más abajo. Guarda.
7. Abre la página pública de ayuda. Sigue los enlaces de categorías y artículos. Busca una frase del artículo en el mismo idioma.

Por ejemplo, usa una categoría Instalación con un artículo titulado Montar tu nueva estantería de pared. Usa Antes del montaje, Montar la estantería y Cuidados tras la instalación como encabezados de segundo nivel. Establece Etiqueta en Guía si quieres mostrar esa etiqueta en su tarjeta. Añade un segundo artículo publicado a la misma categoría para comprobar las guías relacionadas.

Abre Configuración. Los campos de texto y dirección son traducibles. Completa y comprueba cada idioma que publiques.

La instalación proporciona valores predeterminados localizados para inglés, francés, alemán, polaco, italiano y español. Los demás idiomas reciben los valores ingleses. Cambiar después Título de cabecera o Texto de cabecera no reescribe automáticamente los campos de metadatos guardados.

Guarda el formulario. Vacía la caché de la tienda después de cambiar los slugs URL para actualizar las rutas guardadas. Se recuerdan los slugs raíz anteriores. Las terminaciones de búsqueda personalizadas anteriores no se conservan del mismo modo. Comprueba la página de inicio, la búsqueda y los enlaces ya compartidos después de cambiar una dirección.

La sección "Theme Settings" tiene su propio formulario de guardado. "Shop Template" usa "Automatic" de forma predeterminada y también ofrece "None" o una adaptación incluida. "Enable custom assets" empieza en "No" y controla la carga del CSS y JavaScript personalizados del módulo. La sección indica el tema detectado y si existen los archivos personalizados. Usa estos controles para adaptar las páginas públicas a tu tema. Guarda con "Save Theme Settings".

Sus controles compartidos "Content loading" incluyen "Public content", inicialmente "After the page has loaded", y "Visitor-specific content", inicialmente "When the pointer reaches it". También ofrecen "Only when opened". La carga del contenido específico del visitante después de cargar la página solo está disponible cuando todo el contenido afectado lo admite. Son ajustes del contenido compatible entre módulos en el contexto de tienda seleccionado, no un retraso de publicación de tus artículos. Cambiar estos valores compartidos requiere permiso de edición en "Performance" o "Themes". Las anulaciones de contenido declaradas por el módulo empiezan en "Inherit". Esta versión no incluye una declaración de fragmento para sus páginas de artículos.

Abre Categorías, añade una categoría y completa sus campos traducibles. Las categorías agrupan las guías. No contienen la guía en sí.

Deshabilitar una categoría no retira todas sus guías. Sus artículos activos y publicados pueden seguir apareciendo en la búsqueda y abrirse mediante direcciones directas. Deshabilita Activo en cada artículo para retirarlo.

Eliminar una categoría conserva sus artículos y elimina su asignación a ella. Sus categorías hijas también pierden la asignación a la categoría padre.

Abre Artículos. La lista incluye Título, Categoría, Etiqueta, Fuente, Vistas, Destacado, Activo, Posición y Publicado, además del ID del registro. Usa los filtros para encontrar una guía existente.

La publicación, categoría, estado destacado y orden se aplican al artículo completo en todos los idiomas. Proporcionas las traducciones en los campos de idioma del mismo artículo.

Los artículos se ordenan primero por estado destacado, después por posición ascendente, fecha de publicación descendente, fecha de creación descendente e ID del artículo. El módulo comprueba la fecha de publicación cuando se solicita el contenido. No necesitas una tarea cron de publicación.

Este editor no tiene un campo específico para subir una imagen de portada. Añade los medios de la guía mediante su contenido según corresponda.

Usa Escrito por el personal en los editores de artículos y categorías para marcar el contenido como escrito por el personal tras revisar todos los idiomas; un guardado normal no pone esta marca. Solo en el contenido escrito por el personal se sustituyen los marcadores de variables de tienda; el contenido importado o de origen desconocido los conserva literalmente.

El contenido confirmado del personal puede resolver las variables de tienda compatibles mediante el adaptador de contenido incluido. Si vuelves a poner Escrito por el personal en No para un artículo o una categoría, su origen pasa a ser desconocido. El importador marca su resultado como importado.

Si el contenido obligatorio del personal con marcadores de variables no puede resolverse de forma segura, el módulo puede omitir el registro de las listas y de la búsqueda. Una página directa puede devolver una respuesta de indisponibilidad temporal. El texto opcional puede omitirse. Busca entradas trusted_content en el diagnóstico del módulo o el registro del servidor y revisa los campos afectados y las dependencias incluidas. El ajuste Activo no evita estos errores de contenido.

Página de inicio y páginas de guías

La página de inicio agrupa las guías publicadas bajo categorías activas. Los botones de categoría filtran los grupos visibles. Las guías sin categoría usan una sección de recursos separada. La selección destacada incluye hasta cuatro guías destacadas de categorías activas. Se oculta cuando repetiría toda la biblioteca mostrada.

Cada página de artículo muestra su título, introducción, etiqueta y fecha de última actualización cuando está disponible. Su enlace de vuelta lleva a la categoría o a la página de ayuda si no hay una categoría disponible. Debajo aparecen hasta cuatro guías publicadas más de la misma categoría, en el orden de los artículos. No seleccionas los artículos relacionados en otra pantalla.

Navegación del índice

El módulo crea la navegación a partir de encabezados aptos de segundo y tercer nivel del contenido del artículo. Una secuencia adecuada de encabezados numerados tiene prioridad. De lo contrario, usa de dos a doce encabezados de segundo nivel o un conjunto adecuado de dos a doce encabezados en total. Sin un conjunto adecuado, la guía conserva su contenido sin índice.

Comprueba que los enlaces llegan a las secciones correctas y que puedes contraer la lista. Si falta, comprueba el marcado de los encabezados y la compatibilidad con PHP DOM.

Búsqueda local y Search Revolution

Busca una frase en el idioma actual de la tienda. La búsqueda integrada encuentra coincidencias en títulos, extractos, contenido de artículos, títulos y descripciones de metadatos y nombres de categorías. Excluye los artículos inactivos y con fecha futura y limita los resultados a la tienda e idioma actuales. Busca texto en lugar de significado y no busca en las descripciones de categorías. La página pública de resultados muestra hasta sesenta artículos en el orden de los artículos.

Una instalación activa y compatible de Smart Search Revolution puede recibir artículos publicados mediante el hook de proveedor de contenido del módulo. Su servicio público de búsqueda también puede proporcionar secciones de productos y otros resultados configurados bajo las coincidencias locales de artículos. No necesitas ese complemento para la búsqueda local de artículos. Comprueba su configuración si faltan resultados más amplios.

Direcciones, sitemap y vistas

Guardar un cambio de dirección de artículo o categoría registra su slug anterior. Las direcciones antiguas compatibles redirigen a la página publicada actual. Mover un artículo a otra categoría también redirige su ruta de categoría anterior cuando el slug del artículo sigue resolviéndose. Una página pública actual que usa un slug antiguo tiene prioridad sobre la redirección guardada. Eliminar contenido no conserva un destino funcional.

Con Incluir en el sitemap habilitado, el módulo proporciona direcciones aptas de la página de ayuda, categorías y artículos publicados a un consumidor de sitemap compatible. La disponibilidad y la política SEO del módulo también afectan a la elegibilidad. El consumidor produce el sitemap. Comprueba su resultado después de publicar.

Vistas cuenta las visitas mostradas a los artículos, incluidas las repetidas. No mide lectores únicos, satisfacción ni solicitudes de asistencia resueltas. No hay votación de utilidad.

Abre Importación CMS para ver el número de páginas CMS activas, categorías de la base de conocimiento y artículos. Ejecutar importación CMS inicia la migración. Es opcional y no forma parte de la creación manual de artículos.

Revisa primero la importación en una copia de tu tienda. Sus reglas están dirigidas a una tienda francesa de baños. Crea categorías fijas, excluye ciertos slugs, convierte determinados diseños antiguos y aplica sustituciones fijas de texto y enlaces. No ofrece selección de páginas de origen ni asignación editable de categorías. Su consulta de origen CMS no está limitada a la tienda seleccionada.

Se copian las traducciones de origen disponibles. Las que faltan usan el texto de origen seleccionado. Repetir la importación identifica los artículos por su ID CMS original y sustituye el contenido importado y su clasificación. Marca los artículos y categorías importados como contenido importado. También desactiva las páginas CMS que coinciden con los slugs raíz de la página de ayuda y borra las fechas de publicación de los artículos importados del CMS en la tienda de destino seleccionada.

La casilla de redirecciones empieza marcada. Las redirecciones siguen activadas aunque desmarques la casilla. Las redirecciones CMS importadas requieren el almacenamiento complementario mprseo_redirect. Las redirecciones por renombrar artículos y categorías usan el almacenamiento propio de Knowledge Base.

Tras una importación de prueba, revisa cada categoría, guía, traducción, estado de publicación y URL antigua generados antes de usar la acción en tu tienda en producción. No la repitas sobre cambios manuales sin revisar el comportamiento de sustitución.

Las versiones activas compatibles coordinan qué módulo gestiona la base de conocimiento pública. Si la gestiona Support Revolution, Knowledge Base suprime sus rutas independientes y su salida sitemap. Las solicitudes que aún llegan a su controlador redirigen a la página de ayuda de Support Revolution. Configuración muestra un aviso de titularidad.

Ambos módulos conservan su propio contenido en el back office. La titularidad no copia ni combina artículos. Comprueba por separado las URL de artículos ya compartidas. Con versiones anteriores, un coordinador ausente o una decisión de titularidad sin resolver, ambos conjuntos de rutas pueden seguir disponibles.

Comprueba la página de ayuda, una categoría, un artículo y la búsqueda en cada idioma publicado. Confirma que un artículo con fecha futura permanece oculto. Comprueba una dirección antigua después de renombrar una guía. Revisa los artículos relacionados, los enlaces del índice y las entradas sitemap donde se usen.

Tú escribes y traduces las guías. El módulo no genera respuestas ni traducciones.

Haz una copia de seguridad de artículos, traducciones, categorías y ajustes antes de desinstalar. Usa la acción "Uninstall" del módulo en el back office.

Una desinstalación correcta elimina sus artículos, traducciones, categorías, ajustes e historial de slugs guardado. Conserva una copia restaurable de la tienda si necesitas ese contenido más adelante. Si falla la limpieza del tema, la desinstalación puede detenerse antes de eliminar los datos del módulo. Resuelve el fallo de limpieza y vuelve a intentarlo.