Plugin de Moodle

Introducción

El plugin de actividad de Moodle de BCdiploma permite integrar y automatizar de forma sencilla el proceso de emisión de certificados BCdiploma en el LMS Moodle.

Permite:

• administrar la conexión entre Moodle y BCdiploma (autenticación y elección del entorno de trabajo)
• configurar actividades en las que el usuario de Moodle puede:
  • elegir la plantilla de certificado que se va a utilizar
  • elegir el modo de distribución de los certificados (automático o bajo demanda, con o sin envío por correo electrónico)
• generar automáticamente certificados en función de las restricciones definidas en la actividad
• mostrar / reenviar / eliminar los certificados generados desde el informe de la actividad
• volver a emitir certificados

Instalación y limitaciones

Puede descargar el paquete zip de la versión beta del plugin BCdiploma para Moodle aquí e instalarlo desde la interfaz de administración de Moodle mediante la funcionalidad “Install plugin from ZIP file”.

Configuración inicial

En la administración de Moodle, en la lista de plugins instalados, encontrará el plugin BCdiploma con el identificador “mod_bcdiplomacert”.

Antes de cualquier uso, debe realizar una configuración inicial accediendo a los “Settings” del plugin e indicando:

• Issuer ID: Su ID del emisor, disponible en la interfaz de administración de BCdiploma.
• API key: Una clave de API de “publicación” generada en la sección API del backoffice de BCdiploma para el entorno con el que desea interactuar.
• Environment: El entorno con el que desea interactuar (producción o staging, si dispone de él).
• Categories: Categorías que permiten caracterizar la actividad. Este campo es opcional; si se deja vacío, no se creará ninguna categoría. Introduzca una categoría por línea. Ejemplo:

Certificate of Completion

Certificate of Participation

Para obtener su clave de API y su ID del emisor, consulte este artículo.

Configuración y opciones

Añada una actividad “BCdiploma certificate” en un curso para poder generar automáticamente certificados para los participantes de ese curso, y complete los siguientes campos:

• Auto-generate certificates on completion: Si esta opción está activada, los certificados se generarán automáticamente, mediante una tarea cron, en cuanto se levanten las restricciones de la actividad para el beneficiario. Si esta opción no está activada, el certificado se generará cuando el participante acceda a la pestaña de la actividad de su curso (por supuesto, únicamente si se han levantado todas las restricciones de la actividad para él).
• Template to use for certificate generation: La plantilla que se utilizará para la generación de certificados.
• Category: Opcional, permite caracterizar la actividad.
• Automatic emailing: Si esta opción está activada, el certificado se enviará automáticamente al usuario por correo electrónico. Los parámetros de envío (asunto, remitente, etc.) deben configurarse previamente en la interfaz de administración de BCdiploma.
• Expiration date: permite, de forma opcional, especificar una fecha de vencimiento fija - On date - o relativa a la fecha de emisión de los certificados - After (days).

Funcionamiento

Una vez configurada la actividad, todo beneficiario inscrito en el curso, activo y que haya levantado todas sus restricciones dispondrá de un certificado BCdiploma para la plantilla configurada en las opciones de la actividad. El alumno podrá consultar este certificado desde la pestaña de la actividad BCdiploma certificate:

Y también podrá consultarse desde el informe del profesor, para todos los beneficiarios que hayan obtenido un certificado:

Desde esta pantalla, el profesor podrá visualizar, enviar por correo electrónico o eliminar de forma individual el certificado de un beneficiario.

Comportamiento esperado de la opción Auto-generate certificates on completion

La opción Auto-generate certificates on completion permite generar automáticamente, en segundo plano, los certificados de los usuarios para los que se han levantado todas las restricciones de una actividad. Es importante subrayar que, sea cual sea el valor de esta opción, no se generará ningún certificado si quedan restricciones pendientes para el participante en la actividad.

Le recomendamos encarecidamente que establezca la opción “Auto-generate certificates on completion” en “Sí” para que la experiencia del alumno sea más fluida. Esto permite, en particular, el envío automático de los certificados por correo electrónico en cuanto se generan.

Este es el comportamiento esperado del plugin de Moodle en función de si esta opción está activada o no:

• Opción “Auto-generate certificates on completion” en “No”: el certificado se genera en el momento en que el alumno accede a la página del certificado de la actividad; un indicador de carga (spinner) le hace esperar unos segundos mientras se crea el documento.
• Opción “Auto-generate certificates on completion” en “Sí”: el certificado se genera automáticamente en un plazo de 2 a 3 minutos después de que se levanten las restricciones para el alumno, mediante una tarea en segundo plano (CRON). En este caso:
  • Si el alumno accede a la página del certificado antes de ese plazo, se muestra un mensaje que indica un tiempo de espera (2 minutos como máximo).
  • Si el alumno accede a la página después de ese plazo, el certificado está disponible de inmediato (puesto que ya se ha generado automáticamente).

Preguntas frecuentes

¿Por qué mis certificados no se generan automáticamente aunque he activado la opción Auto-generate certificates on completion en la configuración de la actividad?

Debe comprobar los siguientes puntos:

• El curso aún no ha comenzado o ha expirado: no se generará ningún certificado para este curso
• La plantilla seleccionada en la actividad en cuestión se ha desactivado en el backoffice de BCdiploma: por lo tanto, ya no es posible generar certificados con esta plantilla
• Los participantes del curso no son “Student” en el sentido de Moodle, por lo que no se generará ningún certificado para ellos
• Compruebe que la configuración inicial del plugin sigue siendo correcta (véase más arriba)
• Podría haber errores en la ejecución de la tarea “CRON” que genera los certificados en segundo plano. Si existen, estos errores se encontrarán en los registros (logs) de esta tarea, accesibles mediante Site administration | Server | Scheduled task | Issue certificates - BCdiploma certificate, botón log. Compruebe en estos registros que la causa no sea un problema de configuración o de conectividad (p. ej.: clave de API no válida, entorno elegido incorrecto).

Un alumno ha modificado su nombre o su apellido en su perfil de Moodle. ¿Cómo se actualizará su certificado?

Si un alumno modifica su nombre o su apellido en su perfil de Moodle, aparecerá automáticamente un botón de regeneración en la página del certificado de su curso. Al hacer clic en este botón, podrá generar un nuevo certificado que refleje su identidad actualizada.

Obtengo un error 4XX al generar un certificado, ¿por qué?

Un error 4XX (p. ej.: “403 - Access Denied”) se debe generalmente a un problema de autenticación durante los intercambios con la API de BCdiploma. Hay varias posibilidades:

• No ha indicado ninguna clave de API en la configuración del plugin BCdiploma para Moodle
• La clave de API ya no es válida porque usted u otro usuario ha regenerado otra clave de API del mismo nivel (la clave anterior se invalida entonces automáticamente por motivos de seguridad)
• La clave de API se generó en un entorno distinto del seleccionado en Moodle (p. ej.: ha generado una clave en staging y ha seleccionado “DEV” como “Environment” en la configuración del plugin BCdiploma para Moodle)
• La clave de API utilizada no tiene permisos suficientes (el nivel “solo lectura” es insuficiente)
• La plantilla seleccionada en la actividad en cuestión se ha desactivado en el backoffice de BCdiploma: por lo tanto, ya no es posible generar certificados con esta plantilla

Versiones

Leyenda

+ Nueva funcionalidad

* Mejora

- Corrección

v2026062600

+ Compatibilidad con Moodle 5.X

+ Compatibilidad con el entorno PROD-US (api-cus.bcdiploma.com)

+ Advertencia de confirmación al guardar la actividad cuando la generación automática está activada

v2026042800

+ Gestión opcional de la fecha de vencimiento de los certificados en la configuración de la actividad

* Optimización de la tarea programada de generación de certificados

v2026030600

* Mejora del mensaje de espera durante la preparación de los certificados y del mensaje que indica que los certificados solo se generan para las personas con el rol “estudiante”

* Actualización del año del copyright a 2026

v2026021700

* Los usuarios (profesores o administradores) que no son estudiantes ya no generan certificados automáticamente al consultar la actividad: se les muestra un mensaje que lo indica

* A partir de ahora, en los registros (logs) de las tareas CRON solo se trazan los cursos con una actividad bcdiplomacert activa y los usuarios con un certificado por generar

* Cambio del mensaje de espera que indica que la generación está en curso por un mensaje menos engañoso cuando los tiempos de procesamiento son más largos de lo previsto

* Optimización de la tarea programada de generación para procesar únicamente los cursos que tienen una actividad BCdiploma

* A partir de ahora, si la generación automática de certificados no está activada en la actividad, el certificado se generará sobre la marcha cuando un estudiante acceda a la página de consulta del certificado con el parámetro “downloadown=1”

* Adición de un indicador Ⓐ en la página “My digital certificates” que señala que la generación de certificados es automática (si la opción _Auto-generate certificates on completion_ está activada en la actividad)

- La tarea CRON ya no se interrumpe por completo cuando se produce un error 4XX

- Se ha resuelto el error “A required parameter (id) was missing” desde el menú “My digital certificates”. Se debía a que el certificado aún no se había recuperado en Moodle, aunque la solicitud de emisión ya se había enviado a las API de BCdiploma. A partir de ahora, no se puede hacer clic en el botón de acceso al certificado mientras el certificado no esté realmente disponible

- Corrección de la advertencia de PHP “Undefined variable $userid” que podía producirse al consultar un certificado

v2026012000

+ Nueva página “My digital certificates” accesible desde el perfil de usuario, que permite acceder a todos los certificados emitidos anteriormente para el estudiante (my_certificates.php)

* Optimización del uso de recursos durante las llamadas a la API

- Corrección de una llamada a la API que podía generar errores 4XX en determinadas configuraciones

- Corrección del nombre del campo evidenzid en el modelo de datos de Moodle

- Corrección del mecanismo de regeneración automática de los certificados cuando el estudiante ha cambiado de nombre o de apellido

v2025121600

- En determinadas configuraciones, el indicador de carga del certificado gira de forma continua sin llegar a mostrar el certificado del beneficiario.

v2025121200

- En determinadas configuraciones, el indicador de carga del certificado gira de forma continua sin llegar a mostrar el certificado del profesor.

v2025121000

- Corrección del error “Uncaught ReferenceError: $ is not defined” que se producía en determinadas configuraciones al acceder a la actividad bcdiplomacert

v2025120500

- Uso de una URL relativa en lugar de una URL escrita directamente en el código, que impedía la visualización de los certificados generados

- Al hacer clic en el botón de envío de correos electrónicos en la página del informe, se volvía a la parte superior de la página

* Minificación de los archivos fuente JS

* Actualización de una versión de esquema obsoleta

v2025112400

* Generar automáticamente un nuevo certificado para los profesores cuando se ha modificado la plantilla en la actividad

v2025111901

+ Nuevo plugin de Moodle para automatizar la expedición de certificados desde el LMS Moodle