Add events for adding and deleting certificates (#675)

Author: fulldecent

classes/event/certificate_deleted.php

@@ -0,0 +1,72 @@
+<?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/>.
+
+/**
+ * Event triggered when a certificate issue is deleted.
+ *
+ * @package   mod_customcert
+ * @copyright 2025 William Entriken <@fulldecent>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_customcert\event;
+
+/**
+ * Event triggered when a certificate issue is deleted.
+ *
+ * @package   mod_customcert
+ * @copyright 2025 William Entriken <@fulldecent>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class certificate_deleted extends \core\event\base {
+
+    /**
+     * Initialises the event.
+     *
+     */
+    protected function init() {
+        $this->data['crud'] = 'd'; // A 'delete' operation.
+        $this->data['edulevel'] = self::LEVEL_OTHER; // Not teaching, participation, etc.
+        $this->data['objecttable'] = 'customcert_issues'; // The DB table this event pertains to.
+    }
+
+    /**
+     * Returns the localized name of the event.
+     *
+     * @return string
+     */
+    public static function get_name() {
+        return get_string('eventcertificatedeleted', 'mod_customcert');
+    }
+
+    /**
+     * Returns a description of the event for logging/debugging.
+     *
+     * @return string
+     */
+    public function get_description() {
+        return "The certificate issue with id '{$this->objectid}' was deleted, from user with id '{$this->relateduserid}'.";
+    }
+
+    /**
+     * Returns a relevant URL for viewing more information about the event.
+     *
+     * @return \moodle_url
+     */
+    public function get_url() {
+        return new \moodle_url('/mod/customcert/view.php', ['id' => $this->contextinstanceid]);
+    }
+}

classes/event/certificate_issued.php

@@ -0,0 +1,71 @@
+<?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/>.
+
+/**
+ * Event class for when a custom certificate is issued to a user.
+ *
+ * @package   mod_customcert
+ * @copyright 2025 William Entriken <@fulldecent>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_customcert\event;
+
+/**
+ * Event class for when a custom certificate is issued to a user.
+ *
+ * @package   mod_customcert
+ * @copyright 2025 William Entriken <@fulldecent>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class certificate_issued extends \core\event\base {
+
+    /**
+     * Initialises the event.
+     */
+    protected function init() {
+        $this->data['crud'] = 'c'; // A 'create' operation.
+        $this->data['edulevel'] = self::LEVEL_OTHER; // Not teaching, participation, etc.
+        $this->data['objecttable'] = 'customcert_issues'; // The DB table this event pertains to.
+    }
+
+    /**
+     * Returns the localized event name.
+     *
+     * @return string The name of the event.
+     */
+    public static function get_name() {
+        return get_string('eventcertificateissued', 'mod_customcert');
+    }
+
+    /**
+     * Returns a description of what happened.
+     *
+     * @return string A detailed description of the event.
+     */
+    public function get_description() {
+        return "The user with id '{$this->userid}' was issued a custom certificate with issue id '{$this->objectid}'.";
+    }
+
+    /**
+     * Returns the URL relevant to the event.
+     *
+     * @return \moodle_url A URL to view the certificate or related activity.
+     */
+    public function get_url() {
+        return new \moodle_url('/mod/customcert/view.php', ['id' => $this->contextinstanceid]);
+    }
+}

lang/en/customcert.php

@@ -122,6 +122,8 @@
 $string['eventtemplatecreated'] = 'Custom certificate template created';
 $string['eventtemplatedeleted'] = 'Custom certificate template deleted';
 $string['eventtemplateupdated'] = 'Custom certificate template updated';
+$string['eventcertificateupdated'] = 'Certificate updated';
+$string['eventcertificatedeleted'] = 'Certificate deleted';
 $string['exampledatawarning'] = 'Some of these values may just be an example to ensure positioning of the elements is possible.';
 $string['font'] = 'Font';
 $string['font_help'] = 'The font used when generating this element.';

lib.php

@@ -467,7 +467,7 @@ function generate_public_url_for_certificate(string $cert_code): string {
  * It prevents unauthorized access by ensuring that only valid certificates can
  * be accessed through a generated URL.
  *
- * The signature is generated using the HMAC (Hash-based Message Authentication Code) 
+ * The signature is generated using the HMAC (Hash-based Message Authentication Code)
  * method with SHA-256, ensuring strong security. It uses Moodle's `siteidentifier`
  * as the secret key, making it unique to each Moodle installation.
  *