Requisitos
- Moodle 4.x (4.1, 4.2, 4.3, 4.4, o 4.5)
- PHP 8.0+ (probado en 8.0, 8.1, 8.2, 8.3)
- Extensión cURL (para llamadas a la API del proveedor de IA)
- Extensión JSON (estándar en PHP 8.x)
- Una API key de proveedor de IA (OpenAI, DeepSeek, Gemini, Claude, o cualquier endpoint compatible con OpenAI)
Instalación
Paso 1: Descarga
Tras la compra, descarga el ZIP del plugin desde tu panel. El archivo se llama campus-assistant-v2.2.1.zip (~114KB).
Paso 2: Subir a Moodle
Ve al panel de administración de Moodle:
- Administración del sitio → Plugins → Instalar plugins
- Sube el archivo ZIP
- Selecciona el tipo: Plugin local
- Instalar
Paso 3: Configurar
Tras la instalación, ve a:
- Administración del sitio → Plugins locales → Campus Assistant
- Introduce tu licencia (desde tu panel)
- Selecciona tu proveedor de IA
- Introduce tu API key
- Personaliza: nombre, color, logo, idioma, mensaje de bienvenida
- Guardar cambios
Paso 4: Verificar
Visita cualquier página de curso habiendo iniciado sesión como estudiante, profesor o admin. El botón del asistente debería aparecer en la esquina inferior derecha.
Opciones de Configuración
Proveedor de IA
Elije entre los proveedores integrados o usa el tier gratuito:
- Gratuito (Gestionado): 50 mensajes/mes por campus, sin API key
- OpenAI: GPT-4o, GPT-4o-mini — introduce tu API key
- DeepSeek: El más asequible — introduce tu API key
- Google Gemini: Flash, Pro — introduce tu API key
- Anthropic Claude: Haiku, Sonnet — introduce tu API key
- Personalizado: Cualquier endpoint compatible con OpenAI (Ollama, LM Studio, vLLM, etc.)
Marca
- Nombre del asistente: Se muestra en la cabecera del chat
- Icono del botón: Sube tu logo (PNG, SVG)
- Color principal: Color hex para el botón y la cabecera
- Mensaje de bienvenida: Se muestra al abrir el chat
- Idioma por defecto: ES, EN, FR, DE, IT, o PT
Seguridad
- Límite de uso: Mensajes máximos por usuario por hora (por defecto: 20)
- Retención de conversaciones: Días para conservar logs (por defecto: 30, purga automática vía cron)
Referencia de Funciones
Funciones de Estudiante (20)
Lista de cursos, tareas pendientes, próximas entregas, fechas de examen, notas, progreso del curso, foros sin leer, información de tutores, contenido del curso, anuncios, calendario del curso, resultados de feedback, recursos del curso, próxima actividad, tiempo de estudio, compañeros, entregas atrasadas, buscar contenido, estado de entregas, resumen.
Funciones de Profesor (12)
Cursos impartidos, pendiente de corregir, progreso de la clase, estudiantes en riesgo, trabajos sin corregir, lista de estudiantes, resumen de finalización, preguntas del foro, resumen de calificaciones, entregas atrasadas, participación de la clase, próximos eventos.
Funciones de Admin (16)
Estadísticas del campus, matriculaciones por curso, estadísticas de notas, usuarios inactivos, entregas pendientes, actividad reciente, lista de cursos, tasas de finalización, crecimiento de usuarios, uso de almacenamiento, estadísticas de login, categorías de cursos, visión general de plugins, profesores sin cursos, cursos vacíos, salud del sistema.
Solución de Problemas
El botón del asistente no aparece
- Verifica que tu licencia es válida en los ajustes
- Borra la caché de Moodle: Administración del sitio → Desarrollo → Purgar todas las cachés
- Ejecuta cron:
php admin/cli/cron.php - Comprueba que tu tema renderiza el hook
before_standard_html_headhook
El asistente responde con errores
- Verifica que tu API key del proveedor de IA es correcta
- Comprueba los permisos del directorio
app/ - Revisa los logs de error de Moodle:
php admin/cli/psr2logger.php
Compatibilidad de temas
Campus Assistant usa el mecanismo additionalhtmlhead de Moodle para inyección fiable en todos los temas, incluyendo temas comerciales como Edumy que sobreescriben los hooks estándar. Si el botón no aparece, verifica que el ajuste additionalhtmlhead de tu tema no esté desactivado.
¿Necesitas Ayuda?
Escríbenos a hola@campusassistant.app. Tu licencia incluye soporte por email de los desarrolladores que crearon el plugin.