Si estás utilizando Tutor LMS y en algún momento necesitas eliminar a un usuario de un curso de forma manual o automática, puedes hacerlo con una función integrada que Tutor LMS nos ofrece. Aquí te explico cómo puedes lograrlo con una simple línea de código.
La función cancel_course_enrol()
Tutor LMS incluye la función tutor_utils()->cancel_course_enrol($course_id, $user_id, "delete");, que te permite eliminar la inscripción de un usuario de un curso en específico. Solo necesitas proporcionar tres datos:
- ID del curso: El curso del cual quieres eliminar al usuario.
- ID del usuario: El usuario que quieres eliminar del curso.
- Acción: En este caso, la acción es «delete» para eliminar la inscripción.
Ejemplo de uso:
Supongamos que el usuario con ID 123 está inscrito en el curso con ID 456 y necesitas eliminarlo del curso. El código sería así:
$user_id = 123; // ID del usuario
$course_id = 456; // ID del curso
// Eliminar al usuario del curso
tutor_utils()->cancel_course_enrol($course_id, $user_id, "delete");Con este código, el usuario quedará eliminado del curso de forma rápida y sin complicaciones. Es una herramienta útil si necesitas gestionar inscripciones de manera más directa o automatizada.
¿Cuándo utilizar esta función?
Es posible que quieras usar esta función si:
- Necesitas automatizar la eliminación de inscripciones por razones administrativas.
- Tienes usuarios que han completado o abandonado un curso, y quieres ajustar sus inscripciones.
- Prefieres gestionar inscripciones con código en lugar de usar la interfaz de Tutor LMS.