Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Forum thread subscription

From MoodleDocs


Warning: This page is no longer in use. The information contained on the page should NOT be seen as relevant or reliable.


Result

Result of operation will be the patch which will make changes to system Moodle forum unit. Changes add possibility of a subscription to separate discussion of a forum.

The description of changes

Visual changes in the interface the following

  • on page with the table of branches of a forum the new column "Subscribed" with the graphics image, the symbolizing current status of a subscription to each discussion will be added. The image will accept two states symbolizing the fact of a subscription to a current branch. If the current user is subscribed on discussion a column "Subscribed" will contain the following image: subscribed.png, if it is not subscribed, the column "Subscribed" will contain the following image:unsubscribed.png. If the subscription is issued on all forum the column "Subscribed" won't be displayed;

DiscussionsList.png

  • on page of review of discussion of a forum in the unit of adjustments (Settings) the new point will be added «Subscribe to this discussion».

SettingsBlock.png

Data representation

The following information is necessary for storage of a subscription to forum discussion:

  • the discussion identifier;
  • a user id.

In a DB the table containing the fields set forth above will be added. The table will have the name «forum_discuss_subscriptions». Changes in install.xml and upgrade.php will be made.

DatabaseModel.png

Changes on the form of settings of a forum (/mod/forum/mod_form.php)

The parameter "Subscription mode" will contain following options:

  1. Forum optional subscription (discussion subscription disabled)
  2. Forum optional subscription (discussion subscription enabled)
  3. Forum forced subscription
  4. Forum auto subscription (discussion subscription disabled)
  5. Forum auto subscription (discussion subscription enabled)
  6. Forum subscription disabled

The remark: It has been added two new options (point 2 and 5). Remaining options fulfill the same role as earlier (names of options only are changed).

Changes on the form of the publication of a post (/mod/forum/post_form.php)

The parameter "Subscription" will contain following options:

  1. I don't want email copies of posts to this forum or discussion
  2. Send me email copies of posts to this forum
  3. Send me email copies of posts to this discussion

The remark: The option "Send me email copies of posts to this discussion" (point 3) has been added. At the publication of a post with parameter "Subscription" equal to point 3, attempt of a subscription to discussion in which the post is published will be produced.

Response to change of a mode of a subscription

Removal of subscriptions to all discussions the form is produced at passage of a mode of a forum in one of following modes:

  • Forum optional subscription (discussion subscription disabled)
  • Forum forced subscription
  • Forum auto subscription (discussion subscription disabled)
  • Forum subscription disabled

The remark: In system adjustments of the unit the option is added "Remove subscriptions to the discussion". The option defines necessity of removal of subscriptions to discussions at passage in the modes set forth above. If the option matters FALSE, subscriptions to discussions will be saved at passage in the modes set forth above.