diff options
Diffstat (limited to 'platform/www/inc/Ui/Admin.php')
| -rw-r--r-- | platform/www/inc/Ui/Admin.php | 167 |
1 files changed, 167 insertions, 0 deletions
diff --git a/platform/www/inc/Ui/Admin.php b/platform/www/inc/Ui/Admin.php new file mode 100644 index 0000000..fe319d4 --- /dev/null +++ b/platform/www/inc/Ui/Admin.php @@ -0,0 +1,167 @@ +<?php +namespace dokuwiki\Ui; + +/** + * Class Admin + * + * Displays the Admin screen + * + * @package dokuwiki\Ui + * @author Andreas Gohr <andi@splitbrain.org> + * @author Håkan Sandell <hakan.sandell@home.se> + */ +class Admin extends Ui { + + protected $forAdmins = array('usermanager', 'acl', 'extension', 'config', 'styling'); + protected $forManagers = array('revert', 'popularity'); + /** @var array[] */ + protected $menu; + + /** + * Display the UI element + * + * @return void + */ + public function show() { + $this->menu = $this->getPluginList(); + echo '<div class="ui-admin">'; + echo p_locale_xhtml('admin'); + $this->showSecurityCheck(); + $this->showMenu('admin'); + $this->showMenu('manager'); + $this->showVersion(); + $this->showMenu('other'); + echo '</div>'; + } + + /** + * Show the given menu of available plugins + * + * @param string $type admin|manager|other + */ + protected function showMenu($type) { + if (!$this->menu[$type]) return; + + if ($type === 'other') { + echo p_locale_xhtml('adminplugins'); + $class = 'admin_plugins'; + } else { + $class = 'admin_tasks'; + } + + echo "<ul class=\"$class\">"; + foreach ($this->menu[$type] as $item) { + $this->showMenuItem($item); + } + echo '</ul>'; + } + + /** + * Display the DokuWiki version + */ + protected function showVersion() { + echo '<div id="admin__version">'; + echo getVersion(); + echo '</div>'; + } + + /** + * data security check + * + * simple check if the 'savedir' is relative and accessible when appended to DOKU_URL + * + * it verifies either: + * 'savedir' has been moved elsewhere, or + * has protection to prevent the webserver serving files from it + */ + protected function showSecurityCheck() { + global $conf; + if(substr($conf['savedir'], 0, 2) !== './') return; + $img = DOKU_URL . $conf['savedir'] . + '/dont-panic-if-you-see-this-in-your-logs-it-means-your-directory-permissions-are-correct.png'; + echo '<a style="border:none; float:right;" + href="http://www.dokuwiki.org/security#web_access_security"> + <img src="' . $img . '" alt="Your data directory seems to be protected properly." + onerror="this.parentNode.style.display=\'none\'" /></a>'; + } + + /** + * Display a single Admin menu item + * + * @param array $item + */ + protected function showMenuItem($item) { + global $ID; + if(blank($item['prompt'])) return; + echo '<li><div class="li">'; + echo '<a href="' . wl($ID, 'do=admin&page=' . $item['plugin']) . '">'; + echo '<span class="icon">'; + echo inlineSVG($item['icon']); + echo '</span>'; + echo '<span class="prompt">'; + echo $item['prompt']; + echo '</span>'; + echo '</a>'; + echo '</div></li>'; + } + + /** + * Build list of admin functions from the plugins that handle them + * + * Checks the current permissions to decide on manager or admin plugins + * + * @return array list of plugins with their properties + */ + protected function getPluginList() { + global $conf; + + $pluginlist = plugin_list('admin'); + $menu = ['admin' => [], 'manager' => [], 'other' => []]; + + foreach($pluginlist as $p) { + /** @var \dokuwiki\Extension\AdminPlugin $obj */ + if(($obj = plugin_load('admin', $p)) === null) continue; + + // check permissions + if (!$obj->isAccessibleByCurrentUser()) continue; + + if (in_array($p, $this->forAdmins, true)) { + $type = 'admin'; + } elseif (in_array($p, $this->forManagers, true)){ + $type = 'manager'; + } else { + $type = 'other'; + } + + $menu[$type][$p] = array( + 'plugin' => $p, + 'prompt' => $obj->getMenuText($conf['lang']), + 'icon' => $obj->getMenuIcon(), + 'sort' => $obj->getMenuSort(), + ); + } + + // sort by name, then sort + uasort($menu['admin'], [$this, 'menuSort']); + uasort($menu['manager'], [$this, 'menuSort']); + uasort($menu['other'], [$this, 'menuSort']); + + return $menu; + } + + /** + * Custom sorting for admin menu + * + * We sort alphabetically first, then by sort value + * + * @param array $a + * @param array $b + * @return int + */ + protected function menuSort($a, $b) { + $strcmp = strcasecmp($a['prompt'], $b['prompt']); + if($strcmp != 0) return $strcmp; + if($a['sort'] === $b['sort']) return 0; + return ($a['sort'] < $b['sort']) ? -1 : 1; + } +} |