Added functionality to pre-activate a specific area/subarea of the menu.

git-svn-id: file:///svn-source/pmgr/branches/pre_0.1_work_20090819@752 97e9348a-65ac-dc4b-aefc-98561f571b83

site/app_controller.php

@@ -38,7 +38,7 @@ class AppController extends Controller {
   var $helpers = array('Html', 'Form', 'Javascript', 'Format', 'Time', 'Grid');
   var $components = array('DebugKit.Toolbar');
 
-  var $sidemenu_areas = array('SITE' => false, 'CONTROLLER' => false, 'ACTION' => false);
+  var $sidemenu   = array('areas' => array('SITE' => false, 'CONTROLLER' => false, 'ACTION' => false));
   var $std_area   = 10;
   var $new_area   = 20;
   var $op_area    = 30;
@@ -61,7 +61,7 @@ class AppController extends Controller {
 
   function sideMenuAreaVerify(&$area, $subarea, $priority = null) {
     $area = strtoupper($area);
-    if (!array_key_exists($area, $this->sidemenu_areas))
+    if (!array_key_exists($area, $this->sidemenu['areas']))
       $this->INTERNAL_ERROR("Sidemenu link '{$area}': Unknown");
 
     if ($area == 'SITE')
@@ -71,9 +71,9 @@ class AppController extends Controller {
     elseif ($area == 'ACTION')
       $name = Inflector::humanize(Inflector::singularize($this->params['controller']));
 
-    if (empty($this->sidemenu_areas[$area]))
-      $this->sidemenu_areas[$area]
-	= array('enable' => true, 'name' => $name, 'subarea' => array());
+    if (empty($this->sidemenu['areas'][$area]))
+      $this->sidemenu['areas'][$area]
+	= array('enable' => true, 'name' => $name, 'subareas' => array());
 
     if (empty($subarea))
       return;
@@ -94,15 +94,15 @@ class AppController extends Controller {
     else
       $subname .= '-' . $subarea;
 
-    if (empty($this->sidemenu_areas[$area]['subarea'][$subarea]))
-	$this->sidemenu_areas[$area]['subarea'][$subarea]
+    if (empty($this->sidemenu['areas'][$area]['subareas'][$subarea]))
+	$this->sidemenu['areas'][$area]['subareas'][$subarea]
 	  = array('enable' => true, 'name' => $subname, 'priorities' => array());
 
     if (empty($priority))
       return;
 
-    if (empty($this->sidemenu_areas[$area]['subarea'][$subarea]['priorities'][$priority]))
-      $this->sidemenu_areas[$area]['subarea'][$subarea]['priorities'][$priority]
+    if (empty($this->sidemenu['areas'][$area]['subareas'][$subarea]['priorities'][$priority]))
+      $this->sidemenu['areas'][$area]['subareas'][$subarea]['priorities'][$priority]
 	= array();
   }
 
@@ -117,9 +117,22 @@ class AppController extends Controller {
   function sideMenuAreaName($name, $area, $subarea = null) {
     $this->sideMenuAreaVerify($area, $subarea);
     if (empty($subarea))
-      $this->sidemenu_areas[$area]['name'] = $name;
+      $this->sidemenu['areas'][$area]['name'] = $name;
     else
-      $this->sidemenu_areas[$area]['subarea'][$subarea]['name'] = $name;
+      $this->sidemenu['areas'][$area]['subareas'][$subarea]['name'] = $name;
+  }
+
+
+  /**************************************************************************
+   **************************************************************************
+   **************************************************************************
+   * function: sideMenuAreaActivate
+   *  - Sets the selected area/subarea to be active when the
+   *    page is first loaded.
+   */
+
+  function sideMenuAreaActivate($area, $subarea = null) {
+    $this->sidemenu['active'] = compact('area', 'subarea');
   }
 
 
@@ -133,9 +146,9 @@ class AppController extends Controller {
   function sideMenuEnable($area, $subarea = null, $enable = true) {
     $this->sideMenuAreaVerify($area, $subarea);
     if (isset($subarea))
-      $this->sidemenu_areas[$area]['subarea'][$subarea]['enable'] = $enable;
+      $this->sidemenu['areas'][$area]['subareas'][$subarea]['enable'] = $enable;
     else
-      $this->sidemenu_areas[$area]['enable'] = $enable;
+      $this->sidemenu['areas'][$area]['enable'] = $enable;
   }
 
 
@@ -150,7 +163,7 @@ class AppController extends Controller {
     if (empty($subarea))
       $subarea = $this->std_area;
     $this->sideMenuAreaVerify($area, $subarea);
-    $this->sidemenu_areas[$area]['subarea'][$subarea]['priorities'][$priority][]
+    $this->sidemenu['areas'][$area]['subareas'][$subarea]['priorities'][$priority][]
       = array('name' => $name, 'url' => $url) + (empty($extra) ? array() : $extra);
   }
 
@@ -280,24 +293,36 @@ class AppController extends Controller {
       $this->params['admin'] = false;
     }
 
-    foreach ($this->sidemenu_areas AS &$area) {
+    foreach ($this->sidemenu['areas'] AS &$area) {
       if (empty($area['enable']))
 	$area = array();
-      if (empty($area['subarea']))
+      if (empty($area['subareas']))
 	continue;
-      ksort($area['subarea']);
+      ksort($area['subareas']);
 
-      foreach ($area['subarea'] AS &$subarea) {
+      foreach ($area['subareas'] AS &$subarea) {
 	if (empty($subarea['enable']))
 	  $subarea = array();
 	if (empty($subarea['priorities']))
 	  continue;
 	ksort($subarea['priorities']);
       }
+      unset($subarea);
+    }
+    unset($area);
+
+    // Activate a default section (unless already specified)
+    foreach (array_reverse($this->sidemenu['areas']) AS $area_name => $area) {
+      if (empty($area))
+	continue;
+
+      if (empty($this->sidemenu['active']) ||
+	  empty($this->sidemenu['areas'][$this->sidemenu['active']['area']]))
+	$this->sideMenuAreaActivate($area_name);
     }
 
-    //pr($this->sidemenu_areas);
-    $this->set('sidemenu', $this->sidemenu_areas);
+    //pr($this->sidemenu);
+    $this->set('sidemenu', $this->sidemenu);
   }
 
 
@@ -375,6 +400,7 @@ class AppController extends Controller {
 
   function gridView($title, $action = null, $element = null) {
     $this->sideMenuEnable('SITE', $this->op_area);
+    $this->sideMenuAreaActivate('CONTROLLER');
     $this->set('title', $title);
     // The resulting page will contain a grid, which will
     // use ajax to obtain the actual data for this action