Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/banredco/helpdesk/llms.txt

Use this file to discover all available pages before exploring further.

Las categorías son la estructura organizativa de la base de conocimiento. Cada artículo pertenece a una categoría, y en el portal del cliente los artículos publicados se presentan agrupados bajo el encabezado de su categoría correspondiente. Definir una jerarquía de categorías clara desde el inicio facilita la navegación del cliente y mantiene el contenido ordenado a medida que la base de conocimiento crece.

Crear una categoría

1

Acceder al formulario de nueva categoría

En el panel de administración, ve a Base de Conocimiento y haz clic en el botón Categorías para ir a /admin/knowledge-categories.php. Luego haz clic en Nueva Categoría para abrir /admin/knowledge-category-create.php.
2

Ingresar el nombre de la categoría

Escribe el nombre de la categoría en el campo Nombre. Este campo es obligatorio. El sistema generará automáticamente el slug de la categoría a partir del nombre, convirtiendo el texto a minúsculas y reemplazando los caracteres no alfanuméricos por guiones.
3

Definir el orden de aparición (opcional)

Ingresa un número entero en el campo Orden para controlar la posición de la categoría en la lista. Las categorías se ordenan de menor a mayor por sort_order y luego alfabéticamente por nombre. El valor predeterminado es 0.
4

Guardar la categoría

Haz clic en Guardar. El sistema insertará el registro en la tabla knowledge_categories con is_active = 1 (activa de manera predeterminada si la casilla está marcada) y te redirigirá al listado de categorías en /admin/knowledge-categories.php.

Campos del formulario de categoría

CampoTipoObligatorioDescripción
nameTextoNombre de la categoría. Base para generar el slug.
sort_orderNúmero enteroNoOrden de aparición. Menor número = aparece primero. Defecto: 0.
is_activeCasilla (checkbox)No1 = Categoría activa y disponible en artículos; 0 = Inactiva.

Editar una categoría

Para modificar una categoría existente, localízala en el listado de /admin/knowledge-categories.php y haz clic en el ícono de edición (lápiz). Esto abre /admin/knowledge-category-edit.php?id={id} con el formulario precargado. Puedes actualizar el nombre, el orden de aparición y el estado activo/inactivo. El formulario también muestra el slug generado en un campo de solo lectura, que se recalcula a partir del nombre cada vez que se guarda el formulario. Las categorías marcadas como inactivas dejan de aparecer en el selector del formulario de creación de artículos (WHERE is_active = 1).

Eliminar una categoría

Para eliminar una categoría, haz clic en el ícono de papelera en el listado de /admin/knowledge-categories.php. El sistema ejecutará /admin/knowledge-category-delete.php?id={id}.
No es posible eliminar una categoría que tenga artículos asignados. Antes de eliminarla, reasigna o elimina todos los artículos que le pertenecen. Si la categoría contiene artículos, el sistema bloqueará la operación y mostrará el mensaje: “No puedes eliminar una categoría que contiene artículos.” Puedes ver cuántos artículos tiene cada categoría en la columna Artículos del listado, que muestra el conteo en tiempo real.

Cómo se muestran las categorías en el portal

En /soporte/kb.php, el portal del cliente carga únicamente los artículos con is_published = 1 y los agrupa visualmente bajo el encabezado de su categoría. Cada artículo es un enlace que lleva a su URL pública (/soporte/kb/{slug}), donde el cliente puede leer el contenido completo. Las categorías inactivas (is_active = 0) no aparecen en el portal aunque tengan artículos publicados asociados.
// Estructura de URL pública de un artículo
// https://helpdesk.banred.com.co/soporte/kb/{slug}

// Ejemplo:
// https://helpdesk.banred.com.co/soporte/kb/como-restablecer-mi-contrasena
Usa nombres de categoría cortos y descriptivos, como Facturación, Cuenta, Pagos o Soporte Técnico. Los nombres concisos se ven mejor como encabezados en el portal del cliente y facilitan que el usuario encuentre rápidamente la sección relevante sin tener que leer textos largos.

Build docs developers (and LLMs) love