<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[14276] trunk/wp-includes:
  Introduce a template file for the Front Page of a site.</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/14276">14276</a></dd>
<dt>Author</dt> <dd>westi</dd>
<dt>Date</dt> <dd>2010-04-28 07:48:09 +0000 (Wed, 28 Apr 2010)</dd>
</dl>

<h3>Log Message</h3>
<pre>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 <a href="http://trac.wordpress.org/ticket/6801">#6801</a></pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpincludestemplateloaderphp">trunk/wp-includes/template-loader.php</a></li>
<li><a href="#trunkwpincludesthemephp">trunk/wp-includes/theme.php</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpincludestemplateloaderphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/template-loader.php (14275 => 14276)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/template-loader.php        2010-04-28 07:40:49 UTC (rev 14275)
+++ trunk/wp-includes/template-loader.php        2010-04-28 07:48:09 UTC (rev 14276)
</span><span class="lines">@@ -23,6 +23,7 @@
</span><span class="cx">         if     ( is_404()            &amp;&amp; $template = get_404_template()            ) :
</span><span class="cx">         elseif ( is_search()         &amp;&amp; $template = get_search_template()         ) :
</span><span class="cx">         elseif ( is_tax()            &amp;&amp; $template = get_taxonomy_template()       ) :
</span><ins>+        elseif ( is_front_page()     &amp;&amp; $template = get_front_page_template()     ) :
</ins><span class="cx">         elseif ( is_home()           &amp;&amp; $template = get_home_template()           ) :
</span><span class="cx">         elseif ( is_attachment()     &amp;&amp; $template = get_attachment_template()     ) :
</span><span class="cx">                 remove_filter('the_content', 'prepend_attachment');
</span><span class="lines">@@ -43,4 +44,4 @@
</span><span class="cx">         return;
</span><span class="cx"> endif;
</span><span class="cx"> 
</span><del>-?&gt;
</del><span class="cx">\ No newline at end of file
</span><ins>+?&gt;
</ins></span></pre></div>
<a id="trunkwpincludesthemephp"></a>
<div class="modfile"><h4>Modified: trunk/wp-includes/theme.php (14275 => 14276)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-includes/theme.php        2010-04-28 07:40:49 UTC (rev 14275)
+++ trunk/wp-includes/theme.php        2010-04-28 07:48:09 UTC (rev 14276)
</span><span class="lines">@@ -844,7 +844,9 @@
</span><span class="cx"> 
</span><span class="cx"> /**
</span><span class="cx">  * Retrieve path of home template in current or parent template.
</span><del>- *
</del><ins>+ * 
+ * This is the template used for the page containing the blog posts
+ * 
</ins><span class="cx">  * Attempts to locate 'home.php' first before falling back to 'index.php'.
</span><span class="cx">  *
</span><span class="cx">  * @since 1.5.0
</span><span class="lines">@@ -858,6 +860,22 @@
</span><span class="cx"> }
</span><span class="cx"> 
</span><span class="cx"> /**
</span><ins>+ * 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') ) );
+}
+
+/**
</ins><span class="cx">  * Retrieve path of page template in current or parent template.
</span><span class="cx">  *
</span><span class="cx">  * Will first look for the specifically assigned page template
</span><span class="lines">@@ -1001,6 +1019,8 @@
</span><span class="cx"> 
</span><span class="cx">         $located = '';
</span><span class="cx">         foreach ( $template_names as $template_name ) {
</span><ins>+                if ( !$template_name )
+                        continue;
</ins><span class="cx">                 if ( file_exists(STYLESHEETPATH . '/' . $template_name)) {
</span><span class="cx">                         $located = STYLESHEETPATH . '/' . $template_name;
</span><span class="cx">                         break;
</span></span></pre>
</div>
</div>

</body>
</html>