// (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 { Injector } from '@angular/core'; import { TranslateService } from '@ngx-translate/core'; import { AddonModAssignFeedbackHandler } from '../providers/feedback-delegate'; /** * Base handler for feedback plugins. * * This class is needed because parent classes cannot have @Injectable in Angular v6, so the default handler cannot be a * parent class. */ export class AddonModAssignBaseFeedbackHandler implements AddonModAssignFeedbackHandler { name = 'AddonModAssignBaseFeedbackHandler'; type = 'base'; constructor(protected translate: TranslateService) { } /** * Discard the draft data of the feedback plugin. * * @param {number} assignId The assignment ID. * @param {number} userId User ID. * @param {string} [siteId] Site ID. If not defined, current site. * @return {void|Promise} If the function is async, it should return a Promise resolved when done. */ discardDraft(assignId: number, userId: number, siteId?: string): void | Promise { // Nothing to do. } /** * Return the Component to use to display the plugin data. * It's recommended to return the class of the component, but you can also return an instance of the component. * * @param {Injector} injector Injector. * @param {any} plugin The plugin object. * @return {any|Promise} The component (or promise resolved with component) to use, undefined if not found. */ getComponent(injector: Injector, plugin: any): any | Promise { // Nothing to do. } /** * Return the draft saved data of the feedback plugin. * * @param {number} assignId The assignment ID. * @param {number} userId User ID. * @param {string} [siteId] Site ID. If not defined, current site. * @return {any|Promise} Data (or promise resolved with the data). */ getDraft(assignId: number, userId: number, siteId?: string): any | Promise { // Nothing to do. } /** * Get files used by this plugin. * The files returned by this function will be prefetched when the user prefetches the assign. * * @param {any} assign The assignment. * @param {any} submission The submission. * @param {any} plugin The plugin object. * @param {string} [siteId] Site ID. If not defined, current site. * @return {any[]|Promise} The files (or promise resolved with the files). */ getPluginFiles(assign: any, submission: any, plugin: any, siteId?: string): any[] | Promise { return []; } /** * Get a readable name to use for the plugin. * * @param {any} plugin The plugin object. * @return {string} The plugin name. */ getPluginName(plugin: any): string { // Check if there's a translated string for the plugin. const translationId = 'addon.mod_assign_feedback_' + plugin.type + '.pluginname', translation = this.translate.instant(translationId); if (translationId != translation) { // Translation found, use it. return translation; } // Fallback to WS string. if (plugin.name) { return plugin.name; } } /** * Check if the feedback data has changed for this plugin. * * @param {any} assign The assignment. * @param {any} submission The submission. * @param {any} plugin The plugin object. * @param {any} inputData Data entered by the user for the feedback. * @return {boolean|Promise} Boolean (or promise resolved with boolean): whether the data has changed. */ hasDataChanged(assign: any, submission: any, plugin: any, inputData: any): boolean | Promise { return false; } /** * Check whether the plugin has draft data stored. * * @param {number} assignId The assignment ID. * @param {number} userId User ID. * @param {string} [siteId] Site ID. If not defined, current site. * @return {boolean|Promise} Boolean or promise resolved with boolean: whether the plugin has draft data. */ hasDraftData(assignId: number, userId: number, siteId?: string): boolean | Promise { return false; } /** * Whether or not the handler is enabled on a site level. * * @return {boolean|Promise} True or promise resolved with true if enabled. */ isEnabled(): boolean | Promise { return true; } /** * Prefetch any required data for the plugin. * This should NOT prefetch files. Files to be prefetched should be returned by the getPluginFiles function. * * @param {any} assign The assignment. * @param {any} submission The submission. * @param {any} plugin The plugin object. * @param {string} [siteId] Site ID. If not defined, current site. * @return {Promise} Promise resolved when done. */ prefetch(assign: any, submission: any, plugin: any, siteId?: string): Promise { return Promise.resolve(); } /** * Prepare and add to pluginData the data to send to the server based on the draft data saved. * * @param {number} assignId The assignment ID. * @param {number} userId User ID. * @param {any} plugin The plugin object. * @param {any} pluginData Object where to store the data to send. * @param {string} [siteId] Site ID. If not defined, current site. * @return {void|Promise} If the function is async, it should return a Promise resolved when done. */ prepareFeedbackData(assignId: number, userId: number, plugin: any, pluginData: any, siteId?: string): void | Promise { // Nothing to do. } /** * Save draft data of the feedback plugin. * * @param {number} assignId The assignment ID. * @param {number} userId User ID. * @param {any} plugin The plugin object. * @param {any} data The data to save. * @param {string} [siteId] Site ID. If not defined, current site. * @return {void|Promise} If the function is async, it should return a Promise resolved when done. */ saveDraft(assignId: number, userId: number, plugin: any, data: any, siteId?: string): void | Promise { // Nothing to do. } }