Add hook at the end of the quiz - refs BT#16791

main/exercise/exercise_result.php

@@ -199,6 +199,10 @@ if (!empty($learnpath_id) && $saveResults) {
     Exercise::saveExerciseInLp($learnpath_item_id, $exe_id);
 }
 
+$hookQuizEnd = HookQuizEnd::create();
+$hookQuizEnd->setEventData(['exe_id' => $exe_id]);
+$hookQuizEnd->notifyQuizEnd();
+
 // Unset session for clock time
 ExerciseLib::exercise_time_control_delete(
     $objExercise->id,

main/inc/lib/hook/HookQuizEnd.php

@@ -0,0 +1,29 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+/**
+ * Class HookQuizEnd.
+ */
+class HookQuizEnd extends HookEvent implements HookQuizEndEventInterface
+{
+    /**
+     * HookQuizEnd constructor.
+     *
+     * @throws Exception
+     */
+    protected function __construct()
+    {
+        parent::__construct('HookQuizEnd');
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function notifyQuizEnd()
+    {
+        /** @var HookQuizEndObserverInterface $observer */
+        foreach ($this->observers as $observer) {
+            $observer->hookQuizEnd($this);
+        }
+    }
+}

main/inc/lib/hook/interfaces/HookQuizEndEventInterface.php

@@ -0,0 +1,13 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+/**
+ * Interface HookQuizEndEventInterface.
+ */
+interface HookQuizEndEventInterface extends HookEventInterface
+{
+    /**
+     * @return void
+     */
+    public function notifyQuizEnd();
+}

main/inc/lib/hook/interfaces/HookQuizEndObserverInterface.php

@@ -0,0 +1,15 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+/**
+ * Interface HookQuizEndObserverInterface.
+ */
+interface HookQuizEndObserverInterface
+{
+    /**
+     * @param HookQuizEndEventInterface $hookvent
+     *
+     * @return mixed
+     */
+    public function hookQuizEnd(HookQuizEndEventInterface $hookvent);
+}