/**
* Returns a list of quora discussions optionally sorted and paginated.
*
* @param int $quoraid the quora instance id
* @param string $sortby sort by this element (id, timemodified, timestart or timeend)
* @param string $sortdirection sort direction: ASC or DESC
* @param int $page page number
* @param int $perpage items per page
*
* @return array the quora discussion details including warnings
* @since Moodle 2.8
*/
public static function get_quora_discussions_paginated($quoraid, $sortby = 'timemodified', $sortdirection = 'DESC', $page = -1, $perpage = 0)
{
global $CFG, $DB, $USER;
require_once $CFG->dirroot . "/mod/quora/lib.php";
$warnings = array();
$discussions = array();
$params = self::validate_parameters(self::get_quora_discussions_paginated_parameters(), array('quoraid' => $quoraid, 'sortby' => $sortby, 'sortdirection' => $sortdirection, 'page' => $page, 'perpage' => $perpage));
// Compact/extract functions are not recommended.
$quoraid = $params['quoraid'];
$sortby = $params['sortby'];
$sortdirection = $params['sortdirection'];
$page = $params['page'];
$perpage = $params['perpage'];
$sortallowedvalues = array('id', 'timemodified', 'timestart', 'timeend');
if (!in_array($sortby, $sortallowedvalues)) {
throw new invalid_parameter_exception('Invalid value for sortby parameter (value: ' . $sortby . '),' . 'allowed values are: ' . implode(',', $sortallowedvalues));
}
$sortdirection = strtoupper($sortdirection);
$directionallowedvalues = array('ASC', 'DESC');
if (!in_array($sortdirection, $directionallowedvalues)) {
throw new invalid_parameter_exception('Invalid value for sortdirection parameter (value: ' . $sortdirection . '),' . 'allowed values are: ' . implode(',', $directionallowedvalues));
}
$quora = $DB->get_record('quora', array('id' => $quoraid), '*', MUST_EXIST);
$course = $DB->get_record('course', array('id' => $quora->course), '*', MUST_EXIST);
$cm = get_coursemodule_from_instance('quora', $quora->id, $course->id, false, MUST_EXIST);
// Validate the module context. It checks everything that affects the module visibility (including groupings, etc..).
$modcontext = context_module::instance($cm->id);
self::validate_context($modcontext);
// Check they have the view quora capability.
require_capability('mod/quora:viewdiscussion', $modcontext, null, true, 'noviewdiscussionspermission', 'quora');
$sort = 'd.' . $sortby . ' ' . $sortdirection;
$alldiscussions = quora_get_discussions($cm, $sort, true, -1, -1, true, $page, $perpage);
if ($alldiscussions) {
$canviewfullname = has_capability('moodle/site:viewfullnames', $modcontext);
// Get the unreads array, this takes a quora id and returns data for all discussions.
$unreads = array();
if ($cantrack = quora_tp_can_track_quoras($quora)) {
if ($quoratracked = quora_tp_is_tracked($quora)) {
$unreads = quora_get_discussions_unread($cm);
}
}
// The quora function returns the replies for all the discussions in a given quora.
$replies = quora_count_discussion_replies($quoraid, $sort, -1, $page, $perpage);
foreach ($alldiscussions as $discussion) {
// This function checks for qanda quoras.
// Note that the quora_get_discussions returns as id the post id, not the discussion id so we need to do this.
$discussionrec = clone $discussion;
$discussionrec->id = $discussion->discussion;
if (!quora_user_can_see_discussion($quora, $discussionrec, $modcontext)) {
$warning = array();
// Function quora_get_discussions returns quora_posts ids not quora_discussions ones.
$warning['item'] = 'post';
$warning['itemid'] = $discussion->id;
$warning['warningcode'] = '1';
$warning['message'] = 'You can\'t see this discussion';
$warnings[] = $warning;
continue;
}
$discussion->numunread = 0;
if ($cantrack && $quoratracked) {
if (isset($unreads[$discussion->discussion])) {
$discussion->numunread = (int) $unreads[$discussion->discussion];
}
}
$discussion->numreplies = 0;
if (!empty($replies[$discussion->discussion])) {
$discussion->numreplies = (int) $replies[$discussion->discussion]->replies;
}
// Load user objects from the results of the query.
$user = new stdclass();
$user->id = $discussion->userid;
$user = username_load_fields_from_object($user, $discussion);
$discussion->userfullname = fullname($user, $canviewfullname);
// We can have post written by users that are deleted. In this case, those users don't have a valid context.
$usercontext = context_user::instance($user->id, IGNORE_MISSING);
if ($usercontext) {
$discussion->userpictureurl = moodle_url::make_webservice_pluginfile_url($usercontext->id, 'user', 'icon', null, '/', 'f1')->out(false);
} else {
$discussion->userpictureurl = '';
}
$usermodified = new stdclass();
$usermodified->id = $discussion->usermodified;
$usermodified = username_load_fields_from_object($usermodified, $discussion, 'um');
$discussion->usermodifiedfullname = fullname($usermodified, $canviewfullname);
// We can have post written by users that are deleted. In this case, those users don't have a valid context.
$usercontext = context_user::instance($usermodified->id, IGNORE_MISSING);
if ($usercontext) {
$discussion->usermodifiedpictureurl = moodle_url::make_webservice_pluginfile_url($usercontext->id, 'user', 'icon', null, '/', 'f1')->out(false);
} else {
$discussion->usermodifiedpictureurl = '';
}
// Rewrite embedded images URLs.
list($discussion->message, $discussion->messageformat) = external_format_text($discussion->message, $discussion->messageformat, $modcontext->id, 'mod_quora', 'post', $discussion->id);
// List attachments.
if (!empty($discussion->attachment)) {
$discussion->attachments = array();
$fs = get_file_storage();
if ($files = $fs->get_area_files($modcontext->id, 'mod_quora', 'attachment', $discussion->id, "filename", false)) {
foreach ($files as $file) {
$filename = $file->get_filename();
$discussion->attachments[] = array('filename' => $filename, 'mimetype' => $file->get_mimetype(), 'fileurl' => file_encode_url($CFG->wwwroot . '/webservice/pluginfile.php', '/' . $modcontext->id . '/mod_quora/attachment/' . $discussion->id . '/' . $filename));
}
}
}
$discussions[] = $discussion;
}
}
$result = array();
$result['discussions'] = $discussions;
$result['warnings'] = $warnings;
return $result;
}
/**
* Generate and return the track or no track link for a quora.
*
* @global object
* @global object
* @global object
* @param object $quora the quora. Fields used are $quora->id and $quora->forcesubscribe.
* @param array $messages
* @param bool $fakelink
* @return string
* @deprecated since Moodle 2.0 MDL-14632 - please do not use this function any more.
*/
function quora_get_tracking_link($quora, $messages = array(), $fakelink = true)
{
debugging('quora_get_tracking_link() is deprecated.', DEBUG_DEVELOPER);
global $CFG, $USER, $PAGE, $OUTPUT;
static $strnotrackquora, $strtrackquora;
if (isset($messages['trackquora'])) {
$strtrackquora = $messages['trackquora'];
}
if (isset($messages['notrackquora'])) {
$strnotrackquora = $messages['notrackquora'];
}
if (empty($strtrackquora)) {
$strtrackquora = get_string('trackquora', 'quora');
}
if (empty($strnotrackquora)) {
$strnotrackquora = get_string('notrackquora', 'quora');
}
if (quora_tp_is_tracked($quora)) {
$linktitle = $strnotrackquora;
$linktext = $strnotrackquora;
} else {
$linktitle = $strtrackquora;
$linktext = $strtrackquora;
}
$link = '';
if ($fakelink) {
$PAGE->requires->js('/mod/quora/quora.js');
$PAGE->requires->js_function_call('quora_produce_tracking_link', array($quora->id, $linktext, $linktitle));
// use <noscript> to print button in case javascript is not enabled
$link .= '<noscript>';
}
$url = new moodle_url('/mod/quora/settracking.php', array('id' => $quora->id, 'sesskey' => sesskey()));
$link .= $OUTPUT->single_button($url, $linktext, 'get', array('title' => $linktitle));
if ($fakelink) {
$link .= '</noscript>';
}
return $link;
}
/**
* Adds module specific settings to the settings block
*
* @param settings_navigation $settings The settings navigation object
* @param navigation_node $quoranode The node to add module settings to
*/
function quora_extend_settings_navigation(settings_navigation $settingsnav, navigation_node $quoranode)
{
global $USER, $PAGE, $CFG, $DB, $OUTPUT;
$quoraobject = $DB->get_record("quora", array("id" => $PAGE->cm->instance));
if (empty($PAGE->cm->context)) {
$PAGE->cm->context = context_module::instance($PAGE->cm->instance);
}
$params = $PAGE->url->params();
if (!empty($params['d'])) {
$discussionid = $params['d'];
}
// for some actions you need to be enrolled, beiing admin is not enough sometimes here
$enrolled = is_enrolled($PAGE->cm->context, $USER, '', false);
$activeenrolled = is_enrolled($PAGE->cm->context, $USER, '', true);
$canmanage = has_capability('mod/quora:managesubscriptions', $PAGE->cm->context);
$subscriptionmode = \mod_quora\subscriptions::get_subscription_mode($quoraobject);
$cansubscribe = $activeenrolled && !\mod_quora\subscriptions::is_forcesubscribed($quoraobject) && (!\mod_quora\subscriptions::subscription_disabled($quoraobject) || $canmanage);
if ($canmanage) {
$mode = $quoranode->add(get_string('subscriptionmode', 'quora'), null, navigation_node::TYPE_CONTAINER);
$allowchoice = $mode->add(get_string('subscriptionoptional', 'quora'), new moodle_url('/mod/quora/subscribe.php', array('id' => $quoraobject->id, 'mode' => FORUM_CHOOSESUBSCRIBE, 'sesskey' => sesskey())), navigation_node::TYPE_SETTING);
$forceforever = $mode->add(get_string("subscriptionforced", "quora"), new moodle_url('/mod/quora/subscribe.php', array('id' => $quoraobject->id, 'mode' => FORUM_FORCESUBSCRIBE, 'sesskey' => sesskey())), navigation_node::TYPE_SETTING);
$forceinitially = $mode->add(get_string("subscriptionauto", "quora"), new moodle_url('/mod/quora/subscribe.php', array('id' => $quoraobject->id, 'mode' => FORUM_INITIALSUBSCRIBE, 'sesskey' => sesskey())), navigation_node::TYPE_SETTING);
$disallowchoice = $mode->add(get_string('subscriptiondisabled', 'quora'), new moodle_url('/mod/quora/subscribe.php', array('id' => $quoraobject->id, 'mode' => FORUM_DISALLOWSUBSCRIBE, 'sesskey' => sesskey())), navigation_node::TYPE_SETTING);
switch ($subscriptionmode) {
case FORUM_CHOOSESUBSCRIBE:
// 0
$allowchoice->action = null;
$allowchoice->add_class('activesetting');
break;
case FORUM_FORCESUBSCRIBE:
// 1
$forceforever->action = null;
$forceforever->add_class('activesetting');
break;
case FORUM_INITIALSUBSCRIBE:
// 2
$forceinitially->action = null;
$forceinitially->add_class('activesetting');
break;
case FORUM_DISALLOWSUBSCRIBE:
// 3
$disallowchoice->action = null;
$disallowchoice->add_class('activesetting');
break;
}
} else {
if ($activeenrolled) {
switch ($subscriptionmode) {
case FORUM_CHOOSESUBSCRIBE:
// 0
$notenode = $quoranode->add(get_string('subscriptionoptional', 'quora'));
break;
case FORUM_FORCESUBSCRIBE:
// 1
$notenode = $quoranode->add(get_string('subscriptionforced', 'quora'));
break;
case FORUM_INITIALSUBSCRIBE:
// 2
$notenode = $quoranode->add(get_string('subscriptionauto', 'quora'));
break;
case FORUM_DISALLOWSUBSCRIBE:
// 3
$notenode = $quoranode->add(get_string('subscriptiondisabled', 'quora'));
break;
}
}
}
if ($cansubscribe) {
if (\mod_quora\subscriptions::is_subscribed($USER->id, $quoraobject, null, $PAGE->cm)) {
$linktext = get_string('unsubscribe', 'quora');
} else {
$linktext = get_string('subscribe', 'quora');
}
$url = new moodle_url('/mod/quora/subscribe.php', array('id' => $quoraobject->id, 'sesskey' => sesskey()));
$quoranode->add($linktext, $url, navigation_node::TYPE_SETTING);
if (isset($discussionid)) {
if (\mod_quora\subscriptions::is_subscribed($USER->id, $quoraobject, $discussionid, $PAGE->cm)) {
$linktext = get_string('unsubscribediscussion', 'quora');
} else {
$linktext = get_string('subscribediscussion', 'quora');
}
$url = new moodle_url('/mod/quora/subscribe.php', array('id' => $quoraobject->id, 'sesskey' => sesskey(), 'd' => $discussionid, 'returnurl' => $PAGE->url->out()));
$quoranode->add($linktext, $url, navigation_node::TYPE_SETTING);
}
}
if (has_capability('mod/quora:viewsubscribers', $PAGE->cm->context)) {
$url = new moodle_url('/mod/quora/subscribers.php', array('id' => $quoraobject->id));
$quoranode->add(get_string('showsubscribers', 'quora'), $url, navigation_node::TYPE_SETTING);
}
if ($enrolled && quora_tp_can_track_quoras($quoraobject)) {
// keep tracking info for users with suspended enrolments
if ($quoraobject->trackingtype == FORUM_TRACKING_OPTIONAL || !$CFG->quora_allowforcedreadtracking && $quoraobject->trackingtype == FORUM_TRACKING_FORCED) {
if (quora_tp_is_tracked($quoraobject)) {
$linktext = get_string('notrackquora', 'quora');
} else {
$linktext = get_string('trackquora', 'quora');
}
$url = new moodle_url('/mod/quora/settracking.php', array('id' => $quoraobject->id, 'sesskey' => sesskey()));
$quoranode->add($linktext, $url, navigation_node::TYPE_SETTING);
}
}
if (!isloggedin() && $PAGE->course->id == SITEID) {
$userid = guest_user()->id;
} else {
$userid = $USER->id;
}
$hascourseaccess = $PAGE->course->id == SITEID || can_access_course($PAGE->course, $userid);
$enablerssfeeds = !empty($CFG->enablerssfeeds) && !empty($CFG->quora_enablerssfeeds);
if ($enablerssfeeds && $quoraobject->rsstype && $quoraobject->rssarticles && $hascourseaccess) {
if (!function_exists('rss_get_url')) {
require_once "{$CFG->libdir}/rsslib.php";
}
if ($quoraobject->rsstype == 1) {
$string = get_string('rsssubscriberssdiscussions', 'quora');
} else {
$string = get_string('rsssubscriberssposts', 'quora');
}
$url = new moodle_url(rss_get_url($PAGE->cm->context->id, $userid, "mod_quora", $quoraobject->id));
$quoranode->add($string, $url, settings_navigation::TYPE_SETTING, null, null, new pix_icon('i/rss', ''));
}
}
if ($parent) {
// If flat AND parent, then force nested display this time
if ($displaymode == FORUM_MODE_FLATOLDEST or $displaymode == FORUM_MODE_FLATNEWEST) {
$displaymode = FORUM_MODE_NESTED;
}
} else {
$parent = $discussion->firstpost;
}
if (!($post = quora_get_post_full($parent))) {
print_error("notexists", 'quora', "{$CFG->wwwroot}/mod/quora/view.php?f={$quora->id}");
}
if (!quora_user_can_see_post($quora, $discussion, $post, null, $cm)) {
print_error('noviewdiscussionspermission', 'quora', "{$CFG->wwwroot}/mod/quora/view.php?id={$quora->id}");
}
if ($mark == 'read' or $mark == 'unread') {
if ($CFG->quora_usermarksread && quora_tp_can_track_quoras($quora) && quora_tp_is_tracked($quora)) {
if ($mark == 'read') {
quora_tp_add_read_record($USER->id, $postid);
} else {
// unread
quora_tp_delete_read_records($USER->id, $postid);
}
}
}
$searchform = quora_search_form($course);
$quoranode = $PAGE->navigation->find($cm->id, navigation_node::TYPE_ACTIVITY);
if (empty($quoranode)) {
$quoranode = $PAGE->navbar;
} else {
$quoranode->make_active();
}
if (!($course = $DB->get_record("course", array("id" => $quora->course)))) {
print_error('invalidcoursemodule');
}
if (!($cm = get_coursemodule_from_instance("quora", $quora->id, $course->id))) {
print_error('invalidcoursemodule');
}
require_login($course, false, $cm);
$returnto = quora_go_back_to($returnpage . '?id=' . $course->id . '&f=' . $quora->id);
if (!quora_tp_can_track_quoras($quora)) {
redirect($returnto);
}
$info = new stdClass();
$info->name = fullname($USER);
$info->quora = format_string($quora->name);
$eventparams = array('context' => context_module::instance($cm->id), 'relateduserid' => $USER->id, 'other' => array('quoraid' => $quora->id));
if (quora_tp_is_tracked($quora)) {
if (quora_tp_stop_tracking($quora->id)) {
$event = \mod_quora\event\readtracking_disabled::create($eventparams);
$event->trigger();
redirect($returnto, get_string("nownottracking", "quora", $info), 1);
} else {
print_error('cannottrack', '', get_local_referer(false));
}
} else {
// subscribe
if (quora_tp_start_tracking($quora->id)) {
$event = \mod_quora\event\readtracking_enabled::create($eventparams);
$event->trigger();
redirect($returnto, get_string("nowtracking", "quora", $info), 1);
} else {
print_error('cannottrack', '', get_local_referer(false));
/**
* Test the logic in the test_quora_tp_is_tracked() function.
*/
public function test_quora_tp_is_tracked()
{
global $CFG;
$this->resetAfterTest();
$useron = $this->getDataGenerator()->create_user(array('trackquoras' => 1));
$useroff = $this->getDataGenerator()->create_user(array('trackquoras' => 0));
$course = $this->getDataGenerator()->create_course();
$options = array('course' => $course->id, 'trackingtype' => FORUM_TRACKING_OFF);
// Off.
$quoraoff = $this->getDataGenerator()->create_module('quora', $options);
$options = array('course' => $course->id, 'trackingtype' => FORUM_TRACKING_FORCED);
// On.
$quoraforce = $this->getDataGenerator()->create_module('quora', $options);
$options = array('course' => $course->id, 'trackingtype' => FORUM_TRACKING_OPTIONAL);
// Optional.
$quoraoptional = $this->getDataGenerator()->create_module('quora', $options);
// Allow force.
$CFG->quora_allowforcedreadtracking = 1;
// User on, quora off, should be off.
$result = quora_tp_is_tracked($quoraoff, $useron);
$this->assertEquals(false, $result);
// User on, quora force, should be on.
$result = quora_tp_is_tracked($quoraforce, $useron);
$this->assertEquals(true, $result);
// User on, quora optional, should be on.
$result = quora_tp_is_tracked($quoraoptional, $useron);
$this->assertEquals(true, $result);
// User off, quora off, should be off.
$result = quora_tp_is_tracked($quoraoff, $useroff);
$this->assertEquals(false, $result);
// User off, quora force, should be on.
$result = quora_tp_is_tracked($quoraforce, $useroff);
$this->assertEquals(true, $result);
// User off, quora optional, should be off.
$result = quora_tp_is_tracked($quoraoptional, $useroff);
$this->assertEquals(false, $result);
// Don't allow force.
$CFG->quora_allowforcedreadtracking = 0;
// User on, quora off, should be off.
$result = quora_tp_is_tracked($quoraoff, $useron);
$this->assertEquals(false, $result);
// User on, quora force, should be on.
$result = quora_tp_is_tracked($quoraforce, $useron);
$this->assertEquals(true, $result);
// User on, quora optional, should be on.
$result = quora_tp_is_tracked($quoraoptional, $useron);
$this->assertEquals(true, $result);
// User off, quora off, should be off.
$result = quora_tp_is_tracked($quoraoff, $useroff);
$this->assertEquals(false, $result);
// User off, quora force, should be off.
$result = quora_tp_is_tracked($quoraforce, $useroff);
$this->assertEquals(false, $result);
// User off, quora optional, should be off.
$result = quora_tp_is_tracked($quoraoptional, $useroff);
$this->assertEquals(false, $result);
// Stop tracking so we can test again.
quora_tp_stop_tracking($quoraforce->id, $useron->id);
quora_tp_stop_tracking($quoraoptional->id, $useron->id);
quora_tp_stop_tracking($quoraforce->id, $useroff->id);
quora_tp_stop_tracking($quoraoptional->id, $useroff->id);
// Allow force.
$CFG->quora_allowforcedreadtracking = 1;
// User on, preference off, quora force, should be on.
$result = quora_tp_is_tracked($quoraforce, $useron);
$this->assertEquals(true, $result);
// User on, preference off, quora optional, should be on.
$result = quora_tp_is_tracked($quoraoptional, $useron);
$this->assertEquals(false, $result);
// User off, preference off, quora force, should be on.
$result = quora_tp_is_tracked($quoraforce, $useroff);
$this->assertEquals(true, $result);
// User off, preference off, quora optional, should be off.
$result = quora_tp_is_tracked($quoraoptional, $useroff);
$this->assertEquals(false, $result);
// Don't allow force.
$CFG->quora_allowforcedreadtracking = 0;
// User on, preference off, quora force, should be on.
$result = quora_tp_is_tracked($quoraforce, $useron);
$this->assertEquals(false, $result);
// User on, preference off, quora optional, should be on.
$result = quora_tp_is_tracked($quoraoptional, $useron);
$this->assertEquals(false, $result);
// User off, preference off, quora force, should be off.
$result = quora_tp_is_tracked($quoraforce, $useroff);
$this->assertEquals(false, $result);
// User off, preference off, quora optional, should be off.
$result = quora_tp_is_tracked($quoraoptional, $useroff);
$this->assertEquals(false, $result);
}
if ($quora->type == 'qanda' && !has_capability('mod/quora:viewqandawithoutposting', $modcontext) && !empty($discussion->id) && !quora_user_has_posted($quora->id, $discussion->id, $USER->id)) {
echo $OUTPUT->notification(get_string('qandanotify', 'quora'));
}
// If there is a warning message and we are not editing a post we need to handle the warning.
if (!empty($thresholdwarning) && !$edit) {
// Here we want to throw an exception if they are no longer allowed to post.
quora_check_blocking_threshold($thresholdwarning);
}
if (!empty($parent)) {
if (!($discussion = $DB->get_record('quora_discussions', array('id' => $parent->discussion)))) {
print_error('notpartofdiscussion', 'quora');
}
quora_print_post($parent, $discussion, $quora, $cm, $course, false, false, false);
if (empty($post->edit)) {
if ($quora->type != 'qanda' || quora_user_can_see_discussion($quora, $discussion, $modcontext)) {
$quoratracked = quora_tp_is_tracked($quora);
$posts = quora_get_all_discussion_posts($discussion->id, "created ASC", $quoratracked);
quora_print_posts_threaded($course, $cm, $quora, $discussion, $parent, 0, false, $quoratracked, $posts);
}
}
} else {
if (!empty($quora->intro)) {
echo $OUTPUT->box(format_module_intro('quora', $quora, $cm->id), 'generalbox', 'intro');
if (!empty($CFG->enableplagiarism)) {
require_once $CFG->libdir . '/plagiarismlib.php';
echo plagiarism_print_disclosure($cm->id);
}
}
}
if (!empty($formheading)) {
echo $OUTPUT->heading($formheading, 2, array('class' => 'accesshide'));
