<?php

/**

 * Enano - an open-source CMS capable of wiki functions, Drupal-like sidebar blocks, and everything in between

 * Copyright (C) 2006-2007 Dan Fuhry

 * paths.php - The part of Enano that actually manages content. Everything related to page handling and namespaces is in here.

 *

 * This program is Free Software; you can redistribute and/or modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied

 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for details.

 *

 * @package Enano

 * @subpackage PathManager

 * @see http://enanocms.org/Help:API_Documentation

 */

class pathManager {

  var $pages, $custom_page, $cpage, $page, $fullpage, $page_exists, $page_id, $namespace, $nslist, $admin_tree, $wiki_mode, $page_protected, $template_cache, $anonymous_page;

  function __construct()

  {

    global $db, $session, $paths, $template, $plugins; // Common objects

    $GLOBALS['paths'] =& $this;

    $this->pages = Array();

    // DEFINE NAMESPACES HERE

    // The key names should NOT EVER be changed, or Enano will be very broken

    $this->nslist = Array(

      'Article' =>'',

      'User'    =>'User:',

      'File'    =>'File:',

      'Help'    =>'Help:',

      'Admin'   =>'Admin:',

      'Special' =>'Special:',

      'System'  =>'Enano:',

      'Template'=>'Template:',

      'Category'=>'Category:',

      'Anonymous'=>'PhysicalRedirect:',

      'Project' =>sanitize_page_id(getConfig('site_name')).':',

      );

    // ACL types

    // These can also be added from within plugins

    $session->register_acl_type('read',                   AUTH_ALLOW,    'perm_read');

    $session->register_acl_type('post_comments',          AUTH_ALLOW,    'perm_post_comments',          Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('edit_comments',          AUTH_ALLOW,    'perm_edit_comments',          Array('post_comments'),                                   'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('edit_page',              AUTH_WIKIMODE, 'perm_edit_page',              Array('view_source'),                                     'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('edit_wysiwyg',           AUTH_ALLOW,    'perm_edit_wysiwyg',           Array('edit_page'),                                       'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('view_source',            AUTH_WIKIMODE, 'perm_view_source',            Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category'); // Only used if the page is protected

    $session->register_acl_type('mod_comments',           AUTH_DISALLOW, 'perm_mod_comments',           Array('edit_comments'),                                   'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('history_view',           AUTH_WIKIMODE, 'perm_history_view',           Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('history_rollback',       AUTH_DISALLOW, 'perm_history_rollback',       Array('history_view'),                                    'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('history_rollback_extra', AUTH_DISALLOW, 'perm_history_rollback_extra', Array('history_rollback'),                                'Article|User|Project|Template|File|Help|System|Category|Special');

    $session->register_acl_type('protect',                AUTH_DISALLOW, 'perm_protect',                Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('rename',                 AUTH_WIKIMODE, 'perm_rename',                 Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('clear_logs',             AUTH_DISALLOW, 'perm_clear_logs',             Array('read', 'protect', 'even_when_protected'),          'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('vote_delete',            AUTH_ALLOW,    'perm_vote_delete',            Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('vote_reset',             AUTH_DISALLOW, 'perm_vote_reset',             Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('delete_page',            AUTH_DISALLOW, 'perm_delete_page',            Array(),                                                  'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('tag_create',             AUTH_ALLOW,    'perm_tag_create',             Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('tag_delete_own',         AUTH_ALLOW,    'perm_tag_delete_own',         Array('read', 'tag_create'),                              'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('tag_delete_other',       AUTH_DISALLOW, 'perm_tag_delete_other',       Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('set_wiki_mode',          AUTH_DISALLOW, 'perm_set_wiki_mode',          Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('password_set',           AUTH_DISALLOW, 'perm_password_set',           Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('password_reset',         AUTH_DISALLOW, 'perm_password_reset',         Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('mod_misc',               AUTH_DISALLOW, 'perm_mod_misc',               Array(),                                                  'All');

    $session->register_acl_type('edit_cat',               AUTH_WIKIMODE, 'perm_edit_cat',               Array('read'),                                            'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('even_when_protected',    AUTH_DISALLOW, 'perm_even_when_protected',    Array('edit_page', 'rename', 'mod_comments', 'edit_cat'), 'Article|User|Project|Template|File|Help|System|Category');

    $session->register_acl_type('upload_files',           AUTH_DISALLOW, 'perm_upload_files',           Array('create_page'),                                     'Article|User|Project|Template|File|Help|System|Category|Special');

    $session->register_acl_type('upload_new_version',     AUTH_WIKIMODE, 'perm_upload_new_version',     Array('upload_files'),                                    'Article|User|Project|Template|File|Help|System|Category|Special');

    $session->register_acl_type('create_page',            AUTH_WIKIMODE, 'perm_create_page',            Array(),                                                  'Article|User|Project|Template|File|Help|System|Category|Special');

    $session->register_acl_type('html_in_pages',          AUTH_DISALLOW, 'perm_html_in_pages',          Array('edit_page'),                                       'Article|User|Project|Template|File|Help|System|Category|Admin');

    $session->register_acl_type('php_in_pages',           AUTH_DISALLOW, 'perm_php_in_pages',           Array('edit_page', 'html_in_pages'),                      'Article|User|Project|Template|File|Help|System|Category|Admin');

    $session->register_acl_type('edit_acl',               AUTH_DISALLOW, 'perm_edit_acl',               Array('read', 'post_comments', 'edit_comments', 'edit_page', 'view_source', 'mod_comments', 'history_view', 'history_rollback', 'history_rollback_extra', 'protect', 'rename', 'clear_logs', 'vote_delete', 'vote_reset', 'delete_page', 'set_wiki_mode', 'password_set', 'password_reset', 'mod_misc', 'edit_cat', 'even_when_protected', 'upload_files', 'upload_new_version', 'create_page', 'php_in_pages'));

    // DO NOT add new admin pages here! Use a plugin to call $paths->addAdminNode();

    $this->addAdminNode('adm_cat_general',    'adm_page_general_config', 'GeneralConfig', scriptPath . '/images/icons/applets/generalconfig.png');

    $this->addAdminNode('adm_cat_general',    'adm_page_file_uploads',   'UploadConfig', scriptPath . '/images/icons/applets/uploadconfig.png');

    $this->addAdminNode('adm_cat_general',    'adm_page_file_types',     'UploadAllowedMimeTypes', scriptPath . '/images/icons/applets/uploadallowedmimetypes.png');

    $this->addAdminNode('adm_cat_general',    'adm_page_plugins',        'PluginManager', scriptPath . '/images/icons/applets/pluginmanager.png');

    $this->addAdminNode('adm_cat_general',    'adm_page_db_backup',      'DBBackup', scriptPath . '/images/icons/applets/dbbackup.png');

    $this->addAdminNode('adm_cat_general',    'adm_page_lang_manager',   'LangManager', scriptPath . '/images/icons/applets/langmanager.png');

    $this->addAdminNode('adm_cat_content',    'adm_page_manager',        'PageManager', scriptPath . '/images/icons/applets/pagemanager.png');

    $this->addAdminNode('adm_cat_content',    'adm_page_editor',         'PageEditor', scriptPath . '/images/icons/applets/pageeditor.png');

    $this->addAdminNode('adm_cat_content',    'adm_page_pg_groups',      'PageGroups', scriptPath . '/images/icons/applets/pagegroups.png');

    $this->addAdminNode('adm_cat_appearance', 'adm_page_themes',         'ThemeManager', scriptPath . '/images/icons/applets/thememanager.png');

    $this->addAdminNode('adm_cat_users',      'adm_page_users',          'UserManager', scriptPath . '/images/icons/applets/usermanager.png');

    $this->addAdminNode('adm_cat_users',      'adm_page_user_groups',    'GroupManager', scriptPath . '/images/icons/applets/groupmanager.png');

    $this->addAdminNode('adm_cat_users',      'adm_page_coppa',          'COPPA', scriptPath . '/images/icons/applets/coppa.png');

    $this->addAdminNode('adm_cat_users',      'adm_page_mass_email',     'MassEmail', scriptPath . '/images/icons/applets/massemail.png');

    $this->addAdminNode('adm_cat_security',   'adm_page_security_log',   'SecurityLog', scriptPath . '/images/icons/applets/securitylog.png');

    $this->addAdminNode('adm_cat_security',   'adm_page_ban_control',    'BanControl', scriptPath . '/images/icons/applets/bancontrol.png');

    $code = $plugins->setHook('acl_rule_init');

    foreach ( $code as $cmd )

    {

      eval($cmd);

    }

    $this->wiki_mode = (int)getConfig('wiki_mode')=='1';

    $this->template_cache = Array();

  }

  function parse_url($sanitize = true)

  {

    $title = '';

    if( isset($_GET['title']) )

    {

      $title = $_GET['title'];

    }

    elseif( isset($_SERVER['PATH_INFO']) )

    {

      $title = substr($_SERVER['PATH_INFO'], ( strpos($_SERVER['PATH_INFO'], '/') ) + 1 );

    }

    else

    {

      // This method really isn't supported because apache has a habit of passing dots as underscores, thus corrupting the request

      // If you really want to try it, the URI format is yoursite.com/?/Page_title

      if ( count($_GET) > 0 )

      {

        list($getkey) = array_keys($_GET);

        if ( substr($getkey, 0, 1) == '/' )

        {

          $title = substr($getkey, 1);

        }

      }

    }

    return ( $sanitize ) ? sanitize_page_id($title) : $title;

  }

  function init()

  {

    global $db, $session, $paths, $template, $plugins; // Common objects

    global $lang;

    $code = $plugins->setHook('paths_init_before');

    foreach ( $code as $cmd )

    {

      eval($cmd);

    }

    $e = $db->sql_query('SELECT name,urlname,namespace,special,visible,comments_on,protected,delvotes,' . "\n"

                        . '  delvote_ips,wiki_mode,password FROM '.table_prefix.'pages ORDER BY name;');

    if( !$e )

    {

      $db->_die('The error seems to have occured while selecting the page information. File: includes/paths.php; line: '.__LINE__);

    }

    while($r = $db->fetchrow())

    {

      $r['urlname_nons'] = $r['urlname'];

      if ( isset($this->nslist[$r['namespace']]) )

      {

        $r['urlname'] = $this->nslist[$r['namespace']] . $r['urlname']; // Applies the User:/File:/etc prefixes to the URL names

      }

      else

      {

        $ns_char = substr($this->nslist['Special'], -1);

        $r['urlname'] = $r['namespace'] . $ns_char . $r['urlname'];

      }

      if ( $r['delvotes'] == null)

      {

        $r['delvotes'] = 0;

      }

      if ( $r['protected'] == 0 || $r['protected'] == 1 )

      {

        $r['really_protected'] = (int)$r['protected'];

      }

      else if ( $r['protected'] == 2 && getConfig('wiki_mode') == '1')

      {

        $r['really_protected'] = 1;

      }

      else if ( $r['protected'] == 2 && getConfig('wiki_mode') == '0' )

      {

        $r['really_protected'] = 0;

      }

      $this->pages[$r['urlname']] = $r;

      $this->pages[] =& $this->pages[$r['urlname']];

    }

    $db->free_result();

    if ( defined('ENANO_INTERFACE_INDEX') || defined('ENANO_INTERFACE_AJAX') || defined('IN_ENANO_UPGRADE') )

    {

      $title = $this->parse_url(false);

      if ( empty($title) )

      {

        $this->main_page();

      }

      if ( strstr($title, ' ') || strstr($title, '+') || strstr($title, '%20') )

      {

        $title = sanitize_page_id($title);

        redirect(makeUrl($title), '', '', 0);

      }

      $title = sanitize_page_id($title);

      // We've got the title, pull the namespace from it

      $namespace = 'Article';

      $page_id = $title;

      foreach ( $this->nslist as $ns => $prefix )

      {

        $prefix_len = strlen($prefix);

        if ( substr($title, 0, $prefix_len) == $prefix )

        {

          $page_id = substr($title, $prefix_len);

          $namespace = $ns;

        }

      }

      $this->namespace = $namespace;

      $this->fullpage = $title;

      if ( $namespace == 'Special' || $namespace == 'Admin' )

      {

        list($page_id) = explode('/', $page_id);

      }

      $this->page = $this->nslist[$namespace] . $page_id;

      $this->page_id = $page_id;

      // die("All done setting parameters. What we've got:<br/>namespace: $namespace<br/>fullpage: $this->fullpage<br/>page: $this->page<br/>page_id: $this->page_id");

    }

    else

    {

      // Starting up Enano with the API from a page that wants to do its own thing. Generate

      // metadata for an anonymous page and avoid redirection at all costs.

      if ( isset($GLOBALS['title']) )

      {

        $title =& $GLOBALS['title'];

      }

      else

      {

        $title = basename($_SERVER['SCRIPT_NAME']);

      }

      $base_uri = str_replace( scriptPath . '/', '', $_SERVER['SCRIPT_NAME'] );

      $this->page = $this->nslist['Anonymous'] . sanitize_page_id($base_uri);

      $this->fullpage = $this->nslist['Anonymous'] . sanitize_page_id($base_uri);

      $this->namespace = 'Anonymous';

      $this->cpage = array(

          'name' => $title,

          'urlname' => sanitize_page_id($base_uri),

          'namespace' => 'Anonymous',

          'special' => 1,

          'visible' => 1,

          'comments_on' => 1,

          'protected' => 1,

          'delvotes' => 0,

          'delvote_ips' => ''

        );

      $this->anonymous_page = true;

      $code = $plugins->setHook('paths_anonymous_page');

      foreach ( $code as $cmd )

      {

        eval($cmd);

      }

    }

    $this->page = sanitize_page_id($this->page);

    $this->fullpage = sanitize_page_id($this->fullpage);

    if(isset($this->pages[$this->page]))

    {

      $this->page_exists = true;

      $this->cpage = $this->pages[$this->page];

      $this->page_id =& $this->cpage['urlname_nons'];

      $this->namespace = $this->cpage['namespace'];

      if(!isset($this->cpage['wiki_mode'])) $this->cpage['wiki_mode'] = 2;

      // Determine the wiki mode for this page, now that we have this->cpage established

      if($this->cpage['wiki_mode'] == 2)

      {

        $this->wiki_mode = (int)getConfig('wiki_mode');

      }

      else

      {

        $this->wiki_mode = $this->cpage['wiki_mode'];

      }

      // Allow the user to create/modify his user page uncondtionally (admins can still protect the page)

      if($this->page == $this->nslist['User'].str_replace(' ', '_', $session->username))

      {

        $this->wiki_mode = true;

      }

      // And above all, if the site requires wiki mode to be off for non-logged-in users, disable it now

      if(getConfig('wiki_mode_require_login')=='1' && !$session->user_logged_in)

      {

        $this->wiki_mode = false;

      }

      if($this->cpage['protected'] == 2)

      {

        // The page is semi-protected, determine permissions

        if($session->user_logged_in && $session->reg_time + 60*60*24*4 < time()) 

        {

          $this->page_protected = 0;

        }

        else

        {

          $this->page_protected = 1;

        }

      }

      else

      {

        $this->page_protected = $this->cpage['protected'];

      }

    }

    else

    {

      $this->page_exists = false;

      $page_name = dirtify_page_id($this->page);

      $page_name = str_replace('_', ' ', $page_name);

      $pid_cleaned = sanitize_page_id($this->page);

      if ( $pid_cleaned != $this->page )

      {

        redirect(makeUrl($pid_cleaned), 'Sanitizer message', 'page id sanitized', 0);

      }

      if ( !is_array($this->cpage) )

      {

        $this->cpage = Array(

          'name'=>$page_name,

          'urlname'=>$this->page,

          'namespace'=>'Article',

          'special'=>0,

          'visible'=>0,

          'comments_on'=>1,

          'protected'=>0,

          'delvotes'=>0,

          'delvote_ips'=>'',

          'wiki_mode'=>2,

          );

      }

      // Look for a namespace prefix in the urlname, and assign a different namespace, if necessary

      $k = array_keys($this->nslist);

      for($i=0;$i<sizeof($this->nslist);$i++)

      {

        $ln = strlen($this->nslist[$k[$i]]);

        if( substr($this->page, 0, $ln) == $this->nslist[$k[$i]] )

        {

          $this->cpage['namespace'] = $k[$i];

          $this->cpage['urlname_nons'] = substr($this->page, strlen($this->nslist[$this->cpage['namespace']]), strlen($this->page));

          if(!isset($this->cpage['wiki_mode'])) 

          {

            $this->cpage['wiki_mode'] = 2;

          }

        }

      }

      $this->namespace = $this->cpage['namespace'];

      $this->page_id =& $this->cpage['urlname_nons'];

      if($this->namespace=='System') 

      {

        $this->cpage['protected'] = 1;

      }

      if($this->namespace == 'Special' && !$this->anonymous_page)

      {

        // Can't load nonexistent pages

        if( is_string(getConfig('main_page')) )

        {

          $main_page = makeUrl(getConfig('main_page'));

        }

        else

        {

          $main_page = makeUrl($this->pages[0]['urlname']);

        }

        redirect($main_page, $lang->get('page_msg_special_404_title'), $lang->get('page_msg_special_404_body', array('sp_link' => makeUrlNS('Special', 'SpecialPages'))), 15);

        exit;

      }

      // Allow the user to create/modify his user page uncondtionally (admins can still protect the page)

      if($this->page == $this->nslist['User'].str_replace(' ', '_', $session->username)) 

      {

        $this->wiki_mode = true;

      }

    }

    // This is used in the admin panel to keep track of form submission targets

    $this->cpage['module'] = $this->cpage['urlname'];

    // Page is set up, call any hooks

    $code = $plugins->setHook('page_set');

    foreach ( $code as $cmd )

    {

      eval($cmd);

    }

    $session->init_permissions();

    profiler_log('Paths and CMS core initted');

  }

  function add_page($flags)

  {

    global $lang;

    $flags['urlname_nons'] = $flags['urlname'];

    $flags['urlname'] = $this->nslist[$flags['namespace']] . $flags['urlname']; // Applies the User:/File:/etc prefixes to the URL names

    if ( is_object($lang) )

    {

      if ( preg_match('/^[a-z0-9]+_[a-z0-9_]+$/', $flags['name']) )

        $flags['name'] = $lang->get($flags['name']);

    }

    $pages_len = sizeof($this->pages)/2;

    $this->pages[$pages_len] = $flags;

    $this->pages[$flags['urlname']] =& $this->pages[$pages_len];

  }

  function main_page()

  {

    if( is_string(getConfig('main_page')) )

    {

      $main_page = makeUrl(getConfig('main_page'));

    }

    else

    {

      $main_page = makeUrl($this->pages[0]['urlname']);

    }

    redirect($main_page, 'Redirecting...', 'Invalid request, redirecting to main page', 0);

    exit;

  }

  function sysmsg($n)

  {

    global $db, $session, $paths, $template, $plugins; // Common objects

    $q = $db->sql_query('SELECT page_text, char_tag FROM '.table_prefix.'page_text WHERE page_id=\''.$db->escape(sanitize_page_id($n)).'\' AND namespace=\'System\'');

    if( !$q )

    {

      $db->_die('Error during generic selection of system page data.');

    }

    if($db->numrows() < 1)

    {

      return false;

      //$db->_die('Error during generic selection of system page data: there were no rows in the text table that matched the page text query.');

    }

    $r = $db->fetchrow();

    $db->free_result();

    $message = $r['page_text'];

    $message = preg_replace('/<noinclude>(.*?)<\/noinclude>/is', '', $message);

    $message = preg_replace('/<nodisplay>(.*?)<\/nodisplay>/is', '\\1', $message);

    return $message;

  }

  function get_pageid_from_url()

  {

    $url = $this->parse_url();

    if ( substr($url, 0, strlen($this->nslist['Special'])) == $this->nslist['Special'] ||

         substr($url, 0, strlen($this->nslist['Admin']))   == $this->nslist['Admin'])

    {

      list(, $ns) = RenderMan::strToPageID($url);

      $upart = substr($url, strlen($this->nslist[$ns]));

      list($upart) = explode('/', $upart);

      $url = $this->nslist[$ns] . $upart;

    }

    return $url;

  }

  // Parses a (very carefully formed) array into Javascript code compatible with the Tigra Tree Menu used in the admin menu

  function parseAdminTree() 

  {

    global $lang;

    $k = array_keys($this->admin_tree);

    $i = 0;

    $ret = '';

    $icon = "<img alt=\"\" src=\"" . scriptPath . "/images/icons/applets/home.png\" style=\"border-width: 0; margin-right: 3px;\" /> ";

    $icon = addslashes($icon);

    $ret .= "var TREE_ITEMS = [\n  ['$icon" . $lang->get('adm_btn_home') . "', 'javascript:ajaxPage(\'".$this->nslist['Admin']."Home\');',\n    ";

    foreach($k as $key)

    {

      $i++;

      $name = ( preg_match('/^[a-z0-9_]+$/', $key) ) ? $lang->get($key) : $key;

      $ret .= "['".$name."', 'javascript:trees[0].toggle($i)', \n";

      foreach($this->admin_tree[$key] as $c)

      {

        $i++;

        $name = ( preg_match('/^[a-z0-9_]+$/', $key) ) ? $lang->get($c['name']) : $c['name'];

        if ( $c['icon'] && $c['icon'] != scriptPath . '/images/spacer.gif' )

        {

          $icon = "<img alt=\"\" src=\"{$c['icon']}\" style=\"border-width: 0; margin-right: 3px;\" /> ";

        }

        else

        {

          $icon = '';

        }

        $icon = addslashes($icon);

        $ret .= "        ['$icon$name', 'javascript:ajaxPage(\\'".$this->nslist['Admin'].$c['pageid']."\\');'],\n";

      }

      $ret .= "      ],\n";

    }

    $icon = "<img alt=\"\" src=\"" . scriptPath . "/images/icons/applets/adminlogout.png\" style=\"border-width: 0; margin-right: 3px;\" /> ";

    $icon = addslashes($icon);

    $ret .= "    ['$icon" . $lang->get('adm_btn_logout') . "', 'javascript:ajaxPage(\\'".$this->nslist['Admin']."AdminLogout\\');'],\n";

    $ret .= "    ['<span id=\\'keepalivestat\\'>" . $lang->get('adm_btn_keepalive_loading') . "</span>', 'javascript:ajaxToggleKeepalive();', 

                   ['" . $lang->get('adm_btn_keepalive_about') . "', 'javascript:aboutKeepAlive();']

                 ],\n";

    // I used this while I painstakingly wrote the Runt code that auto-expands certain nodes based on the value of a bitfield stored in a cookie. *shudders*

    // $ret .= "    ['(debug) Clear menu bitfield', 'javascript:createCookie(\\'admin_menu_state\\', \\'1\\', 365);'],\n";

    $ret .= "]\n];";

    return $ret;

  }

  /**

   * Creates a new entry in the administration panel's navigation tree.

   * @param string Section name - if this is a language string identifier, it will be sent through $lang->get()

   * @param string The title of the page, also may be a language string identifier

   * @param string The page ID of the admin page, the namespace Admin is assumed

   * @param string Optional. The path to a 16x16 image that will be displayed as the icon for this admin page

   */

  function addAdminNode($section, $page_title, $url, $icon = false)