/**
* @param array $data Parameters:
* - viewid (int)
* - annotationid (int)
*/
public function __construct($data, $cron = false)
{
parent::__construct($data, $cron);
$annotation = new ArtefactTypeAnnotation($this->annotationid);
$annotationfeedback = new ArtefactTypeAnnotationfeedback($this->annotationfeedbackid);
$this->overridemessagecontents = true;
if ($onartefact = $annotation->get('artefact')) {
// Feedback on artefact.
$userid = null;
require_once get_config('docroot') . 'artefact/lib.php';
$artefactinstance = artefact_instance_from_id($onartefact);
if ($artefactinstance->feedback_notify_owner()) {
$userid = $artefactinstance->get('owner');
$groupid = $artefactinstance->get('group');
$institutionid = $artefactinstance->get('institution');
}
if (empty($this->url)) {
$this->url = 'artefact/artefact.php?artefact=' . $onartefact . '&view=' . $this->viewid;
}
} else {
if ($onview = $annotation->get('view')) {
// Feedback on view.
if (!($viewrecord = get_record('view', 'id', $onview))) {
throw new ViewNotFoundException(get_string('viewnotfound', 'error', $onview));
}
$userid = $viewrecord->owner;
$groupid = $viewrecord->group;
$institutionid = $viewrecord->institution;
if (empty($this->url)) {
$this->url = 'view/view.php?id=' . $onview;
}
} else {
// Something is wrong.
throw new ViewNotFoundException(get_string('invalidannotationfeedbacklinkerror', 'artefact.annotation'));
}
}
// Now fetch the users that will need to get notified about this event
// depending on whether the page has an owner, group, or institution id set.
if (!empty($userid)) {
$this->users = activity_get_users($this->get_id(), array($userid));
} else {
if (!empty($groupid)) {
require_once get_config('docroot') . 'lib/group.php';
$sql = "SELECT u.*\n FROM {usr} u, {group_member} m, {group} g\n WHERE g.id = m.group\n AND m.member = u.id\n AND m.group = ?\n AND (g.feedbacknotify = " . GROUP_ROLES_ALL . "\n OR (g.feedbacknotify = " . GROUP_ROLES_NONMEMBER . " AND (m.role = 'tutor' OR m.role = 'admin'))\n OR (g.feedbacknotify = " . GROUP_ROLES_ADMIN . " AND m.role = 'admin')\n )";
$this->users = get_records_sql_array($sql, array($groupid));
} else {
if (!empty($institutionid)) {
require_once get_config('libroot') . 'institution.php';
$institution = new Institution($institutionid);
$admins = $institution->institution_and_site_admins();
$this->users = get_records_sql_array("SELECT * FROM {usr} WHERE id IN (" . implode(',', $admins) . ")", array());
}
}
}
if (empty($this->users)) {
// no one to notify - possibe if group 'feedbacknotify' is set to 0
return;
}
$title = $onartefact ? $artefactinstance->get('title') : $viewrecord->title;
$this->urltext = $title;
$body = $annotationfeedback->get('description');
$posttime = strftime(get_string('strftimedaydatetime'), $annotationfeedback->get('ctime'));
// Internal
$this->message = strip_tags(str_shorten_html($body, 200, true));
// Seen as things like emaildigest base the message on $this->message
// we need to set the language for the $removedbyline here based on first user.
$user = $this->users[0];
$lang = empty($user->lang) || $user->lang == 'default' ? get_config('lang') : $user->lang;
// Comment deleted notification
if ($deletedby = $annotationfeedback->get('deletedby')) {
$this->strings = (object) array('subject' => (object) array('key' => 'annotationfeedbackdeletednotificationsubject', 'section' => 'artefact.annotation', 'args' => array($title)));
$deletedmessage = ArtefactTypeAnnotationfeedback::deleted_by_types_description();
$removedbyline = get_string_from_language($lang, $deletedmessage[$deletedby], 'artefact.annotation');
$this->message = $removedbyline . ":\n" . $this->message;
foreach ($this->users as $key => $user) {
if (empty($user->lang) || $user->lang == 'default') {
// check to see if we need to show institution language
$instlang = get_user_institution_language($user->id);
$lang = empty($instlang) || $instlang == 'default' ? get_config('lang') : $instlang;
} else {
$lang = $user->lang;
}
// For email we can send the message in the user's preferred language
$removedbyline = get_string_from_language($lang, $deletedmessage[$deletedby], 'artefact.annotation');
$this->users[$key]->htmlmessage = get_string_from_language($lang, 'annotationfeedbackdeletedhtml', 'artefact.annotation', hsc($title), $removedbyline, clean_html($body), get_config('wwwroot') . $this->url, hsc($title));
$this->users[$key]->emailmessage = get_string_from_language($lang, 'annotationfeedbackdeletedtext', 'artefact.annotation', $title, $removedbyline, trim(html2text(htmlspecialchars($body))), $title, get_config('wwwroot') . $this->url);
}
return;
}
$this->strings = (object) array('subject' => (object) array('key' => 'newannotationfeedbacknotificationsubject', 'section' => 'artefact.annotation', 'args' => array($title)));
$this->url .= '&showcomment=' . $annotationfeedback->get('id');
// Email
$author = $annotationfeedback->get('author');
foreach ($this->users as $key => $user) {
$authorname = empty($author) ? $annotationfeedback->get('authorname') : display_name($author, $user);
if (empty($user->lang) || $user->lang == 'default') {
// check to see if we need to show institution language
$instlang = get_user_institution_language($user->id);
$lang = empty($instlang) || $instlang == 'default' ? get_config('lang') : $instlang;
} else {
$lang = $user->lang;
}
$this->users[$key]->htmlmessage = get_string_from_language($lang, 'annotationfeedbacknotificationhtml', 'artefact.annotation', hsc($authorname), hsc($title), $posttime, clean_html($body), get_config('wwwroot') . $this->url);
$this->users[$key]->emailmessage = get_string_from_language($lang, 'annotationfeedbacknotificationtext', 'artefact.annotation', $authorname, $title, $posttime, trim(html2text(htmlspecialchars($body))), get_config('wwwroot') . $this->url);
}
}
/**
* Create an annotationfeedback record in the database for the feedback entry.
*/
private static function create_annotationfeedback($entry, $importer, $annotationid)
{
$config = self::get_annotationfeedback_entry_data($entry, $importer, $annotationid);
$content = $config['content'];
$annotationfeedback = new ArtefactTypeAnnotationfeedback();
$annotationfeedback->set('title', $content['title']);
$annotationfeedback->set('description', $content['description']);
if ($content['ctime']) {
$annotationfeedback->set('ctime', $content['ctime']);
}
if ($content['mtime']) {
$annotationfeedback->set('mtime', $content['mtime']);
}
$annotationfeedback->set('owner', $config['owner']);
if ($content['authorname']) {
$annotationfeedback->set('authorname', $content['authorname']);
} else {
$annotationfeedback->set('author', $content['author']);
}
$annotationfeedback->set('private', $content['private']);
$annotationfeedback->set('onannotation', $annotationid);
$annotationfeedback->commit();
// return the newly created artefactid for the feedback.
return $annotationfeedback->get('id');
}
