====== Admin home page plugin ======

---- plugin ----
description: Replacement for 'Admin' page with better usability
author     : Håkan Sandell
email      : hakan.sandell@home.se
type       : action
lastupdate : 2009-06-03
compatible : 2009-02-14, 2008-05-05, 2007-06-26, 2009-12-25, anteater, rincewind rc1
depends    : 
conflicts  : 
similar    : 
tags       : admin shortcuts

downloadurl: http://cloud.github.com/downloads/HakanS/dokuwiki-plugin-adminhomepage/adminhomepage.zip
bugtracker : http://github.com/HakanS/dokuwiki-plugin-adminhomepage/issues
sourcerepo : http://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 =====
Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually.

^ **Download** | [[http://cloud.github.com/downloads/HakanS/dokuwiki-plugin-adminhomepage/adminhomepage.zip|adminhomepage.zip]] | 

See also: [[#Source Code]], [[#Change Log]], [[#Known Bugs]], [[#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.

=== Source Code ===

The source code is available at [[http://github.com/HakanS/dokuwiki-plugin-adminhomepage|GitHub]]

==== 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 <hakan.sandell[at]mydata.se>
 * @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//