display-featured-image-genesis/includes/class-displayfeaturedimagegenesis-description.php

<?php
/**
 * @package   DisplayFeaturedImageGenesis
 * @author    Robin Cornett <hello@robincornett.com>
 * @license   GPL-2.0+
 * @link      http://robincornett.com
 * @copyright 2014 Robin Cornett Creative, LLC
 */

class Display_Featured_Image_Genesis_Description {

	/**
	 * Show optional excerpt on single posts.
	 *
	 * If it's not a single post, nothing happens.
	 *
	 * If there's an excerpt and the move excerpts option is selected, it runs through `wpautop()` before being added to a div.
	 *
	 * @since 1.3.0
	 *
	 * @return null Return early if not a single post with an excerpt.
	 */

	public function do_excerpt() {

		if ( ! is_singular() || is_front_page() ) {
			return;
		}

		$headline = $intro_text = $itemprop = '';

		if ( genesis_html5() ) {
			$itemprop = 'itemprop="headline"';
		}
		$headline = sprintf( '<h1 class="entry-title" ' . $itemprop . '>%s</h1>', get_the_title() );

		if ( has_excerpt() ) {
			$intro_text = apply_filters( 'display_featured_image_genesis_singular_description', get_the_excerpt() );
		}
		if ( $headline || $intro_text ) {
			printf( '<div class="excerpt">%s</div>', $headline . wpautop( $intro_text ) );
		}
	}

	/**
	 * Show optional excerpt on blog or front page.
	 *
	 * If it's not the front page and isn't home, nothing happens.
	 *
	 * If there's an excerpt and the move excerpts option is selected, it runs through `wpautop()` before being added to a div.
	 *
	 * @since 1.3.0
	 *
	 * @return null Return early if not blog/front page.
	 */
	public function do_front_blog_excerpt() {

		if ( ! is_front_page() && ! is_home() ) {
			return;
		}

		$frontpage  = get_option( 'show_on_front' );
		$postspage  = get_post( get_option( 'page_for_posts' ) );
		$headline   = '';
		$intro_text = get_bloginfo( 'description' );

		if ( is_home() && 'page' === $frontpage ) {
			$itemprop = '';
			if ( genesis_html5() ) {
				$itemprop = 'itemprop="headline"';
			}
			$headline   = sprintf( '<h1 class="entry-title" ' . $itemprop . '>%s</h1>', $postspage->post_title );
			$intro_text = $postspage->post_excerpt;
		}

		$intro_text = apply_filters( 'display_featured_image_genesis_front_blog_description', $intro_text );

		if ( $headline || $intro_text ) {
			printf( '<div class="excerpt">%s</div>', $headline . wpautop( $intro_text ) );
		}

	}

	/**
	 * Add custom description to category / tag / taxonomy archive pages.
	 *
	 * If the page is not a category, tag or taxonomy term archive, or we're not on the first page, or there's no term, or
	 * no term meta set, then nothing extra is displayed.
	 *
	 * If there's a description to display, it runs through `wpautop()` before being added to a div.
	 *
	 * @since 1.3.0
	 *
	 * @global WP_Query $wp_query Query object.
	 *
	 * @return null Return early if not the correct archive page, not page one, or no term meta is set.
	 */

	public function do_tax_description() {

		global $wp_query;

		if ( ! is_category() && ! is_tag() && ! is_tax() ) {
			return;
		}

		if ( get_query_var( 'paged' ) >= 2 ) {
			return;
		}

		$term = is_tax() ? get_term_by( 'slug', get_query_var( 'term' ), get_query_var( 'taxonomy' ) ) : $wp_query->get_queried_object();

		if ( ! $term || ! isset( $term->meta ) ) {
			return;
		}

		$intro_text = apply_filters( 'display_featured_image_genesis_term_description', $term->meta['intro_text'] );

		if ( $intro_text ) {
			printf( '<div class="archive-description taxonomy-description">%s</div>', wpautop( $intro_text ) );
		}

	}

	/**
	 * Add custom headline and description to author archive pages.
	 *
	 * If we're not on an author archive page, or not on page 1, then nothing extra is displayed.
	 *
	 * If there's a custom headline to display, it is marked up as a level 1 heading.
	 *
	 * If there's a description (intro text) to display, it is run through `wpautop()` before being added to a div.
	 *
	 * @since 1.4.0
	 *
	 * @return null Return early if not author archive or not page one.
	 */

	public function do_author_description() {

		if ( ! is_author() || get_query_var( 'paged' ) >= 2 ) {
			return;
		}

		$intro_text = apply_filters( 'display_featured_image_genesis_author_description', get_the_author_meta( 'intro_text', (int) get_query_var( 'author' ) ) );

		if ( $intro_text ) {
			printf( '<div class="archive-description author-description">%s</div>', wpautop( $intro_text ) );
		}

	}


	/**
	 * Add custom headline and description to relevant custom post type archive pages.
	 *
	 * If we're not on a post type archive page, or not on page 1, then nothing extra is displayed.
	 *
	 * If there's a custom headline to display, it is marked up as a level 1 heading.
	 *
	 * If there's a description (intro text) to display, it is run through wpautop() before being added to a div.
	 *
	 * @since 2.0.0
	 *
	 * @uses genesis_has_post_type_archive_support() Check if a post type should potentially support an archive setting page.
	 * @uses genesis_get_cpt_option()                Get list of custom post types which need an archive settings page.
	 *
	 * @return null Return early if not on relevant post type archive.
	 */

	public function do_cpt_archive_description() {

		if ( ! is_post_type_archive() || ! genesis_has_post_type_archive_support() ) {
			return;
		}

		if ( get_query_var( 'paged' ) >= 2 ) {
			return;
		}

		$intro_text = apply_filters( 'display_featured_image_genesis_cpt_description', genesis_get_cpt_option( 'intro_text' ) );

		if ( $intro_text ) {
			printf( '<div class="archive-description cpt-archive-description">%s</div>', wpautop( $intro_text ) );
		}

	}

}