Changeset 13146 for trunk/wp-includes/general-template.php

Timestamp:

02/14/2010 09:32:23 AM (14 years ago)

Author:

westi

Message:

Introduce new get_generic_template() function for themes to use to bring in pieces of template.
Use in twentyten for loop.php including. See #9015.

File:

• trunk/wp-includes/general-template.php (modified) (1 diff)

trunk/wp-includes/general-template.php

@@ -92 +92 @@
     if ('' == locate_template($templates, true))
         load_template( get_theme_root() . '/default/sidebar.php');
+}
+
+/**
+ * Load a generic template.
+ *
+ * Includes the named template for a theme or if a name is specified then a
+ * specialised template will be included. If the theme contains no {slug}.php file
+ * then no template will be included.
+ *
+ * For the parameter, if the file is called "{slug}-special.php" then specify
+ * "special".
+ *
+ * @uses locate_template()
+ * @since 3.0.0
+ * @uses do_action() Calls 'get_generic_template_{$slug}' action.
+ *
+ * @param string $slug The slug name for the generic template.
+ * @param string $name The name of the specialised template.
+ */
+function get_generic_template( $slug, $name = null ) {
+    do_action( "get_generic_template_{$slug}", $name );
+
+    $templates = array();
+    if ( isset($name) )
+        $templates[] = "{$slug}-{$name}.php";
+
+    $templates[] = "{$slug}.php";
+
+    locate_template($templates, true);
 }