Ticket #18480: general-template.patch

general-template.php

@@ -70 +70 @@
  * Includes the sidebar template for a theme or if a name is specified then a
  * specialised sidebar will be included.
  *
- * For the parameter, if the file is called "sidebar-special.php" then specify
- * "special".
+ * The parameter maybe a simple text string such as:
+ *              For the parameter, if the file is called "sidebar-special.php" then specify
+ *              "special".
  *
+ * Or, the parameter maybe an array of strings such as: ("mefirst", "mesecond", "special")
+ *      In this case the sidebar search order would be: 
+ *              "sidebar-mefirst.php"
+ *              "sidebar-mesecond.php"
+ *              "sidebar-special.php"
+ *   
  * @uses locate_template()
  * @since 1.5.0
  * @uses do_action() Calls 'get_sidebar' action.
@@ -83 +90 @@
         do_action( 'get_sidebar', $name );
 
         $templates = array();
-        if ( isset($name) )
-                $templates[] = "sidebar-{$name}.php";
 
+        if ( isset($name) ) {
+                if (is_array($name)) {
+                        foreach ( (array) $name as $disname ) {
+                                if ( !$disname ) { continue; }
+                                $templates[] = "sidebar-{$disname}.php";
+                        }
+                } else {
+                        $templates[] = "sidebar-{$name}.php";
+                }
+        }
+
         $templates[] = 'sidebar.php';
 
         // Backward compat code will be removed in a future release
@@ -93 +109 @@
                 load_template( ABSPATH . WPINC . '/theme-compat/sidebar.php');
 }
 
+
 /**
  * Load a template part into a template
  *