MDL-49329 admin: Use the new plugins management on Plugins overview page
[moodle.git] / admin / 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/>.
17 /**
18  * Renderer for core_admin subsystem
19  *
20  * @package    core
21  * @subpackage admin
22  * @copyright  2011 David Mudrak <david@moodle.com>
23  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
24  */
26 defined('MOODLE_INTERNAL') || die();
29 /**
30  * Standard HTML output renderer for core_admin subsystem
31  */
32 class core_admin_renderer extends plugin_renderer_base {
34     /**
35      * Display the 'Do you acknowledge the terms of the GPL' page. The first page
36      * during install.
37      * @return string HTML to output.
38      */
39     public function install_licence_page() {
40         global $CFG;
41         $output = '';
43         $copyrightnotice = text_to_html(get_string('gpl3'));
44         $copyrightnotice = str_replace('target="_blank"', 'onclick="this.target=\'_blank\'"', $copyrightnotice); // extremely ugly validation hack
46         $continue = new single_button(new moodle_url($this->page->url, array(
47             'lang' => $CFG->lang, 'agreelicense' => 1)), get_string('continue'), 'get');
49         $output .= $this->header();
50         $output .= $this->heading('<a href="http://moodle.org">Moodle</a> - Modular Object-Oriented Dynamic Learning Environment');
51         $output .= $this->heading(get_string('copyrightnotice'));
52         $output .= $this->box($copyrightnotice, 'copyrightnotice');
53         $output .= html_writer::empty_tag('br');
54         $output .= $this->confirm(get_string('doyouagree'), $continue, "http://docs.moodle.org/dev/License");
55         $output .= $this->footer();
57         return $output;
58     }
60     /**
61      * Display page explaining proper upgrade process,
62      * there can not be any PHP file leftovers...
63      *
64      * @return string HTML to output.
65      */
66     public function upgrade_stale_php_files_page() {
67         $output = '';
68         $output .= $this->header();
69         $output .= $this->heading(get_string('upgradestalefiles', 'admin'));
70         $output .= $this->box_start('generalbox', 'notice');
71         $output .= format_text(get_string('upgradestalefilesinfo', 'admin', get_docs_url('Upgrading')), FORMAT_MARKDOWN);
72         $output .= html_writer::empty_tag('br');
73         $output .= html_writer::tag('div', $this->single_button($this->page->url, get_string('reload'), 'get'), array('class' => 'buttons'));
74         $output .= $this->box_end();
75         $output .= $this->footer();
77         return $output;
78     }
80     /**
81      * Display the 'environment check' page that is displayed during install.
82      * @param int $maturity
83      * @param boolean $envstatus final result of the check (true/false)
84      * @param array $environment_results array of results gathered
85      * @param string $release moodle release
86      * @return string HTML to output.
87      */
88     public function install_environment_page($maturity, $envstatus, $environment_results, $release) {
89         global $CFG;
90         $output = '';
92         $output .= $this->header();
93         $output .= $this->maturity_warning($maturity);
94         $output .= $this->heading("Moodle $release");
95         $output .= $this->release_notes_link();
97         $output .= $this->environment_check_table($envstatus, $environment_results);
99         if (!$envstatus) {
100             $output .= $this->upgrade_reload(new moodle_url($this->page->url, array('agreelicense' => 1, 'lang' => $CFG->lang)));
101         } else {
102             $output .= $this->notification(get_string('environmentok', 'admin'), 'notifysuccess');
103             $output .= $this->continue_button(new moodle_url($this->page->url, array(
104                 'agreelicense' => 1, 'confirmrelease' => 1, 'lang' => $CFG->lang)));
105         }
107         $output .= $this->footer();
108         return $output;
109     }
111     /**
112      * Displays the list of plugins with unsatisfied dependencies
113      *
114      * @param double|string|int $version Moodle on-disk version
115      * @param array $failed list of plugins with unsatisfied dependecies
116      * @param moodle_url $reloadurl URL of the page to recheck the dependencies
117      * @return string HTML
118      */
119     public function unsatisfied_dependencies_page($version, array $failed, moodle_url $reloadurl) {
120         $output = '';
122         $output .= $this->header();
123         $output .= $this->heading(get_string('pluginscheck', 'admin'));
124         $output .= $this->warning(get_string('pluginscheckfailed', 'admin', array('pluginslist' => implode(', ', array_unique($failed)))));
125         $output .= $this->plugins_check_table(core_plugin_manager::instance(), $version, array('xdep' => true));
126         $output .= $this->warning(get_string('pluginschecktodo', 'admin'));
127         $output .= $this->continue_button($reloadurl);
129         $output .= $this->footer();
131         return $output;
132     }
134     /**
135      * Display the 'You are about to upgrade Moodle' page. The first page
136      * during upgrade.
137      * @param string $strnewversion
138      * @param int $maturity
139      * @param string $testsite
140      * @return string HTML to output.
141      */
142     public function upgrade_confirm_page($strnewversion, $maturity, $testsite) {
143         $output = '';
145         $continueurl = new moodle_url($this->page->url, array('confirmupgrade' => 1, 'cache' => 0));
146         $continue = new single_button($continueurl, get_string('continue'), 'get');
147         $cancelurl = new moodle_url('/admin/index.php');
149         $output .= $this->header();
150         $output .= $this->maturity_warning($maturity);
151         $output .= $this->test_site_warning($testsite);
152         $output .= $this->confirm(get_string('upgradesure', 'admin', $strnewversion), $continue, $cancelurl);
153         $output .= $this->footer();
155         return $output;
156     }
158     /**
159      * Display the environment page during the upgrade process.
160      * @param string $release
161      * @param boolean $envstatus final result of env check (true/false)
162      * @param array $environment_results array of results gathered
163      * @return string HTML to output.
164      */
165     public function upgrade_environment_page($release, $envstatus, $environment_results) {
166         global $CFG;
167         $output = '';
169         $output .= $this->header();
170         $output .= $this->heading("Moodle $release");
171         $output .= $this->release_notes_link();
172         $output .= $this->environment_check_table($envstatus, $environment_results);
174         if (!$envstatus) {
175             $output .= $this->upgrade_reload(new moodle_url($this->page->url, array('confirmupgrade' => 1, 'cache' => 0)));
177         } else {
178             $output .= $this->notification(get_string('environmentok', 'admin'), 'notifysuccess');
180             if (empty($CFG->skiplangupgrade) and current_language() !== 'en') {
181                 $output .= $this->box(get_string('langpackwillbeupdated', 'admin'), 'generalbox', 'notice');
182             }
184             $output .= $this->continue_button(new moodle_url($this->page->url, array(
185                 'confirmupgrade' => 1, 'confirmrelease' => 1, 'cache' => 0)));
186         }
188         $output .= $this->footer();
190         return $output;
191     }
193     /**
194      * Display the upgrade page that lists all the plugins that require attention.
195      * @param core_plugin_manager $pluginman provides information about the plugins.
196      * @param \core\update\checker $checker provides information about available updates.
197      * @param int $version the version of the Moodle code from version.php.
198      * @param bool $showallplugins
199      * @param moodle_url $reloadurl
200      * @param moodle_url $continueurl
201      * @return string HTML to output.
202      */
203     public function upgrade_plugin_check_page(core_plugin_manager $pluginman, \core\update\checker $checker,
204             $version, $showallplugins, $reloadurl, $continueurl) {
206         $output = '';
208         $output .= $this->header();
209         $output .= $this->box_start('generalbox', 'plugins-check-page');
210         $output .= html_writer::tag('p', get_string('pluginchecknotice', 'core_plugin'), array('class' => 'page-description'));
211         $output .= $this->check_for_updates_button($checker, $reloadurl);
212         $output .= $this->missing_dependencies($pluginman);
213         $output .= $this->plugins_check_table($pluginman, $version, array('full' => $showallplugins));
214         $output .= $this->box_end();
215         $output .= $this->upgrade_reload($reloadurl);
217         if ($pluginman->some_plugins_updatable()) {
218             $output .= $this->container_start('upgradepluginsinfo');
219             $output .= $this->help_icon('upgradepluginsinfo', 'core_admin', get_string('upgradepluginsfirst', 'core_admin'));
220             $output .= $this->container_end();
221         }
223         $button = new single_button($continueurl, get_string('upgradestart', 'admin'), 'get');
224         $button->class = 'continuebutton';
225         $output .= $this->render($button);
226         $output .= $this->footer();
228         return $output;
229     }
231     /**
232      * Display the admin notifications page.
233      * @param int $maturity
234      * @param bool $insecuredataroot warn dataroot is invalid
235      * @param bool $errorsdisplayed warn invalid dispaly error setting
236      * @param bool $cronoverdue warn cron not running
237      * @param bool $dbproblems warn db has problems
238      * @param bool $maintenancemode warn in maintenance mode
239      * @param bool $buggyiconvnomb warn iconv problems
240      * @param array|null $availableupdates array of \core\update\info objects or null
241      * @param int|null $availableupdatesfetch timestamp of the most recent updates fetch or null (unknown)
242      * @param string[] $cachewarnings An array containing warnings from the Cache API.
243      *
244      * @return string HTML to output.
245      */
246     public function admin_notifications_page($maturity, $insecuredataroot, $errorsdisplayed,
247             $cronoverdue, $dbproblems, $maintenancemode, $availableupdates, $availableupdatesfetch,
248             $buggyiconvnomb, $registered, array $cachewarnings = array()) {
249         global $CFG;
250         $output = '';
252         $output .= $this->header();
253         $output .= $this->maturity_info($maturity);
254         $output .= empty($CFG->disableupdatenotifications) ? $this->available_updates($availableupdates, $availableupdatesfetch) : '';
255         $output .= $this->insecure_dataroot_warning($insecuredataroot);
256         $output .= $this->display_errors_warning($errorsdisplayed);
257         $output .= $this->buggy_iconv_warning($buggyiconvnomb);
258         $output .= $this->cron_overdue_warning($cronoverdue);
259         $output .= $this->db_problems($dbproblems);
260         $output .= $this->maintenance_mode_warning($maintenancemode);
261         $output .= $this->cache_warnings($cachewarnings);
262         $output .= $this->registration_warning($registered);
264         //////////////////////////////////////////////////////////////////////////////////////////////////
265         ////  IT IS ILLEGAL AND A VIOLATION OF THE GPL TO HIDE, REMOVE OR MODIFY THIS COPYRIGHT NOTICE ///
266         $output .= $this->moodle_copyright();
267         //////////////////////////////////////////////////////////////////////////////////////////////////
269         $output .= $this->footer();
271         return $output;
272     }
274     /**
275      * Display the plugin management page (admin/plugins.php).
276      *
277      * The filtering options array may contain following items:
278      *  bool contribonly - show only contributed extensions
279      *  bool updatesonly - show only plugins with an available update
280      *
281      * @param core_plugin_manager $pluginman
282      * @param \core\update\checker $checker
283      * @param array $options filtering options
284      * @return string HTML to output.
285      */
286     public function plugin_management_page(core_plugin_manager $pluginman, \core\update\checker $checker, array $options = array()) {
288         $output = '';
290         $output .= $this->header();
291         $output .= $this->heading(get_string('pluginsoverview', 'core_admin'));
292         $output .= $this->check_for_updates_button($checker, $this->page->url);
293         $output .= $this->plugins_overview_panel($pluginman, $options);
294         $output .= $this->plugins_control_panel($pluginman, $options);
295         $output .= $this->footer();
297         return $output;
298     }
300     /**
301      * Renders a button to fetch for available updates.
302      *
303      * @param \core\update\checker $checker
304      * @param moodle_url $reloadurl
305      * @return string HTML
306      */
307     public function check_for_updates_button(\core\update\checker $checker, $reloadurl) {
309         $output = '';
311         if ($checker->enabled()) {
312             $output .= $this->container_start('checkforupdates');
313             $output .= $this->single_button(
314                 new moodle_url($reloadurl, array('fetchremote' => 1)),
315                 get_string('checkforupdates', 'core_plugin')
316             );
317             if ($timefetched = $checker->get_last_timefetched()) {
318                 $timefetched = userdate($timefetched, get_string('strftimedatetime', 'core_langconfig'));
319                 $output .= $this->container(get_string('checkforupdateslast', 'core_plugin', $timefetched), 'lasttimefetched');
320             }
321             $output .= $this->container_end();
322         }
324         return $output;
325     }
327     /**
328      * Display a page to confirm the plugin uninstallation.
329      *
330      * @param core_plugin_manager $pluginman
331      * @param \core\plugininfo\base $pluginfo
332      * @param moodle_url $continueurl URL to continue after confirmation
333      * @param moodle_url $cancelurl URL to to go if cancelled
334      * @return string
335      */
336     public function plugin_uninstall_confirm_page(core_plugin_manager $pluginman, \core\plugininfo\base $pluginfo, moodle_url $continueurl, moodle_url $cancelurl) {
337         $output = '';
339         $pluginname = $pluginman->plugin_name($pluginfo->component);
341         $confirm = '<p>' . get_string('uninstallconfirm', 'core_plugin', array('name' => $pluginname)) . '</p>';
342         if ($extraconfirm = $pluginfo->get_uninstall_extra_warning()) {
343             $confirm .= $extraconfirm;
344         }
346         $output .= $this->output->header();
347         $output .= $this->output->heading(get_string('uninstalling', 'core_plugin', array('name' => $pluginname)));
348         $output .= $this->output->confirm($confirm, $continueurl, $cancelurl);
349         $output .= $this->output->footer();
351         return $output;
352     }
354     /**
355      * Display a page with results of plugin uninstallation and offer removal of plugin files.
356      *
357      * @param core_plugin_manager $pluginman
358      * @param \core\plugininfo\base $pluginfo
359      * @param progress_trace_buffer $progress
360      * @param moodle_url $continueurl URL to continue to remove the plugin folder
361      * @return string
362      */
363     public function plugin_uninstall_results_removable_page(core_plugin_manager $pluginman, \core\plugininfo\base $pluginfo,
364                                                             progress_trace_buffer $progress, moodle_url $continueurl) {
365         $output = '';
367         $pluginname = $pluginman->plugin_name($pluginfo->component);
369         // Do not show navigation here, they must click one of the buttons.
370         $this->page->set_pagelayout('maintenance');
371         $this->page->set_cacheable(false);
373         $output .= $this->output->header();
374         $output .= $this->output->heading(get_string('uninstalling', 'core_plugin', array('name' => $pluginname)));
376         $output .= $this->output->box($progress->get_buffer(), 'generalbox uninstallresultmessage');
378         $confirm = $this->output->container(get_string('uninstalldeleteconfirm', 'core_plugin',
379             array('name' => $pluginname, 'rootdir' => $pluginfo->rootdir)), 'uninstalldeleteconfirm');
381         if ($repotype = $pluginman->plugin_external_source($pluginfo->component)) {
382             $confirm .= $this->output->container(get_string('uninstalldeleteconfirmexternal', 'core_plugin', $repotype),
383                 'uninstalldeleteconfirmexternal');
384         }
386         // After any uninstall we must execute full upgrade to finish the cleanup!
387         $output .= $this->output->confirm($confirm, $continueurl, new moodle_url('/admin/index.php'));
388         $output .= $this->output->footer();
390         return $output;
391     }
393     /**
394      * Display a page with results of plugin uninstallation and inform about the need to remove plugin files manually.
395      *
396      * @param core_plugin_manager $pluginman
397      * @param \core\plugininfo\base $pluginfo
398      * @param progress_trace_buffer $progress
399      * @return string
400      */
401     public function plugin_uninstall_results_page(core_plugin_manager $pluginman, \core\plugininfo\base $pluginfo, progress_trace_buffer $progress) {
402         $output = '';
404         $pluginname = $pluginfo->component;
406         $output .= $this->output->header();
407         $output .= $this->output->heading(get_string('uninstalling', 'core_plugin', array('name' => $pluginname)));
409         $output .= $this->output->box($progress->get_buffer(), 'generalbox uninstallresultmessage');
411         $output .= $this->output->box(get_string('uninstalldelete', 'core_plugin',
412             array('name' => $pluginname, 'rootdir' => $pluginfo->rootdir)), 'generalbox uninstalldelete');
413         $output .= $this->output->continue_button(new moodle_url('/admin/index.php'));
414         $output .= $this->output->footer();
416         return $output;
417     }
419     /**
420      * Display the plugin management page (admin/environment.php).
421      * @param array $versions
422      * @param string $version
423      * @param boolean $envstatus final result of env check (true/false)
424      * @param array $environment_results array of results gathered
425      * @return string HTML to output.
426      */
427     public function environment_check_page($versions, $version, $envstatus, $environment_results) {
428         $output = '';
429         $output .= $this->header();
431         // Print the component download link
432         $output .= html_writer::tag('div', html_writer::link(
433                     new moodle_url('/admin/environment.php', array('action' => 'updatecomponent', 'sesskey' => sesskey())),
434                     get_string('updatecomponent', 'admin')),
435                 array('class' => 'reportlink'));
437         // Heading.
438         $output .= $this->heading(get_string('environment', 'admin'));
440         // Box with info and a menu to choose the version.
441         $output .= $this->box_start();
442         $output .= html_writer::tag('div', get_string('adminhelpenvironment'));
443         $select = new single_select(new moodle_url('/admin/environment.php'), 'version', $versions, $version, null);
444         $select->label = get_string('moodleversion');
445         $output .= $this->render($select);
446         $output .= $this->box_end();
448         // The results
449         $output .= $this->environment_check_table($envstatus, $environment_results);
451         $output .= $this->footer();
452         return $output;
453     }
455     /**
456      * Output a warning message, of the type that appears on the admin notifications page.
457      * @param string $message the message to display.
458      * @param string $type type class
459      * @return string HTML to output.
460      */
461     protected function warning($message, $type = 'warning') {
462         return $this->box($message, 'generalbox admin' . $type);
463     }
465     /**
466      * Render an appropriate message if dataroot is insecure.
467      * @param bool $insecuredataroot
468      * @return string HTML to output.
469      */
470     protected function insecure_dataroot_warning($insecuredataroot) {
471         global $CFG;
473         if ($insecuredataroot == INSECURE_DATAROOT_WARNING) {
474             return $this->warning(get_string('datarootsecuritywarning', 'admin', $CFG->dataroot));
476         } else if ($insecuredataroot == INSECURE_DATAROOT_ERROR) {
477             return $this->warning(get_string('datarootsecurityerror', 'admin', $CFG->dataroot), 'error');
479         } else {
480             return '';
481         }
482     }
484     /**
485      * Render an appropriate message if dataroot is insecure.
486      * @param bool $errorsdisplayed
487      * @return string HTML to output.
488      */
489     protected function display_errors_warning($errorsdisplayed) {
490         if (!$errorsdisplayed) {
491             return '';
492         }
494         return $this->warning(get_string('displayerrorswarning', 'admin'));
495     }
497     /**
498      * Render an appropriate message if iconv is buggy and mbstring missing.
499      * @param bool $buggyiconvnomb
500      * @return string HTML to output.
501      */
502     protected function buggy_iconv_warning($buggyiconvnomb) {
503         if (!$buggyiconvnomb) {
504             return '';
505         }
507         return $this->warning(get_string('warningiconvbuggy', 'admin'));
508     }
510     /**
511      * Render an appropriate message if cron has not been run recently.
512      * @param bool $cronoverdue
513      * @return string HTML to output.
514      */
515     public function cron_overdue_warning($cronoverdue) {
516         global $CFG;
517         if (!$cronoverdue) {
518             return '';
519         }
521         if (empty($CFG->cronclionly)) {
522             $url = new moodle_url('/admin/cron.php');
523             if (!empty($CFG->cronremotepassword)) {
524                 $url = new moodle_url('/admin/cron.php', array('password' => $CFG->cronremotepassword));
525             }
527             return $this->warning(get_string('cronwarning', 'admin', $url->out()) . '&nbsp;' .
528                     $this->help_icon('cron', 'admin'));
529         }
531         // $CFG->cronclionly is not empty: cron can run only from CLI.
532         return $this->warning(get_string('cronwarningcli', 'admin') . '&nbsp;' .
533                 $this->help_icon('cron', 'admin'));
534     }
536     /**
537      * Render an appropriate message if there are any problems with the DB set-up.
538      * @param bool $dbproblems
539      * @return string HTML to output.
540      */
541     public function db_problems($dbproblems) {
542         if (!$dbproblems) {
543             return '';
544         }
546         return $this->warning($dbproblems);
547     }
549     /**
550      * Renders cache warnings if there are any.
551      *
552      * @param string[] $cachewarnings
553      * @return string
554      */
555     public function cache_warnings(array $cachewarnings) {
556         if (!count($cachewarnings)) {
557             return '';
558         }
559         return join("\n", array_map(array($this, 'warning'), $cachewarnings));
560     }
562     /**
563      * Render an appropriate message if the site in in maintenance mode.
564      * @param bool $maintenancemode
565      * @return string HTML to output.
566      */
567     public function maintenance_mode_warning($maintenancemode) {
568         if (!$maintenancemode) {
569             return '';
570         }
572         $url = new moodle_url('/admin/settings.php', array('section' => 'maintenancemode'));
573         $url = $url->out(); // get_string() does not support objects in params
575         return $this->warning(get_string('sitemaintenancewarning2', 'admin', $url));
576     }
578     /**
579      * Display a warning about installing development code if necesary.
580      * @param int $maturity
581      * @return string HTML to output.
582      */
583     protected function maturity_warning($maturity) {
584         if ($maturity == MATURITY_STABLE) {
585             return ''; // No worries.
586         }
588         $maturitylevel = get_string('maturity' . $maturity, 'admin');
589         return $this->warning(
590                     $this->container(get_string('maturitycorewarning', 'admin', $maturitylevel)) .
591                     $this->container($this->doc_link('admin/versions', get_string('morehelp'))),
592                 'error');
593     }
595     /*
596      * If necessary, displays a warning about upgrading a test site.
597      *
598      * @param string $testsite
599      * @return string HTML
600      */
601     protected function test_site_warning($testsite) {
603         if (!$testsite) {
604             return '';
605         }
607         $warning = (get_string('testsiteupgradewarning', 'admin', $testsite));
608         return $this->warning($warning, 'error');
609     }
611     /**
612      * Output the copyright notice.
613      * @return string HTML to output.
614      */
615     protected function moodle_copyright() {
616         global $CFG;
618         //////////////////////////////////////////////////////////////////////////////////////////////////
619         ////  IT IS ILLEGAL AND A VIOLATION OF THE GPL TO HIDE, REMOVE OR MODIFY THIS COPYRIGHT NOTICE ///
620         $copyrighttext = '<a href="http://moodle.org/">Moodle</a> '.
621                          '<a href="http://docs.moodle.org/dev/Releases" title="'.$CFG->version.'">'.$CFG->release.'</a><br />'.
622                          'Copyright &copy; 1999 onwards, Martin Dougiamas<br />'.
623                          'and <a href="http://moodle.org/dev">many other contributors</a>.<br />'.
624                          '<a href="http://docs.moodle.org/dev/License">GNU Public License</a>';
625         //////////////////////////////////////////////////////////////////////////////////////////////////
627         return $this->box($copyrighttext, 'copyright');
628     }
630     /**
631      * Display a warning about installing development code if necesary.
632      * @param int $maturity
633      * @return string HTML to output.
634      */
635     protected function maturity_info($maturity) {
636         if ($maturity == MATURITY_STABLE) {
637             return ''; // No worries.
638         }
640         $level = 'warning';
642         if ($maturity == MATURITY_ALPHA) {
643             $level = 'error';
644         }
646         $maturitylevel = get_string('maturity' . $maturity, 'admin');
647         $warningtext = get_string('maturitycoreinfo', 'admin', $maturitylevel);
648         $warningtext .= ' ' . $this->doc_link('admin/versions', get_string('morehelp'));
649         return $this->warning($warningtext, $level);
650     }
652     /**
653      * Displays the info about available Moodle core and plugin updates
654      *
655      * The structure of the $updates param has changed since 2.4. It contains not only updates
656      * for the core itself, but also for all other installed plugins.
657      *
658      * @param array|null $updates array of (string)component => array of \core\update\info objects or null
659      * @param int|null $fetch timestamp of the most recent updates fetch or null (unknown)
660      * @return string
661      */
662     protected function available_updates($updates, $fetch) {
664         $updateinfo = '';
665         $someupdateavailable = false;
666         if (is_array($updates)) {
667             if (is_array($updates['core'])) {
668                 $someupdateavailable = true;
669                 $updateinfo .= $this->heading(get_string('updateavailable', 'core_admin'), 3);
670                 foreach ($updates['core'] as $update) {
671                     $updateinfo .= $this->moodle_available_update_info($update);
672                 }
673                 $updateinfo .= html_writer::tag('p', get_string('updateavailablerecommendation', 'core_admin'),
674                     array('class' => 'updateavailablerecommendation'));
675             }
676             unset($updates['core']);
677             // If something has left in the $updates array now, it is updates for plugins.
678             if (!empty($updates)) {
679                 $someupdateavailable = true;
680                 $updateinfo .= $this->heading(get_string('updateavailableforplugin', 'core_admin'), 3);
681                 $pluginsoverviewurl = new moodle_url('/admin/plugins.php', array('updatesonly' => 1));
682                 $updateinfo .= $this->container(get_string('pluginsoverviewsee', 'core_admin',
683                     array('url' => $pluginsoverviewurl->out())));
684             }
685         }
687         if (!$someupdateavailable) {
688             $now = time();
689             if ($fetch and ($fetch <= $now) and ($now - $fetch < HOURSECS)) {
690                 $updateinfo .= $this->heading(get_string('updateavailablenot', 'core_admin'), 3);
691             }
692         }
694         $updateinfo .= $this->container_start('checkforupdates');
695         $fetchurl = new moodle_url('/admin/index.php', array('fetchupdates' => 1, 'sesskey' => sesskey(), 'cache' => 0));
696         $updateinfo .= $this->single_button($fetchurl, get_string('checkforupdates', 'core_plugin'));
697         if ($fetch) {
698             $updateinfo .= $this->container(get_string('checkforupdateslast', 'core_plugin',
699                 userdate($fetch, get_string('strftimedatetime', 'core_langconfig'))));
700         }
701         $updateinfo .= $this->container_end();
703         return $this->warning($updateinfo);
704     }
706     /**
707      * Display a warning about not being registered on Moodle.org if necesary.
708      *
709      * @param boolean $registered true if the site is registered on Moodle.org
710      * @return string HTML to output.
711      */
712     protected function registration_warning($registered) {
714         if (!$registered) {
716             $registerbutton = $this->single_button(new moodle_url('/admin/registration/register.php',
717                     array('huburl' =>  HUB_MOODLEORGHUBURL, 'hubname' => 'Moodle.org')),
718                     get_string('register', 'admin'));
720             return $this->warning( get_string('registrationwarning', 'admin')
721                     . '&nbsp;' . $this->help_icon('registration', 'admin') . $registerbutton );
722         }
724         return '';
725     }
727     /**
728      * Helper method to render the information about the available Moodle update
729      *
730      * @param \core\update\info $updateinfo information about the available Moodle core update
731      */
732     protected function moodle_available_update_info(\core\update\info $updateinfo) {
734         $boxclasses = 'moodleupdateinfo';
735         $info = array();
737         if (isset($updateinfo->release)) {
738             $info[] = html_writer::tag('span', get_string('updateavailable_release', 'core_admin', $updateinfo->release),
739                 array('class' => 'info release'));
740         }
742         if (isset($updateinfo->version)) {
743             $info[] = html_writer::tag('span', get_string('updateavailable_version', 'core_admin', $updateinfo->version),
744                 array('class' => 'info version'));
745         }
747         if (isset($updateinfo->maturity)) {
748             $info[] = html_writer::tag('span', get_string('maturity'.$updateinfo->maturity, 'core_admin'),
749                 array('class' => 'info maturity'));
750             $boxclasses .= ' maturity'.$updateinfo->maturity;
751         }
753         if (isset($updateinfo->download)) {
754             $info[] = html_writer::link($updateinfo->download, get_string('download'), array('class' => 'info download'));
755         }
757         if (isset($updateinfo->url)) {
758             $info[] = html_writer::link($updateinfo->url, get_string('updateavailable_moreinfo', 'core_plugin'),
759                 array('class' => 'info more'));
760         }
762         $box  = $this->output->box_start($boxclasses);
763         $box .= $this->output->box(implode(html_writer::tag('span', ' ', array('class' => 'separator')), $info), '');
764         $box .= $this->output->box_end();
766         return $box;
767     }
769     /**
770      * Display a link to the release notes.
771      * @return string HTML to output.
772      */
773     protected function release_notes_link() {
774         $releasenoteslink = get_string('releasenoteslink', 'admin', 'http://docs.moodle.org/dev/Releases');
775         $releasenoteslink = str_replace('target="_blank"', 'onclick="this.target=\'_blank\'"', $releasenoteslink); // extremely ugly validation hack
776         return $this->box($releasenoteslink, 'generalbox releasenoteslink');
777     }
779     /**
780      * Display the reload link that appears on several upgrade/install pages.
781      * @return string HTML to output.
782      */
783     function upgrade_reload($url) {
784         return html_writer::empty_tag('br') .
785                 html_writer::tag('div',
786                     html_writer::link($url, $this->pix_icon('i/reload', '', '', array('class' => 'icon icon-pre')) .
787                             get_string('reload'), array('title' => get_string('reload'))),
788                 array('class' => 'continuebutton')) . html_writer::empty_tag('br');
789     }
791     /**
792      * Displays all known plugins and information about their installation or upgrade
793      *
794      * This default implementation renders all plugins into one big table. The rendering
795      * options support:
796      *     (bool)full = false: whether to display up-to-date plugins, too
797      *     (bool)xdep = false: display the plugins with unsatisified dependecies only
798      *
799      * @param core_plugin_manager $pluginman provides information about the plugins.
800      * @param int $version the version of the Moodle code from version.php.
801      * @param array $options rendering options
802      * @return string HTML code
803      */
804     public function plugins_check_table(core_plugin_manager $pluginman, $version, array $options = array()) {
806         $plugininfo = $pluginman->get_plugins();
808         if (empty($plugininfo)) {
809             return '';
810         }
812         $options['full'] = isset($options['full']) ? (bool)$options['full'] : false;
813         $options['xdep'] = isset($options['xdep']) ? (bool)$options['xdep'] : false;
815         $table = new html_table();
816         $table->id = 'plugins-check';
817         $table->head = array(
818             get_string('displayname', 'core_plugin').' / '.get_string('rootdir', 'core_plugin'),
819             get_string('versiondb', 'core_plugin'),
820             get_string('versiondisk', 'core_plugin'),
821             get_string('requires', 'core_plugin'),
822             get_string('source', 'core_plugin').' / '.get_string('status', 'core_plugin'),
823         );
824         $table->colclasses = array(
825             'displayname', 'versiondb', 'versiondisk', 'requires', 'status',
826         );
827         $table->data = array();
829         // Number of displayed plugins per type.
830         $numdisplayed = array();
831         // Number of plugins known to the plugin manager.
832         $sumtotal = 0;
833         // Number of plugins requiring attention.
834         $sumattention = 0;
835         // List of all components we can cancel installation of.
836         $installabortable = array();
838         foreach ($plugininfo as $type => $plugins) {
840             $header = new html_table_cell($pluginman->plugintype_name_plural($type));
841             $header->header = true;
842             $header->colspan = count($table->head);
843             $header = new html_table_row(array($header));
844             $header->attributes['class'] = 'plugintypeheader type-' . $type;
846             $numdisplayed[$type] = 0;
848             if (empty($plugins) and $options['full']) {
849                 $msg = new html_table_cell(get_string('noneinstalled', 'core_plugin'));
850                 $msg->colspan = count($table->head);
851                 $row = new html_table_row(array($msg));
852                 $row->attributes['class'] .= 'msg msg-noneinstalled';
853                 $table->data[] = $header;
854                 $table->data[] = $row;
855                 continue;
856             }
858             $plugintyperows = array();
860             foreach ($plugins as $name => $plugin) {
861                 $sumtotal++;
862                 $row = new html_table_row();
863                 $row->attributes['class'] = 'type-' . $plugin->type . ' name-' . $plugin->type . '_' . $plugin->name;
865                 if ($this->page->theme->resolve_image_location('icon', $plugin->type . '_' . $plugin->name, null)) {
866                     $icon = $this->output->pix_icon('icon', '', $plugin->type . '_' . $plugin->name, array('class' => 'smallicon pluginicon'));
867                 } else {
868                     $icon = '';
869                 }
871                 $displayname = new html_table_cell(
872                     $icon.
873                     html_writer::span($plugin->displayname, 'pluginname').
874                     html_writer::div($plugin->get_dir(), 'plugindir')
875                 );
877                 $versiondb = new html_table_cell($plugin->versiondb);
878                 $versiondisk = new html_table_cell($plugin->versiondisk);
880                 if ($isstandard = $plugin->is_standard()) {
881                     $row->attributes['class'] .= ' standard';
882                     $sourcelabel = html_writer::span(get_string('sourcestd', 'core_plugin'), 'sourcetext label');
883                 } else {
884                     $row->attributes['class'] .= ' extension';
885                     $sourcelabel = html_writer::span(get_string('sourceext', 'core_plugin'), 'sourcetext label label-info');
886                 }
888                 $coredependency = $plugin->is_core_dependency_satisfied($version);
889                 $otherpluginsdependencies = $pluginman->are_dependencies_satisfied($plugin->get_other_required_plugins());
890                 $dependenciesok = $coredependency && $otherpluginsdependencies;
892                 $statuscode = $plugin->get_status();
893                 $row->attributes['class'] .= ' status-' . $statuscode;
894                 $statusclass = 'statustext label ';
895                 switch ($statuscode) {
896                     case core_plugin_manager::PLUGIN_STATUS_NEW:
897                         $statusclass .= $dependenciesok ? 'label-success' : 'label-warning';
898                         break;
899                     case core_plugin_manager::PLUGIN_STATUS_UPGRADE:
900                         $statusclass .= $dependenciesok ? 'label-info' : 'label-warning';
901                         break;
902                     case core_plugin_manager::PLUGIN_STATUS_MISSING:
903                     case core_plugin_manager::PLUGIN_STATUS_DOWNGRADE:
904                     case core_plugin_manager::PLUGIN_STATUS_DELETE:
905                         $statusclass .= 'label-important';
906                         break;
907                     case core_plugin_manager::PLUGIN_STATUS_NODB:
908                     case core_plugin_manager::PLUGIN_STATUS_UPTODATE:
909                         $statusclass .= $dependenciesok ? '' : 'label-warning';
910                         break;
911                 }
912                 $status = html_writer::span(get_string('status_' . $statuscode, 'core_plugin'), $statusclass);
914                 if ($statuscode == core_plugin_manager::PLUGIN_STATUS_NEW and !$plugin->is_standard()) {
915                     if ($pluginman->is_plugin_folder_removable($plugin->component)) {
916                         $installabortable[] = $plugin->component;
917                         $status .= $this->output->single_button(
918                             new moodle_url($this->page->url, array('abortinstall' => $plugin->component)),
919                             get_string('cancelinstallone', 'core_plugin'),
920                             'post',
921                             array('class' => 'actionbutton')
922                         );
923                     }
924                 }
926                 $availableupdates = $plugin->available_updates();
927                 if (!empty($availableupdates)) {
928                     foreach ($availableupdates as $availableupdate) {
929                         $status .= $this->plugin_available_update_info($pluginman, $availableupdate);
930                     }
931                 }
933                 $status = new html_table_cell($sourcelabel.' '.$status);
935                 $requires = new html_table_cell($this->required_column($plugin, $pluginman, $version));
937                 $statusisboring = in_array($statuscode, array(
938                         core_plugin_manager::PLUGIN_STATUS_NODB, core_plugin_manager::PLUGIN_STATUS_UPTODATE));
940                 if ($options['xdep']) {
941                     // we want to see only plugins with failed dependencies
942                     if ($dependenciesok) {
943                         continue;
944                     }
946                 } else if ($statusisboring and $dependenciesok and empty($availableupdates)) {
947                     // no change is going to happen to the plugin - display it only
948                     // if the user wants to see the full list
949                     if (empty($options['full'])) {
950                         continue;
951                     }
953                 } else {
954                     $sumattention++;
955                 }
957                 // The plugin should be displayed.
958                 $numdisplayed[$type]++;
959                 $row->cells = array($displayname, $versiondb, $versiondisk, $requires, $status);
960                 $plugintyperows[] = $row;
961             }
963             if (empty($numdisplayed[$type]) and empty($options['full'])) {
964                 continue;
965             }
967             $table->data[] = $header;
968             $table->data = array_merge($table->data, $plugintyperows);
969         }
971         // Total number of displayed plugins.
972         $sumdisplayed = array_sum($numdisplayed);
974         if ($options['xdep']) {
975             // At the plugins dependencies check page, display the table only.
976             return html_writer::table($table);
977         }
979         $out = $this->output->container_start('', 'plugins-check-info');
981         if ($sumdisplayed == 0) {
982             $out .= $this->output->heading(get_string('pluginchecknone', 'core_plugin'));
984         } else {
985             if (empty($options['full'])) {
986                 $out .= $this->output->heading(get_string('plugincheckattention', 'core_plugin'));
987             } else {
988                 $out .= $this->output->heading(get_string('plugincheckall', 'core_plugin'));
989             }
990         }
992         $out .= $this->output->container_start('actions');
993         if ($installabortable) {
994             $out .= $this->output->single_button(
995                 new moodle_url($this->page->url, array('abortinstallx' => 1)),
996                 get_string('cancelinstallall', 'core_plugin', count($installabortable)),
997                 'post',
998                 array('class' => 'singlebutton cancelinstallall')
999             );
1000         }
1002         $installableupdates = $pluginman->filter_installable($pluginman->available_updates());
1003         if ($installableupdates) {
1004             $out .= $this->output->single_button(
1005                 new moodle_url($this->page->url, array('installupdatex' => 1)),
1006                 get_string('updateavailableinstallall', 'core_admin', count($installableupdates)),
1007                 'post',
1008                 array('class' => 'singlebutton updateavailableinstallall')
1009             );
1010         }
1012         $out .= html_writer::div(html_writer::link(new moodle_url($this->page->url, array('showallplugins' => 0)),
1013             get_string('plugincheckattention', 'core_plugin')).' '.html_writer::span($sumattention, 'badge'));
1015         $out .= html_writer::div(html_writer::link(new moodle_url($this->page->url, array('showallplugins' => 1)),
1016             get_string('plugincheckall', 'core_plugin')).' '.html_writer::span($sumtotal, 'badge'));
1018         $out .= $this->output->container_end(); // .actions
1019         $out .= $this->output->container_end(); // #plugins-check-info
1021         if ($sumdisplayed > 0 or $options['full']) {
1022             $out .= html_writer::table($table);
1023         }
1025         return $out;
1026     }
1028     /**
1029      * Display the continue / cancel widgets for the plugins validation page.
1030      *
1031      * @param null|moodle_url $continue URL for the continue button, should it be displayed
1032      * @param string $label explicit label for the continue button
1033      * @param moodle_url $cancel URL for the cancel link, defaults to the current page
1034      * @return string HTML
1035      */
1036     public function install_remote_plugins_buttons(moodle_url $continue=null, $label=null, moodle_url $cancel=null) {
1038         $out = html_writer::start_div('install-remote-plugins-buttons');
1040         if (!empty($continue)) {
1041             if (empty($label)) {
1042                 $label = get_string('continue');
1043             }
1044             $out .= $this->output->single_button($continue, $label, 'post', array('class' => 'continue'));
1045         }
1047         if (empty($cancel)) {
1048             $cancel = $this->page->url;
1049         }
1050         $out .= html_writer::div(html_writer::link($cancel, get_string('cancel')), 'cancel');
1052         return $out;
1053     }
1055     /**
1056      * Displays the information about missing dependencies
1057      *
1058      * @param core_plugin_manager $pluginman
1059      * @return string
1060      */
1061     protected function missing_dependencies(core_plugin_manager $pluginman) {
1063         $dependencies = $pluginman->missing_dependencies();
1065         if (empty($dependencies)) {
1066             return '';
1067         }
1069         $available = array();
1070         $unavailable = array();
1071         $unknown = array();
1073         foreach ($dependencies as $component => $remoteinfo) {
1074             if ($remoteinfo === false) {
1075                 // The required version is not available. Let us check if there
1076                 // is at least some version in the plugins directory.
1077                 $remoteinfoanyversion = $pluginman->get_remote_plugin_info($component, ANY_VERSION, false);
1078                 if ($remoteinfoanyversion === false) {
1079                     $unknown[$component] = $component;
1080                 } else {
1081                     $unavailable[$component] = $remoteinfoanyversion;
1082                 }
1083             } else {
1084                 $available[$component] = $remoteinfo;
1085             }
1086         }
1088         $out  = $this->output->container_start('plugins-check-dependencies');
1090         if ($unavailable or $unknown) {
1091             $out .= $this->output->heading(get_string('misdepsunavail', 'core_plugin'));
1092             if ($unknown) {
1093                 $out .= $this->output->notification(get_string('misdepsunknownlist', 'core_plugin', implode($unknown, ', ')));
1094             }
1095             if ($unavailable) {
1096                 $unavailablelist = array();
1097                 foreach ($unavailable as $component => $remoteinfoanyversion) {
1098                     $unavailablelistitem = html_writer::link('https://moodle.org/plugins/view.php?plugin='.$component,
1099                         '<strong>'.$remoteinfoanyversion->name.'</strong>');
1100                     if ($remoteinfoanyversion->version) {
1101                         $unavailablelistitem .= ' ('.$component.' &gt; '.$remoteinfoanyversion->version->version.')';
1102                     } else {
1103                         $unavailablelistitem .= ' ('.$component.')';
1104                     }
1105                     $unavailablelist[] = $unavailablelistitem;
1106                 }
1107                 $out .= $this->output->notification(get_string('misdepsunavaillist', 'core_plugin',
1108                     implode($unavailablelist, ', ')));
1109             }
1110             $out .= $this->output->container_start('plugins-check-dependencies-actions');
1111             $out .= ' '.html_writer::link(new moodle_url('/admin/tool/installaddon/'),
1112                 get_string('dependencyuploadmissing', 'core_plugin'));
1113             $out .= $this->output->container_end(); // .plugins-check-dependencies-actions
1114         }
1116         if ($available) {
1117             $out .= $this->output->heading(get_string('misdepsavail', 'core_plugin'));
1118             $out .= $this->output->container_start('plugins-check-dependencies-actions');
1120             $installable = $pluginman->filter_installable($available);
1121             if ($installable) {
1122                 $out .= $this->output->single_button(
1123                     new moodle_url($this->page->url, array('installdepx' => 1)),
1124                     get_string('dependencyinstallmissing', 'core_plugin', count($installable)),
1125                     'post',
1126                     array('class' => 'singlebutton dependencyinstallmissing')
1127                 );
1128             }
1130             $out.= html_writer::div(html_writer::link(new moodle_url('/admin/tool/installaddon/'),
1131                 get_string('dependencyuploadmissing', 'core_plugin')), 'dependencyuploadmissing');
1133             $out .= $this->output->container_end(); // .plugins-check-dependencies-actions
1135             $out .= $this->available_missing_dependencies_list($pluginman, $available);
1136         }
1138         $out .= $this->output->container_end(); // .plugins-check-dependencies
1140         return $out;
1141     }
1143     /**
1144      * Displays the list if available missing dependencies.
1145      *
1146      * @param core_plugin_manager $pluginman
1147      * @param array $dependencies
1148      * @return string
1149      */
1150     protected function available_missing_dependencies_list(core_plugin_manager $pluginman, array $dependencies) {
1151         global $CFG;
1153         $table = new html_table();
1154         $table->id = 'plugins-check-available-dependencies';
1155         $table->head = array(
1156             get_string('displayname', 'core_plugin'),
1157             get_string('release', 'core_plugin'),
1158             get_string('version', 'core_plugin'),
1159             get_string('supportedmoodleversions', 'core_plugin'),
1160             get_string('info', 'core'),
1161         );
1162         $table->colclasses = array('displayname', 'release', 'version', 'supportedmoodleversions', 'info');
1163         $table->data = array();
1165         foreach ($dependencies as $plugin) {
1167             $supportedmoodles = array();
1168             foreach ($plugin->version->supportedmoodles as $moodle) {
1169                 if ($CFG->branch == str_replace('.', '', $moodle->release)) {
1170                     $supportedmoodles[] = html_writer::span($moodle->release, 'label label-success');
1171                 } else {
1172                     $supportedmoodles[] = html_writer::span($moodle->release, 'label');
1173                 }
1174             }
1176             $requriedby = $pluginman->other_plugins_that_require($plugin->component);
1177             if ($requriedby) {
1178                 foreach ($requriedby as $ix => $val) {
1179                     $inf = $pluginman->get_plugin_info($val);
1180                     if ($inf) {
1181                         $requriedby[$ix] = $inf->displayname.' ('.$inf->component.')';
1182                     }
1183                 }
1184                 $info = html_writer::div(
1185                     get_string('requiredby', 'core_plugin', implode(', ', $requriedby)),
1186                     'requiredby'
1187                 );
1188             } else {
1189                 $info = '';
1190             }
1192             $info .= $this->output->container_start('actions');
1194             $info .= html_writer::div(
1195                 html_writer::link('https://moodle.org/plugins/view.php?plugin='.$plugin->component,
1196                     get_string('misdepinfoplugin', 'core_plugin')),
1197                 'misdepinfoplugin'
1198             );
1200             $info .= html_writer::div(
1201                 html_writer::link('https://moodle.org/plugins/pluginversion.php?id='.$plugin->version->id,
1202                     get_string('misdepinfoversion', 'core_plugin')),
1203                 'misdepinfoversion'
1204             );
1206             $info .= html_writer::div(html_writer::link($plugin->version->downloadurl, get_string('download')), 'misdepdownload');
1208             if ($pluginman->is_remote_plugin_installable($plugin->component, $plugin->version->version, $reason)) {
1209                 $info .= $this->output->single_button(
1210                     new moodle_url($this->page->url, array('installdep' => $plugin->component)),
1211                     get_string('dependencyinstall', 'core_plugin'),
1212                     'post',
1213                     array('class' => 'singlebutton dependencyinstall')
1214                 );
1215             } else {
1216                 $reasonhelp = $this->info_remote_plugin_not_installable($reason);
1217                 if ($reasonhelp) {
1218                     $info .= html_writer::div($reasonhelp, 'reasonhelp dependencyinstall');
1219                 }
1220             }
1222             $info .= $this->output->container_end(); // .actions
1224             $table->data[] = array(
1225                 html_writer::div($plugin->name, 'name').' '.html_writer::div($plugin->component, 'component'),
1226                 $plugin->version->release,
1227                 $plugin->version->version,
1228                 implode($supportedmoodles, ' '),
1229                 $info
1230             );
1231         }
1233         return html_writer::table($table);
1234     }
1236     /**
1237      * Explain why {@link core_plugin_manager::is_remote_plugin_installable()} returned false.
1238      *
1239      * @param string $reason the reason code as returned by the plugin manager
1240      * @return string
1241      */
1242     protected function info_remote_plugin_not_installable($reason) {
1244         if ($reason === 'notwritableplugintype' or $reason === 'notwritableplugin') {
1245             return $this->output->help_icon('notwritable', 'core_plugin', get_string('notwritable', 'core_plugin'));
1246         }
1248         if ($reason === 'remoteunavailable') {
1249             return $this->output->help_icon('notdownloadable', 'core_plugin', get_string('notdownloadable', 'core_plugin'));
1250         }
1252         return false;
1253     }
1255     /**
1256      * Formats the information that needs to go in the 'Requires' column.
1257      * @param \core\plugininfo\base $plugin the plugin we are rendering the row for.
1258      * @param core_plugin_manager $pluginman provides data on all the plugins.
1259      * @param string $version
1260      * @return string HTML code
1261      */
1262     protected function required_column(\core\plugininfo\base $plugin, core_plugin_manager $pluginman, $version) {
1264         $requires = array();
1265         $displayuploadlink = false;
1266         $displayupdateslink = false;
1268         foreach ($pluginman->resolve_requirements($plugin, $version) as $reqname => $reqinfo) {
1269             if ($reqname === 'core') {
1270                 if ($reqinfo->status == $pluginman::REQUIREMENT_STATUS_OK) {
1271                     $class = 'requires-ok';
1272                     $label = '';
1273                 } else {
1274                     $class = 'requires-failed';
1275                     $label = html_writer::span(get_string('dependencyfails', 'core_plugin'), 'label label-important');
1276                 }
1277                 $requires[] = html_writer::tag('li',
1278                     html_writer::span(get_string('moodleversion', 'core_plugin', $plugin->versionrequires), 'dep dep-core').
1279                     ' '.$label, array('class' => $class));
1281             } else {
1282                 $actions = array();
1284                 if ($reqinfo->status == $pluginman::REQUIREMENT_STATUS_OK) {
1285                     $label = '';
1286                     $class = 'requires-ok';
1288                 } else if ($reqinfo->status == $pluginman::REQUIREMENT_STATUS_MISSING) {
1289                     if ($reqinfo->availability == $pluginman::REQUIREMENT_AVAILABLE) {
1290                         $label = html_writer::span(get_string('dependencymissing', 'core_plugin'), 'label label-warning');
1291                         $label .= ' '.html_writer::span(get_string('dependencyavailable', 'core_plugin'), 'label label-warning');
1292                         $class = 'requires-failed requires-missing requires-available';
1293                         $actions[] = html_writer::link(
1294                             new moodle_url('https://moodle.org/plugins/view.php', array('plugin' => $reqname)),
1295                             get_string('misdepinfoplugin', 'core_plugin')
1296                         );
1298                     } else {
1299                         $label = html_writer::span(get_string('dependencymissing', 'core_plugin'), 'label label-important');
1300                         $label .= ' '.html_writer::span(get_string('dependencyunavailable', 'core_plugin'),
1301                             'label label-important');
1302                         $class = 'requires-failed requires-missing requires-unavailable';
1303                     }
1304                     $displayuploadlink = true;
1306                 } else if ($reqinfo->status == $pluginman::REQUIREMENT_STATUS_OUTDATED) {
1307                     if ($reqinfo->availability == $pluginman::REQUIREMENT_AVAILABLE) {
1308                         $label = html_writer::span(get_string('dependencyfails', 'core_plugin'), 'label label-warning');
1309                         $label .= ' '.html_writer::span(get_string('dependencyavailable', 'core_plugin'), 'label label-warning');
1310                         $class = 'requires-failed requires-outdated requires-available';
1311                         $displayupdateslink = true;
1313                     } else {
1314                         $label = html_writer::span(get_string('dependencyfails', 'core_plugin'), 'label label-important');
1315                         $label .= ' '.html_writer::span(get_string('dependencyunavailable', 'core_plugin'),
1316                             'label label-important');
1317                         $class = 'requires-failed requires-outdated requires-unavailable';
1318                     }
1319                     $displayuploadlink = true;
1320                 }
1322                 if ($reqinfo->reqver != ANY_VERSION) {
1323                     $str = 'otherpluginversion';
1324                 } else {
1325                     $str = 'otherplugin';
1326                 }
1328                 $requires[] = html_writer::tag('li', html_writer::span(
1329                     get_string($str, 'core_plugin', array('component' => $reqname, 'version' => $reqinfo->reqver)),
1330                     'dep dep-plugin').' '.$label.' '.html_writer::span(implode(' | ', $actions), 'actions'),
1331                     array('class' => $class)
1332                 );
1333             }
1334         }
1336         if (!$requires) {
1337             return '';
1338         }
1340         $out = html_writer::tag('ul', implode("\n", $requires));
1342         if ($displayuploadlink) {
1343             $out .= html_writer::div(
1344                 html_writer::link(
1345                     new moodle_url('/admin/tool/installaddon/'),
1346                     get_string('dependencyuploadmissing', 'core_plugin')
1347                 ),
1348                 'dependencyuploadmissing'
1349             );
1350         }
1352         if ($displayupdateslink) {
1353             $out .= html_writer::div(
1354                 html_writer::link(
1355                     new moodle_url($this->page->url, array('sesskey' => sesskey(), 'fetchupdates' => 1)),
1356                     get_string('checkforupdates', 'core_plugin')
1357                 ),
1358                 'checkforupdates'
1359             );
1360         }
1362         return $out;
1364     }
1366     /**
1367      * Prints an overview about the plugins - number of installed, number of extensions etc.
1368      *
1369      * @param core_plugin_manager $pluginman provides information about the plugins
1370      * @param array $options filtering options
1371      * @return string as usually
1372      */
1373     public function plugins_overview_panel(core_plugin_manager $pluginman, array $options = array()) {
1375         $plugininfo = $pluginman->get_plugins();
1377         $numtotal = $numextension = $numupdatable = 0;
1379         foreach ($plugininfo as $type => $plugins) {
1380             foreach ($plugins as $name => $plugin) {
1381                 if ($plugin->available_updates()) {
1382                     $numupdatable++;
1383                 }
1384                 if ($plugin->get_status() === core_plugin_manager::PLUGIN_STATUS_MISSING) {
1385                     continue;
1386                 }
1387                 $numtotal++;
1388                 if (!$plugin->is_standard()) {
1389                     $numextension++;
1390                 }
1391             }
1392         }
1394         $infoall = html_writer::link(
1395             new moodle_url($this->page->url, array('contribonly' => 0, 'updatesonly' => 0)),
1396             get_string('overviewall', 'core_plugin'),
1397             array('title' => get_string('filterall', 'core_plugin'))
1398         ).' '.html_writer::span($numtotal, 'badge number number-all');
1400         $infoext = html_writer::link(
1401             new moodle_url($this->page->url, array('contribonly' => 1, 'updatesonly' => 0)),
1402             get_string('overviewext', 'core_plugin'),
1403             array('title' => get_string('filtercontribonly', 'core_plugin'))
1404         ).' '.html_writer::span($numextension, 'badge number number-additional');
1406         if ($numupdatable) {
1407             $infoupdatable = html_writer::link(
1408                 new moodle_url($this->page->url, array('contribonly' => 0, 'updatesonly' => 1)),
1409                 get_string('overviewupdatable', 'core_plugin'),
1410                 array('title' => get_string('filterupdatesonly', 'core_plugin'))
1411             ).' '.html_writer::span($numupdatable, 'badge badge-info number number-updatable');
1412         } else {
1413             // No updates, or the notifications disabled.
1414             $infoupdatable = '';
1415         }
1417         $out = html_writer::start_div('', array('id' => 'plugins-overview-panel'));
1419         if (!empty($options['updatesonly'])) {
1420             $out .= $this->output->heading(get_string('overviewupdatable', 'core_plugin'), 3);
1421         } else if (!empty($options['contribonly'])) {
1422             $out .= $this->output->heading(get_string('overviewext', 'core_plugin'), 3);
1423         }
1425         if ($numupdatable) {
1426             $installableupdates = $pluginman->filter_installable($pluginman->available_updates());
1427             if ($installableupdates) {
1428                 $out .= $this->output->single_button(
1429                     new moodle_url($this->page->url, array('installupdatex' => 1)),
1430                     get_string('updateavailableinstallall', 'core_admin', count($installableupdates)),
1431                     'post',
1432                     array('class' => 'singlebutton updateavailableinstallall')
1433                 );
1434             }
1435         }
1437         $out .= html_writer::div($infoall, 'info info-all').
1438             html_writer::div($infoext, 'info info-ext').
1439             html_writer::div($infoupdatable, 'info info-updatable');
1441         $out .= html_writer::end_div(); // #plugins-overview-panel
1443         return $out;
1444     }
1446     /**
1447      * Displays all known plugins and links to manage them
1448      *
1449      * This default implementation renders all plugins into one big table.
1450      *
1451      * @param core_plugin_manager $pluginman provides information about the plugins.
1452      * @param array $options filtering options
1453      * @return string HTML code
1454      */
1455     public function plugins_control_panel(core_plugin_manager $pluginman, array $options = array()) {
1457         $plugininfo = $pluginman->get_plugins();
1459         // Filter the list of plugins according the options.
1460         if (!empty($options['updatesonly'])) {
1461             $updateable = array();
1462             foreach ($plugininfo as $plugintype => $pluginnames) {
1463                 foreach ($pluginnames as $pluginname => $pluginfo) {
1464                     $pluginavailableupdates = $pluginfo->available_updates();
1465                     if (!empty($pluginavailableupdates)) {
1466                         foreach ($pluginavailableupdates as $pluginavailableupdate) {
1467                             $updateable[$plugintype][$pluginname] = $pluginfo;
1468                         }
1469                     }
1470                 }
1471             }
1472             $plugininfo = $updateable;
1473         }
1475         if (!empty($options['contribonly'])) {
1476             $contribs = array();
1477             foreach ($plugininfo as $plugintype => $pluginnames) {
1478                 foreach ($pluginnames as $pluginname => $pluginfo) {
1479                     if (!$pluginfo->is_standard()) {
1480                         $contribs[$plugintype][$pluginname] = $pluginfo;
1481                     }
1482                 }
1483             }
1484             $plugininfo = $contribs;
1485         }
1487         if (empty($plugininfo)) {
1488             return '';
1489         }
1491         $table = new html_table();
1492         $table->id = 'plugins-control-panel';
1493         $table->head = array(
1494             get_string('displayname', 'core_plugin'),
1495             get_string('version', 'core_plugin'),
1496             get_string('availability', 'core_plugin'),
1497             get_string('actions', 'core_plugin'),
1498             get_string('notes','core_plugin'),
1499         );
1500         $table->headspan = array(1, 1, 1, 2, 1);
1501         $table->colclasses = array(
1502             'pluginname', 'version', 'availability', 'settings', 'uninstall', 'notes'
1503         );
1505         foreach ($plugininfo as $type => $plugins) {
1506             $heading = $pluginman->plugintype_name_plural($type);
1507             $pluginclass = core_plugin_manager::resolve_plugininfo_class($type);
1508             if ($manageurl = $pluginclass::get_manage_url()) {
1509                 $heading .= $this->output->action_icon($manageurl, new pix_icon('i/settings',
1510                     get_string('settings', 'core_plugin')));
1511             }
1512             $header = new html_table_cell(html_writer::tag('span', $heading, array('id'=>'plugin_type_cell_'.$type)));
1513             $header->header = true;
1514             $header->colspan = array_sum($table->headspan);
1515             $header = new html_table_row(array($header));
1516             $header->attributes['class'] = 'plugintypeheader type-' . $type;
1517             $table->data[] = $header;
1519             if (empty($plugins)) {
1520                 $msg = new html_table_cell(get_string('noneinstalled', 'core_plugin'));
1521                 $msg->colspan = array_sum($table->headspan);
1522                 $row = new html_table_row(array($msg));
1523                 $row->attributes['class'] .= 'msg msg-noneinstalled';
1524                 $table->data[] = $row;
1525                 continue;
1526             }
1528             foreach ($plugins as $name => $plugin) {
1529                 $row = new html_table_row();
1530                 $row->attributes['class'] = 'type-' . $plugin->type . ' name-' . $plugin->type . '_' . $plugin->name;
1532                 if ($this->page->theme->resolve_image_location('icon', $plugin->type . '_' . $plugin->name)) {
1533                     $icon = $this->output->pix_icon('icon', '', $plugin->type . '_' . $plugin->name, array('class' => 'icon pluginicon'));
1534                 } else {
1535                     $icon = $this->output->pix_icon('spacer', '', 'moodle', array('class' => 'icon pluginicon noicon'));
1536                 }
1537                 $status = $plugin->get_status();
1538                 $row->attributes['class'] .= ' status-'.$status;
1539                 $pluginname  = html_writer::tag('div', $icon.$plugin->displayname, array('class' => 'displayname')).
1540                                html_writer::tag('div', $plugin->component, array('class' => 'componentname'));
1541                 $pluginname  = new html_table_cell($pluginname);
1543                 $version = html_writer::div($plugin->versiondb, 'versionnumber');
1544                 if ((string)$plugin->release !== '') {
1545                     $version = html_writer::div($plugin->release, 'release').$version;
1546                 }
1547                 $version = new html_table_cell($version);
1549                 $isenabled = $plugin->is_enabled();
1550                 if (is_null($isenabled)) {
1551                     $availability = new html_table_cell('');
1552                 } else if ($isenabled) {
1553                     $row->attributes['class'] .= ' enabled';
1554                     $availability = new html_table_cell(get_string('pluginenabled', 'core_plugin'));
1555                 } else {
1556                     $row->attributes['class'] .= ' disabled';
1557                     $availability = new html_table_cell(get_string('plugindisabled', 'core_plugin'));
1558                 }
1560                 $settingsurl = $plugin->get_settings_url();
1561                 if (!is_null($settingsurl)) {
1562                     $settings = html_writer::link($settingsurl, get_string('settings', 'core_plugin'), array('class' => 'settings'));
1563                 } else {
1564                     $settings = '';
1565                 }
1566                 $settings = new html_table_cell($settings);
1568                 if ($uninstallurl = $pluginman->get_uninstall_url($plugin->component, 'overview')) {
1569                     $uninstall = html_writer::link($uninstallurl, get_string('uninstall', 'core_plugin'));
1570                 } else {
1571                     $uninstall = '';
1572                 }
1573                 $uninstall = new html_table_cell($uninstall);
1575                 if ($plugin->is_standard()) {
1576                     $row->attributes['class'] .= ' standard';
1577                     //$source = html_writer::div(get_string('sourcestd', 'core_plugin'), 'source label');
1578                     $source = '';
1579                 } else {
1580                     $row->attributes['class'] .= ' extension';
1581                     $source = html_writer::div(get_string('sourceext', 'core_plugin'), 'source label label-info');
1582                 }
1584                 if ($status === core_plugin_manager::PLUGIN_STATUS_MISSING) {
1585                     $msg = html_writer::div(get_string('status_missing', 'core_plugin'), 'statusmsg label label-important');
1586                 } else if ($status === core_plugin_manager::PLUGIN_STATUS_NEW) {
1587                     $msg = html_writer::div(get_string('status_new', 'core_plugin'), 'statusmsg label label-success');
1588                 } else {
1589                     $msg = '';
1590                 }
1592                 $requriedby = $pluginman->other_plugins_that_require($plugin->component);
1593                 if ($requriedby) {
1594                     $requiredby = html_writer::tag('div', get_string('requiredby', 'core_plugin', implode(', ', $requriedby)),
1595                         array('class' => 'requiredby'));
1596                 } else {
1597                     $requiredby = '';
1598                 }
1600                 $updateinfo = '';
1601                 if (is_array($plugin->available_updates())) {
1602                     foreach ($plugin->available_updates() as $availableupdate) {
1603                         $updateinfo .= $this->plugin_available_update_info($pluginman, $availableupdate);
1604                     }
1605                 }
1607                 $notes = new html_table_cell($source.$msg.$requiredby.$updateinfo);
1609                 $row->cells = array(
1610                     $pluginname, $version, $availability, $settings, $uninstall, $notes
1611                 );
1612                 $table->data[] = $row;
1613             }
1614         }
1616         return html_writer::table($table);
1617     }
1619     /**
1620      * Helper method to render the information about the available plugin update
1621      *
1622      * @param core_plugin_manager $pluginman plugin manager instance
1623      * @param \core\update\info $updateinfo information about the available update for the plugin
1624      */
1625     protected function plugin_available_update_info(core_plugin_manager $pluginman, \core\update\info $updateinfo) {
1627         $boxclasses = 'pluginupdateinfo';
1628         $info = array();
1630         if (isset($updateinfo->release)) {
1631             $info[] = html_writer::div(
1632                 get_string('updateavailable_release', 'core_plugin', $updateinfo->release),
1633                 'info release'
1634             );
1635         }
1637         if (isset($updateinfo->maturity)) {
1638             $info[] = html_writer::div(
1639                 get_string('maturity'.$updateinfo->maturity, 'core_admin'),
1640                 'info maturity'
1641             );
1642             $boxclasses .= ' maturity'.$updateinfo->maturity;
1643         }
1645         if (isset($updateinfo->download)) {
1646             $info[] = html_writer::div(
1647                 html_writer::link($updateinfo->download, get_string('download')),
1648                 'info download'
1649             );
1650         }
1652         if (isset($updateinfo->url)) {
1653             $info[] = html_writer::div(
1654                 html_writer::link($updateinfo->url, get_string('updateavailable_moreinfo', 'core_plugin')),
1655                 'info more'
1656             );
1657         }
1659         $box = html_writer::start_div($boxclasses);
1660         $box .= html_writer::div(
1661             get_string('updateavailable', 'core_plugin', $updateinfo->version),
1662             'version'
1663         );
1664         $box .= html_writer::div(
1665             implode(html_writer::span(' ', 'separator'), $info),
1666             'infos'
1667         );
1669         if ($pluginman->is_remote_plugin_installable($updateinfo->component, $updateinfo->version, $reason)) {
1670             $box .= $this->output->single_button(
1671                 new moodle_url($this->page->url, array('installupdate' => $updateinfo->component,
1672                     'installupdateversion' => $updateinfo->version)),
1673                 get_string('updateavailableinstall', 'core_admin'),
1674                 'post',
1675                 array('class' => 'singlebutton updateavailableinstall')
1676             );
1677         } else {
1678             $reasonhelp = $this->info_remote_plugin_not_installable($reason);
1679             if ($reasonhelp) {
1680                 $box .= html_writer::div($reasonhelp, 'reasonhelp updateavailableinstall');
1681             }
1682         }
1683         $box .= html_writer::end_div();
1685         return $box;
1686     }
1688     /**
1689      * This function will render one beautiful table with all the environmental
1690      * configuration and how it suits Moodle needs.
1691      *
1692      * @param boolean $result final result of the check (true/false)
1693      * @param environment_results[] $environment_results array of results gathered
1694      * @return string HTML to output.
1695      */
1696     public function environment_check_table($result, $environment_results) {
1697         global $CFG;
1699         // Table headers
1700         $servertable = new html_table();//table for server checks
1701         $servertable->head  = array(
1702             get_string('name'),
1703             get_string('info'),
1704             get_string('report'),
1705             get_string('plugin'),
1706             get_string('status'),
1707         );
1708         $servertable->colclasses = array('centeralign name', 'centeralign info', 'leftalign report', 'leftalign plugin', 'centeralign status');
1709         $servertable->attributes['class'] = 'admintable environmenttable generaltable';
1710         $servertable->id = 'serverstatus';
1712         $serverdata = array('ok'=>array(), 'warn'=>array(), 'error'=>array());
1714         $othertable = new html_table();//table for custom checks
1715         $othertable->head  = array(
1716             get_string('info'),
1717             get_string('report'),
1718             get_string('plugin'),
1719             get_string('status'),
1720         );
1721         $othertable->colclasses = array('aligncenter info', 'alignleft report', 'alignleft plugin', 'aligncenter status');
1722         $othertable->attributes['class'] = 'admintable environmenttable generaltable';
1723         $othertable->id = 'otherserverstatus';
1725         $otherdata = array('ok'=>array(), 'warn'=>array(), 'error'=>array());
1727         // Iterate over each environment_result
1728         $continue = true;
1729         foreach ($environment_results as $environment_result) {
1730             $errorline   = false;
1731             $warningline = false;
1732             $stringtouse = '';
1733             if ($continue) {
1734                 $type = $environment_result->getPart();
1735                 $info = $environment_result->getInfo();
1736                 $status = $environment_result->getStatus();
1737                 $plugin = $environment_result->getPluginName();
1738                 $error_code = $environment_result->getErrorCode();
1739                 // Process Report field
1740                 $rec = new stdClass();
1741                 // Something has gone wrong at parsing time
1742                 if ($error_code) {
1743                     $stringtouse = 'environmentxmlerror';
1744                     $rec->error_code = $error_code;
1745                     $status = get_string('error');
1746                     $errorline = true;
1747                     $continue = false;
1748                 }
1750                 if ($continue) {
1751                     if ($rec->needed = $environment_result->getNeededVersion()) {
1752                         // We are comparing versions
1753                         $rec->current = $environment_result->getCurrentVersion();
1754                         if ($environment_result->getLevel() == 'required') {
1755                             $stringtouse = 'environmentrequireversion';
1756                         } else {
1757                             $stringtouse = 'environmentrecommendversion';
1758                         }
1760                     } else if ($environment_result->getPart() == 'custom_check') {
1761                         // We are checking installed & enabled things
1762                         if ($environment_result->getLevel() == 'required') {
1763                             $stringtouse = 'environmentrequirecustomcheck';
1764                         } else {
1765                             $stringtouse = 'environmentrecommendcustomcheck';
1766                         }
1768                     } else if ($environment_result->getPart() == 'php_setting') {
1769                         if ($status) {
1770                             $stringtouse = 'environmentsettingok';
1771                         } else if ($environment_result->getLevel() == 'required') {
1772                             $stringtouse = 'environmentmustfixsetting';
1773                         } else {
1774                             $stringtouse = 'environmentshouldfixsetting';
1775                         }
1777                     } else {
1778                         if ($environment_result->getLevel() == 'required') {
1779                             $stringtouse = 'environmentrequireinstall';
1780                         } else {
1781                             $stringtouse = 'environmentrecommendinstall';
1782                         }
1783                     }
1785                     // Calculate the status value
1786                     if ($environment_result->getBypassStr() != '') {            //Handle bypassed result (warning)
1787                         $status = get_string('bypassed');
1788                         $warningline = true;
1789                     } else if ($environment_result->getRestrictStr() != '') {   //Handle restricted result (error)
1790                         $status = get_string('restricted');
1791                         $errorline = true;
1792                     } else {
1793                         if ($status) {                                          //Handle ok result (ok)
1794                             $status = get_string('ok');
1795                         } else {
1796                             if ($environment_result->getLevel() == 'optional') {//Handle check result (warning)
1797                                 $status = get_string('check');
1798                                 $warningline = true;
1799                             } else {                                            //Handle error result (error)
1800                                 $status = get_string('check');
1801                                 $errorline = true;
1802                             }
1803                         }
1804                     }
1805                 }
1807                 // Build the text
1808                 $linkparts = array();
1809                 $linkparts[] = 'admin/environment';
1810                 $linkparts[] = $type;
1811                 if (!empty($info)){
1812                    $linkparts[] = $info;
1813                 }
1814                 // Plugin environments do not have docs pages yet.
1815                 if (empty($CFG->docroot) or $environment_result->plugin) {
1816                     $report = get_string($stringtouse, 'admin', $rec);
1817                 } else {
1818                     $report = $this->doc_link(join($linkparts, '/'), get_string($stringtouse, 'admin', $rec));
1819                 }
1821                 // Format error or warning line
1822                 if ($errorline || $warningline) {
1823                     $messagetype = $errorline? 'error':'warn';
1824                 } else {
1825                     $messagetype = 'ok';
1826                 }
1827                 $status = '<span class="'.$messagetype.'">'.$status.'</span>';
1828                 // Here we'll store all the feedback found
1829                 $feedbacktext = '';
1830                 // Append the feedback if there is some
1831                 $feedbacktext .= $environment_result->strToReport($environment_result->getFeedbackStr(), $messagetype);
1832                 //Append the bypass if there is some
1833                 $feedbacktext .= $environment_result->strToReport($environment_result->getBypassStr(), 'warn');
1834                 //Append the restrict if there is some
1835                 $feedbacktext .= $environment_result->strToReport($environment_result->getRestrictStr(), 'error');
1837                 $report .= $feedbacktext;
1839                 // Add the row to the table
1840                 if ($environment_result->getPart() == 'custom_check'){
1841                     $otherdata[$messagetype][] = array ($info, $report, $plugin, $status);
1842                 } else {
1843                     $serverdata[$messagetype][] = array ($type, $info, $report, $plugin, $status);
1844                 }
1845             }
1846         }
1848         //put errors first in
1849         $servertable->data = array_merge($serverdata['error'], $serverdata['warn'], $serverdata['ok']);
1850         $othertable->data = array_merge($otherdata['error'], $otherdata['warn'], $otherdata['ok']);
1852         // Print table
1853         $output = '';
1854         $output .= $this->heading(get_string('serverchecks', 'admin'));
1855         $output .= html_writer::table($servertable);
1856         if (count($othertable->data)){
1857             $output .= $this->heading(get_string('customcheck', 'admin'));
1858             $output .= html_writer::table($othertable);
1859         }
1861         // Finally, if any error has happened, print the summary box
1862         if (!$result) {
1863             $output .= $this->box(get_string('environmenterrortodo', 'admin'), 'environmentbox errorbox');
1864         }
1866         return $output;
1867     }
1869     /**
1870      * Render a simple page for providing the upgrade key.
1871      *
1872      * @param moodle_url|string $url
1873      * @return string
1874      */
1875     public function upgradekey_form_page($url) {
1877         $output = '';
1878         $output .= $this->header();
1879         $output .= $this->container_start('upgradekeyreq');
1880         $output .= $this->heading(get_string('upgradekeyreq', 'core_admin'));
1881         $output .= html_writer::start_tag('form', array('method' => 'POST', 'action' => $url));
1882         $output .= html_writer::empty_tag('input', array('name' => 'upgradekey', 'type' => 'password'));
1883         $output .= html_writer::empty_tag('input', array('value' => get_string('submit'), 'type' => 'submit'));
1884         $output .= html_writer::end_tag('form');
1885         $output .= $this->container_end();
1886         $output .= $this->footer();
1888         return $output;
1889     }