. /** * 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 message outputs * * @param array $processors array of objects containing message processors * @return string The text to render */ public function manage_messageoutputs($processors) { global $CFG; // 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', ); foreach ($processors as $processor) { $row = new html_table_row(); $row->attributes['class'] = 'messageoutputs'; // Name $name = new html_table_cell(get_string('pluginname', 'message_'.$processor->name)); // Enable $enable = new html_table_cell(); $enable->attributes['class'] = 'mdl-align'; if (!$processor->available) { $enable->text = html_writer::nonempty_tag('span', get_string('outputnotavailable', 'message'), array('class' => 'error')); } else if (!$processor->configured) { $enable->text = html_writer::nonempty_tag('span', get_string('outputnotconfigured', 'message'), array('class' => 'error')); } else if ($processor->enabled) { $url = new moodle_url('/admin/message.php', array('disable' => $processor->id, 'sesskey' => sesskey())); $enable->text = html_writer::link($url, html_writer::empty_tag('img', array('src' => $this->output->pix_url('t/hide'), 'class' => 'iconsmall', 'title' => get_string('outputenabled', 'message'), 'alt' => get_string('outputenabled', 'message'), ) )); } else { $row->attributes['class'] = 'dimmed_text'; $url = new moodle_url('/admin/message.php', array('enable' => $processor->id, 'sesskey' => sesskey())); $enable->text = html_writer::link($url, html_writer::empty_tag('img', array('src' => $this->output->pix_url('t/show'), 'class' => 'iconsmall', 'title' => get_string('outputdisabled', 'message'), 'alt' => get_string('outputdisabled', 'message'), ) )); } // Settings $settings = new html_table_cell(); if ($processor->available && $processor->hassettings) { $settingsurl = new moodle_url('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 array $preferences array of objects containing current preferences * @return string The text to render */ public function manage_defaultmessageoutputs($processors, $providers, $preferences) { global $CFG; // Prepare list of options for dropdown menu $options = array(); foreach (array('disallowed', 'permitted', 'forced') as $setting) { $options[$setting] = get_string($setting, 'message'); } $output = html_writer::start_tag('form', array('id'=>'defaultmessageoutputs', 'method'=>'post')); $output .= html_writer::empty_tag('input', array('type'=>'hidden', 'name'=>'sesskey', 'value'=>sesskey())); // Display users outputs table $table = new html_table(); $table->attributes['class'] = 'generaltable'; $table->data = array(); $table->head = array(''); // Populate the header row foreach ($processors as $processor) { $table->head[] = 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(); // Provider Name $providername = get_string('messageprovider:'.$provider->name, $provider->component); $row->cells[] = new html_table_cell($providername); $providersettingprefix = $provider->component.'_'.$provider->name.'_'; $disableprovidersetting = $providersettingprefix.'disable'; $providerdisabled = !empty($preferences->$disableprovidersetting); // 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 (array_key_exists($preference, $preferences)) { $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; if (array_key_exists($preference, $preferences)) { $checked = (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'); } } $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; } $output .= html_writer::table($table); $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')); $output .= html_writer::end_tag('div'); $output .= html_writer::end_tag('form'); return $output; } /** * Display the interface for messaging options * * @param array $processors Array of objects containing message processors * @param array $providers Array of objects containing message providers * @param array $preferences Array of objects containing current preferences * @param array $defaultpreferences Array of objects containing site default preferences * @param bool $notificationsdisabled Indicate if the user's "emailstop" flag is set (shouldn't receive any non-forced notifications) * @param null|int $userid User id, or null if current user. * @return string The text to render */ public function manage_messagingoptions($processors, $providers, $preferences, $defaultpreferences, $notificationsdisabled = false, $userid = null) { global $USER; if (empty($userid)) { $userid = $USER->id; } // Filter out enabled, available system_configured and user_configured processors only. $readyprocessors = array_filter($processors, create_function('$a', 'return $a->enabled && $a->configured && $a->object->is_user_configured();')); // Start the form. We're not using mform here because of our special formatting needs ... $output = html_writer::start_tag('form', array('method'=>'post', 'class' => 'mform')); $output .= html_writer::empty_tag('input', array('type'=>'hidden', 'name'=>'sesskey', 'value'=>sesskey())); /// Settings table... $output .= html_writer::start_tag('fieldset', array('id' => 'providers', 'class' => 'clearfix')); $output .= html_writer::nonempty_tag('legend', get_string('providers_config', 'message'), array('class' => 'ftoggler')); foreach($providers as $provider) { if($provider->component != 'moodle') { $components[] = $provider->component; } } // Lets arrange by components so that core settings (moodle) appear as the first table. $components = array_unique($components); asort($components); array_unshift($components, 'moodle'); // pop it in front! phew! asort($providers); $numprocs = count($processors); // Display the messaging options table(s) foreach ($components as $component) { $provideradded = false; $table = new html_table(); $table->attributes['class'] = 'generaltable'; $table->data = array(); if ($component != 'moodle') { $componentname = get_string('pluginname', $component); } else { $componentname = get_string('coresystem'); } $table->head = array($componentname); foreach ($readyprocessors as $processor) { $table->head[] = get_string('pluginname', 'message_'.$processor->name); } // Populate the table with rows foreach ($providers as $provider) { $preferencebase = $provider->component.'_'.$provider->name; // If provider component is not same or provider disabled then don't show. if (($provider->component != $component) || (!empty($defaultpreferences->{$preferencebase.'_disable'}))) { continue; } $provideradded = true; $headerrow = new html_table_row(); $providername = get_string('messageprovider:'.$provider->name, $provider->component); $providercell = new html_table_cell($providername); $providercell->header = true; $providercell->colspan = $numprocs; $providercell->attributes['class'] = 'c0'; $headerrow->cells = array($providercell); $table->data[] = $headerrow; foreach (array('loggedin', 'loggedoff') as $state) { $optionrow = new html_table_row(); $optionname = new html_table_cell(get_string($state.'description', 'message')); $optionname->attributes['class'] = 'c0'; $optionrow->cells = array($optionname); foreach ($readyprocessors as $processor) { // determine the default setting $permitted = MESSAGE_DEFAULT_PERMITTED; $defaultpreference = $processor->name.'_provider_'.$preferencebase.'_permitted'; if (isset($defaultpreferences->{$defaultpreference})) { $permitted = $defaultpreferences->{$defaultpreference}; } // If settings are disallowed or forced, just display the // corresponding message, if not use user settings. if (in_array($permitted, array('disallowed', 'forced'))) { if ($state == 'loggedoff') { // skip if we are rendering the second line continue; } $cellcontent = html_writer::nonempty_tag('div', get_string($permitted, 'message'), array('class' => 'dimmed_text')); $optioncell = new html_table_cell($cellcontent); $optioncell->rowspan = 2; $optioncell->attributes['class'] = 'disallowed'; } else { // determine user preferences and use them. $disabled = array(); $checked = false; if ($notificationsdisabled) { $disabled['disabled'] = 1; } // See if user has touched this preference if (isset($preferences->{$preferencebase.'_'.$state})) { // User have some preferneces for this state in the database, use them $checked = isset($preferences->{$preferencebase.'_'.$state}[$processor->name]); } else { // User has not set this preference yet, using site default preferences set by admin $defaultpreference = 'message_provider_'.$preferencebase.'_'.$state; if (isset($defaultpreferences->{$defaultpreference})) { $checked = (int)in_array($processor->name, explode(',', $defaultpreferences->{$defaultpreference})); } } $elementname = $preferencebase.'_'.$state.'['.$processor->name.']'; // prepare language bits $processorname = get_string('pluginname', 'message_'.$processor->name); $statename = get_string($state, 'message'); $labelparams = array( 'provider' => $providername, 'processor' => $processorname, 'state' => $statename ); $label = get_string('sendingviawhen', 'message', $labelparams); $cellcontent = html_writer::label($label, $elementname, true, array('class' => 'accesshide')); $cellcontent .= html_writer::checkbox($elementname, 1, $checked, '', array_merge(array('id' => $elementname, 'class' => 'notificationpreference'), $disabled)); $optioncell = new html_table_cell($cellcontent); $optioncell->attributes['class'] = 'mdl-align'; } $optionrow->cells[] = $optioncell; } $table->data[] = $optionrow; } } // Add settings only if provider added for component. if ($provideradded) { $output .= html_writer::start_tag('div', array('class' => 'messagesettingcomponent')); $output .= html_writer::table($table); $output .= html_writer::end_tag('div'); } } $output .= html_writer::end_tag('fieldset'); foreach ($processors as $processor) { if (($processorconfigform = $processor->object->config_form($preferences)) && $processor->enabled) { $output .= html_writer::start_tag('fieldset', array('id' => 'messageprocessor_'.$processor->name, 'class' => 'clearfix')); $output .= html_writer::nonempty_tag('legend', get_string('pluginname', 'message_'.$processor->name), array('class' => 'ftoggler')); $output .= html_writer::start_tag('div'); $output .= $processorconfigform; $output .= html_writer::end_tag('div'); $output .= html_writer::end_tag('fieldset'); } } $output .= html_writer::start_tag('fieldset', array('id' => 'messageprocessor_general', 'class' => 'clearfix')); $output .= html_writer::nonempty_tag('legend', get_string('generalsettings','admin'), array('class' => 'ftoggler')); $output .= html_writer::start_tag('div'); $output .= html_writer::checkbox('beepnewmessage', 1, $preferences->beepnewmessage, get_string('beepnewmessage', 'message')); $output .= html_writer::end_tag('div'); $output .= html_writer::start_tag('div'); $output .= html_writer::checkbox('blocknoncontacts', 1, $preferences->blocknoncontacts, get_string('blocknoncontacts', 'message')); $output .= html_writer::end_tag('div'); $disableallcheckbox = html_writer::checkbox('disableall', 1, $notificationsdisabled, get_string('disableall', 'message'), array('class'=>'disableallcheckbox')); $disableallcheckbox .= $this->output->help_icon('disableall', 'message'); $output .= html_writer::nonempty_tag('div', $disableallcheckbox, array('class'=>'disableall')); $redirect = new moodle_url("/user/preferences.php", array('userid' => $userid)); $output .= html_writer::end_tag('fieldset'); $output .= html_writer::start_tag('div', array('class' => 'mdl-align')); $output .= html_writer::empty_tag('input', array('type' => 'submit', 'value' => get_string('savechanges'), 'class' => 'form-submit')); $output .= html_writer::link($redirect, html_writer::empty_tag('input', array('type' => 'button', 'value' => get_string('cancel'), 'class' => 'btn-cancel'))); $output .= html_writer::end_tag('div'); $output .= html_writer::end_tag('form'); return $output; } }