====== Admin Home Page Plugin ======

---- plugin ----
description: Replacement for 'Admin' page with better usability
author     : Håkan Sandell
email      : sandell.hakan@gmail.com
type       : action
lastupdate : 2009-06-03
compatible : Lemming, Anteater, Rincewind
depends    : 
conflicts  : 
similar    : 
tags       : !obsolete

downloadurl: https://github.com/HakanS/dokuwiki-plugin-adminhomepage/archive/master.zip
bugtracker : https://github.com/HakanS/dokuwiki-plugin-adminhomepage/issues
sourcerepo : https://github.com/HakanS/dokuwiki-plugin-adminhomepage
----
Tired of not finding the user manager fast enough? This plugin replaces the standard 'Admin' page. It has the four basic tasks (users, ACL, plugin management & config settings) separated from the rest of currently installed admin plugins.  This will make management faster and easier. As a bonus the DokuWiki version is displayed in a convenient place along with PHP version.

**Note:** This functionality is included in the DokuWiki core since version 2009-12-25 "Lemming" with nicer icons.

===== Download and Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

See also: [[#Change Log]], [[#ToDo/Wish List]]


===== Usage =====

Just install and enjoy! You will see something like this depending on active template. Sometimes a page reload is necessary to clear the browsers CSS-cache.

{{http://cloud.github.com/downloads/HakanS/dokuwiki-plugin-adminhomepage/adminhomepage.png?300|}}


===== Development =====

This plugin uses the [[devel:events_list#TPL_ACT_UNKNOWN]] trick from [[devel:event_handlers#methods|event_handlers]].

  - In [[xref>act_dispatch()]] the [[devel:events_list#ACTION_ACT_PREPROCESS]] event is raised before dispatching any requested actions. The plugin catches the event and replaces ACT='admin' with ACT='adminhomepage'. 
  - Then [[xref>tpl_content_core()]] receives the 'adminhomepage' action and the [[devel:events_list#TPL_ACT_UNKNOWN]] event is raised so the new admin page is rendered.
  - Naturally $_REQUEST['page'] is checked so it's empty, which is the admin main page.


==== Development Resources ====

=== Change Log ===

  * **2009-06-03**
    *  Added German and French translations. Better handling of disabled user manager plugin when LDAP or other auth-backend is used.
  * **2009-05-29**
    *  First version released


=== Internationalization ===

English, German, French and Swedish is included. If you make a translation to another language I'm happy to include it, use Git, mail me or paste it on this page. 


=== ToDo/Wish List ===

  * Nicer icons, they should be a little bigger also 32x32


===== Credits =====

Anyone willing to contribute with better graphics? I'm more than happy to include them and salute you...\\
Etienne M(fr) and Michael Duelli(de) helped out with translations.


===== Discussion =====

  * Great! Thanks. Here is my french translation proposition: <code php>
<?php
/**
 * french language file for AdminHomePage plugin
 *
 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
 * @author     Håkan Sandell <sandell[dot]hakan[at]gmail. com>
 * @author     Etienne M. <emauvaisfr[at]yahoo.fr>
 */

$lang['pageheader']            = 'Administration';
$lang['wiki_version']          = 'Version de DokuWiki :';
$lang['php_version']           = 'Version de PHP :';
$lang['more_adminheader']      = 'Autres plugins d\'administration';
$lang['more_admintext']        = '//Plugins// d\'administration disponibles sur ce DokuWiki. Voir sur [[doku>fr:plugins?pluginsort=d&plugintype=2|Admin Plugins]] pour en ajouter.';
</code>


> Excellent idea. I used your ideas to redesign the core admin area in a similar way.  --- //[[andi@splitbrain.org|Andreas Gohr]] 2009/06/06 12:16//