// (C) Copyright 2015 Martin Dougiamas // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. import { Injectable, Injector } from '@angular/core'; import { AddonCourseCompletionProvider } from './coursecompletion'; import { CoreCourseProvider } from '@core/course/providers/course'; import { CoreCourseOptionsHandler, CoreCourseOptionsHandlerData } from '@core/course/providers/options-delegate'; import { AddonCourseCompletionReportComponent } from '../components/report/report'; /** * Handler to inject an option into the course main menu. */ @Injectable() export class AddonCourseCompletionCourseOptionHandler implements CoreCourseOptionsHandler { name = 'AddonCourseCompletion'; priority = 200; constructor(private courseCompletionProvider: AddonCourseCompletionProvider) {} /** * Whether or not the handler is enabled on a site level. * @return {boolean|Promise} Whether or not the handler is enabled on a site level. */ isEnabled(): boolean | Promise { return this.courseCompletionProvider.isPluginViewEnabled(); } /** * Whether or not the handler is enabled for a certain course. * * @param {number} courseId The course ID. * @param {any} accessData Access type and data. Default, guest, ... * @param {any} [navOptions] Course navigation options for current user. See CoreCoursesProvider.getUserNavigationOptions. * @param {any} [admOptions] Course admin options for current user. See CoreCoursesProvider.getUserAdministrationOptions. * @return {boolean|Promise} True or promise resolved with true if enabled. */ isEnabledForCourse(courseId: number, accessData: any, navOptions?: any, admOptions?: any): boolean | Promise { if (accessData && accessData.type == CoreCourseProvider.ACCESS_GUEST) { return false; // Not enabled for guests. } return this.courseCompletionProvider.isPluginViewEnabledForCourse(courseId).then((courseEnabled) => { // If is not enabled in the course, is not enabled for the user. if (!courseEnabled) { return false; } // Check if the user can see his own report, teachers can't. return this.courseCompletionProvider.isPluginViewEnabledForUser(courseId); }); } /** * Returns the data needed to render the handler. * * @param {number} courseId The course ID. * @return {CoreCourseOptionsHandlerData} Data. */ getDisplayData?(injector: Injector, courseId: number): CoreCourseOptionsHandlerData { return { title: 'addon.coursecompletion.completionmenuitem', class: 'addon-coursecompletion-course-handler', component: AddonCourseCompletionReportComponent, }; } /** * Should invalidate the data to determine if the handler is enabled for a certain course. * * @param {number} courseId The course ID. * @param {any} [navOptions] Course navigation options for current user. See CoreCoursesProvider.getUserNavigationOptions. * @param {any} [admOptions] Course admin options for current user. See CoreCoursesProvider.getUserAdministrationOptions. * @return {Promise} Promise resolved when done. */ invalidateEnabledForCourse(courseId: number, navOptions?: any, admOptions?: any): Promise { return this.courseCompletionProvider.invalidateCourseCompletion(courseId); } /** * Called when a course is downloaded. It should prefetch all the data to be able to see the addon in offline. * * @param {any} course The course. * @return {Promise} Promise resolved when done. */ prefetch(course: any): Promise { return this.courseCompletionProvider.getCompletion(course.id, undefined, { getFromCache: false, emergencyCache: false }); } }