b2evolution

Multilingual multiuser multiblog engine

Home About Demo Download Hosting Extend Docs Support
b2evolution Technical Documentation (Version 1.9) [ class tree: admin ] [ index: admin ] [ all elements ]

Source for file _adminUI_general.class.php

Documentation is available at _adminUI_general.class.php

  1. <?php
  2. /**
  3.  * This file implements the Admin UI class.
  4.  * Admin skins should derive from this class and override {@link get_template()}
  5.  * for example.
  6.  *
  7.  * This file is part of the b2evolution/evocms project - {@link http://b2evolution.net/}.
  8.  * See also {@link http://sourceforge.net/projects/evocms/}.
  9.  *
  10.  * @copyright (c)2003-2006 by Francois PLANQUE - {@link http://fplanque.net/}.
  11.  *  Parts of this file are copyright (c)2005 by Daniel HAHLER - {@link http://thequod.de/contact}.
  12.  *
  13.  * @license http://b2evolution.net/about/license.html GNU General Public License (GPL)
  14.  *
  15.  *  {@internal Open Source relicensing agreement:
  16.  *  Daniel HAHLER grants Francois PLANQUE the right to license
  17.  *  Daniel HAHLER's contributions to this file and the b2evolution project
  18.  *  under any OSI approved OSS license (http://www.opensource.org/licenses/).
  19.  *  }}}
  20.  *
  21.  * @package admin
  22.  *
  23.  *  {@internal Below is a list of authors who have contributed to design/coding of this file: }}
  24.  * @author blueyed: Daniel HAHLER
  25.  * @author fplanque: Francois PLANQUE.
  26.  *
  27.  * @todo Refactor to allow easier contributions! (blueyed)
  28.  *
  29.  * @version $Id: _adminUI_general.class.php,v 1.25.2.6 2006/11/27 19:11:12 fplanque Exp $
  30.  */
  31. if( !defined('EVO_MAIN_INIT') ) die( 'Please, do not access this page directly.' );
  32.  
  33.  
  34. /**
  35.  * The general Admin UI class. It provides functions to handle the UI part of the
  36.  * Backoffice.
  37.  *
  38.  * Admin skins should derive from this class and override {@link get_template()}
  39.  * for example.
  40.  *
  41.  * @package admin
  42.  * @todo CODE DOCUMENTATION!!!
  43.  */
  44. class AdminUI_general
  45. {
  46.  
  47.     /**
  48.      * List of the headlines to output.
  49.      * @var array 
  50.      */
  51.     var $headlines = array();
  52.  
  53.     /**
  54.      * Visual path seperator (used in html title, ..)
  55.      *
  56.      * @var string 
  57.      */
  58.     var $pathSeperator;
  59.  
  60.     /**
  61.      * The Logo for the admin.
  62.      *
  63.      * Defaults to {@link $app_admin_logo} if not set.
  64.      *
  65.      * @var string 
  66.      */
  67.     var $admin_logo;
  68.  
  69.     /*-------------------------------------------------------------------*/
  70.     /*- The members below should not get overridden in a derived class. -*/
  71.  
  72.     /**
  73.      * The menus.
  74.      *
  75.      * Use {@link add_menu_entries()} to add them here.
  76.      *
  77.      * @access protected
  78.      * @var array 
  79.      */
  80.     var $_menus = array();
  81.  
  82.     /**
  83.      * The path of the current selected menu entry.
  84.      * Array of strings.
  85.      * The top level entry is at position 0. Selected submenu entries follow.
  86.      *
  87.      * Use {@link get_path()} or {@link get_path_range()} to access it.
  88.      * Use {@link set_path()}, {@link append_path_level()} or {@link set_path_level()} to set it.
  89.      *
  90.      * @access protected
  91.      * @var array 
  92.      */
  93.     var $path = array();
  94.  
  95.     /**
  96.      * The properties of the path entries.
  97.      * Numbered Array of arrays.
  98.      * The top level entry is at position 0. Selected submenu entries follow.
  99.      *
  100.      * Use {@link get_prop_for_path()} or {@link get_properties_for_path()} to access it
  101.      * Use {@link set_path()}, {@link append_path_level()} or {@link set_path_level()} to set it.
  102.      *
  103.      * @access protected
  104.      * @var array 
  105.      */
  106.     var $pathProps = array();
  107.  
  108.     /**
  109.      * The explicit title for the page.
  110.      * @var string 
  111.      */
  112.     var $title;
  113.  
  114.     /**
  115.      * The explicit title for the titlearea (<h1>).
  116.      * @var string 
  117.      */
  118.     var $title_titlearea;
  119.     var $title_titlearea_appendix = '';
  120.  
  121.  
  122.     /**
  123.      * Constructor.
  124.      */
  125.     function AdminUI_general()
  126.     {
  127.         global $mode; // TODO: make it a real property
  128.         global $htsrv_url, $baseurl;
  129.  
  130.         $this->mode = $mode;
  131.  
  132.         if( is_null($this->admin_logo) )
  133.         {
  134.             global $app_admin_logo;
  135.             $this->admin_logo = $app_admin_logo;
  136.         }
  137.  
  138.         if( is_null($this->pathSeperator) )
  139.         {
  140.             global $admin_path_seprator;
  141.             $this->pathSeperator = $admin_path_seprator;
  142.         }
  143.  
  144.         $this->init_templates();
  145.     }
  146.  
  147.  
  148.     /**
  149.      * This function should init the templates - like adding Javascript through the {@link add_headline()} method.
  150.      */
  151.     function init_templates()
  152.     {
  153.     }
  154.  
  155.  
  156.     /**
  157.      * Add menu entries to the list of entries for a given path.
  158.      *
  159.      * @param NULL|string|arrayThe path to add the entries to. See {@link get_node_by_path()}.
  160.      * @param array Menu entries to add (key (string) => entry (array)).
  161.      *    An entry can have the following keys:
  162.      *      'text': Text/Caption for this entry.
  163.      *      'href': The link for this entry.
  164.      *      'style': CSS style for this entry.
  165.      *      'onclick': onclick property for this entry.
  166.      *      'name': name attribute of the link/entry.
  167.      *      'perm_name': permission name to check.
  168.      *      'perm_level': permission level that must be granted.
  169.      *      'perm_eval': This gets evaluated and must return true for the entry to be accessible.
  170.      *      'text_noperm': Text to display if no permission granted.
  171.      *      'entries': array of sub-entries
  172.      */
  173.     function add_menu_entries( $path, $entries )
  174.     {
  175.         // Get a reference to the node in the menu list.
  176.         $node = & $this->get_node_by_path( $path, true );
  177.  
  178.         /*
  179.         if( !is_array($node) )
  180.         {
  181.             debug_die( 'add_menu_entries() with non-existing path!' );
  182.         }
  183.         */
  184.  
  185.         foreach( $entries as $l_key => $l_menu_props )
  186.         {
  187.             $node['entries'][$l_key] = $l_menu_props;
  188.         }
  189.     }
  190.  
  191.  
  192.     /**
  193.      * Add menu entries to the beginning of the list for given path.
  194.      *
  195.      * @param NULL|string|arrayThe path to add the entries to.
  196.      * @param array Menu entries to add (key (string) => entry (array)).
  197.      * @uses add_menu_entries()
  198.      */
  199.     function unshift_menu_entries( $path, $entries )
  200.     {
  201.         // Get a reference to the node in the menu list.
  202.         $node = & $this->get_node_by_path( $path, true );
  203.  
  204.         $node['entries'] = array_reverse( $node['entries'] );
  205.  
  206.         $this->add_menu_entries( $path, $entries );
  207.  
  208.         $node['entries'] = array_reverse( $node['entries'] );
  209.     }
  210.  
  211.  
  212.     /**
  213.      * Get the <title> of the page.
  214.      *
  215.      * This is either {@link $title} or will be constructed from title/text properties
  216.      * of the path entries.
  217.      *
  218.      * @param boolean If true, the fallback will be in reversed order
  219.      * @return string 
  220.      */
  221.     function get_title( $reversedDefault = false )
  222.     {
  223.         if( isset($this->title) )
  224.         { // Explicit title has been set:
  225.             return $this->title;
  226.         }
  227.         else
  228.         { // Fallback: implode title/text properties of the path
  229.             $titles = $this->get_properties_for_path( $this->path, array( 'title', 'text' ) );
  230.             if( $reversedDefault )
  231.             { // We have asked for reverse order of the path elements:
  232.                 $titles = array_reverse($titles);
  233.             }
  234.             return implode( $this->pathSeperator, $titles );
  235.         }
  236.     }
  237.  
  238.  
  239.     /**
  240.      * Get the title for the titlearea (<h1>).
  241.      *
  242.      * This is the current path in the site structure
  243.      *
  244.      * @return string 
  245.      */
  246.     function get_title_for_titlearea()
  247.     {
  248.         if( ! isset( $this->title_titlearea ) )
  249.         { // Construct path:
  250.             $titles = array();
  251.             foreach( $this->path as $i => $lPath )
  252.             {
  253.                 if( false !== ($title_text = $this->get_prop_for_path( $i, array( 'title', 'text' ) )) )
  254.                 {
  255.                     $titles[] = '<a href="'.$this->get_prop_for_path( $i, array( 'href' ) ).'">'.$title_text.'</a>';
  256.                 }
  257.             }
  258.  
  259.             $this->title_titlearea = implode( $this->pathSeperator, $titles );
  260.         }
  261.  
  262.         return $this->title_titlearea.$this->title_titlearea_appendix;
  263.     }
  264.  
  265.  
  266.     /**
  267.      * Append a string at the end of the existing titlearea.
  268.      *
  269.      * We actually keep the appended stuff separate from the main title, because the main title
  270.      * might in some occasions not be known immediately.
  271.      *
  272.      * @param string What to append to the titlearea
  273.      */
  274.     function append_to_titlearea( $string )
  275.     {
  276.         $this->title_titlearea_appendix .= $this->pathSeperator.$string;
  277.     }
  278.  
  279.  
  280.     /**
  281.      * Get the title for HTML <title> tag.
  282.      *
  283.      * If no explicit title has been specified, auto construct one from path.
  284.      *
  285.      * @return string 
  286.      */
  287.     function get_html_title()
  288.     {
  289.         global $app_shortname;
  290.  
  291.         $r = $app_shortname.$this->pathSeperator;
  292.  
  293.         if( $htmltitle = $this->get_prop_for_node( $this->path, array( 'htmltitle' ) ) )
  294.         { // Explicit htmltitle set:
  295.             $r .= $htmltitle;
  296.         }
  297.         else
  298.         {    // No explicit title set, construct Title from path
  299.             $r .= #preg_replace( '/:$/', '',
  300.                         $this->get_title()
  301.                         #)
  302.                         ;
  303.         }
  304.  
  305.         return $r;
  306.     }
  307.  
  308.  
  309.     /**
  310.      * Get a list of properties for a given path for a set of property names to check.
  311.      * The result is a list of properties for each node down the path.
  312.      *
  313.      * The property names must be given in $prop_by_ref, ordered by preference.
  314.      *
  315.      * @param string|arrayThe path. See {@link get_node_by_path()}.
  316.      * @param array Alternative names of the property to receive (ordered by priority).
  317.      * @return array List of the properties.
  318.      */
  319.     function get_properties_for_path( $path, $prop_by_pref )
  320.     {
  321.         if( !is_array($path) )
  322.         {
  323.             $path = array( $path );
  324.         }
  325.         $r = array();
  326.  
  327.         $prevPath = array();
  328.         foreach( $path as $i => $lPath )
  329.         {
  330.             if( false !== ($prop = $this->get_prop_for_path( $i, $prop_by_pref )) )
  331.             {
  332.                 $r[] = $prop;
  333.             }
  334.  
  335.             $prevPath[] = $lPath;
  336.         }
  337.  
  338.         return $r;
  339.     }
  340.  
  341.  
  342.     /**
  343.      * Get a property of a node, given by path.
  344.      *
  345.      * @param string|arrayThe path. See {@link get_node_by_path()}.
  346.      * @param array Alternative names of the property to receive (ordered by priority).
  347.      * @return mixed|falseFalse if property is not set for the node, otherwise its value.
  348.      */
  349.     function get_prop_for_node( $path, $prop_by_pref )
  350.     {
  351.         $node = & $this->get_node_by_path( $path );
  352.  
  353.         foreach( $prop_by_pref as $lProp )
  354.         {
  355.             if( isset($node[$lProp]) )
  356.             {
  357.                 return $node[$lProp];
  358.             }
  359.         }
  360.  
  361.         return false;
  362.     }
  363.  
  364.  
  365.     /**
  366.      * Get a property for a specific path entry.
  367.      *
  368.      * @param int The numeric index of the path entry to query (0 is first).
  369.      * @param array A list of properties to check, ordered by priority.
  370.      * @return mixed|falseThe first found property or false if it does not exist
  371.      */
  372.     function get_prop_for_path( $depth, $prop_by_pref )
  373.     {
  374.         if( $pathWithProps = $this->get_path( $depth, true ) )
  375.         {
  376.             foreach( $prop_by_pref as $lProp )
  377.             {
  378.                 if( isset($pathWithProps['props'][$lProp]) )
  379.                 {
  380.                     // echo "<br>path depth $depth property $lProp = ".$pathWithProps['props'][$lProp];
  381.                     return $pathWithProps['props'][$lProp];
  382.                 }
  383.             }
  384.         }
  385.  
  386.         return false;
  387.     }
  388.  
  389.  
  390.     /**
  391.      * Get a menu, any level.
  392.      *
  393.      * @param NULL|string|arrayThe path. See {@link get_node_by_path()}.
  394.      * @param string The template name, see {@link get_template()}.
  395.      */
  396.     function get_html_menu( $path = NULL, $template = 'main' )
  397.     {
  398.         /* debug:
  399.         $r = ' dispMenu-BEGIN ';
  400.         $r .= $this->get_html_menu_entries( $path, $template );
  401.         $r .= ' dispMenu-END ';
  402.         return $r;
  403.         */
  404.         return $this->get_html_menu_entries( $path, $template );
  405.     }
  406.  
  407.  
  408.     /**
  409.      * Display doctype + <head>...</head> section
  410.      */
  411.     function disp_html_head()
  412.     {
  413.         global $view_path;
  414.  
  415.         require $view_path.'_menutop.php';
  416.     }
  417.  
  418.  
  419.     /**
  420.      * Dsiplay the top of the HTML <body>...
  421.      *
  422.      * Typically includes title, menu, messages, etc.
  423.      */
  424.     function disp_body_top()
  425.     {
  426.         echo "<body>\n";
  427.  
  428.         echo $this->get_body_top();
  429.     }
  430.  
  431.     /**
  432.      * Display body bottom, debug info and close </html>
  433.      */
  434.     function disp_global_footer()
  435.     {
  436.         global $view_path;
  437.  
  438.         require $view_path.'_footer.php';
  439.     }
  440.  
  441.  
  442.     /**
  443.      * Display the start of a payload block
  444.      *
  445.      * Note: it is possible to display several payload blocks on a single page.
  446.      *       The first block uses the "sub" template, the others "block".
  447.      *
  448.      * @see disp_payload_end()
  449.      * @todo check if the plugin event is appropriate. Maybe it should rather go as 'AdminAfterBodyTop' or sth like this.
  450.      */
  451.     function disp_payload_begin()
  452.     {
  453.         global $Plugins;
  454.  
  455.         if( empty($this->displayed_sub_begin) )
  456.         {
  457.             $Plugins->trigger_event( 'AdminBeginPayload' );
  458.  
  459.             // Display submenu (this also opens a div class="panelblock" or class="panelblocktabs")
  460.  
  461.             //echo ' disp_submenu-BEGIN ';
  462.             $path = array( $this->get_path(0) );
  463.             echo $this->get_html_menu( $path, 'sub' );
  464.             //echo ' disp_submenu-END ';
  465.  
  466.             $this->displayed_sub_begin = 1;
  467.         }
  468.         else
  469.         {
  470.             $template = $this->get_template( 'block' );
  471.  
  472.             echo $template['begin'];
  473.         }
  474.  
  475.     }
  476.  
  477.  
  478.     /**
  479.      * Display the end of a payload block
  480.      *
  481.      * Note: it is possible to display several payload blocks on a single page.
  482.      *       The first block uses the "sub" template, the others "block".
  483.      * @see disp_payload_begin()
  484.      */
  485.     function disp_payload_end()
  486.     {
  487.         if( empty($this->displayed_sub_end) )
  488.         {
  489.             $name = 'sub';
  490.             $this->displayed_sub_end = 1;
  491.         }
  492.         else
  493.         {
  494.             $name = 'block';
  495.         }
  496.  
  497.         $template = $this->get_template( $name );
  498.  
  499.         echo $template['end'];
  500.     }
  501.  
  502.  
  503.     /**
  504.      * Display a view (from the inc/VIEWS/ hierarchy )
  505.      *
  506.      * Note: doing the require inside of a function has the side effect of forcing the view
  507.      * to declare any global object it wants to use. This can be a little tedious but on the
  508.      * other hand it has the advantage of clearly showing what objects are used and makes it
  509.      * easier to audit the views in order to determine if they include more business logic
  510.      * than they ought to.
  511.      *
  512.      * @param string 
  513.      * @param array params to be used in the view (optional)
  514.      */
  515.     function disp_view( $view_name, $view_params = array() )
  516.     {
  517.         global $view_path;
  518.  
  519.         // THESE ARE THE GLOBALS WE WANT TO MAKE AVAILABLE TO ALL VIEWS:
  520.         global $action;
  521.         global $ctrl;
  522.  
  523.         global $DB;    // Note: not sure it's agood idea to let the views hit on the db...
  524.  
  525.         global $model_path;        // TEMP (for object inclusion)
  526.         global $misc_inc_path;
  527.  
  528.         global $current_User;
  529.         global $Request;
  530.  
  531.  
  532.         require $view_path.$view_name;
  533.     }
  534.  
  535.  
  536.     /**
  537.      * Returns the list of available Collections (aka Blogs) to work on.
  538.      *
  539.      * @todo Use BlogCache(?)
  540.      * @todo Use a template (i wanna make an UL/LI/A list structure in newer skins)
  541.      *
  542.      * @param string name of required permission needed to display the blog in the list
  543.      * @param string level of required permission needed to display the blog in the list
  544.      * @param string Url format string for elements, with %d for blog number.
  545.      * @param string Title for "all" button
  546.      * @param string URL for "all" button
  547.      * @param string onclick attribute format string, with %d for blog number.
  548.      * @param string name attribute for each button (%d for blog number)
  549.      * @return string HTML
  550.      */
  551.     function get_html_collection_list( $permname = 'blog_ismember', $permlevel = 1, $url_format = '?blog=%d',
  552.                             $all_title = NULL, $all_url = '', $onclick = NULL, $name = NULL )
  553.     {
  554.         global $current_User, $blog;
  555.  
  556.         $template = $this->get_template( 'CollectionList' );
  557.  
  558.         $r = $template['before'];
  559.  
  560.         if( !is_null($all_title) )
  561.         {    // We want to add an "all" button
  562.             $r .= $template[ $blog == 0 ? 'beforeEachSel' : 'beforeEach' ];
  563.             $r .= '<a href="'.$all_url
  564.                         .'" class="'.( $blog == 0 ? 'CurrentBlog' : 'OtherBlog' ).'">'
  565.                         .$all_title.'</a> ';
  566.             $r .= $template[ $blog == 0 ? 'afterEachSel' : 'afterEach' ];
  567.         }
  568.  
  569.         for( $curr_blog_ID = blog_list_start();
  570.                     $curr_blog_ID != false;
  571.                     $curr_blog_ID = blog_list_next() )
  572.         {
  573.             if( ! $current_User->check_perm( $permname, $permlevel, false, $curr_blog_ID ) )
  574.             { // Current user doesn't have required permission on this blog...
  575.                 continue;
  576.             }
  577.  
  578.             $r .= $template[ $curr_blog_ID == $blog ? 'beforeEachSel' : 'beforeEach' ];
  579.  
  580.             $r .= '<a href="'.sprintf( $url_format, $curr_blog_ID )
  581.                         .'" class="'.( $curr_blog_ID == $blog ? 'CurrentBlog' : 'OtherBlog' ).'"';
  582.  
  583.             if( !is_null($onclick) )
  584.             {    // We want to include an onclick attribute:
  585.                 $r .= ' onclick="'.sprintf( $onclick, $curr_blog_ID ).'"';
  586.             }
  587.  
  588.             if( !is_null($name) )
  589.             {    // We want to include a name attribute:
  590.                 $r .= ' name="'.sprintf( $name, $curr_blog_ID ).'"';
  591.             }
  592.  
  593.             $r .= '>'.blog_list_iteminfo( 'shortname', false ).'</a> ';
  594.  
  595.             $r .= $template[ $curr_blog_ID == $blog ? 'afterEachSel' : 'afterEach' ];
  596.         }
  597.  
  598.         $r .= $template['after'];
  599.  
  600.         return $r;
  601.     }
  602.  
  603.  
  604.     /**
  605.      * Get the HTML for the menu entries of a specific path.
  606.      *
  607.      * @param NULL|string|arrayThe path. See {@link get_node_by_path()}.
  608.      * @param string Template name, see {@link get_template()}.
  609.      * @param int Depth (recursion)
  610.      * @return string The HTML for the menu.
  611.      */
  612.     function get_html_menu_entries( $path, $template, $depth = 0 )
  613.     {
  614.         global $current_User;
  615.  
  616.         $r = '';
  617.  
  618.         $templateForLevel = $this->get_template( $template, $depth );
  619.  
  620.         if( !( $menuEntries = $this->get_menu_entries($path) ) )
  621.         {    // No menu entries at this level
  622.             if( isset($templateForLevel['empty']) )
  623.             {
  624.                 $r .= $templateForLevel['empty'];
  625.             }
  626.         }
  627.         else
  628.         {    // There are entries to display:
  629.             $r .= $templateForLevel['before'];
  630.  
  631.             $selected = $this->get_selected($path);
  632.  
  633.             foreach( $menuEntries as $loop_key => $loop_details )
  634.             {
  635.                 $perm = true; // By default
  636.  
  637.                 if( ! ($perm = $this->check_perm( $loop_details )) && ! isset($loop_details['text_noperm']) )
  638.                 { // If permission requested but not granted, and we have no alt text, display no tab:
  639.                     continue;
  640.                 }
  641.  
  642.                 $anchor = '<a href="';
  643.  
  644.                 if( isset( $loop_details['href'] ) )
  645.                 {
  646.                     $anchor .= $loop_details['href'];
  647.                 }
  648.                 elseif( !empty($loop_details['href_eval']) )
  649.                 { // Useful for passing dynamic context vars (fp>> I AM using it)
  650.                     $anchor .= eval( $loop_details['href_eval'] );
  651.                 }
  652.                 else
  653.                 {
  654.                     $anchor .= regenerate_url( 'tab', 'tab='.$loop_key );
  655.                 }
  656.                 $anchor .= '"';
  657.                 if( isset($loop_details['style']) )
  658.                 {
  659.                     $anchor .= ' style="'.$loop_details['style'].'"';
  660.                 }
  661.                 if( isset($loop_details['onclick']) )
  662.                 {
  663.                     $anchor .= ' onclick="'.$loop_details['onclick'].'"';
  664.                 }
  665.                 if( isset($loop_details['name']) )
  666.                 {
  667.                     $anchor .= ' name="'.$loop_details['name'].'"';
  668.                 }
  669.  
  670.                 $anchor .= '>'.format_to_output( $perm ? $loop_details['text'] : $loop_details['text_noperm'], 'htmlbody' )
  671.                               ."</a>";
  672.  
  673.                 if( $loop_key == $selected )
  674.                 { // Highlight selected entry
  675.                     if( !empty( $templateForLevel['_props']['recurseSelected'] )
  676.                             && ( $recursePath = array_merge( $path, $loop_key ) )
  677.                             && ($this->get_menu_entries($recursePath) ) )
  678.                     {
  679.                         $r .= isset($templateForLevel['beforeEachSelWithSub'])
  680.                             ? $templateForLevel['beforeEachSelWithSub']
  681.                             : $templateForLevel['beforeEachSel'];
  682.                         $r .= $anchor;
  683.  
  684.                         // Recurse:
  685.                         $r .= $this->get_html_menu_entries( $recursePath, $template, $depth+1 );
  686.  
  687.                         $r .= isset($templateForLevel['afterEachSelWithSub'])
  688.                             ? $templateForLevel['afterEachSelWithSub']
  689.                             : $templateForLevel['afterEachSel'];
  690.                     }
  691.                     else
  692.                     {
  693.                         $r .= $templateForLevel['beforeEachSel'];
  694.                         $r .= $anchor;
  695.                         $r .= $templateForLevel['afterEachSel'];
  696.                     }
  697.                 }
  698.                 else
  699.                 {
  700.                     $r .= $templateForLevel['beforeEach'];
  701.                     $r .= $anchor;
  702.                     $r .= $templateForLevel['afterEach'];
  703.                 }
  704.             }
  705.             $r .= $templateForLevel['after'];
  706.         }
  707.  
  708.         return $r;
  709.     }
  710.  
  711.  
  712.     /**
  713.      * Get menu entries for a given path.
  714.      *
  715.      * @param NULL|string|arrayThe path. See {@link get_node_by_path()}.
  716.      * @return array The menu entries (may be empty).
  717.      */
  718.     function get_menu_entries( $path )
  719.     {
  720.         $node = & $this->get_node_by_path( $path );
  721.  
  722.         return isset( $node['entries'] ) ? $node['entries'] : array();
  723.     }
  724.  
  725.  
  726.     /**
  727.      * Get the key of a selected entry for a path.
  728.      *
  729.      * @param NULL|string|arrayThe path. See {@link get_node_by_path()}.
  730.      * @return string|false
  731.      */
  732.     function get_selected( $path )
  733.     {
  734.         $node = & $this->get_node_by_path($path);
  735.  
  736.         if( isset($node['selected']) )
  737.         {
  738.             return $node['selected'];
  739.         }
  740.  
  741.         return false;
  742.     }
  743.  
  744.  
  745.     /**
  746.      * Get the reference of a node from the menu entries using a path.
  747.      *
  748.      * @param array|string|NULLThe path. NULL means root, string means child of root,
  749.      *                           array means path below root.
  750.      *                           (eg <code>array('options', 'general')</code>).
  751.      * @param boolean Should the node be created if it does not exist already?
  752.      * @return array|falseThe node as array or false, if the path does not exist (and we do not $createIfNotExisting).
  753.      */
  754.     function & get_node_by_path( $path, $createIfNotExisting = false )
  755.     {
  756.         if( is_null($path) )
  757.         { // root element
  758.             $path = array();
  759.         }
  760.         elseif( ! is_array($path) )
  761.         {
  762.             $path = array($path);
  763.         }
  764.  
  765.         $node = & $this->_menus;
  766.         foreach( $path as $lStep )
  767.         {
  768.             if( ! isset($node['entries'][$lStep]) )
  769.             {
  770.                 if( $createIfNotExisting )
  771.                 {
  772.                     $node['entries'][$lStep] = array();
  773.                 }
  774.                 else
  775.                 {
  776.                     $r = false;
  777.                     return $r;
  778.                 }
  779.             }
  780.             $node = & $node['entries'][$lStep];
  781.         }
  782.  
  783.         return $node;
  784.     }
  785.  
  786.  
  787.     /**
  788.      * Get a template by name and depth.
  789.      *
  790.      * Templates can handle multiple depth levels
  791.      *
  792.      * This is a method (and not a member array) to allow dynamic generation.
  793.      * fp>>I'm not so sure about this... feels a little bloated... gotta think about it..
  794.      *
  795.      * @param string Name of the template ('main', 'sub')
  796.      * @param integer Nesting level (start at 0)
  797.      * @return array Associative array which defines layout and optionally properties.
  798.      */
  799.     function get_template( $name, $depth = 0 )
  800.     {
  801.         switch( $name )
  802.         {
  803.             case 'main':
  804.                 switch( $depth )
  805.                 {
  806.                     case 0:
  807.                         // main level
  808.                         global $app_shortname, $app_version;
  809.  
  810.                         return array(
  811.                             'before' => '<div id="mainmenu"><ul>',
  812.                             'after' => "</ul>\n<p class=\"center\">$app_shortname v <strong>$app_version</strong></p>\n</div>",
  813.                             'beforeEach' => '<li>',
  814.                             'afterEach' => '</li>',
  815.                             'beforeEachSel' => '<li class="current">',
  816.                             'afterEachSel' => '</li>',
  817.                             'beforeEachSelWithSub' => '<li class="parent">',
  818.                             'afterEachSelWithSub' => '</li>',
  819.                             '_props' => array(
  820.                                 /**
  821.                                  * @todo Move to new skin (recurse for subentries if an entry is selected)
  822.                                 'recurseSelected' => true,
  823.                                 */
  824.                             ),
  825.                         );
  826.  
  827.                     default:
  828.                         // any sublevel
  829.                         return array(
  830.                             'before' => '<ul class="submenu">',
  831.                             'after' => '</ul>',
  832.                             'beforeEach' => '<li>',
  833.                             'afterEach' => '</li>',
  834.                             'beforeEachSel' => '<li class="current">',
  835.                             'afterEachSel' => '</li>',
  836.                         );
  837.                 }
  838.  
  839.                 break;
  840.  
  841.  
  842.             case 'sub':
  843.                 // submenu, we support just one sub-level (by default)
  844.                 return array(
  845.                         'before' => '<div class="pt">'
  846.                             ."\n".'<ul class="hack">'
  847.                             ."\n<li><!-- Yes, this empty UL is needed! It's a DOUBLE hack for correct CSS display --></li>"
  848.                             // TODO: this hack MAY NOT be needed when not using pixels instead of decimal ems or exs in the CSS
  849.                             ."\n</ul>"
  850.                             ."\n".'<div class="panelblocktabs">'
  851.                             ."\n".'<ul class="tabs">',
  852.                         'after' => "</ul>\n</div>\n</div>"
  853.                             ."\n".'<div class="tabbedpanelblock">',
  854.                         'empty' => '<div class="panelblock">',
  855.                         'beforeEach' => '<li>',
  856.                         'afterEach'  => '</li>',
  857.                         'beforeEachSel' => '<li class="current">',
  858.                         'afterEachSel' => '</li>',
  859.                         'end' => '</div>', // used to end payload block that opened submenu
  860.                     );
  861.  
  862.  
  863.             case 'block':
  864.                 // a payload block, anywhere "below" submenu. Gets used by disp_payload_begin()/disp_payload_end()
  865.                 return array(
  866.                         'begin' => '<div class="panelblock">',
  867.                         'end' => "\n</div>",
  868.                     );
  869.  
  870.  
  871.             case 'CollectionList':
  872.                 // Template for a list of Collections (Blogs)
  873.                 return array(
  874.                         'before' => '',
  875.                         'after' => '',
  876.                         'beforeEach' => '',
  877.                         'afterEach' => '',
  878.                         'beforeEachSel' => '',
  879.                         'afterEachSel' => '',
  880.                     );
  881.                 // fp>> I'll use the following as soon as I have time to play with the CSS:
  882.                 return array(
  883.                         'before' => '<ul class="submenu">',
  884.                         'after' => '</ul>',
  885.                         'beforeEach' => '<li>',
  886.                         'afterEach' => '</li>',
  887.                         'beforeEachSel' => '<li class="current">',
  888.                         'afterEachSel' => '</li>',
  889.                     );
  890.  
  891.  
  892.             case 'Results':
  893.                 // Results list:
  894.                 return array(
  895.                     'before' => '<div class="results">',
  896.                     'header_start' => '<div class="results_nav">',
  897.                         'header_text' => '<strong>'.T_('Pages').'</strong>: $prev$ $first$ $list_prev$ $list$ $list_next$ $last$ $next$',
  898.                         'header_text_single' => '',
  899.                     'header_end' => '</div>',
  900.                     'list_start' => '<table class="grouped" cellspacing="0">'."\n\n",
  901.                         'head_start' => "<thead><tr>\n",
  902.                             'head_title' => '<th colspan="$nb_cols$"><span style="float:right">$global_icons$</span>$title$</th></tr>'
  903.                                             ."\n\n<tr>\n",
  904.                             'filters_start' => '<tr class="filters"><td colspan="$nb_cols$">',
  905.                             'filters_end' => '</td></tr>',
  906.                             'line_start_head' => '<tr>',  // TODO: fusionner avec colhead_start_first; mettre à jour admin_UI_general; utiliser colspan="$headspan$"
  907.                             'colhead_start' => '<th $class_attrib$>',
  908.                             'colhead_start_first' => '<th class="firstcol $class$">',
  909.                             'colhead_start_last' => '<th class="lastcol $class$">',
  910.                             'colhead_end' => "</th>\n",
  911.                             'sort_asc_off' => '<img src="../admin/img/grey_arrow_up.gif" alt="A" title="'.T_('Ascending order')
  912.                                                 .'" height="12" width="11" />',
  913.                             'sort_asc_on' => '<img src="../admin/img/black_arrow_up.gif" alt="A" title="'.T_('Ascending order')
  914.                                                 .'" height="12" width="11" />',
  915.                             'sort_desc_off' => '<img src="../admin/img/grey_arrow_down.gif" alt="D" title="'.T_('Descending order')
  916.                                                 .'" height="12" width="11" />',
  917.                             'sort_desc_on' => '<img src="../admin/img/black_arrow_down.gif" alt="D" title="'.T_('Descending order')
  918.                                                 .'" height="12" width="11" />',
  919.                             'basic_sort_off' => '',
  920.                             'basic_sort_asc' => get_icon( 'ascending' ),
  921.                             'basic_sort_desc' => get_icon( 'descending' ),
  922.                         'head_end' => "</tr></thead>\n\n",
  923.                         'tfoot_start' => "<tfoot>\n",
  924.                         'tfoot_end' => "</tfoot>\n\n",
  925.                         'body_start' => "<tbody>\n",
  926.                             'line_start' => "<tr>\n",
  927.                             'line_start_odd' => '<tr class="odd">'."\n",
  928.                             'line_start_last' => '<tr class="lastline">'."\n",
  929.                             'line_start_odd_last' => '<tr class="odd lastline">'."\n",
  930.                                 'col_start' => '<td $class_attrib$>',
  931.                                 'col_start_first' => '<td class="firstcol $class$">',
  932.                                 'col_start_last' => '<td class="lastcol $class$">',
  933.                                 'col_end' => "</td>\n",
  934.                             'line_end' => "</tr>\n\n",
  935.                             'grp_line_start' => '<tr class="group">'."\n",
  936.                             'grp_line_start_odd' => '<tr class="odd">'."\n",
  937.                             'grp_line_start_last' => '<tr class="lastline">'."\n",
  938.                             'grp_line_start_odd_last' => '<tr class="odd lastline">'."\n",
  939.                                         'grp_col_start' => '<td $class_attrib$ $colspan_attrib$>',
  940.                                         'grp_col_start_first' => '<td class="firstcol $class$" $colspan_attrib$>',
  941.                                         'grp_col_start_last' => '<td class="lastcol $class$" $colspan_attrib$>',
  942.                                 'grp_col_end' => "</td>\n",
  943.                             'grp_line_end' => "</tr>\n\n",
  944.                         'body_end' => "</tbody>\n\n",
  945.                         'total_line_start' => '<tr class="total">'."\n",
  946.                             'total_col_start' => '<td $class_attrib$>',
  947.                             'total_col_start_first' => '<td class="firstcol $class$">',
  948.                             'total_col_start_last' => '<td class="lastcol $class$">',
  949.                             'total_col_end' => "</td>\n",
  950.                         'total_line_end' => "</tr>\n\n",
  951.                     'list_end' => "</table>\n\n",
  952.                     'footer_start' => '<div class="results_nav">',
  953.                     'footer_text' => '<strong>'.T_('Pages').'</strong>: $prev$ $first$ $list_prev$ $list$ $list_next$ $last$ $next$'
  954.                                       /* T_('Page $scroll_list$ out of $total_pages$   $prev$ | $next$<br />'. */
  955.                                       /* '<strong>$total_pages$ Pages</strong> : $prev$ $list$ $next$' */
  956.                                       /* .' <br />$first$  $list_prev$  $list$  $list_next$  $last$ :: $prev$ | $next$') */,
  957.                     'footer_text_single' => T_('1 page'),
  958.                     'footer_text_no_limit' => '', // Text if theres no LIMIT and therefor only one page anyway
  959.                         'prev_text' => T_('Previous'),
  960.                         'next_text' => T_('Next'),
  961.                         'list_prev_text' => T_('...'),
  962.                         'list_next_text' => T_('...'),
  963.                         'list_span' => 11,
  964.                         'scroll_list_range' => 5,
  965.                     'footer_end' => "</div>\n\n",
  966.                     'no_results_start' => '<table class="grouped clear" cellspacing="0">'."\n\n"
  967.                                                 .'<th><span style="float:right">$global_icons$</span>'
  968.                                                 .'$title$</th></tr>'."\n",
  969.                     'no_results_end'   => '<tr class="lastline"><td class="firstcol lastcol">'.T_('No results.').'</td></tr>'
  970.                                                 .'</table>'."\n\n",
  971.                 'after' => '</div>',
  972.                 'sort_type' => 'basic'
  973.                 );
  974.  
  975.             case 'Form':
  976.                 // Default Form settings:
  977.                 return array(
  978.                     'layout' => 'fieldset',
  979.                 );
  980.  
  981.             // TODO: add default settings for 'table', 'fieldset', etc...
  982.  
  983.             default:
  984.                 debug_die( 'Unknown $name for AdminUI::get_template(): '.var_export($name, true) /* PHP 4.2 ! */ );
  985.         }
  986.     }
  987.  
  988.  
  989.     /**
  990.      * Add a headline for HTML <head>.
  991.      *
  992.      * @param string The line that should be added to <head>.
  993.      */
  994.     function add_headline( $headline )
  995.     {
  996.         $this->headlines[] = $headline;
  997.     }
  998.  
  999.  
  1000.     /**
  1001.      * Get the headlines for HTML <head> (CSS files especially).
  1002.      *
  1003.      * To define headlines for a derived skin, add entries to
  1004.      * {@link $headlines} and "return parent::get_headlines();".
  1005.      *
  1006.      * @return string The concatenated headlines to output in HTML <head>.
  1007.      */
  1008.     function get_headlines()
  1009.     {
  1010.         $r = implode( "\n\t", $this->headlines )."\n\t";
  1011.  
  1012.         return $r;
  1013.     }
  1014.  
  1015.  
  1016.     /**
  1017.      *
  1018.      * @todo Move generation of blog list to this class!
  1019.      *
  1020.      * @return string 
  1021.      */
  1022.     function get_bloglist_buttons( $before = '', $after = '' )
  1023.     {
  1024.         global $blogListButtons;
  1025.  
  1026.         if( !empty($blogListButtons) )
  1027.         {
  1028.             return $before.$blogListButtons.$after;
  1029.         }
  1030.     }
  1031.  
  1032.  
  1033.     /**
  1034.      * Get a path key by numeric key. Starts with 0.
  1035.      *
  1036.      * @param integer The numeric index of the path (0 is first).
  1037.      * @param boolean Also return properties?
  1038.      * @return string|array|false(depends on $withProps)
  1039.      */
  1040.     function get_path( $which, $withProps = false )
  1041.     {
  1042.         if( $which === 'last' )
  1043.         {
  1044.             $which = count($this->path)-1;
  1045.         }
  1046.         if( !isset($this->path[$which]) )
  1047.         {
  1048.             return false;
  1049.         }
  1050.  
  1051.         if( $withProps )
  1052.         {
  1053.             return array(
  1054.                 'path' => $this->path[$which],
  1055.                 'props' => isset( $this->pathProps[$which] ) ? $this->pathProps[$which] : array(),
  1056.             );
  1057.         }
  1058.  
  1059.         return $this->path[$which];
  1060.     }
  1061.  
  1062.  
  1063.     /**
  1064.      * Get tghe list of path keys in a given range.
  1065.      *
  1066.      * @param integer start index
  1067.      * @param integer|NULLend index (NULL means same as start index)
  1068.      * @return array List of path keys.
  1069.      */
  1070.     function get_path_range( $start, $end = NULL )
  1071.     {
  1072.         if( is_null($end) )
  1073.         {
  1074.             $end = $start;
  1075.         }
  1076.  
  1077.         $r = array();
  1078.         for( $i = $start; $i <= $end; $i++ )
  1079.         {
  1080.             $r[] = isset($this->path[$i]) ? $this->path[$i] : NULL;
  1081.         }
  1082.  
  1083.         return $r;
  1084.     }
  1085.  
  1086.  
  1087.     /**
  1088.      * Set a specific path level (specific depth).
  1089.      *
  1090.      * First level is 0, then the first subpath/submenu is level 1, etc.
  1091.      *
  1092.      * E.g., if plugins.php gets called, there could be a call to
  1093.      * $AdminUI->set_path_level( 0, 'plugins' ), which selects this entry from the menu.
  1094.      * If a specific tab is called inside of plugins.php, there could be a call to
  1095.      * $AdminUI->set_path_level( 1, $tab )
  1096.      *
  1097.      * Though, it is recommended to call the wrapper functions:
  1098.      *  - {@link append_path_level()}
  1099.      *  - {@link set_path()}
  1100.      *
  1101.      * This also marks the parent node as selected and checks for permissions.
  1102.      *
  1103.      * @param integer Path level to set (starts at 0)
  1104.      * @param array Either the key of the path or an array(keyname, propsArray).
  1105.      * @param array Properties for this path entry.
  1106.      * @param boolean Exit script when the user has no permissions to this path and
  1107.      *                 text_noperm is not set for the path?
  1108.      * @return boolean True if perm granted, false if not (and we're not exiting).
  1109.      */
  1110.     function set_path_level( $level, $pathKey, $pathProps = array(), $die_if_no_perm = true )
  1111.     {
  1112.         // Get the parent node (the level above this one):
  1113.         if( $level == 0 )
  1114.         { // first level in menu-path: parent node is NULL
  1115.             $parentNode = & $this->get_node_by_path( NULL );
  1116.         }
  1117.         else
  1118.         { // parent node is the trunk from root to previous level
  1119.             $parentNode = & $this->get_node_by_path( $this->get_path_range( 0, $level-1 ) );
  1120.         }
  1121.         if( ! $parentNode )
  1122.         { // parent node does not exist:
  1123.             return false;
  1124.         }
  1125.  
  1126.         // Store the selected entry name in the parent node:
  1127.         $parentNode['selected'] = $pathKey;
  1128.  
  1129.         $this->path[$level] = $pathKey;
  1130.         $this->pathProps[$level] = $pathProps;
  1131.         // FP> WHY ON EARTH would we want to do that? $this->pathProps[$level] = array_merge( $parentNode, $pathProps );
  1132.  
  1133.         // pre_dump( 'set_path_level: ', $level, $pathKey, $this->pathProps[$level] );
  1134.  
  1135.         $perm = $this->check_perm( $pathProps );
  1136.         if( ! $perm && empty($pathProps['text_noperm']) && $die_if_no_perm )
  1137.         {
  1138.             debug_die( T_('Permission denied!').' (set_path_level: '.$level.'/'.$pathKey.')' );
  1139.         }
  1140.  
  1141.         return $perm;
  1142.     }
  1143.  
  1144.  
  1145.     /**
  1146.      * Append a selected menu entry to the current path of selected entries.
  1147.      *
  1148.      * @param string|arrayEither the key of the path or an array(keyname, propsArray).
  1149.      */
  1150.     function append_path_level( $path, $pathProps = array() )
  1151.     {
  1152.         $search_path = $this->path;
  1153.         $search_path[] = $path;
  1154.         // auto-detect path props from menu entries
  1155.         if( $node = & $this->get_node_by_path( $search_path ) )
  1156.         {
  1157.             $pathProps = array_merge( $node, $pathProps );
  1158.         }
  1159.  
  1160.         // Set the path level right after the last existing one:
  1161.         return $this->set_path_level( count($this->path), $path, $pathProps );
  1162.     }
  1163.  
  1164.  
  1165.     /**
  1166.      * Set the full selected path.
  1167.      *
  1168.      * For example, this selects the tab/submenu 'plugins' in the main menu 'options':
  1169.      * <code>
  1170.      * set_path( 'options', 'plugins' );
  1171.      * </code>
  1172.      *
  1173.      * Use {@link append_path_level()} to append a single path element.
  1174.      *
  1175.      * This is an easy stub for {@link set_path_level()}.
  1176.      *
  1177.      * @param string|array,...VARIABLE NUMBER OF ARGUMENTS. Each is either the key of a path entry or an array(keyname, propsArray).
  1178.      */
  1179.     function set_path(        )
  1180.     {
  1181.         $args = func_get_args();
  1182.  
  1183.         $i = 0;
  1184.         $prevPath = array();  // Remember the path we have walked through
  1185.  
  1186.         // Loop though all path levels to set:
  1187.         foreach( $args as $arg )
  1188.         {
  1189.             if( is_array($arg) )
  1190.             { // Path name and properties given
  1191.                 list( $pathName, $pathProps ) = $arg;
  1192.             }
  1193.             else
  1194.             { // Just the path name
  1195.                 $pathName = $arg;
  1196.                 $pathProps = array();
  1197.             }
  1198.  
  1199.             if( $node = & $this->get_node_by_path( array_merge( $prevPath, array($pathName) ) ) )
  1200.             { // the node exists in the menu entries: merge the properties
  1201.                 $pathProps = array_merge( $node, $pathProps );
  1202.             }
  1203.  
  1204.             if( ! $this->set_path_level( $i++, $pathName, $pathProps ) )
  1205.             {
  1206.                 return false;
  1207.             }
  1208.  
  1209.             $prevPath[] = $pathName;
  1210.         }
  1211.  
  1212.         return true;
  1213.     }
  1214.  
  1215.  
  1216.     /**
  1217.      * Get the top of the HTML <body>.
  1218.      *
  1219.      * @return string 
  1220.      */
  1221.     function get_body_top()
  1222.     {
  1223.         return '';
  1224.     }
  1225.  
  1226.  
  1227.     /**
  1228.      * Get the end of the HTML <body>. Close open divs, etc...
  1229.      *
  1230.      * @return string 
  1231.      */
  1232.     function get_body_bottom()
  1233.     {
  1234.         return '';
  1235.     }
  1236.  
  1237.  
  1238.     /**
  1239.      * GLOBAL HEADER - APP TITLE, LOGOUT, ETC.
  1240.      *
  1241.      * @return string 
  1242.      */
  1243.     function get_page_head()
  1244.     {
  1245.         global $app_shortname, $app_version, $current_User, $htsrv_url_sensitive, $admin_url, $baseurl, $rsc_url;
  1246.  
  1247.         $r = '
  1248.         <div id="header">
  1249.             '.$this->admin_logo.'
  1250.  
  1251.             <div id="headinfo">
  1252.                 <span id="headfunctions">'
  1253.                     // Note: if we log in with another user, we may not have the perms to come back to the same place any more, thus: redirect to admin home.
  1254.                     .'<a href="'.$htsrv_url_sensitive.'login.php?action=logout&amp;redirect_to='.rawurlencode(url_rel_to_same_host($admin_url, $htsrv_url_sensitive)).'">'.T_('Logout').'</a>
  1255.                     <img src="'.$rsc_url.'icons/close.gif" width="14" height="14" border="0" class="top" alt="" title="'
  1256.                     .T_('Logout').'" /></a>
  1257.                 </span>
  1258.  
  1259.                 '.$app_shortname.' v <strong>'.$app_version.'</strong>
  1260.                 &middot; '.$this->get_head_info().'
  1261.             </div>
  1262.  
  1263.             <h1>'.$this->get_title_for_titlearea().'</h1>
  1264.         </div>
  1265.         ';
  1266.  
  1267.         return $r;
  1268.     }
  1269.  
  1270.  
  1271.     /**
  1272.      * Get default head info (local time, GMT, Login).
  1273.      *
  1274.      * @return string 
  1275.      */
  1276.     function get_head_info()
  1277.     {
  1278.         global $pagenow, $obhandler_debug, $localtimenow, $servertimenow, $current_User;
  1279.  
  1280.         $r = '';
  1281.  
  1282.         if( !$obhandler_debug )
  1283.         { // don't display changing time when we want to test obhandler
  1284.             $r .= "\n".T_('Time:').' <strong>'.date_i18n( locale_timefmt(), $localtimenow ).'</strong>'
  1285.                 .' &middot; <acronym title="'.T_('Greenwich Mean Time').'">'
  1286.                 ./* TRANS: short for Greenwich Mean Time */ T_('GMT:').'</acronym> <strong>'.gmdate( locale_timefmt(), $servertimenow).'</strong>'
  1287.                 .' &middot; '.T_('Logged in as:').' <strong><a href="'.$pagenow.'?ctrl=users&amp;user_ID='.$current_User->ID.'">'.$current_User->dget('login').'</a></strong>'
  1288.                 ."\n";
  1289.         }
  1290.  
  1291.         return $r;
  1292.     }
  1293.  
  1294.  
  1295.     /**
  1296.      * Checks if {@link $current_User the current User} has needed perms on a menu entry.
  1297.      *
  1298.      * @param array Path properties: An array, where 'perm_name' and/or 'perm_eval' might be set.
  1299.      *               'perm_level' (used with 'perm_name') defaults to 'any' if not given.
  1300.      * @return boolean 
  1301.      */
  1302.     function check_perm( $perminfo )
  1303.     {
  1304.         global $current_User;
  1305.  
  1306.         if( isset($perminfo['perm_name']) )
  1307.         { // 'perm_name' given, check it together with 'perm_level' (which defaults to 'any')
  1308.             $perm_level = isset( $perminfo['perm_level'] ) ? $perminfo['perm_level'] : 'any';
  1309.             if( ! $current_User->check_perm( $perminfo['perm_name'], $perm_level ) )
  1310.             {    // permission denied!
  1311.                 return false;
  1312.             }
  1313.         }
  1314.  
  1315.         if( isset($perminfo['perm_eval']) )
  1316.         { // also check for 'perm_eval'
  1317.             if( ! eval($perminfo['perm_eval']) )
  1318.             {    // permission denied!
  1319.                 return false;
  1320.             }
  1321.         }
  1322.  
  1323.         return true;
  1324.     }
  1325.  
  1326. }
  1327.  
  1328. /*
  1329.  * $Log: _adminUI_general.class.php,v $
  1330.  * Revision 1.25.2.6  2006/11/27 19:11:12  fplanque
  1331.  * i18n
  1332.  *
  1333.  * Revision 1.25.2.5  2006/11/04 19:55:15  fplanque
  1334.  * Reinjected old Log blocks. Removing them from CVS was a bad idea -- especially since Daniel has decided branch 1.9 was his HEAD...
  1335.  *
  1336.  * Revision 1.25  2006/07/12 20:17:13  fplanque
  1337.  * minor
  1338.  *
  1339.  * Revision 1.24  2006/07/08 22:33:43  blueyed
  1340.  * Integrated "simple edit form".
  1341.  *
  1342.  * Revision 1.23  2006/07/08 17:04:19  fplanque
  1343.  * minor
  1344.  *
  1345.  * Revision 1.21  2006/06/25 23:34:15  blueyed
  1346.  * wording pt2
  1347.  *
  1348.  * Revision 1.20  2006/06/25 23:23:38  blueyed
  1349.  * wording
  1350.  *
  1351.  * Revision 1.19  2006/06/22 22:30:05  blueyed
  1352.  * htsrv url for password related scripts (login, register and profile update)
  1353.  *
  1354.  * Revision 1.18  2006/06/22 19:23:01  blueyed
  1355.  * Text for fotter, if no LIMIT
  1356.  *
  1357.  * Revision 1.17  2006/06/22 18:37:48  fplanque
  1358.  * fixes
  1359.  *
  1360.  * Revision 1.16  2006/06/14 17:03:59  fplanque
  1361.  * A little better logout from admin... useful for bozos.
  1362.  *
  1363.  * Revision 1.15  2006/06/13 21:49:16  blueyed
  1364.  * Merged from 1.8 branch
  1365.  *
  1366.  * Revision 1.13.2.3  2006/06/12 20:00:57  fplanque
  1367.  * one too many massive syncs...
  1368.  *
  1369.  * Revision 1.13  2006/05/12 21:53:38  blueyed
  1370.  * Fixes, cleanup, translation for plugins
  1371.  *
  1372.  * Revision 1.12  2006/05/02 18:15:20  fplanque
  1373.  * invalid xhtml fix
  1374.  *
  1375.  * Revision 1.11  2006/04/27 18:28:33  fplanque
  1376.  * moved Blog specific stuff out of evocore
  1377.  *
  1378.  * Revision 1.10  2006/04/24 20:43:43  blueyed
  1379.  * Exit to selected blog, if any
  1380.  *
  1381.  * Revision 1.9  2006/04/19 17:17:19  blueyed
  1382.  * Fix
  1383.  *
  1384.  * Revision 1.8  2006/04/19 12:54:41  fplanque
  1385.  * not using exit links any more because it won't translate
  1386.  *
  1387.  * Revision 1.7  2006/04/14 19:25:32  fplanque
  1388.  * evocore merge with work app
  1389.  *
  1390.  * Revision 1.6  2006/04/12 15:16:54  fplanque
  1391.  * partial cleanup
  1392.  *
  1393.  * Revision 1.5  2006/04/11 21:56:27  blueyed
  1394.  * cleanup
  1395.  *
  1396.  * Revision 1.4  2006/04/04 21:54:23  blueyed
  1397.  * cleanup/whitespace
  1398.  *
  1399.  * Revision 1.2  2006/03/12 23:09:30  fplanque
  1400.  * doc cleanup
  1401.  *
  1402.  * Revision 1.1  2006/02/23 21:12:51  fplanque
  1403.  * File reorganization to MVC (Model View Controller) architecture.
  1404.  * See index.hml files in folders.
  1405.  * (Sorry for all the remaining bugs induced by the reorg... :/)
  1406.  *
  1407.  * Revision 1.52  2006/02/03 21:58:04  fplanque
  1408.  * Too many merges, too little time. I can hardly keep up. I'll try to check/debug/fine tune next week...
  1409.  *
  1410.  * Revision 1.51  2006/02/01 20:06:15  blueyed
  1411.  * die_if_no_perm re-enabled
  1412.  *
  1413.  * Revision 1.50  2006/01/30 19:49:17  fplanque
  1414.  * Fixed the 3 broken check_perm() features! 1) text_no_perm 2) perm_eval 3) average user trying to edit his profile
  1415.  *
  1416.  * Revision 1.49  2006/01/30 16:09:33  blueyed
  1417.  * doc
  1418.  *
  1419.  * Revision 1.47  2006/01/26 23:08:35  blueyed
  1420.  * Plugins enhanced.
  1421.  *
  1422.  * Revision 1.46  2006/01/26 20:27:45  blueyed
  1423.  * minor
  1424.  *
  1425.  * Revision 1.45  2006/01/25 18:24:21  fplanque
  1426.  * hooked bozo validator in several different places
  1427.  *
  1428.  * Revision 1.44  2006/01/23 23:29:49  blueyed
  1429.  * Added permission checks when setting a path
  1430.  *
  1431.  * Revision 1.43  2006/01/10 19:03:16  blueyed
  1432.  * Use $app_shortname in get_page_head()
  1433.  *
  1434.  * Revision 1.42  2005/12/12 19:21:20  fplanque
  1435.  * big merge; lots of small mods; hope I didn't make to many mistakes :]
  1436.  *
  1437.  * Revision 1.41  2005/12/08 22:54:02  blueyed
  1438.  * Doc, Normalization
  1439.  *
  1440.  * Revision 1.40  2005/11/25 03:57:57  blueyed
  1441.  * doc, normalization
  1442.  *
  1443.  * Revision 1.39  2005/11/17 17:39:55  blueyed
  1444.  * Removed trailing whitespace in T_() for acronym title
  1445.  *
  1446.  * Revision 1.38  2005/11/03 18:23:43  fplanque
  1447.  * minor
  1448.  *
  1449.  * Revision 1.37  2005/10/30 23:42:46  blueyed
  1450.  * Refactored get_head_links() into existing get_headlines(); doc
  1451.  *
  1452.  * Revision 1.36  2005/10/28 20:08:46  blueyed
  1453.  * Normalized AdminUI
  1454.  *
  1455.  * Revision 1.35  2005/10/26 23:08:28  blueyed
  1456.  * doc; todo
  1457.  *
  1458.  * Revision 1.34  2005/10/12 18:24:37  fplanque
  1459.  * bugfixes
  1460.  *
  1461.  * Revision 1.33  2005/09/06 17:13:53  fplanque
  1462.  * stop processing early if referer spam has been detected
  1463.  *
  1464.  * Revision 1.32  2005/08/31 19:06:41  fplanque
  1465.  * minor
  1466.  *
  1467.  * Revision 1.30  2005/07/18 14:21:37  fplanque
  1468.  * Use a default Form layout which can be skin dependant
  1469.  *
  1470.  * Revision 1.29  2005/07/15 16:41:50  fplanque
  1471.  * fixed typo
  1472.  *
  1473.  * Revision 1.28  2005/07/14 21:03:31  blueyed
  1474.  * Fixed notice with array_merge() again.
  1475.  *
  1476.  * Revision 1.27  2005/07/10 00:09:06  blueyed
  1477.  * renamed getNode() to get_node_by_path(), fixed array_merge() notice for PHP5
  1478.  *
  1479.  * Revision 1.26  2005/06/23 18:43:06  blueyed
  1480.  * Fixed constructor's name.
  1481.  *
  1482.  * Revision 1.25  2005/06/22 17:21:39  blueyed
  1483.  * css fix for khtml
  1484.  *
  1485.  * Revision 1.24  2005/06/03 20:14:37  fplanque
  1486.  * started input validation framework
  1487.  *
  1488.  * Revision 1.22  2005/05/02 19:06:44  fplanque
  1489.  * started paging of user list..
  1490.  *
  1491.  * Revision 1.21  2005/04/28 20:44:17  fplanque
  1492.  * normalizing, doc
  1493.  *
  1494.  * Revision 1.20  2005/04/21 18:01:28  fplanque
  1495.  * CSS styles refactoring
  1496.  *
  1497.  * Revision 1.19  2005/04/15 18:02:57  fplanque
  1498.  * finished implementation of properties/meta data editor
  1499.  * started implementation of files to items linking
  1500.  *
  1501.  * Revision 1.18  2005/03/21 17:37:47  fplanque
  1502.  * results/table layout refactoring
  1503.  *
  1504.  * Revision 1.17  2005/03/18 00:24:04  blueyed
  1505.  * doc
  1506.  *
  1507.  * Revision 1.16  2005/03/17 14:06:37  fplanque
  1508.  * put back page titles in logical order
  1509.  *
  1510.  * Revision 1.15  2005/03/16 19:58:13  fplanque
  1511.  * small AdminUI cleanup tasks
  1512.  *
  1513.  * Revision 1.14  2005/03/16 16:05:09  fplanque
  1514.  * $app_footer_text
  1515.  *
  1516.  * Revision 1.13  2005/03/13 19:46:53  blueyed
  1517.  * application config layer
  1518.  *
  1519.  * Revision 1.12  2005/03/11 12:40:15  fplanque
  1520.  * multiple browsing views, part ONE
  1521.  *
  1522.  */
  1523. ?>
admin

Packages

main
admin
admin-skin
conf
evocore
evoskins
gsbcore
htsrv
install
libs
obsolete
plugins
xmlsrv

Documentation generated on Tue, 18 Dec 2007 19:10:08 +0100 by phpDocumentor 1.4.0