From 98d642c7a97f036c3600655831e3845591937b8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luca=20B=C3=B6sch?= <luca.boesch@bfh.ch>
Date: Fri, 29 Oct 2021 16:07:56 +0200
Subject: [PATCH] Begin develop subscription like forum.

---
 .../moodle2/backup_pdfannotator_stepslib.php  |   2 +-
 classes/existing_subscriber_selector.php      |  69 ++
 classes/output/comment.php                    | 130 ++-
 classes/output/index.php                      |   3 +
 classes/potential_subscriber_selector.php     | 163 ++++
 classes/subscriber_selector_base.php          |  87 ++
 classes/subscriptions.php                     | 884 ++++++++++++++++++
 db/install.xml                                |   1 +
 db/upgrade.php                                |  15 +
 lang/en/pdfannotator.php                      |  13 +
 lib.php                                       |  20 +
 locallib.php                                  |  13 +
 mod_form.php                                  |  27 +-
 model/comment.class.php                       |   9 +-
 settings.php                                  |   9 +-
 templates/comment.mustache                    | 120 ++-
 templates/index.mustache                      |  32 +-
 tests/behat/add_pdfannotator.feature          |  31 +
 tests/behat/annotate_pdfannotator.feature     | 114 +++
 tests/behat/behat_pdfannotator_editpdf.php    |  59 ++
 tests/fixtures/submission.pdf                 | Bin 0 -> 24751 bytes
 version.php                                   |  62 +-
 22 files changed, 1758 insertions(+), 105 deletions(-)
 create mode 100644 classes/existing_subscriber_selector.php
 create mode 100644 classes/potential_subscriber_selector.php
 create mode 100644 classes/subscriber_selector_base.php
 create mode 100644 classes/subscriptions.php
 create mode 100644 tests/behat/add_pdfannotator.feature
 create mode 100644 tests/behat/annotate_pdfannotator.feature
 create mode 100644 tests/behat/behat_pdfannotator_editpdf.php
 create mode 100644 tests/fixtures/submission.pdf

diff --git a/backup/moodle2/backup_pdfannotator_stepslib.php b/backup/moodle2/backup_pdfannotator_stepslib.php
index 5160537..7102adb 100644
--- a/backup/moodle2/backup_pdfannotator_stepslib.php
+++ b/backup/moodle2/backup_pdfannotator_stepslib.php
@@ -55,7 +55,7 @@ protected function define_structure() {
         // 2. Define each element separately.
         $pdfannotator = new backup_nested_element('pdfannotator', array('id'), array(
             'name', 'intro', 'introformat', 'usevotes', 'useprint', 'useprintcomments', 'use_studenttextbox', 'use_studentdrawing',
-            'useprivatecomments', 'useprotectedcomments', 'timecreated', 'timemodified'));
+            'useprotectedcomments', 'useprivatecomments', 'forcesubscribe', 'timecreated', 'timemodified'));
 
             $annotations = new backup_nested_element('annotations');
             $annotation = new backup_nested_element('annotation', array('id'), array('page', 'userid', 'annotationtypeid',
diff --git a/classes/existing_subscriber_selector.php b/classes/existing_subscriber_selector.php
new file mode 100644
index 0000000..b4e2f5b
--- /dev/null
+++ b/classes/existing_subscriber_selector.php
@@ -0,0 +1,69 @@
+<?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/>.
+
+/**
+ * A type of pdfannotator.
+ *
+ * @package    mod_pdfannotator
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+require_once($CFG->dirroot.'/user/selector/lib.php');
+
+/**
+ * User selector control for removing subscribed users
+ * @package   mod_pdfannotator
+ * @copyright 2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class mod_pdfannotator_existing_subscriber_selector extends mod_pdfannotator_subscriber_selector_base {
+
+    /**
+     * Finds all subscribed users
+     *
+     * @param string $search
+     * @return array
+     */
+    public function find_users($search) {
+        global $DB;
+        list($wherecondition, $params) = $this->search_sql($search, 'u');
+        $params['pdfannotatorid'] = $this->pdfannotatorid;
+
+        // Only active enrolled or everybody on the frontpage.
+        list($esql, $eparams) = get_enrolled_sql($this->context, '', $this->currentgroup, true);
+        $fields = $this->required_fields_sql('u');
+        list($sort, $sortparams) = users_order_by_sql('u', $search, $this->accesscontext);
+        $params = array_merge($params, $eparams, $sortparams);
+
+        $subscribers = $DB->get_records_sql("SELECT $fields
+                                               FROM {user} u
+                                               JOIN ($esql) je ON je.id = u.id
+                                               JOIN {pdfannotator_subscriptions} s ON s.userid = u.id
+                                              WHERE $wherecondition AND s.pdfannotator = :pdfannotatorid
+                                           ORDER BY $sort", $params);
+
+        $cm = get_coursemodule_from_instance('pdfannotator', $this->pdfannotatorid);
+        $modinfo = get_fast_modinfo($cm->course);
+        $info = new \core_availability\info_module($modinfo->get_cm($cm->id));
+        $subscribers = $info->filter_user_list($subscribers);
+
+        return array(get_string("existingsubscribers", 'pdfannotator') => $subscribers);
+    }
+
+}
diff --git a/classes/output/comment.php b/classes/output/comment.php
index b212b83..1551c10 100644
--- a/classes/output/comment.php
+++ b/classes/output/comment.php
@@ -29,16 +29,22 @@
  */
 class comment implements \renderable, \templatable {
 
+    /**
+     * @var array An array of comments
+     */
     private $comments = [];
+
+    /**
+     * @var bool Visibility of a question
+     */
     private $questionvisibility;
 
     /**
      * Constructor of renderable for comments.
      *
-     * @param object $data Comment or array of comments
-     * @param object $cm Course module
+     * @param stdClass $data Comment or array of comments
+     * @param stdClass $cm course module object
      * @param object $context Context
-     * @return type
      */
     public function __construct($data, $cm, $context) {
         global $USER;
@@ -46,7 +52,6 @@ public function __construct($data, $cm, $context) {
         if (!is_array($data)) {
             $data = [$data];
         }
-
         $report = has_capability('mod/pdfannotator:report', $context);
         $closequestion = has_capability('mod/pdfannotator:closequestion', $context);
         $closeanyquestion = has_capability('mod/pdfannotator:closeanyquestion', $context);
@@ -83,7 +88,7 @@ public function __construct($data, $cm, $context) {
             $this->addeditbutton($comment, $editanypost);
             $this->addhidebutton($comment, $seehiddencomments, $hidecomments);
             $this->adddeletebutton($comment, $deleteown, $deleteany);
-            $this->addsubscribebutton($comment, $subscribe);
+            $this->addsubscribebutton($comment, $subscribe, $cm);
             $this->addforwardbutton($comment, $forwardquestions, $cm);
             $this->addmarksolvedbutton($comment, $solve);
 
@@ -94,8 +99,8 @@ public function __construct($data, $cm, $context) {
             }
 
             if (!empty($comment->modifiedby) && ($comment->modifiedby != $comment->userid) && ($comment->userid != 0)) {
-                $comment->modifiedby = get_string('modifiedby', 'pdfannotator') . ' '.
-                    pdfannotator_get_username($comment->modifiedby);
+                $comment->modifiedby = get_string('modifiedby', 'pdfannotator') . ' ' .
+                pdfannotator_get_username($comment->modifiedby);
             } else {
                 $comment->modifiedby = null;
             }
@@ -112,8 +117,9 @@ public function __construct($data, $cm, $context) {
     /**
      * This function is required by any renderer to retrieve the data structure
      * passed into the template.
+     *
      * @param \renderer_base $output
-     * @return type
+     * @return stdClass
      */
     public function export_for_template(\renderer_base $output) {
         $data = [];
@@ -121,6 +127,12 @@ public function export_for_template(\renderer_base $output) {
         return $data;
     }
 
+    /**
+     * Add css class to a comment
+     *
+     * @param object $comment
+     * @param bool $owner
+     */
     private function addcssclasses($comment, $owner) {
         $comment->wrapperClass = 'chat-message comment-list-item';
         if ($comment->isquestion) {
@@ -136,6 +148,12 @@ private function addcssclasses($comment, $owner) {
         }
     }
 
+    /**
+     * Set votes to a comment
+     *
+     * @param object $comment
+     * @throws \coding_exception
+     */
     public function setvotes($comment) {
         if ($comment->usevotes && !$comment->isdeleted) {
             if ($comment->owner) {
@@ -163,7 +181,8 @@ public function setvotes($comment) {
 
     /**
      * Add check icon if comment is marked as correct.
-     * @param type $comment
+     *
+     * @param object $comment
      */
     public function addsolvedicon($comment) {
         if ($comment->solved) {
@@ -179,9 +198,10 @@ public function addsolvedicon($comment) {
 
     /**
      * Report comment if user is not the owner.
-     * @param type $comment
-     * @param type $owner
-     * @param type $report
+     *
+     * @param object $comment
+     * @param bool $report
+     * @param stdClass $cm course module object
      */
     private function addreportbutton($comment, $report, $cm) {
         if (!$comment->isdeleted && $report && !$comment->owner && !isset($comment->type)) {
@@ -193,10 +213,11 @@ private function addreportbutton($comment, $report, $cm) {
 
     /**
      * Open/close question if user is owner of the question or manager.
-     * @param type $comment
-     * @param type $owner
-     * @param type $closequestion
-     * @param type $closeanyquestion
+     *
+     * @param object $comment
+     * @param bool $closequestion
+     * @param bool $closeanyquestion
+     * @throws \coding_exception
      */
     private function addcloseopenbutton($comment, $closequestion, $closeanyquestion) {
 
@@ -215,9 +236,10 @@ private function addcloseopenbutton($comment, $closequestion, $closeanyquestion)
 
     /**
      * Button for editing comment if user is owner of the comment or manager.
-     * @param type $comment
-     * @param type $owner
-     * @param type $editanypost
+     *
+     * @param object $comment
+     * @param bool $editanypost
+     * @throws \coding_exception
      */
     private function addeditbutton($comment, $editanypost) {
         if (!$comment->isdeleted && !isset($comment->type) && ($comment->owner || $editanypost)) {
@@ -228,6 +250,14 @@ private function addeditbutton($comment, $editanypost) {
         }
     }
 
+    /**
+     * Add a hide button
+     *
+     * @param object $comment
+     * @param bool $seehiddencomments
+     * @param bool $hidecomments
+     * @throws \coding_exception
+     */
     private function addhidebutton($comment, $seehiddencomments, $hidecomments) {
         // Don't need to hide personal notes.
         if ($this->questionvisibility == 'private') {
@@ -257,32 +287,53 @@ private function addhidebutton($comment, $seehiddencomments, $hidecomments) {
 
     /**
      * Delete comment if user is owner of the comment or manager.
-     * @param type $comment
-     * @param type $owner
-     * @param type $deleteown
-     * @param type $deleteany
+     *
+     * @param object $comment
+     * @param bool $deleteown
+     * @param bool $deleteany
+     * @throws \coding_exception
      */
     private function adddeletebutton($comment, $deleteown, $deleteany) {
         if (!$comment->isdeleted && ($deleteany || ($deleteown && $comment->owner))) {
             $comment->buttons[] = ["classes" => "comment-delete-a", "text" => get_string('delete', 'pdfannotator'),
                 "moodleicon" => ["key" => "delete", "component" => "pdfannotator",
-                    "title" => get_string('delete', 'pdfannotator')]];
+                "title" => get_string('delete', 'pdfannotator')]];
         }
     }
 
-    private function addsubscribebutton($comment, $subscribe) {
+    /**
+     * Add a subscribe button
+     *
+     * @param object $comment
+     * @param bool $subscribe
+     * @param stdClass $cm course module object
+     * @throws \coding_exception
+     */
+    private function addsubscribebutton($comment, $subscribe, $cm) {
         if (!isset($comment->type) && $comment->isquestion && $subscribe && $comment->visibility != 'private') {
-            // Only set for textbox and drawing.
-            if (!empty($comment->issubscribed)) {
-                $comment->buttons[] = ["classes" => "comment-subscribe-a", "faicon" => ["class" => "fa-bell-slash"],
-                    "text" => get_string('unsubscribeQuestion', 'pdfannotator')];
-            } else {
-                $comment->buttons[] = ["classes" => "comment-subscribe-a", "faicon" => ["class" => "fa-bell"],
-                    "text" => get_string('subscribeQuestion', 'pdfannotator')];
+            // Only set for textbox and drawing, and only if subscription mode is not disabled or forced.
+            if ((pdfannotator_get_subscriptionmode($cm->instance) == PDFANNOTATOR_CHOOSESUBSCRIBE) ||
+                (pdfannotator_get_subscriptionmode($cm->instance) == PDFANNOTATOR_INITIALSUBSCRIBE)) {
+                if (!empty($comment->issubscribed)) {
+                    $comment->buttons[] = ["classes" => "comment-subscribe-a", "faicon" => ["class" => "fa-bell-slash"],
+                        "text" => get_string('unsubscribeQuestion', 'pdfannotator')];
+                } else {
+                    $comment->buttons[] = ["classes" => "comment-subscribe-a", "faicon" => ["class" => "fa-bell"],
+                        "text" => get_string('subscribeQuestion', 'pdfannotator')];
+                }
             }
         }
     }
 
+    /**
+     * Add a forward button
+     *
+     * @param object $comment
+     * @param bool $forwardquestions
+     * @param stdClass $cm course module object
+     * @throws \coding_exception
+     * @throws \moodle_exception
+     */
     private function addforwardbutton($comment, $forwardquestions, $cm) {
         if (!isset($comment->type) && $comment->isquestion && !$comment->isdeleted && $forwardquestions &&
             $comment->visibility != 'private') {
@@ -291,22 +342,29 @@ private function addforwardbutton($comment, $forwardquestions, $cm) {
             $url = new moodle_url($CFG->wwwroot . '/mod/pdfannotator/view.php', $urlparams);
 
             $comment->buttons[] = ["classes" => "comment-forward-a", "attributes" => ["name" => "onclick",
-                "value" => "window.location.href = '$url';"], "faicon" => ["class" => "fa-share"],
-                "text" => get_string('forward', 'pdfannotator')];
+                "value" => "window.location.href = '$url';"],
+                "faicon" => ["class" => "fa-share"], "text" => get_string('forward', 'pdfannotator')];
         }
     }
 
+    /**
+     * Add a Mark as correct or a Remove mark as correct button
+     *
+     * @param object $comment
+     * @param bool $solve
+     * @throws \coding_exception
+     */
     private function addmarksolvedbutton($comment, $solve) {
         if ($solve && !$comment->isquestion && !$comment->isdeleted && !isset($comment->type) &&
             $this->questionvisibility != 'private') {
             if ($comment->solved) {
                 $comment->buttons[] = ["classes" => "comment-solve-a", "text" => get_string('removeCorrect', 'pdfannotator'),
                     "moodleicon" => ["key" => "i/completion-manual-n", "component" => "core",
-                        "title" => get_string('removeCorrect', 'pdfannotator')]];
+                    "title" => get_string('removeCorrect', 'pdfannotator')]];
             } else {
                 $comment->buttons[] = ["classes" => "comment-solve-a", "text" => get_string('markCorrect', 'pdfannotator'),
                     "moodleicon" => ["key" => "i/completion-manual-enabled", "component" => "core",
-                        "title" => get_string('markCorrect', 'pdfannotator')]];
+                    "title" => get_string('markCorrect', 'pdfannotator')]];
             }
         }
     }
diff --git a/classes/output/index.php b/classes/output/index.php
index 846bc3e..c37c480 100644
--- a/classes/output/index.php
+++ b/classes/output/index.php
@@ -44,6 +44,7 @@ class index implements \renderable, \templatable { // Class should be placed els
     private $printurl;
     private $useprivatecomments;
     private $useprotectedcomments;
+    private $forcesubscribe;
 
     public function __construct($pdfannotator, $capabilities, $file) {
 
@@ -55,6 +56,7 @@ public function __construct($pdfannotator, $capabilities, $file) {
         $this->useprintcomments = ($pdfannotator->useprintcomments || $capabilities->useprintcomments);
         $this->useprivatecomments = $pdfannotator->useprivatecomments;
         $this->useprotectedcomments = $pdfannotator->useprotectedcomments;
+        $this->forcesubscribe = $pdfannotator->forcesubscribe;
 
         $contextid = $file->get_contextid();
         $component = $file->get_component();
@@ -85,6 +87,7 @@ public function export_for_template(\renderer_base $output) {
         if ($data->useprivatecomments) {
             $data->privatehelpicon = $OUTPUT->help_icon('private_comments', 'mod_pdfannotator');
         }
+        $data->forcesubscribe = $this->forcesubscribe;
         $data->printlink = $this->printurl;
         $data->pixprintdoc = $OUTPUT->image_url('download', 'mod_pdfannotator');
         $data->pixprintcomments = $OUTPUT->image_url('print_comments', 'mod_pdfannotator');
diff --git a/classes/potential_subscriber_selector.php b/classes/potential_subscriber_selector.php
new file mode 100644
index 0000000..704864e
--- /dev/null
+++ b/classes/potential_subscriber_selector.php
@@ -0,0 +1,163 @@
+<?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/>.
+
+/**
+ * A type of pdfannotator.
+ *
+ * @package    mod_pdfannotator
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+require_once($CFG->dirroot.'/user/selector/lib.php');
+
+/**
+ * A user selector control for potential subscribers to the selected pdfannotator
+ * @package   mod_pdfannotator
+ * @copyright 2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class mod_pdfannotator_potential_subscriber_selector extends mod_pdfannotator_subscriber_selector_base {
+    /**
+     * If set to true EVERYONE in this course is force subscribed to this pdfannotator
+     * @var bool
+     */
+    protected $forcesubscribed = false;
+
+    /**
+     * Can be used to store existing subscribers so that they can be removed from
+     * the potential subscribers list
+     *
+     * @var array
+     */
+    protected $existingsubscribers = array();
+
+    /**
+     * Constructor method
+     * @param string $name
+     * @param array $options
+     */
+    public function __construct($name, $options) {
+        parent::__construct($name, $options);
+        if (isset($options['forcesubscribed'])) {
+            $this->forcesubscribed = true;
+        }
+    }
+
+    /**
+     * Returns an array of options for this control
+     * @return array
+     */
+    protected function get_options() {
+        $options = parent::get_options();
+        if ($this->forcesubscribed === true) {
+            $options['forcesubscribed'] = 1;
+        }
+        return $options;
+    }
+
+    /**
+     * Finds all potential users
+     *
+     * Potential subscribers are all enroled users who are not already subscribed.
+     *
+     * @param string $search
+     * @return array
+     */
+    public function find_users($search) {
+        global $DB;
+
+        $whereconditions = array();
+        list($wherecondition, $params) = $this->search_sql($search, 'u');
+        if ($wherecondition) {
+            $whereconditions[] = $wherecondition;
+        }
+
+        if (!$this->forcesubscribed) {
+            $existingids = array();
+            foreach ($this->existingsubscribers as $group) {
+                foreach ($group as $user) {
+                    $existingids[$user->id] = 1;
+                }
+            }
+            if ($existingids) {
+                list($usertest, $userparams) = $DB->get_in_or_equal(
+                        array_keys($existingids), SQL_PARAMS_NAMED, 'existing', false);
+                $whereconditions[] = 'u.id ' . $usertest;
+                $params = array_merge($params, $userparams);
+            }
+        }
+
+        if ($whereconditions) {
+            $wherecondition = 'WHERE ' . implode(' AND ', $whereconditions);
+        }
+
+        list($esql, $eparams) = get_enrolled_sql($this->context, '', $this->currentgroup, true);
+        $params = array_merge($params, $eparams);
+
+        $fields      = 'SELECT ' . $this->required_fields_sql('u');
+
+        $sql = " FROM {user} u
+                 JOIN ($esql) je ON je.id = u.id
+                      $wherecondition";
+
+        list($sort, $sortparams) = users_order_by_sql('u', $search, $this->accesscontext);
+        $order = ' ORDER BY ' . $sort;
+
+        $availableusers = $DB->get_records_sql($fields . $sql . $order, array_merge($params, $sortparams));
+
+        $cm = get_coursemodule_from_instance('pdfannotator', $this->pdfannotatorid);
+        $modinfo = get_fast_modinfo($cm->course);
+        $info = new \core_availability\info_module($modinfo->get_cm($cm->id));
+        $availableusers = $info->filter_user_list($availableusers);
+
+        if (empty($availableusers)) {
+            return array();
+        }
+
+        // Check to see if there are too many to show sensibly.
+        if (!$this->is_validating()) {
+            $potentialmemberscount = count($availableusers);
+            if ($potentialmemberscount > $this->maxusersperpage) {
+                return $this->too_many_results($search, $potentialmemberscount);
+            }
+        }
+
+        if ($this->forcesubscribed) {
+            return array(get_string("existingsubscribers", 'pdfannotator') => $availableusers);
+        } else {
+            return array(get_string("potentialsubscribers", 'pdfannotator') => $availableusers);
+        }
+    }
+
+    /**
+     * Sets the existing subscribers
+     * @param array $users
+     */
+    public function set_existing_subscribers(array $users) {
+        $this->existingsubscribers = $users;
+    }
+
+    /**
+     * Sets this pdfannotator as force subscribed or not
+     * @param bool $setting Whether the pdfannotator should be be force subscribed
+     */
+    public function set_force_subscribed($setting=true) {
+        $this->forcesubscribed = true;
+    }
+}
diff --git a/classes/subscriber_selector_base.php b/classes/subscriber_selector_base.php
new file mode 100644
index 0000000..bb78342
--- /dev/null
+++ b/classes/subscriber_selector_base.php
@@ -0,0 +1,87 @@
+<?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/>.
+
+/**
+ * A type of pdfannotator.
+ *
+ * @package    mod_pdfannotator
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+require_once($CFG->dirroot.'/user/selector/lib.php');
+
+/**
+ * Abstract class used by pdfannotator subscriber selection controls
+ * @package   mod_pdfannotator
+ * @copyright 2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+abstract class mod_pdfannotator_subscriber_selector_base extends user_selector_base {
+
+    /**
+     * The id of the pdfannotator this selector is being used for
+     * @var int
+     */
+    protected $pdfannotatorid = null;
+    /**
+     * The context of the pdfannotator this selector is being used for
+     * @var object
+     */
+    protected $context = null;
+    /**
+     * The id of the current group
+     * @var int
+     */
+    protected $currentgroup = null;
+
+    /**
+     * Constructor method
+     * @param string $name
+     * @param array $options
+     */
+    public function __construct($name, $options) {
+        $options['accesscontext'] = $options['context'];
+        parent::__construct($name, $options);
+        if (isset($options['context'])) {
+            $this->context = $options['context'];
+        }
+        if (isset($options['currentgroup'])) {
+            $this->currentgroup = $options['currentgroup'];
+        }
+        if (isset($options['pdfannotatorid'])) {
+            $this->pdfannotatorid = $options['pdfannotatorid'];
+        }
+    }
+
+    /**
+     * Returns an array of options to seralise and store for searches
+     *
+     * @return array
+     */
+    protected function get_options() {
+        global $CFG;
+        $options = parent::get_options();
+        $options['file'] = substr(__FILE__, strlen($CFG->dirroot.'/'));
+        $options['context'] = $this->context;
+        $options['currentgroup'] = $this->currentgroup;
+        $options['pdfannotatorid'] = $this->pdfannotatorid;
+        return $options;
+    }
+
+}
diff --git a/classes/subscriptions.php b/classes/subscriptions.php
new file mode 100644
index 0000000..65ef799
--- /dev/null
+++ b/classes/subscriptions.php
@@ -0,0 +1,884 @@
+<?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/>.
+
+/**
+ * Pdfannotator subscription manager.
+ *
+ * @package    mod_pdfannotator
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_pdfannotator;
+
+defined('MOODLE_INTERNAL') || die();
+
+/**
+ * Pdfannotator subscription manager.
+ *
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class subscriptions {
+
+    /**
+     * The status value for an unsubscribed discussion.
+     *
+     * @var int
+     */
+    const PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED = -1;
+
+    /**
+     * The subscription cache for pdfannotators.
+     *
+     * The first level key is the user ID
+     * The second level is the pdfannotator ID
+     * The Value then is bool for subscribed of not.
+     *
+     * @var array[] An array of arrays.
+     */
+    protected static $pdfannotatorcache = array();
+
+    /**
+     * The list of pdfannotators which have been wholly retrieved for the pdfannotator subscription cache.
+     *
+     * This allows for prior caching of an entire pdfannotator to reduce the
+     * number of DB queries in a subscription check loop.
+     *
+     * @var bool[]
+     */
+    protected static $fetchedpdfannotators = array();
+
+    /**
+     * The subscription cache for pdfannotator discussions.
+     *
+     * The first level key is the user ID
+     * The second level is the pdfannotator ID
+     * The third level key is the discussion ID
+     * The value is then the users preference (int)
+     *
+     * @var array[]
+     */
+    protected static $pdfannotatordiscussioncache = array();
+
+    /**
+     * The list of pdfannotators which have been wholly retrieved for the pdfannotator discussion subscription cache.
+     *
+     * This allows for prior caching of an entire pdfannotator to reduce the
+     * number of DB queries in a subscription check loop.
+     *
+     * @var bool[]
+     */
+    protected static $discussionfetchedpdfannotators = array();
+
+    /**
+     * Whether a user is subscribed to this pdfannotator, or a discussion within
+     * the pdfannotator.
+     *
+     * If a discussion is specified, then report whether the user is
+     * subscribed to posts to this particular discussion, taking into
+     * account the pdfannotator preference.
+     *
+     * If it is not specified then only the pdfannotator preference is considered.
+     *
+     * @param int $userid The user ID
+     * @param \stdClass $pdfannotator The record of the pdfannotator to test
+     * @param int $discussionid The ID of the discussion to check
+     * @param object $cm The coursemodule record. If not supplied, this will be calculated using get_fast_modinfo instead.
+     * @return bool
+     * @throws \coding_exception
+     * @throws \moodle_exception
+     */
+    public static function is_subscribed($userid, $pdfannotator, $discussionid = null, $cm = null) {
+        // If pdfannotator is force subscribed and has allowforcesubscribe, then user is subscribed.
+        if (self::is_forcesubscribed($pdfannotator)) {
+            if (!$cm) {
+                $cm = get_fast_modinfo($pdfannotator->course)->instances['pdfannotator'][$pdfannotator->id];
+            }
+            if (has_capability('mod/pdfannotator:allowforcesubscribe', \context_module::instance($cm->id), $userid)) {
+                return true;
+            }
+        }
+
+        if ($discussionid === null) {
+            return self::is_subscribed_to_pdfannotator($userid, $pdfannotator);
+        }
+
+        $subscriptions = self::fetch_discussion_subscription($pdfannotator->id, $userid);
+
+        // Check whether there is a record for this discussion subscription.
+        if (isset($subscriptions[$discussionid])) {
+            return ($subscriptions[$discussionid] != self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED);
+        }
+
+        return self::is_subscribed_to_pdfannotator($userid, $pdfannotator);
+    }
+
+    /**
+     * Whether a user is subscribed to this pdfannotator.
+     *
+     * @param int $userid The user ID
+     * @param \stdClass $pdfannotator The record of the pdfannotator to test
+     * @return boolean
+     */
+    protected static function is_subscribed_to_pdfannotator($userid, $pdfannotator) {
+        return self::fetch_subscription_cache($pdfannotator->id, $userid);
+    }
+
+    /**
+     * Helper to determine whether a pdfannotator has it's subscription mode set
+     * to forced subscription.
+     *
+     * @param \stdClass $pdfannotator The record of the pdfannotator to test
+     * @return bool
+     */
+    public static function is_forcesubscribed($pdfannotator) {
+        return ($pdfannotator->forcesubscribe == pdfannotator_FORCESUBSCRIBE);
+    }
+
+    /**
+     * Helper to determine whether a pdfannotator has it's subscription mode set to disabled.
+     *
+     * @param \stdClass $pdfannotator The record of the pdfannotator to test
+     * @return bool
+     */
+    public static function subscription_disabled($pdfannotator) {
+        return ($pdfannotator->forcesubscribe == pdfannotator_DISALLOWSUBSCRIBE);
+    }
+
+    /**
+     * Helper to determine whether the specified pdfannotator can be subscribed to.
+     *
+     * @param \stdClass $pdfannotator The record of the pdfannotator to test
+     * @return bool
+     */
+    public static function is_subscribable($pdfannotator) {
+        return (isloggedin() && !isguestuser() &&
+                !self::is_forcesubscribed($pdfannotator) &&
+                !self::subscription_disabled($pdfannotator));
+    }
+
+    /**
+     * Set the pdfannotator subscription mode.
+     *
+     * By default when called without options, this is set to PDFANNOTATOR_FORCESUBSCRIBE.
+     *
+     * @param \stdClass $pdfannotatorid The id of the pdfannotator to set the state
+     * @param int $status The new subscription state
+     * @return bool
+     * @throws \dml_exception
+     */
+    public static function set_subscription_mode($pdfannotatorid, $status = 1) {
+        global $DB;
+        return $DB->set_field("pdfannotator", "forcesubscribe", $status, array("id" => $pdfannotatorid));
+    }
+
+    /**
+     * Returns the current subscription mode for the pdfannotator.
+     *
+     * @param \stdClass $pdfannotator The record of the pdfannotator to set
+     * @return int The pdfannotator subscription mode
+     */
+    public static function get_subscription_mode($pdfannotator) {
+        return $pdfannotator->forcesubscribe;
+    }
+
+    /**
+     * Returns an array of pdfannotators that the current user is subscribed to and is allowed to unsubscribe from
+     *
+     * @return array An array of unsubscribable pdfannotators
+     */
+    public static function get_unsubscribable_pdfannotators() {
+        global $USER, $DB;
+
+        // Get courses that $USER is enrolled in and can see.
+        $courses = enrol_get_my_courses();
+        if (empty($courses)) {
+            return array();
+        }
+
+        $courseids = array();
+        foreach ($courses as $course) {
+            $courseids[] = $course->id;
+        }
+        list($coursesql, $courseparams) = $DB->get_in_or_equal($courseids, SQL_PARAMS_NAMED, 'c');
+
+        // Get all pdfannotators from the user's courses that they are subscribed to and which are not set to forced.
+        // It is possible for users to be subscribed to a pdfannotator in subscription disallowed mode so they must be listed
+        // here so that that can be unsubscribed from.
+        $sql = "SELECT f.id, cm.id as cm, cm.visible, f.course
+                FROM {pdfannotator} f
+                JOIN {course_modules} cm ON cm.instance = f.id
+                JOIN {modules} m ON m.name = :modulename AND m.id = cm.module
+                LEFT JOIN {pdfannotator_subscriptions} fs ON (fs.pdfannotator = f.id AND fs.userid = :userid)
+                WHERE f.forcesubscribe <> :forcesubscribe
+                AND fs.id IS NOT NULL
+                AND cm.course
+                $coursesql";
+        $params = array_merge($courseparams, array(
+            'modulename' => 'pdfannotator',
+            'userid' => $USER->id,
+            'forcesubscribe' => pdfannotator_FORCESUBSCRIBE,
+        ));
+        $pdfannotators = $DB->get_recordset_sql($sql, $params);
+
+        $unsubscribablepdfannotators = array();
+        foreach ($pdfannotators as $pdfannotator) {
+            if (empty($pdfannotator->visible)) {
+                // The pdfannotator is hidden - check if the user can view the pdfannotator.
+                $context = \context_module::instance($pdfannotator->cm);
+                if (!has_capability('moodle/course:viewhiddenactivities', $context)) {
+                    // The user can't see the hidden pdfannotator to cannot unsubscribe.
+                    continue;
+                }
+            }
+
+            $unsubscribablepdfannotators[] = $pdfannotator;
+        }
+        $pdfannotators->close();
+
+        return $unsubscribablepdfannotators;
+    }
+
+    /**
+     * Get the list of potential subscribers to a pdfannotator.
+     *
+     * @param context_module $context the pdfannotator context.
+     * @param integer $groupid the id of a group, or 0 for all groups.
+     * @param string $fields the list of fields to return for each user. As for get_users_by_capability.
+     * @param string $sort sort order. As for get_users_by_capability.
+     * @return array list of users.
+     */
+    public static function get_potential_subscribers($context, $groupid, $fields, $sort = '') {
+        global $DB;
+
+        // Only active enrolled users or everybody on the frontpage.
+        list($esql, $params) = get_enrolled_sql($context, 'mod/pdfannotator:allowforcesubscribe', $groupid, true);
+        if (!$sort) {
+            list($sort, $sortparams) = users_order_by_sql('u');
+            $params = array_merge($params, $sortparams);
+        }
+
+        $sql = "SELECT $fields
+                FROM {user} u
+                JOIN ($esql) je ON je.id = u.id
+               WHERE u.auth <> 'nologin' AND u.suspended = 0 AND u.confirmed = 1
+            ORDER BY $sort";
+
+        return $DB->get_records_sql($sql, $params);
+    }
+
+    /**
+     * Fetch the pdfannotator subscription data for the specified userid and pdfannotator.
+     *
+     * @param int $pdfannotatorid The pdfannotator to retrieve a cache for
+     * @param int $userid The user ID
+     * @return boolean
+     */
+    public static function fetch_subscription_cache($pdfannotatorid, $userid) {
+        if (isset(self::$pdfannotatorcache[$userid]) && isset(self::$pdfannotatorcache[$userid][$pdfannotatorid])) {
+            return self::$pdfannotatorcache[$userid][$pdfannotatorid];
+        }
+        self::fill_subscription_cache($pdfannotatorid, $userid);
+
+        if (!isset(self::$pdfannotatorcache[$userid]) || !isset(self::$pdfannotatorcache[$userid][$pdfannotatorid])) {
+            return false;
+        }
+
+        return self::$pdfannotatorcache[$userid][$pdfannotatorid];
+    }
+
+    /**
+     * Fill the pdfannotator subscription data for the specified userid and pdfannotator.
+     *
+     * If the userid is not specified, then all subscription data for that pdfannotator is fetched in a single query and used
+     * for subsequent lookups without requiring further database queries.
+     *
+     * @param int $pdfannotatorid The pdfannotator to retrieve a cache for
+     * @param int $userid The user ID
+     * @return void
+     */
+    public static function fill_subscription_cache($pdfannotatorid, $userid = null) {
+        global $DB;
+
+        if (!isset(self::$fetchedpdfannotators[$pdfannotatorid])) {
+            // This pdfannotator has not been fetched as a whole.
+            if (isset($userid)) {
+                if (!isset(self::$pdfannotatorcache[$userid])) {
+                    self::$pdfannotatorcache[$userid] = array();
+                }
+
+                if (!isset(self::$pdfannotatorcache[$userid][$pdfannotatorid])) {
+                    if ($DB->record_exists('pdfannotator_subscriptions', array(
+                        'userid' => $userid,
+                        'pdfannotator' => $pdfannotatorid,
+                    ))) {
+                        self::$pdfannotatorcache[$userid][$pdfannotatorid] = true;
+                    } else {
+                        self::$pdfannotatorcache[$userid][$pdfannotatorid] = false;
+                    }
+                }
+            } else {
+                $subscriptions = $DB->get_recordset('pdfannotator_subscriptions', array(
+                    'pdfannotator' => $pdfannotatorid,
+                ), '', 'id, userid');
+                foreach ($subscriptions as $id => $data) {
+                    if (!isset(self::$pdfannotatorcache[$data->userid])) {
+                        self::$pdfannotatorcache[$data->userid] = array();
+                    }
+                    self::$pdfannotatorcache[$data->userid][$pdfannotatorid] = true;
+                }
+                self::$fetchedpdfannotators[$pdfannotatorid] = true;
+                $subscriptions->close();
+            }
+        }
+    }
+
+    /**
+     * Fill the pdfannotator subscription data for all pdfannotators that the specified userid can subscribe to in the specified
+     * course.
+     *
+     * @param int $courseid The course to retrieve a cache for
+     * @param int $userid The user ID
+     * @return void
+     */
+    public static function fill_subscription_cache_for_course($courseid, $userid) {
+        global $DB;
+
+        if (!isset(self::$pdfannotatorcache[$userid])) {
+            self::$pdfannotatorcache[$userid] = array();
+        }
+
+        $sql = "SELECT
+                    f.id AS pdfannotatorid,
+                    s.id AS subscriptionid
+                FROM {pdfannotator} f
+                LEFT JOIN {pdfannotator_subscriptions} s ON (s.pdfannotator = f.id AND s.userid = :userid)
+                WHERE f.course = :course
+                AND f.forcesubscribe <> :subscriptionforced";
+
+        $subscriptions = $DB->get_recordset_sql($sql, array(
+            'course' => $courseid,
+            'userid' => $userid,
+            'subscriptionforced' => pdfannotator_FORCESUBSCRIBE,
+        ));
+
+        foreach ($subscriptions as $id => $data) {
+            self::$pdfannotatorcache[$userid][$id] = !empty($data->subscriptionid);
+        }
+        $subscriptions->close();
+    }
+
+    /**
+     * Returns a list of user objects who are subscribed to this pdfannotator.
+     *
+     * @param stdClass $pdfannotator The pdfannotator record.
+     * @param int $groupid The group id if restricting subscriptions to a group of users, or 0 for all.
+     * @param context_module $context the pdfannotator context, to save re-fetching it where possible.
+     * @param string $fields requested user fields (with "u." table prefix).
+     * @param boolean $includediscussionsubscriptions Whether to take discussion subscriptions and unsubscriptions into
+     * consideration.
+     * @return array list of users.
+     */
+    public static function fetch_subscribed_users($pdfannotator, $groupid = 0, $context = null, $fields = null,
+            $includediscussionsubscriptions = false) {
+        global $CFG, $DB;
+
+        if (empty($fields)) {
+            $userfieldsapi = \core_user\fields::for_name();
+            $allnames = $userfieldsapi->get_sql('u', false, '', '', false)->selects;
+            $fields = "u.id,
+                       u.username,
+                       $allnames,
+                       u.maildisplay,
+                       u.mailformat,
+                       u.maildigest,
+                       u.imagealt,
+                       u.email,
+                       u.emailstop,
+                       u.city,
+                       u.country,
+                       u.lastaccess,
+                       u.lastlogin,
+                       u.picture,
+                       u.timezone,
+                       u.theme,
+                       u.lang,
+                       u.trackpdfannotators,
+                       u.mnethostid";
+        }
+
+        // Retrieve the pdfannotator context if it wasn't specified.
+        $context = pdfannotator_get_context($pdfannotator->id, $context);
+
+        if (self::is_forcesubscribed($pdfannotator)) {
+            $results = self::get_potential_subscribers($context, $groupid, $fields, "u.email ASC");
+
+        } else {
+            // Only active enrolled users or everybody on the frontpage.
+            list($esql, $params) = get_enrolled_sql($context, '', $groupid, true);
+            $params['pdfannotatorid'] = $pdfannotator->id;
+
+            if ($includediscussionsubscriptions) {
+                $params['spdfannotatorid'] = $pdfannotator->id;
+                $params['dspdfannotatorid'] = $pdfannotator->id;
+                $params['unsubscribed'] = self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED;
+
+                $sql = "SELECT $fields
+                        FROM (
+                            SELECT userid FROM {pdfannotator_subscriptions} s
+                            WHERE
+                                s.pdfannotator = :spdfannotatorid
+                                UNION
+                            SELECT userid FROM {pdfannotator_discussion_subs} ds
+                            WHERE
+                                ds.pdfannotator = :dspdfannotatorid AND ds.preference <> :unsubscribed
+                        ) subscriptions
+                        JOIN {user} u ON u.id = subscriptions.userid
+                        JOIN ($esql) je ON je.id = u.id
+                        WHERE u.auth <> 'nologin' AND u.suspended = 0 AND u.confirmed = 1
+                        ORDER BY u.email ASC";
+
+            } else {
+                $sql = "SELECT $fields
+                        FROM {user} u
+                        JOIN ($esql) je ON je.id = u.id
+                        JOIN {pdfannotator_subscriptions} s ON s.userid = u.id
+                        WHERE
+                          s.pdfannotator = :pdfannotatorid AND u.auth <> 'nologin' AND u.suspended = 0 AND u.confirmed = 1
+                        ORDER BY u.email ASC";
+            }
+            $results = $DB->get_records_sql($sql, $params);
+        }
+
+        // Guest user should never be subscribed to a pdfannotator.
+        unset($results[$CFG->siteguest]);
+
+        // Apply the activity module availability resetrictions.
+        $cm = get_coursemodule_from_instance('pdfannotator', $pdfannotator->id, $pdfannotator->course);
+        $modinfo = get_fast_modinfo($pdfannotator->course);
+        $info = new \core_availability\info_module($modinfo->get_cm($cm->id));
+        $results = $info->filter_user_list($results);
+
+        return $results;
+    }
+
+    /**
+     * Retrieve the discussion subscription data for the specified userid and pdfannotator.
+     *
+     * This is returned as an array of discussions for that pdfannotator which contain the preference in a stdClass.
+     *
+     * @param int $pdfannotatorid The pdfannotator to retrieve a cache for
+     * @param int $userid The user ID
+     * @return array of stdClass objects with one per discussion in the pdfannotator.
+     */
+    public static function fetch_discussion_subscription($pdfannotatorid, $userid = null) {
+        self::fill_discussion_subscription_cache($pdfannotatorid, $userid);
+
+        if (!isset(self::$pdfannotatordiscussioncache[$userid]) ||
+            !isset(self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid])) {
+            return array();
+        }
+
+        return self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid];
+    }
+
+    /**
+     * Fill the discussion subscription data for the specified userid and pdfannotator.
+     *
+     * If the userid is not specified, then all discussion subscription data for that pdfannotator is fetched in a single query
+     * and used for subsequent lookups without requiring further database queries.
+     *
+     * @param int $pdfannotatorid The pdfannotator to retrieve a cache for
+     * @param int $userid The user ID
+     * @return void
+     */
+    public static function fill_discussion_subscription_cache($pdfannotatorid, $userid = null) {
+        global $DB;
+
+        if (!isset(self::$discussionfetchedpdfannotators[$pdfannotatorid])) {
+            // This pdfannotator hasn't been fetched as a whole yet.
+            if (isset($userid)) {
+                if (!isset(self::$pdfannotatordiscussioncache[$userid])) {
+                    self::$pdfannotatordiscussioncache[$userid] = array();
+                }
+
+                if (!isset(self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid])) {
+                    $subscriptions = $DB->get_recordset('pdfannotator_discussion_subs', array(
+                        'userid' => $userid,
+                        'pdfannotator' => $pdfannotatorid,
+                    ), null, 'id, discussion, preference');
+
+                    self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid] = array();
+                    foreach ($subscriptions as $id => $data) {
+                        self::add_to_discussion_cache($pdfannotatorid, $userid, $data->discussion, $data->preference);
+                    }
+
+                    $subscriptions->close();
+                }
+            } else {
+                $subscriptions = $DB->get_recordset('pdfannotator_discussion_subs', array(
+                    'pdfannotator' => $pdfannotatorid,
+                ), null, 'id, userid, discussion, preference');
+                foreach ($subscriptions as $id => $data) {
+                    self::add_to_discussion_cache($pdfannotatorid, $data->userid, $data->discussion, $data->preference);
+                }
+                self::$discussionfetchedpdfannotators[$pdfannotatorid] = true;
+                $subscriptions->close();
+            }
+        }
+    }
+
+    /**
+     * Add the specified discussion and user preference to the discussion
+     * subscription cache.
+     *
+     * @param int $pdfannotatorid The ID of the pdfannotator that this preference belongs to
+     * @param int $userid The ID of the user that this preference belongs to
+     * @param int $discussion The ID of the discussion that this preference relates to
+     * @param int $preference The preference to store
+     */
+    protected static function add_to_discussion_cache($pdfannotatorid, $userid, $discussion, $preference) {
+        if (!isset(self::$pdfannotatordiscussioncache[$userid])) {
+            self::$pdfannotatordiscussioncache[$userid] = array();
+        }
+
+        if (!isset(self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid])) {
+            self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid] = array();
+        }
+
+        self::$pdfannotatordiscussioncache[$userid][$pdfannotatorid][$discussion] = $preference;
+    }
+
+    /**
+     * Reset the discussion cache.
+     *
+     * This cache is used to reduce the number of database queries when
+     * checking pdfannotator discussion subscription states.
+     */
+    public static function reset_discussion_cache() {
+        self::$pdfannotatordiscussioncache = array();
+        self::$discussionfetchedpdfannotators = array();
+    }
+
+    /**
+     * Reset the pdfannotator cache.
+     *
+     * This cache is used to reduce the number of database queries when
+     * checking pdfannotator subscription states.
+     */
+    public static function reset_pdfannotator_cache() {
+        self::$pdfannotatorcache = array();
+        self::$fetchedpdfannotators = array();
+    }
+
+    /**
+     * Adds user to the subscriber list.
+     *
+     * @param int $userid The ID of the user to subscribe
+     * @param \stdClass $pdfannotator The pdfannotator record for this pdfannotator.
+     * @param \context_module|null $context Module context, may be omitted if not known or if called for the current
+     *      module set in page.
+     * @param boolean $userrequest Whether the user requested this change themselves. This has an effect on whether
+     *     discussion subscriptions are removed too.
+     * @return bool|int Returns true if the user is already subscribed, or the pdfannotator_subscriptions ID if the user was
+     *     successfully subscribed.
+     */
+    public static function subscribe_user($userid, $pdfannotator, $context = null, $userrequest = false) {
+        global $DB;
+
+        if (self::is_subscribed($userid, $pdfannotator)) {
+            return true;
+        }
+
+        $sub = new \stdClass();
+        $sub->userid  = $userid;
+        $sub->pdfannotator = $pdfannotator->id;
+
+        $result = $DB->insert_record("pdfannotator_subscriptions", $sub);
+
+        if ($userrequest) {
+            $discussionsubscriptions = $DB->get_recordset('pdfannotator_discussion_subs', array('userid' => $userid,
+                'pdfannotator' => $pdfannotator->id));
+            $DB->delete_records_select('pdfannotator_discussion_subs',
+                    'userid = :userid AND pdfannotator = :pdfannotatorid AND preference <> :preference', array(
+                        'userid' => $userid,
+                        'pdfannotatorid' => $pdfannotator->id,
+                        'preference' => self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED,
+                    ));
+
+            // Reset the subscription caches for this pdfannotator.
+            // We know that the there were previously entries and there aren't any more.
+            if (isset(self::$pdfannotatordiscussioncache[$userid]) &&
+                isset(self::$pdfannotatordiscussioncache[$userid][$pdfannotator->id])) {
+                foreach (self::$pdfannotatordiscussioncache[$userid][$pdfannotator->id] as $discussionid => $preference) {
+                    if ($preference != self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED) {
+                        unset(self::$pdfannotatordiscussioncache[$userid][$pdfannotator->id][$discussionid]);
+                    }
+                }
+            }
+        }
+
+        // Reset the cache for this pdfannotator.
+        self::$pdfannotatorcache[$userid][$pdfannotator->id] = true;
+
+        $context = pdfannotator_get_context($pdfannotator->id, $context);
+        $params = array(
+            'context' => $context,
+            'objectid' => $result,
+            'relateduserid' => $userid,
+            'other' => array('pdfannotatorid' => $pdfannotator->id),
+
+        );
+        $event  = event\subscription_created::create($params);
+        if ($userrequest && $discussionsubscriptions) {
+            foreach ($discussionsubscriptions as $subscription) {
+                $event->add_record_snapshot('pdfannotator_discussion_subs', $subscription);
+            }
+            $discussionsubscriptions->close();
+        }
+        $event->trigger();
+
+        return $result;
+    }
+
+    /**
+     * Removes user from the subscriber list
+     *
+     * @param int $userid The ID of the user to unsubscribe
+     * @param \stdClass $pdfannotator The pdfannotator record for this pdfannotator.
+     * @param \context_module|null $context Module context, may be omitted if not known or if called for the current
+     *     module set in page.
+     * @param boolean $userrequest Whether the user requested this change themselves. This has an effect on whether
+     *     discussion subscriptions are removed too.
+     * @return boolean Always returns true.
+     */
+    public static function unsubscribe_user($userid, $pdfannotator, $context = null, $userrequest = false) {
+        global $DB;
+
+        $sqlparams = array(
+            'userid' => $userid,
+            'pdfannotator' => $pdfannotator->id,
+        );
+        $DB->delete_records('pdfannotator_digests', $sqlparams);
+
+        if ($pdfannotatorsubscription = $DB->get_record('pdfannotator_subscriptions', $sqlparams)) {
+            $DB->delete_records('pdfannotator_subscriptions', array('id' => $pdfannotatorsubscription->id));
+
+            if ($userrequest) {
+                $discussionsubscriptions = $DB->get_recordset('pdfannotator_discussion_subs', $sqlparams);
+                $DB->delete_records('pdfannotator_discussion_subs',
+                        array('userid' => $userid, 'pdfannotator' => $pdfannotator->id,
+                            'preference' => self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED));
+
+                // We know that the there were previously entries and there aren't any more.
+                if (isset(self::$pdfannotatordiscussioncache[$userid]) &&
+                    isset(self::$pdfannotatordiscussioncache[$userid][$pdfannotator->id])) {
+                    self::$pdfannotatordiscussioncache[$userid][$pdfannotator->id] = array();
+                }
+            }
+
+            // Reset the cache for this pdfannotator.
+            self::$pdfannotatorcache[$userid][$pdfannotator->id] = false;
+
+            $context = pdfannotator_get_context($pdfannotator->id, $context);
+            $params = array(
+                'context' => $context,
+                'objectid' => $pdfannotatorsubscription->id,
+                'relateduserid' => $userid,
+                'other' => array('pdfannotatorid' => $pdfannotator->id),
+
+            );
+            $event = event\subscription_deleted::create($params);
+            $event->add_record_snapshot('pdfannotator_subscriptions', $pdfannotatorsubscription);
+            if ($userrequest && $discussionsubscriptions) {
+                foreach ($discussionsubscriptions as $subscription) {
+                    $event->add_record_snapshot('pdfannotator_discussion_subs', $subscription);
+                }
+                $discussionsubscriptions->close();
+            }
+            $event->trigger();
+        }
+
+        return true;
+    }
+
+    /**
+     * Subscribes the user to the specified discussion.
+     *
+     * @param int $userid The userid of the user being subscribed
+     * @param \stdClass $discussion The discussion to subscribe to
+     * @param \context_module|null $context Module context, may be omitted if not known or if called for the current
+     *     module set in page.
+     * @return boolean Whether a change was made
+     */
+    public static function subscribe_user_to_discussion($userid, $discussion, $context = null) {
+        global $DB;
+
+        // First check whether the user is subscribed to the discussion already.
+        $subscription = $DB->get_record('pdfannotator_discussion_subs', array('userid' => $userid,
+            'discussion' => $discussion->id));
+        if ($subscription) {
+            if ($subscription->preference != self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED) {
+                // The user is already subscribed to the discussion. Ignore.
+                return false;
+            }
+        }
+        // No discussion-level subscription. Check for a pdfannotator level subscription.
+        if ($DB->record_exists('pdfannotator_subscriptions', array('userid' => $userid,
+            'pdfannotator' => $discussion->pdfannotator))) {
+            if ($subscription && $subscription->preference == self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED) {
+                // The user is subscribed to the pdfannotator, but unsubscribed from the discussion, delete the discussion
+                // preference.
+                $DB->delete_records('pdfannotator_discussion_subs', array('id' => $subscription->id));
+                unset(self::$pdfannotatordiscussioncache[$userid][$discussion->pdfannotator][$discussion->id]);
+            } else {
+                // The user is already subscribed to the pdfannotator. Ignore.
+                return false;
+            }
+        } else {
+            if ($subscription) {
+                $subscription->preference = time();
+                $DB->update_record('pdfannotator_discussion_subs', $subscription);
+            } else {
+                $subscription = new \stdClass();
+                $subscription->userid  = $userid;
+                $subscription->pdfannotator = $discussion->pdfannotator;
+                $subscription->discussion = $discussion->id;
+                $subscription->preference = time();
+
+                $subscription->id = $DB->insert_record('pdfannotator_discussion_subs', $subscription);
+                self::$pdfannotatordiscussioncache[$userid][$discussion->pdfannotator][$discussion->id] = $subscription->preference;
+            }
+        }
+
+        $context = pdfannotator_get_context($discussion->pdfannotator, $context);
+        $params = array(
+            'context' => $context,
+            'objectid' => $subscription->id,
+            'relateduserid' => $userid,
+            'other' => array(
+                'pdfannotatorid' => $discussion->pdfannotator,
+                'discussion' => $discussion->id,
+            ),
+
+        );
+        $event  = event\discussion_subscription_created::create($params);
+        $event->trigger();
+
+        return true;
+    }
+    /**
+     * Unsubscribes the user from the specified discussion.
+     *
+     * @param int $userid The userid of the user being unsubscribed
+     * @param \stdClass $discussion The discussion to unsubscribe from
+     * @param \context_module|null $context Module context, may be omitted if not known or if called for the current
+     *     module set in page.
+     * @return boolean Whether a change was made
+     */
+    public static function unsubscribe_user_from_discussion($userid, $discussion, $context = null) {
+        global $DB;
+
+        // First check whether the user's subscription preference for this discussion.
+        $subscription = $DB->get_record('pdfannotator_discussion_subs', array('userid' => $userid,
+            'discussion' => $discussion->id));
+        if ($subscription) {
+            if ($subscription->preference == self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED) {
+                // The user is already unsubscribed from the discussion. Ignore.
+                return false;
+            }
+        }
+        // No discussion-level preference. Check for a pdfannotator level subscription.
+        if (!$DB->record_exists('pdfannotator_subscriptions', array('userid' => $userid,
+            'pdfannotator' => $discussion->pdfannotator))) {
+            if ($subscription && $subscription->preference != self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED) {
+                // The user is not subscribed to the pdfannotator, but subscribed from the discussion, delete the discussion
+                // subscription.
+                $DB->delete_records('pdfannotator_discussion_subs', array('id' => $subscription->id));
+                unset(self::$pdfannotatordiscussioncache[$userid][$discussion->pdfannotator][$discussion->id]);
+            } else {
+                // The user is not subscribed from the pdfannotator. Ignore.
+                return false;
+            }
+        } else {
+            if ($subscription) {
+                $subscription->preference = self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED;
+                $DB->update_record('pdfannotator_discussion_subs', $subscription);
+            } else {
+                $subscription = new \stdClass();
+                $subscription->userid  = $userid;
+                $subscription->pdfannotator = $discussion->pdfannotator;
+                $subscription->discussion = $discussion->id;
+                $subscription->preference = self::PDFANNOTATOR_DISCUSSION_UNSUBSCRIBED;
+
+                $subscription->id = $DB->insert_record('pdfannotator_discussion_subs', $subscription);
+            }
+            self::$pdfannotatordiscussioncache[$userid][$discussion->pdfannotator][$discussion->id] = $subscription->preference;
+        }
+
+        $context = pdfannotator_get_context($discussion->pdfannotator, $context);
+        $params = array(
+            'context' => $context,
+            'objectid' => $subscription->id,
+            'relateduserid' => $userid,
+            'other' => array(
+                'pdfannotatorid' => $discussion->pdfannotator,
+                'discussion' => $discussion->id,
+            ),
+
+        );
+        $event  = event\discussion_subscription_deleted::create($params);
+        $event->trigger();
+
+        return true;
+    }
+
+    /**
+     * Gets the default subscription value for the logged in user.
+     *
+     * @param \stdClass $pdfannotator The pdfannotator record
+     * @param \context $context The course context
+     * @param \cm_info $cm cm_info
+     * @param int|null $discussionid The discussion we are checking against
+     * @return bool Default subscription
+     * @throws coding_exception
+     */
+    public static function get_user_default_subscription($pdfannotator, $context, $cm, ?int $discussionid) {
+        global $USER;
+        $manageactivities = has_capability('moodle/course:manageactivities', $context);
+        if (self::subscription_disabled($pdfannotator) && !$manageactivities) {
+            // User does not have permission to subscribe to this discussion at all.
+            $discussionsubscribe = false;
+        } else if (self::is_forcesubscribed($pdfannotator)) {
+            // User does not have permission to unsubscribe from this discussion at all.
+            $discussionsubscribe = true;
+        } else {
+            if (isset($discussionid) && self::is_subscribed($USER->id, $pdfannotator, $discussionid, $cm)) {
+                // User is subscribed to the discussion - continue the subscription.
+                $discussionsubscribe = true;
+            } else if (!isset($discussionid) && self::is_subscribed($USER->id, $pdfannotator, null, $cm)) {
+                // Starting a new discussion, and the user is subscribed to the pdfannotator - subscribe to the discussion.
+                $discussionsubscribe = true;
+            } else {
+                // User is not subscribed to either pdfannotator or discussion. Follow user preference.
+                $discussionsubscribe = $USER->autosubscribe ?? false;
+            }
+        }
+
+        return $discussionsubscribe;
+    }
+}
diff --git a/db/install.xml b/db/install.xml
index 3324d94..995dfc9 100644
--- a/db/install.xml
+++ b/db/install.xml
@@ -18,6 +18,7 @@
         <FIELD NAME="use_studentdrawing" TYPE="int" LENGTH="2" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
         <FIELD NAME="useprivatecomments" TYPE="int" LENGTH="2" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
         <FIELD NAME="useprotectedcomments" TYPE="int" LENGTH="2" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
+        <FIELD NAME="forcesubscribe" TYPE="int" LENGTH="1" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
         <FIELD NAME="timecreated" TYPE="int" LENGTH="10" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
         <FIELD NAME="timemodified" TYPE="int" LENGTH="10" NOTNULL="true" DEFAULT="0" SEQUENCE="false"/>
       </FIELDS>
diff --git a/db/upgrade.php b/db/upgrade.php
index c623f1f..191110a 100644
--- a/db/upgrade.php
+++ b/db/upgrade.php
@@ -603,5 +603,20 @@ function xmldb_pdfannotator_upgrade($oldversion) {
         upgrade_mod_savepoint(true, 2021032201, 'pdfannotator');
     }
 
+    if ($oldversion < 2021110100) {
+
+        // Define field forcesubscribe to be added to pdfannotator.
+        $table = new xmldb_table('pdfannotator');
+        $field = new xmldb_field('forcesubscribe', XMLDB_TYPE_INTEGER, '1', null, XMLDB_NOTNULL, null, '0', 'useprotectedcomments');
+
+        // Conditionally launch add field forcesubscribe.
+        if (!$dbman->field_exists($table, $field)) {
+            $dbman->add_field($table, $field);
+        }
+
+        // Pdfannotator savepoint reached.
+        upgrade_mod_savepoint(true, 2021110100, 'pdfannotator');
+    }
+
     return true;
 }
diff --git a/lang/en/pdfannotator.php b/lang/en/pdfannotator.php
index f06bb51..2ff2522 100644
--- a/lang/en/pdfannotator.php
+++ b/lang/en/pdfannotator.php
@@ -63,6 +63,7 @@
 $string['comment'] = 'Comment';
 $string['commentDeleted'] = 'Comment has been deleted';
 $string['comments'] = 'Comments';
+$string['configsubscriptiontype'] = 'Default setting for subscription mode.';
 $string['correct'] = 'correct';
 $string['count'] = 'count';
 $string['createAnnotation'] = 'Create Annotation';
@@ -424,6 +425,18 @@
 $string['subscribed'] = 'Subscribed';
 $string['subscribedanswers'] = 'to my subscribed questions';
 $string['subscribeQuestion'] = 'Subscribe';
+$string['subscription'] = 'Subscription';
+$string['subscriptionauto'] = 'Auto subscription';
+$string['subscriptiondisabled'] = 'Subscription disabled';
+$string['subscriptionforced'] = 'Forced subscription';
+$string['subscriptionmode'] = 'Subscription mode';
+$string['subscriptionmode_help'] = 'When a participant is subscribed to a question it means they will receive notifications for questions. There are 4 subscription mode options:
+
+* Auto subscription - Everyone is subscribed initially to notifications for questions but can choose to unsubscribe at any time
+* Optional subscription - Participants can choose whether notifications for questions are subscribed
+* Forced subscription - Everyone is subscribed to notifications for questions and cannot unsubscribe
+* Subscription disabled - Subscriptions to notifications for questions are not allowed';
+$string['subscriptionoptional'] = 'Optional subscription';
 $string['subtitleforreportcommentform'] = 'Your message for the course manager';
 $string['successfullyEdited'] = 'Changes saved';
 $string['successfullyHidden'] = 'Participants now see this comment as hidden.';
diff --git a/lib.php b/lib.php
index 85b0433..81956f8 100644
--- a/lib.php
+++ b/lib.php
@@ -21,6 +21,11 @@
  */
 defined('MOODLE_INTERNAL') || die;
 
+define('PDFANNOTATOR_CHOOSESUBSCRIBE', 0);
+define('PDFANNOTATOR_FORCESUBSCRIBE', 1);
+define('PDFANNOTATOR_INITIALSUBSCRIBE', 2);
+define('PDFANNOTATOR_DISALLOWSUBSCRIBE',3);
+
 /**
  * List of features supported in pdfannotator module
  * @param string $feature FEATURE_xx constant for requested feature
@@ -732,3 +737,18 @@ function pdfannotator_print_recent_mod_activity($activity, $courseid, $detail, $
 
     echo $output;
 }
+
+/**
+ * List the options for pdfannotator subscription modes.
+ * This is used by the settings page and by the mod_form page.
+ *
+ * @return array
+ */
+function pdfannotator_get_subscriptionmode_options() {
+    $options = array();
+    $options[PDFANNOTATOR_INITIALSUBSCRIBE] = get_string('subscriptionauto', 'pdfannotator');
+    $options[PDFANNOTATOR_CHOOSESUBSCRIBE] = get_string('subscriptionoptional', 'pdfannotator');
+    $options[PDFANNOTATOR_FORCESUBSCRIBE] = get_string('subscriptionforced', 'pdfannotator');
+    $options[PDFANNOTATOR_DISALLOWSUBSCRIBE] = get_string('subscriptiondisabled', 'pdfannotator');
+    return $options;
+}
diff --git a/locallib.php b/locallib.php
index e01ead4..0935ca5 100644
--- a/locallib.php
+++ b/locallib.php
@@ -119,6 +119,19 @@ function pdfannotator_get_username($userid) {
     return fullname($user);
 }
 
+/**
+ * Returns the subscription mode for a given pdfannotator
+ *
+ * @param $id The pdfannotator id
+ * @return false|int
+ * @throws dml_exception
+ */
+function pdfannotator_get_subscriptionmode($id) {
+    global $DB;
+    $subscriptionmode = $DB->get_field('pdfannotator', 'forcesubscribe', array('id' => $id), $strictness = MUST_EXIST);
+    return $subscriptionmode;
+}
+
 function pdfannotator_get_annotationtype_id($typename) {
     global $DB;
     if ($typename == 'point') {
diff --git a/mod_form.php b/mod_form.php
index cf4f7fd..ea45421 100644
--- a/mod_form.php
+++ b/mod_form.php
@@ -14,6 +14,8 @@
 // You should have received a copy of the GNU General Public License
 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
 /**
+ * The pdfannotator module form
+ *
  * @package   mod_pdfannotator
  * @copyright 2018 RWTH Aachen (see README.md)
  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
@@ -94,20 +96,20 @@ public function definition() {
         $mform->setDefault('useprint', $config->useprint);
         $mform->addHelpButton('useprint', 'setting_useprint_document', 'pdfannotator');
 
-        $mform->addElement('advcheckbox', 'useprintcomments', get_string('setting_useprint_comments', 'pdfannotator'),
-            get_string('useprint_comments', 'pdfannotator'), null, array(0, 1));
+        $mform->addElement('advcheckbox', 'useprintcomments', get_string('setting_useprint_comments',
+            'pdfannotator'), get_string('useprint_comments', 'pdfannotator'), null, array(0, 1));
         $mform->setType('useprintcomments', PARAM_BOOL);
         $mform->setDefault('useprintcomments', $config->useprintcomments);
         $mform->addHelpButton('useprintcomments', 'setting_useprint_comments', 'pdfannotator');
 
-        $mform->addElement('advcheckbox', 'useprivatecomments', get_string('setting_use_private_comments', 'pdfannotator'),
-            get_string('use_private_comments', 'pdfannotator'), null, array(0, 1));
+        $mform->addElement('advcheckbox', 'useprivatecomments', get_string('setting_use_private_comments',
+            'pdfannotator'), get_string('use_private_comments', 'pdfannotator'), null, array(0, 1));
         $mform->setType('useprivatecomments', PARAM_BOOL);
         $mform->setDefault('useprivatecomments', $config->use_private_comments);
         $mform->addHelpButton('useprivatecomments', 'setting_use_private_comments', 'pdfannotator');
 
-        $mform->addElement('advcheckbox', 'useprotectedcomments', get_string('setting_use_protected_comments', 'pdfannotator'),
-            get_string('use_protected_comments', 'pdfannotator'), null, array(0, 1));
+        $mform->addElement('advcheckbox', 'useprotectedcomments', get_string('setting_use_protected_comments',
+            'pdfannotator'), get_string('use_protected_comments', 'pdfannotator'), null, array(0, 1));
         $mform->setType('useprotectedcomments', PARAM_BOOL);
         $mform->setDefault('useprotectedcomments', $config->use_protected_comments);
         $mform->addHelpButton('useprotectedcomments', 'setting_use_protected_comments', 'pdfannotator');
@@ -119,6 +121,19 @@ public function definition() {
             $mform->addElement('select', 'legacyfiles', get_string('legacyfiles', 'pdfannotator'), $options);
         }
 
+        // Subscription and tracking.
+        $mform->addElement('header', 'subscriptionandtrackinghdr', get_string('subscription', 'pdfannotator'));
+
+        $options = pdfannotator_get_subscriptionmode_options();
+        $mform->addElement('select', 'forcesubscribe', get_string('subscriptionmode', 'pdfannotator'), $options);
+        $mform->addHelpButton('forcesubscribe', 'subscriptionmode', 'pdfannotator');
+        if (isset($CFG->pdfannotator_subscription)) {
+            $defaultpdfannotatorsubscription = $CFG->pdfannotator_subscription;
+        } else {
+            $defaultpdfannotatorsubscription = PDFANNOTATOR_INITIALSUBSCRIBE;
+        }
+        $mform->setDefault('forcesubscribe', $defaultpdfannotatorsubscription);
+
         $this->standard_coursemodule_elements();
 
         $this->add_action_buttons();
diff --git a/model/comment.class.php b/model/comment.class.php
index b282c6b..e6adc7f 100644
--- a/model/comment.class.php
+++ b/model/comment.class.php
@@ -95,7 +95,14 @@ public static function create($documentid, $annotationid, $content, $visibility,
                     }
                 }
             } else if ($visibility != 'private') {
-                self::insert_subscription($annotationid, $context);
+
+                $pdfannotatorid = 1;
+
+                if (!((pdfannotator_get_subscriptionmode($cm->instance) == PDFANNOTATOR_CHOOSESUBSCRIBE) ||
+                    (pdfannotator_get_subscriptionmode($cm->instance) == PDFANNOTATOR_DISALLOWSUBSCRIBE))) {
+                    // Don't insert if subscription mode is Optional subscription or Subscription disabled
+                    self::insert_subscription($annotationid, $context);
+                }
 
                 // Notify all users, that there is a new question.
                 $recipients = get_enrolled_users($context, 'mod/pdfannotator:recievenewquestionnotifications');
diff --git a/settings.php b/settings.php
index d445ca4..4a25a95 100644
--- a/settings.php
+++ b/settings.php
@@ -21,6 +21,8 @@
  */
 defined('MOODLE_INTERNAL') || die; // Prevents crashes on misconfigured production server.
 
+require_once($CFG->dirroot . '/mod/pdfannotator/lib.php');
+
 if ($ADMIN->fulltree) {
     require_once('constants.php');
     $settings->add(new admin_setting_configcheckbox('mod_pdfannotator/usevotes',
@@ -49,7 +51,12 @@
             get_string('global_setting_use_protected_comments', 'pdfannotator'),
             get_string('global_setting_use_protected_comments_desc', 'pdfannotator'), 0));
 
-    // Define what API to use for converting latex formulas into png.
+    // Default Subscription mode setting.
+    $options = pdfannotator_get_subscriptionmode_options();
+    $settings->add(new admin_setting_configselect('pdfannotator_subscription', get_string('subscriptionmode', 'pdfannotator'),
+        get_string('configsubscriptiontype', 'pdfannotator'), PDFANNOTATOR_INITIALSUBSCRIBE, $options));
+
+    //Define what API to use for converting latex formulas into png.
     $options = array();
     $options[LATEX_TO_PNG_MOODLE] = get_string("global_setting_latexusemoodle", "pdfannotator");
     $options[LATEX_TO_PNG_GOOGLE_API] = get_string("global_setting_latexusegoogle", "pdfannotator");
diff --git a/templates/comment.mustache b/templates/comment.mustache
index 68c167e..05eabda 100644
--- a/templates/comment.mustache
+++ b/templates/comment.mustache
@@ -1,3 +1,100 @@
+{{!
+    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/>.
+}}
+{{!
+    @template mod_pdfannotator/comment
+
+    Template which displays a comment.
+
+    Classes required for JS:
+    * none
+
+    Data attributes required for JS:
+    * none
+
+    Example context (json):
+    {
+      "comments": [
+        {
+          "userid": "103",
+          "visibility": "public",
+          "isquestion": true,
+          "annotationid": 1,
+          "annotation": 1,
+          "timecreated": "58 minutes ago",
+          "isdeleted": false,
+          "uuid": "1",
+          "ishidden": 0,
+          "content": "Comment",
+          "username": "me",
+          "solved": false,
+          "votes": "0",
+          "isvoted": false,
+          "usevotes": true,
+          "issubscribed": true,
+          "buttons": [
+            {
+              "classes": "comment-solve-a",
+              "faicon": {
+                "class": "fa-lock"
+              },
+              "text": "Close question"
+            },
+            {
+              "classes": "comment-edit-a",
+              "attributes": {
+                "name": "id",
+                "value": "editButton1"
+              },
+              "moodleicon": {
+                "key": "i/edit",
+                "component": "core",
+                "title": "Edit"
+              },
+              "text": "Edit"
+            },
+            {
+              "classes": "comment-delete-a",
+              "text": "Delete",
+              "moodleicon": {
+                "key": "delete",
+                "component": "pdfannotator",
+                "title": "Delete"
+              }
+            },
+            {
+              "classes": "comment-subscribe-a",
+              "faicon": {
+                "class": "fa-bell-slash"
+              },
+              "text": "Unsubscribe"
+            }
+          ],
+          "owner": true,
+          "private": false,
+          "protected": false,
+          "wrapperClass": "chat-message comment-list-item questioncomment owner usevotes",
+          "voteBtn": "own comment",
+          "voteTitle": "0 persons are also interested in this question",
+          "modifiedby": null,
+          "dropdown": true
+        }
+      ]
+    }
+}}
 {{# comments }}
     <div class="{{ wrapperClass }} {{dimmed}}" id="comment_{{ uuid }}">
 
@@ -10,15 +107,14 @@
                 <div class="countVotes" title="{{ voteTitle }}"> {{{ votes }}} </div>
             {{/ usevotes }} {{/ isdeleted }}
         </div>
- 
+
         <div class="chat-message-container">
 
             <div class="chat-message-meta">
                 {{# dropdown }}
-                    <div class="dropdown">          
+                    <div class="dropdown">
                         <a class="dropdown-toggle" id="dropdownMenuButton" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
-                            <i title="{{# str }} actiondropdown, pdfannotator {{/ str }}" class="icon fa fa-cog fa-fw"></i>
-                        </a>
+                            <i title="{{# str }} actiondropdown, pdfannotator {{/ str }}" class="icon fa fa-cog fa-fw"></i></a>
                         <div class="dropdown-menu dropdown-menu-right">
                             {{# report }}
                                 <span class="comment-report-button">
@@ -28,7 +124,7 @@
                                         <input type="hidden" name="action" value="report">
                                         <input type="hidden" name="id" value="{{ cmid }}">
                                             <button class="dropdown-item comment-report-a" title="{{# str }} toreport, pdfannotator {{/ str }}">
-                                                {{# pix }}flagged,pdfannotator, {{# str }} toreport, pdfannotator {{/ str }} {{/ pix}} {{# str }} toreport, pdfannotator {{/ str }}                                     
+                                                {{# pix }}flagged,pdfannotator, {{# str }} toreport, pdfannotator {{/ str }} {{/ pix}} {{# str }} toreport, pdfannotator {{/ str }}
                                             </button>
                                     </form>
                                 </span>
@@ -45,24 +141,24 @@
                         </div>
                     </div>
                 {{/ dropdown }}
-                {{^ isdeleted }}  
+                {{^ isdeleted }}
                     <span class="time"> {{ timecreated }} </span>
                     <span class="user"> {{ username }} </span>
                 {{/ isdeleted }}
             </div>
-           
+
             <div class="chat-message-text">
                 <div id="chatmessage{{ uuid }}">{{{ content }}}</div>
-                
+
                 {{#displayhidden}}<span id="taghidden{{uuid}}" class="tag tag-info">{{# str }} hiddenforparticipants, pdfannotator {{/ str }}</span>{{/displayhidden}}
-            
+
                 <form id="edit{{ uuid }}" class="edit-comment-form" style="display:none;">
-                    <textarea id="editarea{{ uuid }}" placeholder="" cols="40" rows="3"></textarea>                  
+                    <textarea id="editarea{{ uuid }}" placeholder="" cols="40" rows="3"></textarea>
                     <input id="commentSubmit" class="owner btn btn-primary mb-1" type="submit" value="{{# str }} editButton, pdfannotator {{/ str }}">
                     <input id="commentCancel" class="owner btn btn-secondary mb-1" type="reset" value="{{# str }} cancelButton, pdfannotator {{/ str }}" >
                 </form>
-            
-            </div>            
+
+            </div>
                 {{^ isdeleted }}
                     <em class="edited">
                         {{# edited }}
diff --git a/templates/index.mustache b/templates/index.mustache
index 57c31b8..c869c1d 100644
--- a/templates/index.mustache
+++ b/templates/index.mustache
@@ -5,10 +5,10 @@
 
     <div class="row">
         <div id="pdftoolbar" class="toolbar col-md-12">
-            <div id="toolbarContent"> 
+            <div id="toolbarContent">
                 <button id="pdfannotator_cursor" class="cursor" type="button" title="Cursor" data-tooltype="cursor"><i class="fa fa-hand-pointer-o" aria-hidden="true"></i></button>
                 <div class="spacer"></div>
-                <button class="comment" type="button" title="{{# str }} point, pdfannotator {{/ str }}" data-tooltype="point">{{# pix }}pinbild,pdfannotator, {{# str }} point, pdfannotator {{/ str }} {{/ pix}}</button>           
+                <button class="comment" type="button" title="{{# str }} point, pdfannotator {{/ str }}" data-tooltype="point">{{# pix }}pinbild,pdfannotator, {{# str }} point, pdfannotator {{/ str }} {{/ pix}}</button>
                 <button class="pdfannotator_rectangle" type="button" title="{{# str }} rectangle, pdfannotator {{/ str }}" data-tooltype="area">{{# pix }}i/completion-manual-n,core, {{# str }} rectangle, pdfannotator {{/ str }} {{/ pix}}</button>
                 <button class="pdfannotator_highlight" type="button" title="{{# str }} highlight, pdfannotator {{/ str }}" data-tooltype="highlight">{{# pix }}text_highlight_picker,pdfannotator, {{# str }} highlight, pdfannotator {{/ str }} {{/ pix}}</button>
                 <button class="pdfannotator_strikeout" type="button" title="{{# str }} strikeout, pdfannotator {{/ str }}" data-tooltype="strikeout">{{# pix }}strikethrough,pdfannotator, {{# str }} strikeout, pdfannotator {{/ str }} {{/ pix}}</button>
@@ -35,8 +35,8 @@
                 <span class="toolbaritem">
                     <button id="scaleMinus" class="" title="{{# str }} zoomout, pdfannotator {{/ str }}" alt="{{# str }} zoomout, pdfannotator {{/ str }}">
                         <i class="icon fa fa-minus-circle fa-lg" title="{{# str }} zoomout, pdfannotator {{/ str }}" alt="{{# str }} zoomout, pdfannotator {{/ str }}"></i>
-                    </button><!--
-                 --><button id="scalePlus" class="" title="{{# str }} zoomin, pdfannotator {{/ str }}" alt="{{# str }} zoomin, pdfannotator {{/ str }}">
+                    </button>
+                    <button id="scalePlus" class="" title="{{# str }} zoomin, pdfannotator {{/ str }}" alt="{{# str }} zoomin, pdfannotator {{/ str }}">
                         <i class="icon fa fa-plus-circle fa-lg" title="{{# str }} zoomin, pdfannotator {{/ str }}" alt="{{# str }} zoomin, pdfannotator {{/ str }}"></i>
                     </button>
                 </span>
@@ -61,11 +61,11 @@
                 <span class="toolbaritem">
                     <button id="prevPage" class="" title="{{# str }} prevPage, pdfannotator {{/ str }}" alt="{{# str }} prevPage, pdfannotator {{/ str }}">
                         <i class="icon fa fa-arrow-circle-up fa-lg" title="{{# str }} prevPage, pdfannotator {{/ str }}" alt="{{# str }} prevPage, pdfannotator {{/ str }}"></i>
-                    </button><!--
-                  --><button id="nextPage" class="" title="{{# str }} nextPage, pdfannotator {{/ str }}" alt="{{# str }} nextPage, pdfannotator {{/ str }}">
+                    </button>
+                    <button id="nextPage" class="" title="{{# str }} nextPage, pdfannotator {{/ str }}" alt="{{# str }} nextPage, pdfannotator {{/ str }}">
                         <i class="icon fa fa-arrow-circle-down fa-lg" title="{{# str }} nextPage, pdfannotator {{/ str }}" alt="{{# str }} nextPage, pdfannotator {{/ str }}"></i>
-                     </button>
-                    <input id="currentPage" title="{{# str }} currentPage, pdfannotator {{/ str }}" type="number" min="1" value="1"> / 
+                    </button>
+                    <input id="currentPage" title="{{# str }} currentPage, pdfannotator {{/ str }}" type="number" min="1" value="1"> /
                     <span id="sumPages" title="{{# str }} sumPages, pdfannotator {{/ str }}">1</span>
                 </span>
 
@@ -88,11 +88,11 @@
                 <button id="toolbar-dropdown-button" class="pdf-annotator-hidden" type="button" data-toggle="collapse" data-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
                     <i class="icon fa fa-bars fa-lg"></i>
                 </button>
-            </div>    
+            </div>
             <div class="collapse navbar-collapse" id="navbarNavAltMarkup">
                 <div class="navbar-nav">
                     <div id="toolbar-dropdown-content" class="row">
-                     </div>     
+                     </div>
                 </div>
             </div>
         </div>
@@ -100,7 +100,7 @@
 
 
 
-  
+
     <div class="row-fluid row" id="body-wrapper">
         <div class="span8 col-lg-8" id="content-wrapper">
             <div id="viewer" class="pdfViewer"></div>
@@ -118,11 +118,11 @@
                         <i class="icon fa fa-search fa-fw" title="{{# str }} search, pdfannotator {{/ str }}" alt="{{# str }} search, pdfannotator {{/ str }}"></i>
                     </button>
                     <form id="searchForm">
-                        <input type="search" id="searchPattern" class="form-control" name="pattern" placeholder="{{#str}}search, pdfannotator{{/str}}">      
+                        <input type="search" id="searchPattern" class="form-control" name="pattern" placeholder="{{#str}}search, pdfannotator{{/str}}">
                         <button type="submit" id="searchClear">
                             <i class="icon fa fa-times fa-fw"></i>
                         </button>
-                    </form>                    
+                    </form>
                 </div>
             <div class="comment-list">
                 <div class="comment-list-container">
@@ -130,7 +130,7 @@
                 </div>
                 <form id="comment-list-form" class="comment-list-form" style="display:none;">
 
-                    <textarea id="myarea" placeholder="{{# str }} addAComment, pdfannotator {{/ str }}" cols="40" rows="3"></textarea>                 
+                    <textarea id="myarea" placeholder="{{# str }} addAComment, pdfannotator {{/ str }}" cols="40" rows="3"></textarea>
 
                     <div id="anonymousDiv" class="row-fluid row">
                         <input type="checkbox" name="visibility" value="anonymous" id="anonymousCheckbox" class="pdfannotator-radio" style="width:auto;"><label id="anonymousLabel" for="anonymousCheckbox">{{# str }} sendAnonymous, pdfannotator {{/ str }}</label>
@@ -147,15 +147,13 @@
                         <label id="protectedLabel" for="protectedCheckbox">{{# str }} sendProtected, pdfannotator {{/ str }} </label> {{{protectedhelpicon}}}
                     </div>
                     {{/ useprotectedcomments }}
-                                       
+
                     <input id="commentSubmit" class="owner btn btn-primary mb-1" type="submit" value="{{# str }} answerButton, pdfannotator {{/ str }}">
                     <input id="commentCancel" class="owner btn btn-secondary" type="reset" value="{{# str }} cancelButton, pdfannotator {{/ str }}" >
                 </form>
             </div>
-
         </div>
     </div>
-
 </div>
 
 
diff --git a/tests/behat/add_pdfannotator.feature b/tests/behat/add_pdfannotator.feature
new file mode 100644
index 0000000..85d2952
--- /dev/null
+++ b/tests/behat/add_pdfannotator.feature
@@ -0,0 +1,31 @@
+@mod @mod_pdfannotator @_file_upload
+Feature: Add a pdfannotator activity
+  In order to let the users use the pdfannotator in a course
+  As a teacher
+  I need to add a pdfannotator to a moodle course
+
+  @javascript
+  Scenario: Add a pdfannotator to a course
+    Given the following "users" exist:
+      | username | firstname | lastname | email                |
+      | teacher1 | Teacher   | 1        | teacher1@example.com |
+      | student1 | Student   | 1        | student1@example.com |
+    And the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+    And the following "course enrolments" exist:
+      | user     | course | role           |
+      | teacher1 | C1     | editingteacher |
+      | student1 | C1     | student        |
+    And I log in as "teacher1"
+    And I am on "Course 1" course homepage with editing mode on
+    And I add a "PDF Annotation" to section "1" and I fill the form with:
+      | Name              | Test pdf annotation                                             |
+      | Description       | Test pdf annotation description                                 |
+      | Select a pdf-file | mod/pdfannotator/tests/fixtures/submission.pdf |
+    And I am on "Course 1" course homepage with editing mode on
+    And I log out
+    And I log in as "student1"
+    And I am on "Course 1" course homepage
+    And I follow "Test pdf annotation"
+    Then I should see "Test pdf annotation"
diff --git a/tests/behat/annotate_pdfannotator.feature b/tests/behat/annotate_pdfannotator.feature
new file mode 100644
index 0000000..ebbeaa1
--- /dev/null
+++ b/tests/behat/annotate_pdfannotator.feature
@@ -0,0 +1,114 @@
+@mod @mod_pdfannotator @_file_upload  @javascript
+Feature: Annotate in a pdfannotator activity
+  In order to annotate in the pdfannotator in a course
+  As a student
+  I need to note questions and subscribe or unsubscribe to notificatoins
+
+  Background:
+    Given the following "users" exist:
+      | username | firstname | lastname | email                |
+      | teacher1 | Teacher   | 1        | teacher1@example.com |
+      | student1 | Student   | 1        | student1@example.com |
+    And the following "courses" exist:
+      | fullname | shortname | category |
+      | Course 1 | C1        | 0        |
+    And the following "course enrolments" exist:
+      | user     | course | role           |
+      | teacher1 | C1     | editingteacher |
+      | student1 | C1     | student        |
+    And I log in as "teacher1"
+    And I am on "Course 1" course homepage with editing mode on
+    And I add a "PDF Annotation" to section "1" and I fill the form with:
+      | Name              | Test PDF annotation                            |
+      | Description       | Test pdf annotation description                |
+      | Subscription mode | Optional subscription                          |
+      | Select a pdf-file | mod/pdfannotator/tests/fixtures/submission.pdf |
+    And I am on "Course 1" course homepage with editing mode on
+    And I log out
+
+  Scenario: Add a question to a pdfannotator with optional subscription
+    Given I log in as "student1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I click on "comment" "button"
+    And I wait "1" seconds
+    And I point at the pdfannotator canvas
+    And I wait "1" seconds
+    And I set the field with xpath "//textarea[@id='myarea']" to "This is a smurfing smurf"
+    And I click on "Create Annotation" "button"
+    And I wait until the page is ready
+    And I click the pdfannotator public comment dropdown menu button
+    And I should not see "Unsubscribe"
+    Then I should see "Subscribe"
+    And I log out
+
+  Scenario: Add a question to a pdfannotator with auto subscription
+    Given I log in as "teacher1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I navigate to "Edit settings" in current page administration
+    And I set the following fields to these values:
+      | Subscription mode | Auto subscription |
+    And I press "Save"
+    And I log out
+    And I log in as "student1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I click on "comment" "button"
+    And I wait "1" seconds
+    And I point at the pdfannotator canvas
+    And I wait "1" seconds
+    And I set the field with xpath "//textarea[@id='myarea']" to "This is a smurfing smurf"
+    And I click on "Create Annotation" "button"
+    And I wait until the page is ready
+    And I click the pdfannotator public comment dropdown menu button
+    And I should not see "Subscribe"
+    Then I should see "Unsubscribe"
+    And I log out
+
+  Scenario: Add a question to a pdfannotator with subscription disabled
+    Given I log in as "teacher1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I navigate to "Edit settings" in current page administration
+    And I set the following fields to these values:
+      | Subscription mode | Subscription disabled |
+    And I press "Save"
+    And I log out
+    And I log in as "student1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I click on "comment" "button"
+    And I wait "1" seconds
+    And I point at the pdfannotator canvas
+    And I wait "1" seconds
+    And I set the field with xpath "//textarea[@id='myarea']" to "This is a smurfing smurf"
+    And I click on "Create Annotation" "button"
+    And I wait until the page is ready
+    And I click the pdfannotator public comment dropdown menu button
+    And I should not see "Subscribe"
+    Then I should not see "Unsubscribe"
+    And I log out
+
+  Scenario: Add a question to a pdfannotator with forced subscription
+    Given I log in as "teacher1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I navigate to "Edit settings" in current page administration
+    And I set the following fields to these values:
+      | Subscription mode | Forced subscription |
+    And I press "Save"
+    And I log out
+    And I log in as "student1"
+    And I am on "Course 1" course homepage
+    And I follow "Test PDF annotation"
+    And I click on "comment" "button"
+    And I wait "1" seconds
+    And I point at the pdfannotator canvas
+    And I wait "1" seconds
+    And I set the field with xpath "//textarea[@id='myarea']" to "This is a smurfing smurf"
+    And I click on "Create Annotation" "button"
+    And I wait until the page is ready
+    And I click the pdfannotator public comment dropdown menu button
+    And I should not see "Subscribe"
+    Then I should not see "Unsubscribe"
diff --git a/tests/behat/behat_pdfannotator_editpdf.php b/tests/behat/behat_pdfannotator_editpdf.php
new file mode 100644
index 0000000..9e7a250
--- /dev/null
+++ b/tests/behat/behat_pdfannotator_editpdf.php
@@ -0,0 +1,59 @@
+<?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/>.
+
+/**
+ * Behat pdfannotator-related steps definitions.
+ *
+ * @package    pdfannotator
+ * @category   test
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+// NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
+
+require_once(__DIR__ . '/../../../../lib/behat/behat_base.php');
+
+/**
+ * Steps definitions related with the pdfannotator.
+ *
+ * @package    pdfannotator
+ * @category   test
+ * @copyright  2021 Luca Bösch <luca.boesch@bfh.ch>
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class behat_pdfannotator_editpdf extends behat_base {
+
+    /**
+     * Point at the pdfannotator pdf.
+     *
+     * @When /^I point at the pdfannotator canvas$/
+     */
+    public function i_point_at_the_pdfannotator_canvas() {
+        $node = $this->find('xpath', '//div[@id=\'pageContainer1\']');
+        $this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
+    }
+
+    /**
+     * Point at the pdfannotator pdf.
+     *
+     * @When /^I click the pdfannotator public comment dropdown menu button$/
+     */
+    public function i_click_the_pdfannotator_public_comment_dropdown_menu_button() {
+        $node = $this->find('xpath', '//a[@id=\'dropdownMenuButton\']');
+        $this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
+    }
+}
diff --git a/tests/fixtures/submission.pdf b/tests/fixtures/submission.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..576d37832e921287cfbd2e5f63bdea43534789c9
GIT binary patch
literal 24751
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

literal 0
HcmV?d00001

diff --git a/version.php b/version.php
index 93bb2d7..91c64b4 100644
--- a/version.php
+++ b/version.php
@@ -1,31 +1,31 @@
-<?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/>.
-
-/**
- * Version information for mod/pdfannotator
- *
- * @package   mod_pdfannotator
- * @copyright 2018 RWTH Aachen
- * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
- */
-
-defined('MOODLE_INTERNAL') || die();
-
-$plugin->component = 'mod_pdfannotator';
-$plugin->version   = 2021090100;
-$plugin->release  = 'PDF Annotator v1.4 release 9';
-$plugin->requires  = 2021051700;
-$plugin->maturity  = MATURITY_STABLE;
+<?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/>.
+
+/**
+ * Version information for mod/pdfannotator
+ *
+ * @package   mod_pdfannotator
+ * @copyright 2018 RWTH Aachen
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$plugin->component = 'mod_pdfannotator';
+$plugin->version   = 2021110100;
+$plugin->release  = 'PDF Annotator v1.4 release 9';
+$plugin->requires  = 2021051700;
+$plugin->maturity  = MATURITY_STABLE;