cache/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  * The Cache renderer.
  19  *
  20  * This file is part of Moodle's cache API, affectionately called MUC.
  21  *
  22  * @package    core
  23  * @category   cache
  24  * @copyright  2012 Sam Hemelryk
  25  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  26  */
  27
  28 defined('MOODLE_INTERNAL') || die();
  29
  30 /**
  31  * The cache renderer (mainly admin interfaces).
  32  *
  33  * @package    core
  34  * @category   cache
  35  * @copyright  2012 Sam Hemelryk
  36  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  37  */
  38 class core_cache_renderer extends plugin_renderer_base {
  39
  40     /**
  41      * Displays store summaries.
  42      *
  43      * @param array $stores
  44      * @param array $plugins
  45      * @return string HTML
  46      */
  47     public function store_instance_summariers(array $stores, array $plugins) {
  48         $table = new html_table();
  49         $table->head = array(
  50             get_string('storename', 'cache'),
  51             get_string('plugin', 'cache'),
  52             get_string('storeready', 'cache'),
  53             get_string('mappings', 'cache'),
  54             get_string('modes', 'cache'),
  55             get_string('supports', 'cache'),
  56             get_string('lockingmeans', 'cache'),
  57             get_string('actions', 'cache'),
  58         );
  59         $table->colclasses = array(
  60             'storename',
  61             'plugin',
  62             'storeready',
  63             'mappings',
  64             'modes',
  65             'supports',
  66             'locking',
  67             'actions'
  68         );
  69         $table->data = array();
  70
  71         $defaultstoreactions = get_string('defaultstoreactions', 'cache');
  72
  73         foreach ($stores as $name => $store) {
  74             $actions = cache_administration_helper::get_store_instance_actions($name, $store);
  75             $modes = array();
  76             foreach ($store['modes'] as $mode => $enabled) {
  77                 if ($enabled) {
  78                     $modes[] = get_string('mode_'.$mode, 'cache');
  79                 }
  80             }
  81
  82             $supports = array();
  83             foreach ($store['supports'] as $support => $enabled) {
  84                 if ($enabled) {
  85                     $supports[] = get_string('supports_'.$support, 'cache');
  86                 }
  87             }
  88
  89             $info = '';
  90             if (!empty($store['default'])) {
  91                 $info = $this->output->pix_icon('i/info', $defaultstoreactions, '', array('class' => 'icon'));
  92             }
  93             $htmlactions = array();
  94             foreach ($actions as $action) {
  95                 $htmlactions[] = $this->output->action_link($action['url'], $action['text']);
  96             }
  97
  98             $isready = $store['isready'] && $store['requirementsmet'];
  99             $readycell = new html_table_cell;
 100             if ($isready) {
 101                 $readycell->text = $this->output->pix_icon('i/valid', '1');
 102             }
 103
 104             $storename = $store['name'];
 105             if (!empty($store['default'])) {
 106                 $storename = get_string('store_'.$store['name'], 'cache');
 107             }
 108             if (!$isready && (int)$store['mappings'] > 0) {
 109                 $readycell->text = $this->output->help_icon('storerequiresattention', 'cache');
 110                 $readycell->attributes['class'] = 'store-requires-attention';
 111             }
 112
 113             $lock = $store['lock']['name'];
 114             if (!empty($store['lock']['default'])) {
 115                 $lock = get_string($store['lock']['name'], 'cache');
 116             }
 117
 118             $row = new html_table_row(array(
 119                 $storename,
 120                 get_string('pluginname', 'cachestore_'.$store['plugin']),
 121                 $readycell,
 122                 $store['mappings'],
 123                 join(', ', $modes),
 124                 join(', ', $supports),
 125                 $lock,
 126                 $info.join(', ', $htmlactions)
 127             ));
 128             $row->attributes['class'] = 'store-'.$name;
 129             if ($store['default']) {
 130                 $row->attributes['class'] .= ' default-store';
 131             }
 132             $table->data[] = $row;
 133         }
 134
 135         $html  = html_writer::start_tag('div', array('id' => 'core-cache-store-summaries'));
 136         $html .= $this->output->heading(get_string('storesummaries', 'cache'), 3);
 137         $html .= html_writer::table($table);
 138         $html .= html_writer::end_tag('div');
 139         return $html;
 140     }
 141
 142     /**
 143      * Displays plugin summaries
 144      *
 145      * @param array $plugins
 146      * @return string HTML
 147      */
 148     public function store_plugin_summaries(array $plugins) {
 149         $table = new html_table();
 150         $table->head = array(
 151             get_string('plugin', 'cache'),
 152             get_string('storeready', 'cache'),
 153             get_string('stores', 'cache'),
 154             get_string('modes', 'cache'),
 155             get_string('supports', 'cache'),
 156             get_string('actions', 'cache'),
 157         );
 158         $table->colclasses = array(
 159             'plugin',
 160             'storeready',
 161             'stores',
 162             'modes',
 163             'supports',
 164             'actions'
 165         );
 166         $table->data = array();
 167
 168         foreach ($plugins as $name => $plugin) {
 169             $actions = cache_administration_helper::get_store_plugin_actions($name, $plugin);
 170
 171             $modes = array();
 172             foreach ($plugin['modes'] as $mode => $enabled) {
 173                 if ($enabled) {
 174                     $modes[] = get_string('mode_'.$mode, 'cache');
 175                 }
 176             }
 177
 178             $supports = array();
 179             foreach ($plugin['supports'] as $support => $enabled) {
 180                 if ($enabled) {
 181                     $supports[] = get_string('supports_'.$support, 'cache');
 182                 }
 183             }
 184
 185             $htmlactions = array();
 186             foreach ($actions as $action) {
 187                 $htmlactions[] = $this->output->action_link($action['url'], $action['text']);
 188             }
 189
 190             $row = new html_table_row(array(
 191                 $plugin['name'],
 192                 ($plugin['requirementsmet']) ? $this->output->pix_icon('i/valid', '1') : '',
 193                 $plugin['instances'],
 194                 join(', ', $modes),
 195                 join(', ', $supports),
 196                 join(', ', $htmlactions)
 197             ));
 198
 199             $row->attributes['class'] = 'plugin-'.$name;
 200             $table->data[] = $row;
 201         }
 202
 203         $html  = html_writer::start_tag('div', array('id' => 'core-cache-plugin-summaries'));
 204         $html .= $this->output->heading(get_string('pluginsummaries', 'cache'), 3);
 205         $html .= html_writer::table($table);
 206         $html .= html_writer::end_tag('div');
 207         return $html;
 208     }
 209
 210     /**
 211      * Displays definition summaries
 212      *
 213      * @param array $definitions
 214      * @return string HTML
 215      */
 216     public function definition_summaries(array $definitions, context $context) {
 217         $table = new html_table();
 218         $table->head = array(
 219             get_string('definition', 'cache'),
 220             get_string('mode', 'cache'),
 221             get_string('component', 'cache'),
 222             get_string('area', 'cache'),
 223             get_string('mappings', 'cache'),
 224             get_string('sharing', 'cache'),
 225             get_string('actions', 'cache'),
 226         );
 227         $table->colclasses = array(
 228             'definition',
 229             'mode',
 230             'component',
 231             'area',
 232             'mappings',
 233             'sharing',
 234             'actions'
 235         );
 236         $table->data = array();
 237
 238         $none = new lang_string('none', 'cache');
 239         foreach ($definitions as $id => $definition) {
 240             $actions = cache_administration_helper::get_definition_actions($context, $definition);
 241             $htmlactions = array();
 242             foreach ($actions as $action) {
 243                 $action['url']->param('definition', $id);
 244                 $htmlactions[] = $this->output->action_link($action['url'], $action['text']);
 245             }
 246             if (!empty($definition['mappings'])) {
 247                 $mapping = join(', ', $definition['mappings']);
 248             } else {
 249                 $mapping = '<em>'.$none.'</em>';
 250             }
 251
 252             $row = new html_table_row(array(
 253                 $definition['name'],
 254                 get_string('mode_'.$definition['mode'], 'cache'),
 255                 $definition['component'],
 256                 $definition['area'],
 257                 $mapping,
 258                 join(', ', $definition['selectedsharingoption']),
 259                 join(', ', $htmlactions)
 260             ));
 261             $row->attributes['class'] = 'definition-'.$definition['component'].'-'.$definition['area'];
 262             $table->data[] = $row;
 263         }
 264
 265         $html  = html_writer::start_tag('div', array('id' => 'core-cache-definition-summaries'));
 266         $html .= $this->output->heading(get_string('definitionsummaries', 'cache'), 3);
 267         $html .= html_writer::table($table);
 268
 269         $url = new moodle_url('/cache/admin.php', array('action' => 'rescandefinitions', 'sesskey' => sesskey()));
 270         $link = html_writer::link($url, get_string('rescandefinitions', 'cache'));
 271         $html .= html_writer::tag('div', $link, array('id' => 'core-cache-rescan-definitions'));
 272
 273         $html .= html_writer::end_tag('div');
 274         return $html;
 275     }
 276
 277     /**
 278      * Displays mode mappings
 279      *
 280      * @param string $applicationstore
 281      * @param string $sessionstore
 282      * @param string $requeststore
 283      * @param moodle_url $editurl
 284      * @return string HTML
 285      */
 286     public function mode_mappings($applicationstore, $sessionstore, $requeststore, moodle_url $editurl) {
 287         $table = new html_table();
 288         $table->colclasses = array(
 289             'mode',
 290             'mapping',
 291         );
 292         $table->rowclasses = array(
 293             'mode_application',
 294             'mode_session',
 295             'mode_request'
 296         );
 297         $table->head = array(
 298             get_string('mode', 'cache'),
 299             get_string('mappings', 'cache'),
 300         );
 301         $table->data = array(
 302             array(get_string('mode_'.cache_store::MODE_APPLICATION, 'cache'), $applicationstore),
 303             array(get_string('mode_'.cache_store::MODE_SESSION, 'cache'), $sessionstore),
 304             array(get_string('mode_'.cache_store::MODE_REQUEST, 'cache'), $requeststore)
 305         );
 306
 307         $html = html_writer::start_tag('div', array('id' => 'core-cache-mode-mappings'));
 308         $html .= $this->output->heading(get_string('defaultmappings', 'cache'), 3);
 309         $html .= html_writer::table($table);
 310         $link = html_writer::link($editurl, get_string('editmappings', 'cache'));
 311         $html .= html_writer::tag('div', $link, array('class' => 'edit-link'));
 312         $html .= html_writer::end_tag('div');
 313         return $html;
 314     }
 315
 316     /**
 317      * Display basic information about lock instances.
 318      *
 319      * @todo Add some actions so that people can configure lock instances.
 320      *
 321      * @param array $locks
 322      * @return string
 323      */
 324     public function lock_summaries(array $locks) {
 325         $table = new html_table();
 326         $table->colclasses = array(
 327             'name',
 328             'type',
 329             'default',
 330             'uses',
 331             'actions'
 332         );
 333         $table->rowclasses = array(
 334             'lock_name',
 335             'lock_type',
 336             'lock_default',
 337             'lock_uses',
 338             'lock_actions',
 339         );
 340         $table->head = array(
 341             get_string('lockname', 'cache'),
 342             get_string('locktype', 'cache'),
 343             get_string('lockdefault', 'cache'),
 344             get_string('lockuses', 'cache'),
 345             get_string('actions', 'cache')
 346         );
 347         $table->data = array();
 348         $tick = $this->output->pix_icon('i/valid', '');
 349         foreach ($locks as $lock) {
 350             $actions = array();
 351             if ($lock['uses'] === 0 && !$lock['default']) {
 352                 $url = new moodle_url('/cache/admin.php', array('lock' => $lock['name'], 'action' => 'deletelock', 'sesskey' => sesskey()));
 353                 $actions[] = html_writer::link($url, get_string('delete', 'cache'));
 354             }
 355             $table->data[] = new html_table_row(array(
 356                 new html_table_cell($lock['name']),
 357                 new html_table_cell($lock['type']),
 358                 new html_table_cell($lock['default'] ? $tick : ''),
 359                 new html_table_cell($lock['uses']),
 360                 new html_table_cell(join(' ', $actions))
 361             ));
 362         }
 363
 364         $url = new moodle_url('/cache/admin.php', array('action' => 'newlockinstance', 'sesskey' => sesskey()));
 365         $select = new single_select($url, 'lock', cache_administration_helper::get_addable_lock_options());
 366         $select->label = get_string('addnewlockinstance', 'cache');
 367
 368         $html = html_writer::start_tag('div', array('id' => 'core-cache-lock-summary'));
 369         $html .= $this->output->heading(get_string('locksummary', 'cache'), 3);
 370         $html .= html_writer::table($table);
 371         $html .= html_writer::tag('div', $this->output->render($select), array('class' => 'new-instance'));
 372         $html .= html_writer::end_tag('div');
 373         return $html;
 374     }
 375
 376     /**
 377      * Renders an array of notifications for the cache configuration screen.
 378      *
 379      * Takes an array of notifications with the form:
 380      * $notifications = array(
 381      *     array('This is a success message', true),
 382      *     array('This is a failure message', false),
 383      * );
 384      *
 385      * @param array $notifications
 386      * @return string
 387      */
 388     public function notifications(array $notifications = array()) {
 389         if (count($notifications) === 0) {
 390             // There are no notifications to render.
 391             return '';
 392         }
 393         $html = html_writer::start_div('notifications');
 394         foreach ($notifications as $notification) {
 395             list($message, $notifysuccess) = $notification;
 396             $html .= $this->notification($message, ($notifysuccess) ? 'notifysuccess' : 'notifyproblem');
 397         }
 398         $html .= html_writer::end_div();
 399         return $html;
 400     }
 401 }