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.

Los artículos son el contenido central de la base de conocimiento. Cada artículo está vinculado a una categoría, se redacta en un editor de texto enriquecido y puede mantenerse como borrador hasta que esté listo para publicarse. Una vez publicado, el artículo queda accesible en el portal del cliente mediante su URL única basada en el slug generado automáticamente a partir del título.

Crear un artículo

1

Acceder al formulario de creación

En el panel de administración, dirígete a Base de Conocimiento y haz clic en el botón Nuevo Artículo (esquina superior derecha). Esto te llevará a /admin/knowledge-create.php.
2

Escribir el título

Ingresa un título claro y descriptivo en el campo Título. Este campo es obligatorio. El sistema generará automáticamente el slug de la URL a partir del título, convirtiendo el texto a minúsculas, eliminando caracteres especiales y reemplazando espacios por guiones.
3

Seleccionar la categoría

Elige la categoría correspondiente en el selector Categoría. El listado muestra únicamente las categorías activas (is_active = 1), ordenadas por sort_order y luego por nombre. La categoría debe existir previamente; si no hay categorías creadas, el selector estará vacío.
4

Redactar el contenido

Escribe el cuerpo del artículo en el campo Contenido, que utiliza el editor de texto enriquecido CKEditor. Puedes dar formato al texto, insertar imágenes, tablas, listas y enlaces. El contenido se almacena como HTML en la base de datos.
5

Seleccionar el estado

Marca la casilla Publicado para que el artículo sea visible de inmediato en el portal del cliente. Si deseas guardarlo como borrador mientras lo terminas de redactar, deja la casilla sin marcar.
6

Guardar el artículo

Haz clic en Guardar Artículo. El sistema insertará el registro en la tabla knowledge_articles y te redirigirá al listado principal en /admin/knowledge.php, donde verás el nuevo artículo al tope de la tabla.

Campos del formulario

CampoTipoObligatorioDescripción
titleTextoTítulo del artículo. Sirve de base para generar el slug.
category_idSelector (select)Categoría activa a la que pertenece el artículo.
contentEditor enriquecidoNoCuerpo del artículo en HTML (CKEditor).
is_publishedCasilla (checkbox)No1 = Publicado y visible; 0 = Borrador, solo visible en admin.

Editar un artículo

Para modificar un artículo existente, localízalo en el listado de /admin/knowledge.php y haz clic en el ícono de edición (lápiz). Esto abre /admin/knowledge-edit.php?id={id} con el formulario precargado con los valores actuales del artículo: categoría, título, contenido y estado de publicación. A diferencia del formulario de creación, el selector de categorías en la edición carga todas las categorías existentes (sin filtrar por is_active), permitiendo reasignar el artículo a cualquier categoría. Al guardar, el sistema ejecuta un UPDATE sobre knowledge_articles y actualiza también el campo updated_at y el slug (recalculado a partir del título modificado). Si el slug cambia, los enlaces anteriores al artículo dejarán de funcionar.

Vista previa del artículo

Antes de publicar, puedes previsualizar cómo verá el cliente el artículo haciendo clic en el ícono de ojo en el listado. Esto abre /admin/knowledge-view.php?id={id}, que renderiza el título, la categoría y el contenido HTML tal como aparecerá en el portal. La vista previa también incrementa el contador de views del artículo.

Buscar artículos

Utiliza el campo de búsqueda en la parte superior de /admin/knowledge.php para filtrar artículos por título. La búsqueda es insensible a mayúsculas y admite coincidencias parciales, ya que internamente usa LIKE '%término%' sobre la columna title de knowledge_articles. La tabla de resultados muestra el ID, título, categoría, número de vistas y estado de cada artículo coincidente.
-- Ejemplo de la consulta generada al buscar "contraseña"
SELECT a.*, c.name category_name
FROM knowledge_articles a
LEFT JOIN knowledge_categories c ON c.id = a.category_id
WHERE a.title LIKE '%contraseña%'
ORDER BY a.id DESC
Los artículos en estado Borrador (is_published = 0) no son visibles en el portal del cliente (/soporte/kb.php). Solo los artículos con is_published = 1 se muestran al público. Usa el estado borrador para preparar contenido sin exponerlo antes de que esté revisado y aprobado.

Build docs developers (and LLMs) love