README

A Laravel package for synchronising users with Moodle and retrieve course information.

Installation

composer require networkrailbusinesssystems/laravel-moodle

The package should auto register the service providers.

Migrations

Your User table should include the following columns:

$table
    ->string('email')
    ->unique()
    ->nullable();

$table
    ->unsignedBigInteger('moodle_id')
    ->nullable();

Configuration

Optionally, publish the config file. This is required if you want to customise which user fields are synchronised from your Laravel user model to Moodle.

php artisan vendor:publish

Update your auth.php config file, providers > users > drivers to moodle

Update the .env file with the: MOODLE_BASE_URL with the url of your Moodle installation MOODLE_ADMIN_TOKEN is the token for the authorised Moodle Web Service user.

User Model

When a user is synchronised with Moodle, the package will create the Moodle user if they do not already exist, or update their details if they do.

The Moodle user ID is then stored in the local user's moodle_id field.

To customise which user fields are synchronised from your Laravel user model to Moodle, publish the laravel-moodle config file and update the sync_attributes array.

Middleware

The package provides laravel-moodle middleware to synchronise the authenticated Laravel user with Moodle.

The middleware should be used after the application's user authentication middleware.

Route::get('/', function () {})->middleware('laravel-moodle');

Emulator

An emulator is provided for development purposes, which simulates some of Moodle's endpoint responses.

You can enable it in your application while serving, set the MOODLE_EMULATOR_ENABLED env setting to true.

For unit tests, add NetworkRailBusinessSystems\LaravelMoodle\ServiceProvider::startEmulator() to your setup function.

Moodle Configuration

In order to access data from Moodle, it needs to be configured first as the web service features are disabled by default.

Enable Web Services for mobile devices
- Site Administration > Mobile app > Mobile settings
- Enable web services for mobile devices - yes
- Save changes
Enable Web Services (yes, again)
- Site Administration > Advanced features
- Enable Web Services - yes
- Save changes
Create new webservice
- Site Administration > Plugins > Web services > External Services
- Add Custom Service or use an existing custom service
  - Name: Web Service
  - Short name: web_service
  - Enabled: true
  - Authorised users only: false
  - Can download files: true
  - Save changes
Enable the following functions in the new Moodle web service
- Site Administration > Plugins > Web services > External Services
- On the newly created Web Service, click functions and add the following
  - core_badges_get_user_badges
  - core_calendar_get_calendar_monthly_view
  - core_completion_get_activities_completion_status
  - core_completion_get_course_completion_status
  - core_course_get_categories
  - core_course_get_contents
  - core_course_get_course_module
  - core_course_get_courses
  - core_course_get_courses_by_field
  - core_course_search_courses
  - core_enrol_get_enrolled_users
  - core_enrol_get_users_courses
  - core_user_create_users
  - core_user_get_users
  - core_user_update_users
  - enrol_manual_enrol_users
  - enrol_manual_unenrol_users
  - enrol_self_enrol_user
  - gradereport_overview_get_course_grades
  - mod_assign_get_assignments
  - mod_assign_get_submissions
  - mod_assign_get_submission_status
  - mod_assign_save_submission
  - mod_page_get_pages_by_courses
  - mod_page_view_page
  - mod_resource_get_resources_by_courses
  - mod_resource_view_resource
  - mod_book_get_books_by_courses
  - mod_scorm_get_scorm_scoes
  - mod_scorm_get_scorms_by_courses
Create a token for the admin user (used in the Laravel .env file)
- Site Administration > Plugins > Web services > Manage tokens
- Click Add
  - Search for the admin user you want to use
  - Select your Web Service
  - Save changes
Allow users to create tokens for the new Web Service so they can create a token when they log in
- Site Administration > Users > Define Roles
- Edit Authenticated user
- Capabilities > Create a web service token > Allow
- Save

Endpoints

Use the LaravelMoodle facade to access the web service data.

use NetworkRailBusinessSystems\LaravelMoodle\LaravelMoodle as LaravelMoodle;

The package uses Spatie Data Transfer Objects to format the response into objects.

Create or Update users

Return the Moodle user ID.

$moodleId = LaravelMoodle::syncUser($user, $userKey, $moodleKey);

echo $moodleId; // 123

Search Moodle for an existing user.

Update the Moodle user if one exists.

Create the Moodle user if one does not exist.

Get Courses

Returns a collection of courses.

$data = LaravelMoodle::getCourses();

foreach ($data->courses as $course) {
    echo $course->fullname; // My First Course
}

echo $data->courses[0]->fullname; // My First Course

To filter the list of courses pass in the term and the field. you can use id, ids, shortname and category id.

// Get course with id 3
$data = LaravelMoodle::getCourses('2', 'id');

// Get courses with ids 2 & 3
$data = LaravelMoodle::getCourses('2,3', 'ids');

Get Course By Id

Once you know the course ID (int) you can get a specific course.

$course = LaravelMoodle::getCourse(2);

echo $course->fullname; // My First Course

Search Courses

Pass in your search term as the first parameter (string).

$searchResults = LaravelMoodle::searchCourses('search term');

echo $searchResults->total; // 1
echo $searchResults->courses[0]->fullname; // My First Course

Optionally pass in page number (integer) and per page (integer).

$searchResults = LaravelMoodle::searchCourses('search term', 2, 15);

You can also limit the search to only enrolled courses by specifying 1 as the 4th parameter.

$searchResults = LaravelMoodle::searchCourses('search term', 2, 15, 1);

Get Course Contents By Id

Once you know the course Id you can get the contents of a specific course.

$courseContents = LaravelMoodle::getCourseContents(1);

echo $courseContents[0]->name; // Topic name
echo $courseContents[0]->modules[0]->name; // Activity name

Get Course Module By Id

Once you know the module id from the course contents you can get more details about the module.

$module = LaravelMoodle::getCourseModule(11);

echo $module->cm->name; // Topic name

Get Course Pages

Once you know the course id you can get the pages for the course.

$pages = LaravelMoodle::getCoursePages(1);

echo $pages->pages[0]->name; // Page name

Get Course Page

Get a specific course page by module id.

$page = LaravelMoodle::getCoursePage($courseId, $moduleId);

Get Course Scorms

Once you know the course id you can get the scorms for the course.

$scorms = LaravelMoodle::getCourseScorms(1);

echo $scorms->scorms[0]->name; // Example scorm

Get Course Scorm

Get a specific course scorm by module id.

$scorm = LaravelMoodle::getCourseScorm($courseId, $moduleId);

Get Course Resources

Once you know the course id you can get the resources.

$resources = LaravelMoodle::getCourseResources(1);
echo $resources->resources[0]->name;

Get Course Resource

Get a specific course resource by module id.

$resource = LaravelMoodle::getCourseResource($courseId, $moduleId);

Get Course Completion

You can get the course completion status by passing in the user id and the course id.

$completion = LaravelMoodle::getCourseCompletion(2, 2);

Get Course Activities Completion

You can get details of a course's activities completion by passing in the user id and the course id.

$activities = LaravelMoodle::getCourseActivitiesCompletion(2, 2);

echo $activities->statuses[0]->state;

Get Course Assignments

Get the assignments for a specific course by passing in the course id.

$data = LaravelMoodle::getCourseAssignments(2);

echo $data->courses[0]->assignments[0]->name;
echo $data->courses[0]->assignments[0]->id;

Get Course Assignment

Get a specific course assignment by the module id.

$assignment = LaravelMoodle::getCourseAssignment($courseId, $moduleId);

Get Assignment Submission Status

Provides information on the previous attempts for an assignment. User id is optional as it defaults to the current user.

LaravelMoodle::getAssignmentSubmissionStatus($assignmentId, $userId);

Save Course Assignment

Submit the online text for a specific assignment. Returns true on success.

$submit = LaravelMoodle::saveCourseAssignment($assignmentId, 'The content');

echo $submit; // true

If there is an issue submitting then an array of warnings will be returned, with the error details in the item and message.

$submit = LaravelMoodle::saveCourseAssignment($assignmentId, '');

echo $submit[0]->item; // Nothing was submitted
echo $submit[0]->message; // Could not save submission

Get User Grades

Get the grades for a user. Default to 0 for the current logged in user.

$grades = LaravelMoodle::getUserGrades();

echo $grades->grades[0]->courseid; // 2
echo $grades->grades[0]->grade; // A

Get Course Grade for User

Get the grade for a user for a specific course. Default to 0 for the current logged in user. Returns null for grade if course not found.

$grade = LaravelMoodle::getCourseGrade(2);

echo $grade->courseid; // 2
echo $grade->grade; // A

Search Users

Search for users. Default search field is username if not provided.

// Defaults to searching by username
$users = LaravelMoodle::searchUsers('testuser');

// Override to search by email address
$users = LaravelMoodle::searchUsers('test.user@fake.email', 'email');

echo $users->users[0]->fullname; // Test User

Enrol User On A Course

You can enrol a user onto a course by specifying the user id then the course id. By default they have the student role, but you can specify the role id.

The user performing the call must be an Admin or Manager in Moodle or a teacher in the course.

There is a null response from Moodle when successful, but enrolUserOnCourse returns true when successful and MoodleException if it fails.

// Defaults role to student
LaravelMoodle::enrolUserOnCourse(2, 2);

// Override role to editing teacher
LaravelMoodle::enrolUserOnCourse(2, 2, 3);

Unenrol User On A Course

You can unenrol a user on a course. Role id is not required. It will default to the student role.

LaravelMoodle::unenrolUserOnCourse($userId, $courseId, $roleId);

Get Enrolled Users For A Course

You can get a collection of users enrolled on a course. These are Moodle users and not Laravel user models.

$enrolledUsers = LaravelMoodle::getEnrolledUsersForCourse(2);

echo $enrolledUsers[0]->fullname; // Test User
echo $enrolledUsers[0]->roles[0]->shortname; // Student

Get Categories

Get all categories.

$categories = LaravelMoodle::getCategories();

echo $categories[0]->name; // Category name

Search Categories

Search for categories. Defaults to searching name if second parameter isn't passed. The search term is an exact match only.

$categories = LaravelMoodle::searchCategories('Business Briefing System');

echo $categories[0]->name; // Business Briefing System

View Page Event

Trigger the view page event for activity auto completion. Pass in the page id. Returns true if successful and MoodleException if unsuccessful.

$pageViewed = LaravelMoodle::viewPageEvent(1);

dd($pageViewed); // true

HasDates Trait

The package has a HasDates trait that can be added to FlexibleDataTransferObjects to convert the timestamp from Moodle into a Carbon instance to allow easier formatting for presentation.

$data = LaravelMoodle::getCourses();

$data->courses[0]->asDate('startdate')->format('d/m/Y');
$data->courses[0]->dates()->startdate->format('d/m/Y');
$data->courses[0]->dates()->enddate->format('d/m/Y');

networkrailbusinesssystems / laravel-moodle

Package info

Security

Statistics