<?php
/**
 * The framework has its own template hierarchy that can be used instead of the default WordPress
 * template hierarchy.  It is not much different than the default.  It was built to extend the default by
 * making it smarter and more flexible.  The goal is to give theme developers and end users an
 * easy-to-override system that doesn't involve massive amounts of conditional tags within files.
 *
 * @package    HybridCore
 * @subpackage Includes
 * @author     Justin Tadlock <justin@justintadlock.com>
 * @copyright  Copyright (c) 2008 - 2015, Justin Tadlock
 * @link       http://themehybrid.com/hybrid-core
 * @license    http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 */

# Filter the date template.
add_filter( 'date_template', 'hybrid_date_template', 5 );

# Filter the author/user template.
add_filter( 'author_template', 'hybrid_user_template', 5 );

# Filter the tag and category (taxonomy) templates.
add_filter( 'tag_template',      'hybrid_taxonomy_template', 5 );
add_filter( 'category_template', 'hybrid_taxonomy_template', 5 );
add_filter( 'taxonomy_template', 'hybrid_taxonomy_template', 5 );

# Filter the single, page, and attachment (singular) templates.
add_filter( 'single_template',     'hybrid_singular_template', 5 );
add_filter( 'page_template',       'hybrid_singular_template', 5 );
add_filter( 'attachment_template', 'hybrid_singular_template', 5 );

# Filter the front page template.
add_filter( 'front_page_template', 'hybrid_front_page_template', 5 ); // Doesn't work b/c bug with get_query_template().
add_filter( 'frontpage_template',  'hybrid_front_page_template', 5 );

# Filter the comments template.
add_filter( 'comments_template', 'hybrid_comments_template', 5 );

/**
 * Overrides WP's default template for date-based archives. Better abstraction of templates than
 * is_date() allows by checking for the year, month, week, day, hour, and minute.
 *
 * @since  0.6.0
 * @access public
 * @param  string $template
 * @return string $template
 */
function hybrid_date_template( $template ) {
	$templates = array();

	// If viewing a time-based archive.
	if ( is_time() ) {

		// If viewing a minutely archive.
		if ( get_query_var( 'minute' ) )
			$templates[] = 'minute.php';

		// If viewing an hourly archive.
		elseif ( get_query_var( 'hour' ) )
			$templates[] = 'hour.php';

		// Catchall for any time-based archive.
		$templates[] = 'time.php';
	}

	// If viewing a daily archive.
	elseif ( is_day() )
		$templates[] = 'day.php';

	// If viewing a weekly archive.
	elseif ( get_query_var( 'w' ) )
		$templates[] = 'week.php';

	// If viewing a monthly archive.
	elseif ( is_month() )
		$templates[] = 'month.php';

	// If viewing a yearly archive.
	elseif ( is_year() )
		$templates[] = 'year.php';

	// Catchall template for date-based archives.
	$templates[] = 'date.php';

	// Fall back to the basic archive template.
	$templates[] = 'archive.php';

	// Return the found template.
	return locate_template( $templates );
}

/**
 * Overrides WP's default template for author-based archives. Better abstraction of templates than
 * is_author() allows by allowing themes to specify templates for a specific author. The hierarchy is
 * user-$nicename.php, $user-role-$role.php, user.php, author.php, archive.php.
 *
 * @since  0.7.0
 * @access public
 * @param  string $template
 * @return string
 */
function hybrid_user_template( $template ) {
	$templates = array();

	// Get the user nicename.
	$name = get_the_author_meta( 'user_nicename', get_query_var( 'author' ) );

	// Get the user object.
	$user = new WP_User( absint( get_query_var( 'author' ) ) );

	// Add the user nicename template.
	$templates[] = "user-{$name}.php";

	// Add role-based templates for the user.
	if ( is_array( $user->roles ) ) {
		foreach ( $user->roles as $role )
			$templates[] = "user-role-{$role}.php";
	}

	// Add a basic user template.
	$templates[] = 'user.php';

	// Add backwards compatibility with the WordPress author template.
	$templates[] = 'author.php';

	// Fall back to the basic archive template.
	$templates[] = 'archive.php';

	// Return the found template.
	return locate_template( $templates );
}

/**
 * Overrides WP's default template for category- and tag-based archives. This allows better
 * organization of taxonomy template files by making categories and post tags work the same way as
 * other taxonomies. The hierarchy is taxonomy-$taxonomy-$term.php, taxonomy-$taxonomy.php,
 * taxonomy.php, archive.php.
 *
 * @since  0.7.0
 * @access public
 * @param  string $template
 * @return string Full path to file.
 */
function hybrid_taxonomy_template( $template ) {

	// Get the queried term object.
	$term = get_queried_object();

	// Remove 'post-format' from the slug.
	$slug = 'post_format' === $term->taxonomy ? hybrid_clean_post_format_slug( $term->slug ) : $term->slug;

	// Return the available templates.
	return locate_template( array( "taxonomy-{$term->taxonomy}-{$slug}.php", "taxonomy-{$term->taxonomy}.php", 'taxonomy.php', 'archive.php' ) );
}

/**
 * Overrides the default single (singular post) template.  Post templates can be loaded using a custom
 * post template, by slug, or by ID.
 *
 * Attachment templates are handled slightly differently. Rather than look for the slug or ID, templates
 * can be loaded by attachment-$mime[0]_$mime[1].php, attachment-$mime[1].php, or attachment-$mime[0].php.
 *
 * @since  0.7.0
 * @access public
 * @param  string $template The default WordPress post template.
 * @return string $template The theme post template after all templates have been checked for.
 */
function hybrid_singular_template( $template ) {

	$templates = array();

	// Get the queried post.
	$post = get_queried_object();

	// Check for a custom post template by custom field key '_wp_post_template'.
	$custom = hybrid_get_post_template( get_queried_object_id() );

	if ( $custom )
		$templates[] = $custom;

	// If viewing an attachment page, handle the files by mime type.
	if ( is_attachment() ) {

		// Split the mime_type into two distinct parts.
		$type    = hybrid_get_attachment_type();
		$subtype = hybrid_get_attachment_subtype();

		if ( $subtype ) {
			$templates[] = "attachment-{$type}-{$subtype}.php";
			$templates[] = "attachment-{$subtype}.php";
		}

		$templates[] = "attachment-{$type}.php";
	}

	// If viewing any other type of singular page.
	else {

		// Add a post name (slug) template.
		$templates[] = "{$post->post_type}-{$post->post_name}.php";

		// Add a post ID template.
		$templates[] = "{$post->post_type}-{$post->ID}.php";
	}

	// Add a template based off the post type name.
	$templates[] = "{$post->post_type}.php";

	// Allow for WP standard 'single' templates for compatibility.
	$templates[] = "single-{$post->post_type}.php";
	$templates[] = 'single.php';

	// Add a general template of singular.php.
	$templates[] = "singular.php";

	// Return the found template.
	return locate_template( $templates );
}

/**
 * Fix for the front page template handling in WordPress core. Its handling is not logical because it
 * forces devs to account for both a page on the front page and posts on the front page.  Theme devs
 * must handle both scenarios if they've created a "front-page.php" template.  This filter overwrites
 * that and disables the "front-page.php" template if posts are to be shown on the front page.  This
 * way, the "front-page.php" template will only ever be used if an actual page is supposed to be
 * shown on the front.
 *
 * @link   http://www.chipbennett.net/2013/09/14/home-page-and-front-page-and-templates-oh-my/
 * @since  2.0.0
 * @access public
 * @param  string  $template
 * @return string
 */
function hybrid_front_page_template( $template ) {

	return is_home() ? '' : $template;
}

/**
 * Overrides the default comments template.  This filter allows for a "comments-{$post_type}.php"
 * template based on the post type of the current single post view.  If this template is not found, it falls
 * back to the default "comments.php" template.
 *
 * @since  1.5.0
 * @access public
 * @param  string $template The comments template file name.
 * @return string $template The theme comments template after all templates have been checked for.
 */
function hybrid_comments_template( $template ) {

	$templates = array();

	// Allow for custom templates entered into comments_template( $file ).
	$template = str_replace( HYBRID_CHILD, '', $template );

	if ( 'comments.php' !== $template )
		$templates[] = $template;

	// Add a comments template based on the post type.
	$templates[] = 'comments-' . get_post_type() . '.php';

	// Add the default comments template.
	$templates[] = 'comments.php';

	// Return the found template.
	return locate_template( $templates );
}
