MDL-75146 mod_data: add a manager class

2022-07-22 07:27:40 +02:00
parent 4ce642e8ba
commit c6db008496
8 changed files with 406 additions and 138 deletions
@@ -0,0 +1,170 @@
+<?php
+// This file is part of Moodle - http://moodle.org/
+//
+// Moodle is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// Moodle is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
+
+namespace mod_data;
+
+use context_module;
+use cm_info;
+use completion_info;
+use mod_data\event\course_module_viewed;
+use mod_data\event\template_viewed;
+use stdClass;
+
+/**
+ * Class manager for database activity
+ *
+ * @package    mod_data
+ * @copyright  2022 Ferran Recio <[email protected]>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class manager {
+
+    /** Module name. */
+    const MODULE = 'data';
+
+    /** Pluginname name. */
+    const PLUGIN = 'mod_data';
+
+    /** @var stdClass course_module record. */
+    private $instance;
+
+    /** @var context_module the current context. */
+    private $context;
+
+    /** @var cm_info course_modules record. */
+    private $cm;
+
+    /**
+     * Class contructor.
+     *
+     * @param cm_info $cm course module info object
+     * @param stdClass $instance activity instance object.
+     */
+    public function __construct(cm_info $cm, stdClass $instance) {
+        $this->cm = $cm;
+        $this->instance = $instance;
+        $this->context = context_module::instance($cm->id);
+        $this->instance->cmidnumber = $cm->idnumber;
+    }
+
+    /**
+     * Create a manager instance from an instance record.
+     *
+     * @param stdClass $instance a activity record
+     * @return manager
+     */
+    public static function create_from_instance(stdClass $instance): self {
+        $cm = get_coursemodule_from_instance(self::MODULE, $instance->id);
+        // Ensure that $this->cm is a cm_info object.
+        $cm = cm_info::create($cm);
+        return new self($cm, $instance);
+    }
+
+    /**
+     * Create a manager instance from an course_modules record.
+     *
+     * @param stdClass|cm_info $cm a activity record
+     * @return manager
+     */
+    public static function create_from_coursemodule($cm): self {
+        global $DB;
+        // Ensure that $this->cm is a cm_info object.
+        $cm = cm_info::create($cm);
+        $instance = $DB->get_record(self::MODULE, ['id' => $cm->instance], '*', MUST_EXIST);
+        return new self($cm, $instance);
+    }
+
+    /**
+     * Create a manager instance from a data_record entry.
+     *
+     * @param stdClass $record the data_record record
+     * @return manager
+     */
+    public static function create_from_data_record($record): self {
+        global $DB;
+        $instance = $DB->get_record(self::MODULE, ['id' => $record->dataid], '*', MUST_EXIST);
+        $cm = get_coursemodule_from_instance(self::MODULE, $instance->id);
+        $cm = cm_info::create($cm);
+        return new self($cm, $instance);
+    }
+
+    /**
+     * Return the current context.
+     *
+     * @return context_module
+     */
+    public function get_context(): context_module {
+        return $this->context;
+    }
+
+    /**
+     * Return the current instance.
+     *
+     * @return stdClass the instance record
+     */
+    public function get_instance(): stdClass {
+        return $this->instance;
+    }
+
+    /**
+     * Return the current cm_info.
+     *
+     * @return cm_info the course module
+     */
+    public function get_coursemodule(): cm_info {
+        return $this->cm;
+    }
+
+    /**
+     * Trigger module viewed event and set the module viewed for completion.
+     *
+     * @param stdClass $course course object
+     */
+    public function set_module_viewed(stdClass $course) {
+        global $CFG;
+        require_once($CFG->libdir . '/completionlib.php');
+
+        // Trigger module viewed event.
+        $event = course_module_viewed::create([
+            'objectid' => $this->instance->id,
+            'context' => $this->context,
+        ]);
+        $event->add_record_snapshot('course', $course);
+        $event->add_record_snapshot('course_modules', $this->cm);
+        $event->add_record_snapshot(self::MODULE, $this->instance);
+        $event->trigger();
+
+        // Completion.
+        $completion = new completion_info($course);
+        $completion->set_module_viewed($this->cm);
+    }
+
+    /**
+     * Trigger module template viewed event.
+     */
+    public function set_template_viewed() {
+        // Trigger an event for viewing templates.
+        $event = template_viewed::create([
+            'context' => $this->context,
+            'courseid' => $this->cm->course,
+            'other' => [
+                'dataid' => $this->instance->id,
+            ],
+        ]);
+        $event->add_record_snapshot(self::MODULE, $this->instance);
+        $event->trigger();
+    }
+}