Configuración Inicial en FacturaScripts
Una vez que has configurado el servicio web en Moodle (ver guía anterior), el siguiente paso es instalar y configurar el plugin MoodleManagement en FacturaScripts.
Instalación del plugin
- Copie la carpeta MoodleManagement dentro del directorio Plugins de su instalación de FacturaScripts
- Acceda a FacturaScripts como administrador
- Vaya a Admin > Plugins
- Localice MoodleManagement en la lista y haga clic en "Activar"
- El sistema ejecutará la instalación automática: creará las tablas en la base de datos, registrará los controladores y configurará los workers y tareas cron.
Registrar su primera instancia Moodle MoodleManagement permite conectar múltiples plataformas Moodle simultáneamente. Cada conexión se denomina "instancia".
- Acceda a Gestión Moodle > Instancias Moodle (aparece en el menú principal tras activar el plugin)
- Haga clic en "+ Nuevo"
- Complete los campos:
- Nombre del sitio: un nombre descriptivo para identificar la instancia (ej: "Academia Principal", "Campus Formación")
- URL: la URL completa de su Moodle, sin barra final (ej: https://miacademia.com/moodle)
- Token: pegue el token generado en Moodle (ver Paso 6 de la guía anterior)
- Entorno: seleccione producción, staging o desarrollo según corresponda
- Estado: activa (por defecto)
- Guarde el registro
Probar la conexión Después de guardar la instancia:
- Haga clic en el botón "Probar Conexión"
- Si la conexión es exitosa, verá un mensaje de confirmación y se actualizarán automáticamente los datos del sitio:
- Nombre del sitio en Moodle
- Versión de Moodle
- Release
- Lista de funciones WS disponibles
- Si falla, revise la sección de solución de problemas de la guía de configuración WS.
Entender el menú de Gestión Moodle Tras la instalación, aparece un nuevo grupo de menú "Gestión Moodle" con las siguientes secciones:
- Instancias Moodle: gestión de las conexiones a plataformas Moodle
- Usuarios Moodle: mapeo entre usuarios de Moodle y contactos de FacturaScripts
- Cursos Moodle: mapeo entre cursos de Moodle y productos de FacturaScripts
- Categorías: categorías de cursos importadas desde Moodle
- Matrículas: gestión de matrículas con estados y vinculación a facturas
- Cohorts: grupos de usuarios (cohorts) de Moodle
- Roles: mapeo de los roles estándar de Moodle
Configurar productos como cursos Moodle Para que la automatización de matrículas funcione (matriculación automática al facturar), es necesario vincular productos de FacturaScripts con cursos de Moodle:
- Primero importe los cursos desde Moodle (ver guía de importación)
- Al importar un curso, el sistema puede crear automáticamente un producto en FacturaScripts
- Ese producto queda vinculado al curso Moodle
- Cuando se facture ese producto a un cliente cuyo contacto esté mapeado con un usuario Moodle, el worker de matrícula automática se encargará del proceso
Automatizaciones activas Al instalar el plugin se registran automáticamente los siguientes procesos: Workers (se ejecutan en tiempo real al ocurrir eventos):
- EnrolmentWorker: al pagarse una factura con productos vinculados a cursos, matricula automáticamente al alumno en Moodle
- PreEnrolmentWorker: al crear un presupuesto o pedido con productos de curso, crea matrículas en estado pendiente
- ContactSyncWorker: al modificar un contacto en FS, sincroniza los datos con su usuario Moodle
- ContactDeleteWorker: al eliminar un contacto en FS, suspende su cuenta y matrículas en Moodle Tareas cron (se ejecutan periódicamente):
- Health check (cada hora): verifica el estado de todas las instancias Moodle
- Sincronización de usuarios (cada 6 horas): importa cambios de usuarios desde Moodle
- Sincronización de cursos (cada 6 horas): importa cambios de cursos desde Moodle
- Reconciliación (diaria): verifica que los mapeos de FS coincidan con los datos reales en Moodle
- Limpieza (diaria): elimina mapeos huérfanos de contactos que ya no existen en FS
- Control de expiración (cada 6 horas): detecta matrículas por vencer en 7 días y expira las vencidas
Estos procesos funcionan de forma transparente sin intervención del administrador.