Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?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/>.

/**
 * Contains renderer objects for messaging
 *
 * @package    core_message
 * @copyright  2011 Lancaster University Network Services Limited
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

/**
 * message Renderer
 *
 * Class for rendering various message objects
 *
 * @package    core_message
 * @subpackage message
 * @copyright  2011 Lancaster University Network Services Limited
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class core_message_renderer extends plugin_renderer_base {

    /**
     * Display the interface to manage both message outputs and default message outputs
     *
     * @param  array $allprocessors  array of objects containing all message processors
     * @param  array $processors  array of objects containing active message processors
     * @param  array $providers   array of objects containing message providers
     * @param  stdClass $preferences object containing current preferences
     * @return string The text to render
     */
    public function manage_messageoutput_settings($allprocessors, $processors, $providers, $preferences) {
        $output = html_writer::start_tag('form', array('id' => 'defaultmessageoutputs', 'method' => 'post'));
        $output .= html_writer::empty_tag('input', array('type' => 'hidden', 'name' => 'sesskey', 'value' => sesskey()));

        // Add message output processors enabled/disabled and settings.
        $output .= $this->heading(get_string('messageoutputs', 'message'));
        $output .= $this->manage_messageoutputs($allprocessors);

        // Add active message output processors settings.
< $output .= $this->heading(get_string('managemessageoutputs', 'message'));
$output .= $this->manage_defaultmessageoutputs($processors, $providers, $preferences); $output .= html_writer::start_tag('div', array('class' => 'form-buttons')); $output .= html_writer::empty_tag('input', array('type' => 'submit', 'value' => get_string('savechanges', 'admin'), 'class' => 'form-submit btn btn-primary') ); $output .= html_writer::end_tag('div'); $output .= html_writer::end_tag('form'); return $output; } /** * Display the interface to manage message outputs * * @param array $processors array of objects containing message processors * @return string The text to render */ public function manage_messageoutputs($processors) { // Display the current workflows $table = new html_table(); $table->attributes['class'] = 'admintable generaltable'; $table->data = array(); $table->head = array( get_string('name'), get_string('enable'), get_string('settings'), ); $table->colclasses = array(
< 'displayname', 'availability', 'settings',
> 'displayname', 'availability text-center', 'settings',
); foreach ($processors as $processor) { $row = new html_table_row(); $row->attributes['class'] = 'messageoutputs'; $name = new html_table_cell(get_string('pluginname', 'message_'.$processor->name)); $enable = new html_table_cell(); if (!$processor->available) { $enable->text = html_writer::nonempty_tag('span', get_string('outputnotavailable', 'message'), array('class' => 'error') ); } else { $enable->text = html_writer::checkbox($processor->name, $processor->id, $processor->enabled, '', array('id' => $processor->name) ); } // Settings $settings = new html_table_cell(); if ($processor->available && $processor->hassettings) { $settingsurl = new moodle_url('/admin/settings.php', array('section' => 'messagesetting'.$processor->name)); $settings->text = html_writer::link($settingsurl, get_string('settings', 'message')); } $row->cells = array($name, $enable, $settings); $table->data[] = $row; } return html_writer::table($table); } /** * Display the interface to manage default message outputs * * @param array $processors array of objects containing message processors * @param array $providers array of objects containing message providers * @param stdClass $preferences object containing current preferences * @return string The text to render */ public function manage_defaultmessageoutputs($processors, $providers, $preferences) {
< // Prepare list of options for dropdown menu < $options = array(); < foreach (array('disallowed', 'permitted', 'forced') as $setting) { < $options[$setting] = get_string($setting, 'message'); < } < < // Display users outputs table < $table = new html_table(); < $table->attributes['class'] = 'generaltable'; < $table->data = array(); < $table->head = array('');
> $context = [];
< // Populate the header row
foreach ($processors as $processor) {
< $table->head[] = get_string('pluginname', 'message_'.$processor->name);
> $processor->displayname = get_string('pluginname', 'message_'.$processor->name);
}
< // Add enable/disable to head < $table->head[] = get_string('enabled', 'core_message');
< // Generate the matrix of settings for each provider and processor < foreach ($providers as $provider) { < $row = new html_table_row(); < $row->attributes['class'] = 'defaultmessageoutputs'; < $row->cells = array();
> $activitycomponents = []; > $othercomponents = [];
< // Provider Name < $providername = get_string('messageprovider:'.$provider->name, $provider->component); < $row->cells[] = new html_table_cell($providername);
> foreach ($providers as $provider) { > $provider->displayname = get_string('messageprovider:'.$provider->name, $provider->component);
$providersettingprefix = $provider->component.'_'.$provider->name.'_';
< $disableprovidersetting = $providersettingprefix.'disable'; < $providerdisabled = !empty($preferences->$disableprovidersetting);
> $provider->enabledsetting = $providersettingprefix.'disable'; > $provider->enabled = empty($preferences->{$provider->enabledsetting}); > $provider->enabledlabel = get_string('providerenabled', 'message', $provider->displayname); > $provider->settings = []; >
// Settings for each processor foreach ($processors as $processor) {
< $cellcontent = ''; < foreach (array('permitted', 'loggedin', 'loggedoff') as $setting) { < // pepare element and preference names < $elementname = $providersettingprefix.$setting.'['.$processor->name.']'; < $preferencebase = $providersettingprefix.$setting; < // prepare language bits < $processorname = get_string('pluginname', 'message_'.$processor->name); < $statename = get_string($setting, 'message'); < $labelparams = array( < 'provider' => $providername, < 'processor' => $processorname, < 'state' => $statename < ); < if ($setting == 'permitted') { < $label = get_string('sendingvia', 'message', $labelparams); < // determine the current setting or use default < $select = MESSAGE_DEFAULT_PERMITTED; < $preference = $processor->name.'_provider_'.$preferencebase; < if ($providerdisabled) { < $select = MESSAGE_DISALLOWED; < } else if (property_exists($preferences, $preference)) { < $select = $preferences->{$preference}; < } < // dropdown menu < $cellcontent = html_writer::label($label, $elementname, true, array('class' => 'accesshide')); < $cellcontent .= html_writer::select($options, $elementname, $select, false, array('id' => $elementname)); < $cellcontent .= html_writer::tag('div', get_string('defaults', 'message')); < } else { < $label = get_string('sendingviawhen', 'message', $labelparams); < // determine the current setting based on the 'permitted' setting above < $checked = false; < if ($select == 'forced') { < $checked = true; < } else if ($select == 'permitted') { < $preference = 'message_provider_'.$preferencebase;
> $setting = new StdClass(); > > $setting->lockedsetting = $providersettingprefix.'locked['.$processor->name.']'; > $preference = $processor->name.'_provider_'.$providersettingprefix.'locked'; > > $setting->locked = false;
if (property_exists($preferences, $preference)) {
< $checked = (int)in_array($processor->name, explode(',', $preferences->{$preference}));
> $setting->locked = $preferences->{$preference} == 1;
}
> } > $setting->enabledsetting = $providersettingprefix.'enabled['.$processor->name.']'; // generate content > $preference = 'message_provider_'.$providersettingprefix.'enabled'; $cellcontent .= html_writer::start_tag('div'); > $cellcontent .= html_writer::label($label, $elementname, true, array('class' => 'accesshide')); > $setting->enabled = false; $cellcontent .= html_writer::checkbox($elementname, 1, $checked, '', array('id' => $elementname)); > if (property_exists($preferences, $preference)) { $cellcontent .= $statename; > $setting->enabled = (int)in_array($processor->name, explode(',', $preferences->{$preference}));
< // generate content < $cellcontent .= html_writer::start_tag('div'); < $cellcontent .= html_writer::label($label, $elementname, true, array('class' => 'accesshide')); < $cellcontent .= html_writer::checkbox($elementname, 1, $checked, '', array('id' => $elementname)); < $cellcontent .= $statename; < $cellcontent .= html_writer::end_tag('div');
> $labelparams = [ > 'provider' => $provider->displayname, > 'processor' => $processor->displayname, > ]; > $setting->enabledlabel = get_string('sendingviaenabled', 'message', $labelparams); > $setting->lockedlabel = get_string('sendingvialocked', 'message', $labelparams); > > $provider->settings[] = $setting; > } > > // Order the components so that the activities appear first, followed > // by the system and then anything else. > if ($provider->component != 'moodle') { > if (substr($provider->component, 0, 4) == 'mod_') { > // Activities. > $activitycomponents[] = $provider->component; > } else { > // Other stuff. > $othercomponents[] = $provider->component;
< $row->cells[] = new html_table_cell($cellcontent);
< $disableprovider = html_writer::checkbox($disableprovidersetting, 1, !$providerdisabled, '', < array('id' => $disableprovidersetting, 'class' => 'messagedisable')); < $disableprovider = html_writer::tag('div', $disableprovider); < $row->cells[] = new html_table_cell($disableprovider); < $table->data[] = $row;
> > $activitycomponents = array_unique($activitycomponents); > asort($activitycomponents); > $othercomponents = array_unique($othercomponents); > asort($othercomponents); > $components = array_merge($activitycomponents, ['moodle'], $othercomponents); > asort($providers); > > $colspan = count($processors) + 2; > $componentsexport = []; > > foreach ($components as $component) { > $componentexport = new StdClass(); > $componentexport->name = $component; > > if ($component != 'moodle') { > $componentexport->displayname = get_string('pluginname', $component); > } else { > $componentexport->displayname = get_string('coresystem');
< $output = html_writer::table($table); < return $output;
> $componentexport->providers = []; > foreach ($providers as $provider) { > if ($provider->component == $component) { > $componentexport->providers[] = $provider; > } > } > $componentexport->colspan = $colspan; > $componentsexport[] = $componentexport; > } > > $context['processors'] = array_values($processors); > $context['components'] = $componentsexport; > > return $this->render_from_template('message/default_notification_preferences', $context);
} /** * Display the interface for notification preferences * * @param object $user instance of a user * @return string The text to render */ public function render_user_notification_preferences($user) { $processors = get_message_processors(); $providers = message_get_providers_for_user($user->id); $preferences = \core_message\api::get_all_message_preferences($processors, $providers, $user); $notificationlistoutput = new \core_message\output\preferences\notification_list($processors, $providers, $preferences, $user); return $this->render_from_template('message/notification_preferences', $notificationlistoutput->export_for_template($this)); } /** * Display the interface for message preferences * * @param object $user instance of a user * @return string The text to render */ public function render_user_message_preferences($user) { global $CFG; // Filter out enabled, available system_configured and user_configured processors only. $readyprocessors = array_filter(get_message_processors(), function($processor) { return $processor->enabled && $processor->configured && $processor->object->is_user_configured() && // Filter out processors that don't have and message preferences to configure. $processor->object->has_message_preferences(); }); $providers = array_filter(message_get_providers_for_user($user->id), function($provider) { return $provider->component === 'moodle'; }); $preferences = \core_message\api::get_all_message_preferences($readyprocessors, $providers, $user); $notificationlistoutput = new \core_message\output\preferences\message_notification_list($readyprocessors, $providers, $preferences, $user); $context = $notificationlistoutput->export_for_template($this); // Get the privacy settings options for being messaged. $privacysetting = \core_message\api::get_user_privacy_messaging_preference($user->id); $choices = array(); $choices[] = [ 'value' => \core_message\api::MESSAGE_PRIVACY_ONLYCONTACTS, 'text' => get_string('contactableprivacy_onlycontacts', 'message'), 'checked' => ($privacysetting == \core_message\api::MESSAGE_PRIVACY_ONLYCONTACTS) ]; $choices[] = [ 'value' => \core_message\api::MESSAGE_PRIVACY_COURSEMEMBER, 'text' => get_string('contactableprivacy_coursemember', 'message'), 'checked' => ($privacysetting == \core_message\api::MESSAGE_PRIVACY_COURSEMEMBER) ]; if (!empty($CFG->messagingallusers)) { // Add the MESSAGE_PRIVACY_SITE option when site-wide messaging between users is enabled. $choices[] = [ 'value' => \core_message\api::MESSAGE_PRIVACY_SITE, 'text' => get_string('contactableprivacy_site', 'message'), 'checked' => ($privacysetting == \core_message\api::MESSAGE_PRIVACY_SITE) ]; } $context['privacychoices'] = $choices; return $this->render_from_template('message/message_preferences', $context); } }