Changeset 14276

Timestamp:

04/28/2010 07:48:09 AM (13 years ago)

Author:

westi

Message:

Introduce a template file for the Front Page of a site. Has priority over every other template which applies and falls back to the standard template flow for the page / list of posts.
Fixes #6801

Location:

trunk/wp-includes

Files:

• template-loader.php (modified) (1 diff)
• theme.php (modified) (3 diffs)

trunk/wp-includes/template-loader.php

@@ -24 +24 @@
     elseif ( is_search()         && $template = get_search_template()         ) :
     elseif ( is_tax()            && $template = get_taxonomy_template()       ) :
+    elseif ( is_front_page()     && $template = get_front_page_template()     ) :
     elseif ( is_home()           && $template = get_home_template()           ) :
     elseif ( is_attachment()     && $template = get_attachment_template()     ) :

trunk/wp-includes/theme.php

@@ -845 +845 @@
 /**
  * Retrieve path of home template in current or parent template.
- *
+ * 
+ * This is the template used for the page containing the blog posts
+ * 
  * Attempts to locate 'home.php' first before falling back to 'index.php'.
  *
@@ -856 +858 @@
     $template = locate_template(array('home.php', 'index.php'));
     return apply_filters('home_template', $template);
+}
+
+/**
+ * Retrieve path of front-page template in current or parent template.
+ *
+ * Looks for 'front-page.php'.
+ *
+ * @since 3.0.0
+ * @uses apply_filters() Calls 'front_page_template' on file path of template.
+ *
+ * @return string
+ */
+function get_front_page_template() {
+    global $wp_query;
+
+    return apply_filters( 'front_page_template', locate_template( array('front-page.php') ) );
 }
 
@@ -1002 +1020 @@
     $located = '';
     foreach ( $template_names as $template_name ) {
+        if ( !$template_name )
+            continue;
         if ( file_exists(STYLESHEETPATH . '/' . $template_name)) {
             $located = STYLESHEETPATH . '/' . $template_name;