admin/filters.php

   1 <?php
   2
   3 ///////////////////////////////////////////////////////////////////////////
   4 //                                                                       //
   5 // NOTICE OF COPYRIGHT                                                   //
   6 //                                                                       //
   7 // Moodle - Modular Object-Oriented Dynamic Learning Environment         //
   8 //          http://moodle.org                                            //
   9 //                                                                       //
  10 // Copyright (C) 1999 onwards Martin Dougiamas  http://dougiamas.com     //
  11 //                                                                       //
  12 // This program is free software; you can redistribute it and/or modify  //
  13 // it under the terms of the GNU General Public License as published by  //
  14 // the Free Software Foundation; either version 2 of the License, or     //
  15 // (at your option) any later version.                                   //
  16 //                                                                       //
  17 // This program is distributed in the hope that it will be useful,       //
  18 // but WITHOUT ANY WARRANTY; without even the implied warranty of        //
  19 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         //
  20 // GNU General Public License for more details:                          //
  21 //                                                                       //
  22 //          http://www.gnu.org/copyleft/gpl.html                         //
  23 //                                                                       //
  24 ///////////////////////////////////////////////////////////////////////////
  25
  26 /**
  27  * Processes actions from the admin_setting_managefilters object (defined in
  28  * adminlib.php).
  29  *
  30  * @license http://www.gnu.org/copyleft/gpl.html GNU Public License
  31  * @package administration
  32  *//** */
  33
  34     require_once(dirname(__FILE__) . '/../config.php');
  35     require_once($CFG->libdir . '/adminlib.php');
  36
  37     $action = optional_param('action', '', PARAM_ALPHANUMEXT);
  38     $filterpath = optional_param('filterpath', '', PARAM_PATH);
  39
  40     require_login();
  41     $systemcontext = context_system::instance();
  42     require_capability('moodle/site:config', $systemcontext);
  43
  44     $returnurl = "$CFG->wwwroot/$CFG->admin/filters.php";
  45     admin_externalpage_setup('managefilters');
  46
  47     $filters = filter_get_global_states();
  48
  49     // In case any new filters have been installed, but not put in the table yet.
  50     $fitlernames = filter_get_all_installed();
  51     $newfilters = $fitlernames;
  52     foreach ($filters as $filter => $notused) {
  53         unset($newfilters[$filter]);
  54     }
  55
  56 /// Process actions ============================================================
  57
  58     if ($action) {
  59         if (!isset($filters[$filterpath]) && !isset($newfilters[$filterpath])) {
  60             throw new moodle_exception('filternotinstalled', 'error', $returnurl, $filterpath);
  61         }
  62
  63         if (!confirm_sesskey()) {
  64             redirect($returnurl);
  65         }
  66     }
  67
  68     switch ($action) {
  69
  70     case 'setstate':
  71         if ($newstate = optional_param('newstate', '', PARAM_INT)) {
  72             filter_set_global_state($filterpath, $newstate);
  73             if ($newstate == TEXTFILTER_DISABLED) {
  74                 filter_set_applies_to_strings($filterpath, false);
  75             }
  76             unset($newfilters[$filterpath]);
  77         }
  78         break;
  79
  80     case 'setapplyto':
  81         $applytostrings = optional_param('stringstoo', false, PARAM_BOOL);
  82         filter_set_applies_to_strings($filterpath, $applytostrings);
  83         break;
  84
  85     case 'down':
  86         if (isset($filters[$filterpath])) {
  87             $oldpos = $filters[$filterpath]->sortorder;
  88             if ($oldpos <= count($filters)) {
  89                 filter_set_global_state($filterpath, $filters[$filterpath]->active, $oldpos + 1);
  90             }
  91         }
  92         break;
  93
  94     case 'up':
  95         if (isset($filters[$filterpath])) {
  96             $oldpos = $filters[$filterpath]->sortorder;
  97             if ($oldpos >= 1) {
  98                 filter_set_global_state($filterpath, $filters[$filterpath]->active, $oldpos - 1);
  99             }
 100         }
 101         break;
 102
 103     case 'delete':
 104         if (!empty($filternames[$filterpath])) {
 105             $filtername = $filternames[$filterpath];
 106         } else {
 107             $filtername = $filterpath;
 108         }
 109
 110         if (substr($filterpath, 0, 4) == 'mod/') {
 111             $mod = basename($filterpath);
 112             $a = new stdClass;
 113             $a->filter = $filtername;
 114             $a->module = get_string('modulename', $mod);
 115             print_error('cannotdeletemodfilter', 'admin', $returnurl, $a);
 116         }
 117
 118         // If not yet confirmed, display a confirmation message.
 119         if (!optional_param('confirm', '', PARAM_BOOL)) {
 120             $title = get_string('deletefilterareyousure', 'admin', $filtername);
 121             echo $OUTPUT->header();
 122             echo $OUTPUT->heading($title);
 123
 124             $linkcontinue = new moodle_url($returnurl, array('action' => 'delete', 'filterpath' => $filterpath, 'confirm' => 1));
 125             $formcancel = new single_button(new moodle_url($returnurl), get_string('no'), 'get');
 126             echo $OUTPUT->confirm(get_string('deletefilterareyousuremessage', 'admin', $filtername), $linkcontinue, $formcancel);
 127             echo $OUTPUT->footer();
 128             exit;
 129         }
 130
 131         // Do the deletion.
 132         $title = get_string('deletingfilter', 'admin', $filtername);
 133         echo $OUTPUT->header();
 134         echo $OUTPUT->heading($title);
 135
 136         // Delete all data for this plugin.
 137         filter_delete_all_for_filter($filterpath);
 138
 139         $a = new stdClass;
 140         $a->filter = $filtername;
 141         $a->directory = $filterpath;
 142         echo $OUTPUT->box(get_string('deletefilterfiles', 'admin', $a), 'generalbox', 'notice');
 143         echo $OUTPUT->continue_button($returnurl);
 144         echo $OUTPUT->footer();
 145         exit;
 146     }
 147
 148     // Add any missing filters to the DB table.
 149     foreach ($newfilters as $filter => $notused) {
 150         filter_set_global_state($filter, TEXTFILTER_DISABLED);
 151     }
 152
 153     // Reset caches and return
 154     if ($action) {
 155         reset_text_filters_cache();
 156         redirect($returnurl);
 157     }
 158
 159 /// End of process actions =====================================================
 160
 161 /// Print the page heading.
 162     echo $OUTPUT->header();
 163     echo $OUTPUT->heading(get_string('filtersettings', 'admin'));
 164
 165     $activechoices = array(
 166         TEXTFILTER_DISABLED => get_string('disabled', 'filters'),
 167         TEXTFILTER_OFF => get_string('offbutavailable', 'filters'),
 168         TEXTFILTER_ON => get_string('on', 'filters'),
 169     );
 170     $applytochoices = array(
 171         0 => get_string('content', 'filters'),
 172         1 => get_string('contentandheadings', 'filters'),
 173     );
 174
 175     $filters = filter_get_global_states();
 176
 177     // In case any new filters have been installed, but not put in the table yet.
 178     $filternames = filter_get_all_installed();
 179     $newfilters = $filternames;
 180     foreach ($filters as $filter => $notused) {
 181         unset($newfilters[$filter]);
 182     }
 183     $stringfilters = filter_get_string_filters();
 184
 185     $table = new html_table();
 186     $table->head  = array(get_string('filter'), get_string('isactive', 'filters'),
 187             get_string('order'), get_string('applyto', 'filters'), get_string('settings'), get_string('delete'));
 188     $table->align = array('left', 'left', 'center', 'left', 'left');
 189     $table->width = '100%';
 190     $table->data  = array();
 191
 192     $lastactive = null;
 193     foreach ($filters as $filter => $filterinfo) {
 194         if ($filterinfo->active != TEXTFILTER_DISABLED) {
 195             $lastactive = $filter;
 196         }
 197     }
 198
 199     // iterate through filters adding to display table
 200     $firstrow = true;
 201     foreach ($filters as $filter => $filterinfo) {
 202         $applytostrings = isset($stringfilters[$filter]) && $filterinfo->active != TEXTFILTER_DISABLED;
 203         $row = get_table_row($filterinfo, $firstrow, $filter == $lastactive, $applytostrings);
 204         $table->data[] = $row;
 205         if ($filterinfo->active == TEXTFILTER_DISABLED) {
 206             $table->rowclasses[] = 'dimmed_text';
 207         } else {
 208             $table->rowclasses[] = '';
 209         }
 210         $firstrow = false;
 211     }
 212     foreach ($newfilters as $filter => $filtername) {
 213         $filterinfo = new stdClass;
 214         $filterinfo->filter = $filter;
 215         $filterinfo->active = TEXTFILTER_DISABLED;
 216         $row = get_table_row($filterinfo, false, false, false);
 217         $table->data[] = $row;
 218         $table->rowclasses[] = 'dimmed_text';
 219     }
 220
 221     echo html_writer::table($table);
 222     echo '<p class="filtersettingnote">' . get_string('filterallwarning', 'filters') . '</p>';
 223     echo $OUTPUT->footer();
 224
 225 /// Display helper functions ===================================================
 226
 227 function filters_action_url($filterpath, $action) {
 228     return new moodle_url('/admin/filters.php', array('sesskey'=>sesskey(), 'filterpath'=>$filterpath, 'action'=>$action));
 229 }
 230
 231 function get_table_row($filterinfo, $isfirstrow, $islastactive, $applytostrings) {
 232     global $CFG, $OUTPUT, $activechoices, $applytochoices, $filternames; //TODO: this is sloppy coding style!!
 233     $row = array();
 234     $filter = $filterinfo->filter;
 235
 236     // Filter name
 237     if (!empty($filternames[$filter])) {
 238         $row[] = $filternames[$filter];
 239     } else {
 240         $row[] = '<span class="error">' . get_string('filemissing', '', $filter) . '</span>';
 241     }
 242
 243     // Disable/off/on
 244     $select = new single_select(filters_action_url($filter, 'setstate'), 'newstate', $activechoices, $filterinfo->active, null, 'active' . basename($filter));
 245     $select->set_label(get_string('isactive', 'filters'), array('class' => 'accesshide'));
 246     $row[] = $OUTPUT->render($select);
 247
 248     // Re-order
 249     $updown = '';
 250     $spacer = '<img src="' . $OUTPUT->pix_url('spacer') . '" class="iconsmall" alt="" /> ';
 251     if ($filterinfo->active != TEXTFILTER_DISABLED) {
 252         if (!$isfirstrow) {
 253             $updown .= $OUTPUT->action_icon(filters_action_url($filter, 'up'), new pix_icon('t/up', get_string('up')));
 254         } else {
 255             $updown .= $spacer;
 256         }
 257         if (!$islastactive) {
 258             $updown .= $OUTPUT->action_icon(filters_action_url($filter, 'down'), new pix_icon('t/down', get_string('down')));
 259         } else {
 260             $updown .= $spacer;
 261         }
 262     }
 263     $row[] = $updown;
 264
 265     // Apply to strings.
 266     $select = new single_select(filters_action_url($filter, 'setapplyto'), 'stringstoo', $applytochoices, $applytostrings, null, 'applyto' . basename($filter));
 267     $select->set_label(get_string('applyto', 'filters'), array('class' => 'accesshide'));
 268     $select->disabled = $filterinfo->active == TEXTFILTER_DISABLED;
 269     $row[] = $OUTPUT->render($select);
 270
 271     // Settings link, if required
 272     if (filter_has_global_settings($filter)) {
 273         $row[] = '<a href="' . $CFG->wwwroot . '/' . $CFG->admin . '/settings.php?section=filtersetting' .
 274                 str_replace('/', '',$filter) . '">' . get_string('settings') . '</a>';
 275     } else {
 276         $row[] = '';
 277     }
 278
 279     // Delete
 280     if (substr($filter, 0, 4) != 'mod/') {
 281         $row[] = '<a href="' . filters_action_url($filter, 'delete') . '">' . get_string('delete') . '</a>';
 282     } else {
 283         $row[] = '';
 284     }
 285
 286     return $row;
 287 }