Documentación del componente «Cursos»

Introducción

• Gestión de cursos: Crea y organiza un número ilimitado de cursos con descripciones, imágenes y precios
• Sistema de categorías: Organiza los cursos en categorías lógicas
• Integración con el comercio electrónico: Acepta pagos a través de PayPal (modos Sandbox y Live)
• Sistema de valoración: permite a los clientes valorar y opinar sobre los cursos
• Visualización de módulos: muestra los cursos en tu sitio web utilizando plantillas de módulos personalizables
• Seguimiento de compras: Realiza un seguimiento de todas las compras y transacciones relacionadas con los cursos
• Perfiles de los formadores: añade la imagen, el nombre y la descripción del formador a cada curso
• Métricas de los cursos: muestra el número de lecciones y el número de alumnos matriculados
• Opciones de visualización flexibles: 21 estilos diferentes de presentación de los cursos

Instalación

Requisitos del sistema

• Joomla 4 o posterior
• PHP 7.0 o superior
• MySQL 5.5+ o PostgreSQL 9.5+

Pasos de instalación

1. Descarga el componente
   • Descarga el paquete del componente Mx Courses (archivo .zip con el componente, el módulo y el plugin)
2. Instálalo a través de Joomla
   • Inicia sesión en tu panel de administración de Joomla
   • Ve a Sistema → Instalar, Actualizar, Extensiones
   • Haz clic en la pestaña «Subir archivo de paquete»
   • Selecciona el archivo zip de Mx Courses que has descargado
   • Haz clic en «Subir e instalar»
3. Comprueba la instalación
   • Ve a Componentes → Mx Courses en el menú de administración
   • Deberías ver la interfaz de gestión de cursos
4. Tablas de la base de datos
   • El proceso de instalación crea automáticamente las tablas de base de datos necesarias:
     • jos_mxcourses_items (elementos del curso)
     • jos_mxcourses_purchases (registros de compra)

Configuración inicial

Acceso a la configuración de los componentes

1. Ve a Componentes → Cursos Mx en el menú de administración
2. Haz clic en el botón «Opciones» de la barra de herramientas (arriba a la derecha)

Secciones de configuración

Ajustes básicos

Configuración de archivos multimedia y miniaturas

Configura cómo se generan y se muestran las miniaturas del curso:

Opciones de compra y valoración

Habilitar funciones de comercio electrónico y valoración:

Permisos

Establecer niveles de acceso de los usuarios para gestionar cursos y ver compras:

• Permisos de gestión básicos
• Permisos de visualización para diferentes grupos de usuarios

Gestión de categorías

Las categorías ayudan a organizar los cursos de forma lógica para facilitar la navegación.

Crear una categoría

1. Ve a Componentes → Categorías
2. Selecciona «Mx Courses» en el menú desplegable de extensiones (si es necesario)
3. Haz clic en «Nuevo»
4. Rellena los datos de la categoría:
   • Título: Nombre de la categoría (p. ej., «Desarrollo web»)
   • Alias: nombre adecuado para la URL
   • Descripción: Descripción de la categoría (opcional)

Asignación de cursos a categorías

1. Editar un curso
2. En el menú desplegable «Categoría», selecciona la categoría adecuada
3. Guarda el curso

Organización de la jerarquía de categorías

Las categorías admiten una estructura de tipo «padre-hijo»:

1. Crea una categoría principal (por ejemplo, «Programación»)
2. Crea subcategorías (por ejemplo, «Desarrollo web», «Aplicaciones de escritorio»)
3. Al crear subcategorías, selecciona la categoría principal en el campo «Principal»

Gestión de cursos (elementos)

Creación de un nuevo curso

1. Ve a Componentes → Cursos Mx → Elementos
2. Haz clic en el botón «Nuevo»
3. Rellena los datos del curso:

Campos obligatorios

Campos multimedia

Precios y detalles

Opciones de visualización

Editar un curso

1. Ve a Componentes → Cursos Mx → Elementos
2. Haz clic en el título del curso para editarlo
3. Modifica los detalles según sea necesario
4. Haz clic en «Guardar» o en «Guardar y cerrar»

Publicar o retirar cursos

Curso individual

1. Haz clic en el curso para editarlo
2. Establece el estado en «Publicado» (marca de verificación verde) o «No publicado»
3. Haz clic en «Guardar»

Acciones masivas

1. En la vista de lista «Elementos», selecciona uno o varios cursos utilizando las casillas de selección
2. Haz clic en el menú desplegable «Estado» y selecciona:
   • Publicar: hacer visible
   • Retirar de la publicación: ocultar al público
   • Archivar: mover al archivo
   • Papelera: eliminar (se puede recuperar)

Eliminación de cursos

Eliminación temporal (Papelera)

1. Selecciona el curso o cursos que deseas eliminar
2. Haz clic en el botón «Papelera» o selecciona la opción correspondiente en el menú desplegable «Estado»
3. Los cursos se mueven a la papelera, pero se pueden recuperar

Eliminación definitiva

1. Accede a los cursos que se encuentran en la papelera
2. Seleccione los cursos
3. Haz clic en el botón «Eliminar»
4. Confirma la eliminación

Configuración de pagos y compras

Configuración de PayPal

Modo Sandbox (pruebas)

1. Ve a Componentes → Mx Courses → Opciones
2. Haz clic en la pestaña «Compra y valoración»
3. Activa la opción «Habilitar compras»
4. Establece el modo de pago en «Sandbox»
5. Introduce tu correo electrónico de PayPal para Sandbox
6. Establece la moneda (normalmente USD para las pruebas)
7. Haz clic en «Guardar»

Para obtener las credenciales de Sandbox:

• Visita el entorno de pruebas para desarrolladores de PayPal
• Crea una cuenta de prueba para empresas
• Utiliza la dirección de correo electrónico de la empresa facilitada en Sandbox

Modo en vivo (producción)

1. Ve a Componentes → Cursos Mx → Opciones
2. Haz clic en la pestaña «Compra y valoración»
3. Establece el modo de pago en «En producción»
4. Introduce tu correo electrónico empresarial de PayPal (cuenta de PayPal verificada)
5. Establece la moneda en la que desees
6. Haz clic en «Guardar»

Importante: Cambia al modo «Live» solo después de haber realizado pruebas exhaustivas en el modo «Sandbox».

Gestión de compras

Realiza un seguimiento de todas las compras de los clientes:

1. Ve a Componentes → Cursos Mx → Compras
2. Ver la lista de todas las compras:
   • Nombre del cliente
   • Título del curso
   • Fecha de compra
   • Importe pagado
   • Estado del pago

Explicación del estado de la compra

• Pendiente: Se ha recibido el pago, pero aún no se ha confirmado
• Completado: Pago confirmado, el cliente tiene acceso
• Fallido: la transacción de pago ha fallado
• Reembolsado: Se ha reembolsado el pago

Configuración de visualización del módulo

El módulo Mx Courses muestra los cursos en toda tu web.

Instalación del módulo

1. El módulo mod_mx_course se instala junto con el componente
2. Ve a Extensiones → Módulos en el panel de administración
3. Haz clic en «Nuevo» para crear una nueva instancia del módulo

Configuración del módulo

Ajustes básicos

Parámetros del módulo

Estilos de visualización disponibles

Elige entre 21 diseños de módulos diferentes:

Prueba diferentes estilos para encontrar el mejor aspecto para tu sitio web.

Asignación de módulos a páginas de menú

Para mostrar el módulo solo en páginas específicas:

1. Edita el módulo
2. Haz clic en la pestaña «Asignación de menú»
3. Selecciona:
   • En todas las páginas: Mostrar en todas partes
   • En las páginas donde: Mostrar solo en las páginas seleccionadas
   • En páginas donde NO: Ocultar en las páginas seleccionadas

Funciones de la interfaz de usuario

Vista del cliente

Página de listado de cursos

Los clientes ven:

• El título del curso y una imagen en miniatura
• Breve descripción (texto introductorio)
• Nombre del formador, descripción e imagen de perfil
• Número de lecciones y número de alumnos matriculados
• Precio (si se ha establecido)
• Valoraciones y reseñas (si están habilitadas)
• Botón «Leer más» o «Comprar ahora»

Página de detalles del curso

Al visualizar un curso completo:

• Descripción completa del curso
• Imagen del curso a tamaño completo
• Información detallada
• Precio y botón «Comprar curso» (si está habilitado)
• Valoración media y opiniones de los clientes

Compra de un curso

Para cursos de pago:

1. Haz clic en el botón «Comprar curso»
2. Confirma los detalles del curso
3. Se le redirigirá a la página de pago de PayPal
4. Realiza el pago a través de PayPal
5. Vuelve a la página web con la confirmación de la compra
6. Accede a los materiales del curso (si procede)

Para cursos gratuitos:

1. Haz clic en el botón «Inscribirse» (si está habilitado)
2. Inscripción inmediata como usuario registrado

Dejar opiniones y valoraciones

Si la valoración está habilitada:

1. En la página de detalles del curso, desplázate hasta la sección de valoraciones
2. Haz clic en la puntuación con estrellas que desees (de 1 a 5 estrellas)
3. Si lo deseas, añade un comentario
4. Envía la valoración

Normas de permiso:

• Todos: cualquier visitante puede valorar (solo para usuarios registrados)
• Solo compradores: Solo los clientes que hayan comprado el curso pueden valorar

Integración con la búsqueda

Si la búsqueda de Joomla está activada:

• Los cursos aparecen en los resultados de búsqueda del sitio
• La búsqueda incluye el título, la descripción y el texto de introducción
• El componente cuenta con el complemento Finder para realizar búsquedas avanzadas

Solución de problemas

Problemas comunes y soluciones

Los cursos no aparecen en el sitio

Problema: Los cursos están configurados, pero no se ven en el módulo

Soluciones:

• Comprueba que el estado del curso esté establecido en «Publicado»
• Comprueba que el módulo esté «Publicado»
• Comprueba que la asignación de menú del módulo incluya la página actual
• Borra la caché de Joomla (Sistema → Caché → Eliminar todo)
• Comprueba la asignación de categorías si se filtra por categoría

Las imágenes no se muestran

Problema: Las imágenes del curso aparecen dañadas o no se ven

Soluciones:

• Comprueba que el archivo de imagen exista en el servidor
• Comprueba la ruta de la imagen en la base de datos
• Restablecer las miniaturas (Componentes → Mx Courses → Opciones → Multimedia → Restablecer miniaturas)
• Comprueba los permisos del archivo de imagen (debe ser legible)
• Intenta subir la imagen de nuevo

Los pagos con PayPal no funcionan

Problema: el botón «Comprar curso» no funciona o el pago falla

Soluciones:

• Comprueba que la opción «Habilitar compras» esté activada
• Comprueba que la dirección de correo electrónico de PayPal sea correcta
• Prueba en modo Sandbox antes de pasar a producción
• Comprueba la configuración de IPN (Notificación de pago instantáneo) en PayPal
• Comprueba los registros de errores del servidor en busca de errores de IPN de PayPal
• Asegúrate de que dispones de un certificado SSL si estás en modo «Live»

No se generan miniaturas

Problema: Las miniaturas personalizadas no aparecen o se ven mal

Soluciones:

• Ve a Opciones → pestaña «Multimedia»
• Haz clic en el botón «Restablecer miniaturas»
• Espera a que finalice el proceso
• Comprueba la configuración del «Estilo de miniatura» en cada curso
• Comprueba que la imagen cumpla los requisitos mínimos de tamaño

Error de base de datos durante la instalación

Problema: La instalación falla debido a un error de base de datos

Soluciones:

• Comprueba que el usuario de la base de datos tenga permisos CREATE/ALTER TABLE
• Comprueba la compatibilidad de la versión de MySQL/PostgreSQL
• Asegúrate de que el prefijo de la base de datos no entre en conflicto con tablas existentes
• Intenta desinstalar y volver a instalar el componente
• Comprueba los registros del sistema de Joomla en busca de errores específicos

Preguntas frecuentes

Preguntas generales

P: ¿Puedo establecer precios diferentes para distintos grupos de usuarios?
R: El componente admite un único precio por curso. Para opciones de precios más avanzadas, te recomendamos utilizar complementos adicionales de comercio electrónico para Joomla.

P: ¿Qué métodos de pago se admiten?
R: Actualmente, PayPal es el principal método de pago. Las pasarelas de pago adicionales requieren un desarrollo a medida.

P: ¿Puedo ofrecer descuentos o cupones para los cursos?
R: El componente básico no incluye la funcionalidad de descuentos. Es posible que algunas extensiones de terceros ofrezcan esta función.

Preguntas técnicas

P: ¿Admite el componente varios idiomas?
R: Sí, es totalmente compatible con varios idiomas. Crea cursos en diferentes idiomas utilizando el campo «Idioma».

P: ¿Puedo exportar los datos de los cursos?
R: Se puede acceder a la función de exportación a través de las herramientas de componentes de Joomla o directamente desde la base de datos (MySQL/PostgreSQL).

P: ¿Existe una API para la integración con sistemas externos?
R: El componente utiliza la arquitectura MVC estándar de Joomla. Los puntos finales de API personalizados requieren un desarrollo a medida.

Preguntas sobre personalización

P: ¿Puedo personalizar las plantillas de visualización del módulo?
R: Sí, las plantillas del módulo se encuentran en /modules/mod_mx_course/tmpl/. Edita los archivos de estilo para personalizar los diseños.

P: ¿Cómo añado campos personalizados a los cursos?
R: Modifica los archivos XML de definición de formularios en /admin/models/forms/item.xml.

P: ¿Puedo modificar el proceso de compra?
R: Sí, edita el controlador del sitio y el gestor de IPN en /site/controller.php.

Preguntas sobre el rendimiento

P: ¿Este componente ralentizará mi sitio web?
R: No, está optimizado para ofrecer un buen rendimiento. Utiliza el almacenamiento en caché de Joomla para obtener los mejores resultados.

P: ¿Cuántos cursos puedo crear?
R: Un número ilimitado. El rendimiento depende de los recursos del servidor y de la estrategia de almacenamiento en caché.

Asistencia y recursos

• Correo electrónico de soporte:
• Actualizaciones: Disponibles a través del servidor de actualizaciones de Joomla (un año a partir de la fecha de compra)