message/renderer.php

   1 <?php
   2 // This file is part of Moodle - http://moodle.org/
   3 //
   4 // Moodle is free software: you can redistribute it and/or modify
   5 // it under the terms of the GNU General Public License as published by
   6 // the Free Software Foundation, either version 3 of the License, or
   7 // (at your option) any later version.
   8 //
   9 // Moodle is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 /**
  18  * Messaging libraries
  19  *
  20  * @package    message
  21  * @copyright  2011 Lancaster University Network Services Limited
  22  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23  */
  24
  25 defined('MOODLE_INTERNAL') || die();
  26
  27 /**
  28  * message Renderer
  29  *
  30  * Class for rendering various message objects
  31  *
  32  * @package    message
  33  * @copyright  2011 Lancaster University Network Services Limited
  34  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  35  */
  36 class core_message_renderer extends plugin_renderer_base {
  37
  38     /**
  39      * Display the interface to manage message outputs
  40      *
  41      * @param   mixed   $processors array of objects containing message processors
  42      * @return  string              The text to render
  43      */
  44     public function manage_messageoutputs($processors) {
  45         global $CFG;
  46         // Display the current workflows
  47         $table = new html_table();
  48         $table->attributes['class'] = 'generaltable';
  49         $table->data        = array();
  50         $table->head        = array(
  51             get_string('name'),
  52             get_string('enable'),
  53             get_string('settings'),
  54         );
  55         $table->colclasses = array(
  56             'displayname', 'availability', 'settings',
  57         );
  58
  59         foreach ($processors as $processor) {
  60             $row = new html_table_row();
  61             $row->attributes['class'] = 'messageoutputs';
  62
  63             // Name
  64             $name = new html_table_cell(get_string('pluginname', 'message_'.$processor->name));
  65
  66             // Enable
  67             $enable = new html_table_cell();
  68             $enable->attributes['class'] = 'mdl-align';
  69             if (!$processor->available) {
  70                 $enable->text = html_writer::nonempty_tag('span', get_string('outputnotavailable', 'message'), array('class' => 'error'));
  71             } else if (!$processor->configured) {
  72                 $enable->text = html_writer::nonempty_tag('span', get_string('outputnotconfigured', 'message'), array('class' => 'error'));
  73             } else if ($processor->enabled) {
  74                 $url = new moodle_url('/admin/message.php', array('disable' => $processor->id, 'sesskey' => sesskey()));
  75                 $enable->text = html_writer::link($url, html_writer::empty_tag('img',
  76                     array('src'   => $this->output->pix_url('i/hide'),
  77                           'class' => 'icon',
  78                           'title' => get_string('outputenabled', 'message'),
  79                           'alt'   => get_string('outputenabled', 'message'),
  80                     )
  81                 ));
  82             } else {
  83                 $name->attributes['class'] = 'dimmed_text';
  84                 $url = new moodle_url('/admin/message.php', array('enable' => $processor->id, 'sesskey' => sesskey()));
  85                 $enable->text = html_writer::link($url, html_writer::empty_tag('img',
  86                     array('src'   => $this->output->pix_url('i/show'),
  87                           'class' => 'icon',
  88                           'title' => get_string('outputdisabled', 'message'),
  89                           'alt'   => get_string('outputdisabled', 'message'),
  90                     )
  91                 ));
  92             }
  93             // Settings
  94             $settings = new html_table_cell();
  95             if ($processor->available && $processor->hassettings) {
  96                 $settingsurl = new moodle_url('settings.php', array('section' => 'messagesetting'.$processor->name));
  97                 $settings->text = html_writer::link($settingsurl, get_string('settings', 'message'));
  98             }
  99
 100             $row->cells = array($name, $enable, $settings);
 101             $table->data[] = $row;
 102         }
 103         return html_writer::table($table);
 104     }
 105
 106     /**
 107      * Display the interface to manage default message outputs
 108      *
 109      * @param   mixed   $processors  array of objects containing message processors
 110      * @param   mixed   $providers   array of objects containing message providers
 111      * @param   mixed   $preferences array of objects containing current preferences
 112      * @return  string               The text to render
 113      */
 114     public function manage_defaultmessageoutputs($processors, $providers, $preferences) {
 115         global $CFG;
 116
 117         // Prepare list of options for dropdown menu
 118         $options = array();
 119         foreach (array('disallowed', 'permitted', 'forced') as $setting) {
 120             $options[$setting] = get_string($setting, 'message');
 121         }
 122
 123         $output = html_writer::start_tag('form', array('id'=>'defaultmessageoutputs', 'method'=>'post'));
 124         $output .= html_writer::empty_tag('input', array('type'=>'hidden', 'name'=>'sesskey', 'value'=>sesskey()));
 125
 126         // Display users outputs table
 127         $table = new html_table();
 128         $table->attributes['class'] = 'generaltable';
 129         $table->data        = array();
 130         $table->head        = array('');
 131
 132         // Populate the header row
 133         foreach ($processors as $processor) {
 134             $table->head[]  = get_string('pluginname', 'message_'.$processor->name);
 135         }
 136         // Generate the matrix of settings for each provider and processor
 137         foreach ($providers as $provider) {
 138             $row = new html_table_row();
 139             $row->attributes['class'] = 'defaultmessageoutputs';
 140             $row->cells = array();
 141
 142             // Provider Name
 143             $providername = get_string('messageprovider:'.$provider->name, $provider->component);
 144             $row->cells[] = new html_table_cell($providername);
 145
 146             // Settings for each processor
 147             foreach ($processors as $processor) {
 148                 $cellcontent = '';
 149                 foreach (array('permitted', 'loggedin', 'loggedoff') as $setting) {
 150                     // pepare element and preference names
 151                     $elementname = $provider->component.'_'.$provider->name.'_'.$setting.'['.$processor->name.']';
 152                     $preferencebase = $provider->component.'_'.$provider->name.'_'.$setting;
 153                     // prepare language bits
 154                     $processorname = get_string('pluginname', 'message_'.$processor->name);
 155                     $statename = get_string($setting, 'message');
 156                     $labelparams = array(
 157                         'provider'  => $providername,
 158                         'processor' => $processorname,
 159                         'state'     => $statename
 160                     );
 161                     if ($setting == 'permitted') {
 162                         $label = get_string('sendingvia', 'message', $labelparams);
 163                         // determine the current setting or use default
 164                         $select = MESSAGE_DEFAULT_PERMITTED;
 165                         $preference = $processor->name.'_provider_'.$preferencebase;
 166                         if (array_key_exists($preference, $preferences)) {
 167                             $select = $preferences->{$preference};
 168                         }
 169                         // dropdown menu
 170                         $cellcontent = html_writer::label($label, $elementname, true, array('class' => 'accesshide'));
 171                         $cellcontent .= html_writer::select($options, $elementname, $select, false, array('id' => $elementname));
 172                         $cellcontent .= html_writer::tag('div', get_string('defaults', 'message'));
 173                     } else {
 174                         $label = get_string('sendingviawhen', 'message', $labelparams);
 175                         // determine the current setting based on the 'permitted' setting above
 176                         $checked = false;
 177                         if ($select == 'forced') {
 178                             $checked = true;
 179                         } else if ($select == 'permitted') {
 180                             $preference = 'message_provider_'.$preferencebase;
 181                             if (array_key_exists($preference, $preferences)) {
 182                                 $checked = (int)in_array($processor->name, explode(',', $preferences->{$preference}));
 183                             }
 184                         }
 185                         // generate content
 186                         $cellcontent .= html_writer::start_tag('div');
 187                         $cellcontent .= html_writer::label($label, $elementname, true, array('class' => 'accesshide'));
 188                         $cellcontent .= html_writer::checkbox($elementname, 1, $checked, '', array('id' => $elementname));
 189                         $cellcontent .= $statename;
 190                         $cellcontent .= html_writer::end_tag('div');
 191                     }
 192                 }
 193                 $row->cells[] = new html_table_cell($cellcontent);
 194             }
 195             $table->data[] = $row;
 196         }
 197
 198         $output .= html_writer::table($table);
 199         $output .= html_writer::start_tag('div', array('class' => 'form-buttons'));
 200         $output .= html_writer::empty_tag('input', array('type' => 'submit', 'value' => get_string('savechanges','admin'), 'class' => 'form-submit'));
 201         $output .= html_writer::end_tag('div');
 202         $output .= html_writer::end_tag('form');
 203         return $output;
 204     }
 205
 206     /**
 207      * Display the interface for messaging options
 208      *
 209      * @param   mixed   $processors         array of objects containing message processors
 210      * @param   mixed   $providers          array of objects containing message providers
 211      * @param   mixed   $preferences        array of objects containing current preferences
 212      * @param   mixed   $defaultpreferences array of objects containing site default preferences
 213      * $param   boolean $notificationsdisabled indicates whether the user's "emailstop" flag is
 214      *                                      set so shouldn't receive any non-forced notifications
 215      * @return  string                      The text to render
 216      */
 217     public function manage_messagingoptions($processors, $providers, $preferences, $defaultpreferences, $notificationsdisabled = false) {
 218         // Filter out enabled, available system_configured and user_configured processors only.
 219         $readyprocessors = array_filter($processors, create_function('$a', 'return $a->enabled && $a->configured && $a->object->is_user_configured();'));
 220
 221         // Start the form.  We're not using mform here because of our special formatting needs ...
 222         $output = html_writer::start_tag('form', array('method'=>'post', 'class' => 'mform'));
 223         $output .= html_writer::empty_tag('input', array('type'=>'hidden', 'name'=>'sesskey', 'value'=>sesskey()));
 224
 225         /// Settings table...
 226         $output .= html_writer::start_tag('fieldset', array('id' => 'providers', 'class' => 'clearfix'));
 227         $output .= html_writer::nonempty_tag('legend', get_string('providers_config', 'message'), array('class' => 'ftoggler'));
 228
 229         // Display the messging options table
 230         $table = new html_table();
 231         $table->attributes['class'] = 'generaltable';
 232         $table->data        = array();
 233         $table->head        = array('');
 234
 235         foreach ($readyprocessors as $processor) {
 236             $table->head[]  = get_string('pluginname', 'message_'.$processor->name);
 237         }
 238
 239         $number_procs = count($processors);
 240         // Populate the table with rows
 241         foreach ( $providers as $provider) {
 242             $preferencebase = $provider->component.'_'.$provider->name;
 243
 244             $headerrow = new html_table_row();
 245             $providername = get_string('messageprovider:'.$provider->name, $provider->component);
 246             $providercell = new html_table_cell($providername);
 247             $providercell->header = true;
 248             $providercell->colspan = $number_procs + 1;
 249             $providercell->attributes['class'] = 'c0';
 250             $headerrow->cells = array($providercell);
 251             $table->data[] = $headerrow;
 252
 253             foreach (array('loggedin', 'loggedoff') as $state) {
 254                 $optionrow = new html_table_row();
 255                 $optionname = new html_table_cell(get_string($state.'description', 'message'));
 256                 $optionname->attributes['class'] = 'c0';
 257                 $optionrow->cells = array($optionname);
 258                 foreach ($readyprocessors as $processor) {
 259                     // determine the default setting
 260                     $permitted = MESSAGE_DEFAULT_PERMITTED;
 261                     $defaultpreference = $processor->name.'_provider_'.$preferencebase.'_permitted';
 262                     if (isset($defaultpreferences->{$defaultpreference})) {
 263                         $permitted = $defaultpreferences->{$defaultpreference};
 264                     }
 265                     // If settings are disallowed or forced, just display the
 266                     // corresponding message, if not use user settings.
 267                     if (in_array($permitted, array('disallowed', 'forced'))) {
 268                         if ($state == 'loggedoff') {
 269                             // skip if we are rendering the second line
 270                             continue;
 271                         }
 272                         $cellcontent = html_writer::nonempty_tag('div', get_string($permitted, 'message'), array('class' => 'dimmed_text'));
 273                         $optioncell = new html_table_cell($cellcontent);
 274                         $optioncell->rowspan = 2;
 275                         $optioncell->attributes['class'] = 'disallowed';
 276                     } else {
 277                         // determine user preferences and use them.
 278                         $disabled = array();
 279                         $checked = false;
 280                         if ($notificationsdisabled) {
 281                             $disabled['disabled'] = 1;
 282                         }
 283                         // See if user has touched this preference
 284                         if (isset($preferences->{$preferencebase.'_'.$state})) {
 285                             // User have some preferneces for this state in the database, use them
 286                             $checked = isset($preferences->{$preferencebase.'_'.$state}[$processor->name]);
 287                         } else {
 288                             // User has not set this preference yet, using site default preferences set by admin
 289                             $defaultpreference = 'message_provider_'.$preferencebase.'_'.$state;
 290                             if (isset($defaultpreferences->{$defaultpreference})) {
 291                                 $checked = (int)in_array($processor->name, explode(',', $defaultpreferences->{$defaultpreference}));
 292                             }
 293                         }
 294                         $elementname = $preferencebase.'_'.$state.'['.$processor->name.']';
 295                         // prepare language bits
 296                         $processorname = get_string('pluginname', 'message_'.$processor->name);
 297                         $statename = get_string($state, 'message');
 298                         $labelparams = array(
 299                             'provider'  => $providername,
 300                             'processor' => $processorname,
 301                             'state'     => $statename
 302                         );
 303                         $label = get_string('sendingviawhen', 'message', $labelparams);
 304                         $cellcontent = html_writer::label($label, $elementname, true, array('class' => 'accesshide'));
 305                         $cellcontent .= html_writer::checkbox($elementname, 1, $checked, '', array_merge(array('id' => $elementname, 'class' => 'notificationpreference'), $disabled));
 306                         $optioncell = new html_table_cell($cellcontent);
 307                         $optioncell->attributes['class'] = 'mdl-align';
 308                     }
 309                     $optionrow->cells[] = $optioncell;
 310                 }
 311                 $table->data[] = $optionrow;
 312             }
 313         }
 314         $output .= html_writer::start_tag('div');
 315         $output .= html_writer::table($table);
 316         $output .= html_writer::end_tag('div');
 317
 318         $disableallcheckbox = $this->output->help_icon('disableall', 'message') . get_string('disableall', 'message') . html_writer::checkbox('disableall', 1, $notificationsdisabled, '', array('class'=>'disableallcheckbox'));
 319         $output .= html_writer::nonempty_tag('div', $disableallcheckbox, array('class'=>'disableall'));
 320
 321         $output .= html_writer::end_tag('fieldset');
 322
 323         foreach ($processors as $processor) {
 324             if (($processorconfigform = $processor->object->config_form($preferences)) && $processor->enabled) {
 325                 $output .= html_writer::start_tag('fieldset', array('id' => 'messageprocessor_'.$processor->name, 'class' => 'clearfix'));
 326                 $output .= html_writer::nonempty_tag('legend', get_string('pluginname', 'message_'.$processor->name), array('class' => 'ftoggler'));
 327                 $output .= html_writer::start_tag('div');
 328                 $output .= $processorconfigform;
 329                 $output .= html_writer::end_tag('div');
 330                 $output .= html_writer::end_tag('fieldset');
 331             }
 332         }
 333
 334         $output .= html_writer::start_tag('fieldset', array('id' => 'messageprocessor_general', 'class' => 'clearfix'));
 335         $output .= html_writer::nonempty_tag('legend', get_string('generalsettings','admin'), array('class' => 'ftoggler'));
 336         $output .= html_writer::start_tag('div');
 337         $output .= get_string('blocknoncontacts', 'message').': ';
 338         $output .= html_writer::checkbox('blocknoncontacts', 1, $preferences->blocknoncontacts, '');
 339         $output .= html_writer::end_tag('div');
 340         $output .= html_writer::end_tag('fieldset');
 341         $output .= html_writer::start_tag('div', array('class' => 'mdl-align'));
 342         $output .= html_writer::empty_tag('input', array('type' => 'submit', 'value' => get_string('updatemyprofile'), 'class' => 'form-submit'));
 343         $output .= html_writer::end_tag('div');
 344         $output .= html_writer::end_tag('form');
 345         return $output;
 346     }
 347
 348 }