<?php

/**

 * WordPress Post Template Functions.

 *

 * Gets content for the current post in the loop.

 *

 * @package WordPress

 * @subpackage Template

 */

/**

 * Display the ID of the current item in the WordPress Loop.

 *

 * @since 0.71

 */

function the_ID() {

	echo get_the_ID();

}

/**

 * Retrieve the ID of the current item in the WordPress Loop.

 *

 * @since 2.1.0

 *

 * @return int|false The ID of the current item in the WordPress Loop. False if $post is not set.

 */

function get_the_ID() {

	$post = get_post();

	return ! empty( $post ) ? $post->ID : false;

}

/**

 * Display or retrieve the current post title with optional markup.

 *

 * @since 0.71

 *

 * @param string $before Optional. Markup to prepend to the title. Default empty.

 * @param string $after  Optional. Markup to append to the title. Default empty.

 * @param bool   $echo   Optional. Whether to echo or return the title. Default true for echo.

 * @return string|void Current post title if $echo is false.

 */

function the_title( $before = '', $after = '', $echo = true ) {

	$title = get_the_title();

		return;

	$title = $before . $title . $after;

		echo $title;

		return $title;

}

/**

 * Sanitize the current title when retrieving or displaying.

 *

 * Works like the_title(), except the parameters can be in a string or

 * an array. See the function for what can be override in the $args parameter.

 *

 * The title before it is displayed will have the tags stripped and esc_attr()

 * before it is passed to the user or displayed. The default as with the_title(),

 * is to display the title.

 *

 * @since 2.3.0

 *

 * @param string|array $args {

 *     Title attribute arguments. Optional.

 *

 *     @type string  $before Markup to prepend to the title. Default empty.

 *     @type string  $after  Markup to append to the title. Default empty.

 *     @type bool    $echo   Whether to echo or return the title. Default true for echo.

 *     @type WP_Post $post   Current post object to retrieve the title for.

 * }

 * @return string|void String when echo is false.

 */

function the_title_attribute( $args = '' ) {

	$title = get_the_title( $r['post'] );

	if ( strlen( $title ) == 0 ) {

		return;

	}

	$title = $r['before'] . $title . $r['after'];

	$title = esc_attr( strip_tags( $title ) );

	if ( $r['echo'] ) {

		echo $title;

	} else {

		return $title;

	}

}

/**

 * Retrieve post title.

 *

 * If the post is protected and the visitor is not an admin, then "Protected"

 * will be displayed before the post title. If the post is private, then

 * "Private" will be located before the post title.

 *

 * @since 0.71

 *

 * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.

 * @return string

 */

function get_the_title( $post = 0 ) {

	$post = get_post( $post );

	$title = isset( $post->post_title ) ? $post->post_title : '';

	if ( ! is_admin() ) {

		if ( ! empty( $post->post_password ) ) {

			/**

			 * Filters the text prepended to the post title for protected posts.

			 *

			 * The filter is only applied on the front end.

			 *

			 * @since 2.8.0

			 *

			 * @param string  $prepend Text displayed before the post title.

			 *                         Default 'Protected: %s'.

			 * @param WP_Post $post    Current post object.

			 */

			$protected_title_format = apply_filters( 'protected_title_format', __( 'Protected: %s' ), $post );

		} elseif ( isset( $post->post_status ) && 'private' == $post->post_status ) {

			/**

			 * Filters the text prepended to the post title of private posts.

			 *

			 * The filter is only applied on the front end.

			 *

			 * @since 2.8.0

			 *

			 * @param string  $prepend Text displayed before the post title.

			 *                         Default 'Private: %s'.

			 * @param WP_Post $post    Current post object.

			 */

			$private_title_format = apply_filters( 'private_title_format', __( 'Private: %s' ), $post );

		}

	}

	/**

	 * Filters the post title.

	 *

	 * @since 0.71

	 *

	 * @param string $title The post title.

	 * @param int    $id    The post ID.

	 */

	return apply_filters( 'the_title', $title, $id );

}

/**

 * Display the Post Global Unique Identifier (guid).

 *

 * The guid will appear to be a link, but should not be used as a link to the

 * post. The reason you should not use it as a link, is because of moving the

 * blog across domains.

 *

 * URL is escaped to make it XML-safe.

 *

 * @since 1.5.0

 *

 * @param int|WP_Post $post Optional. Post ID or post object. Default is global $post.

 */

function the_guid( $post = 0 ) {

	$post = get_post( $post );

	$guid = isset( $post->guid ) ? get_the_guid( $post ) : '';

	$id   = isset( $post->ID ) ? $post->ID : 0;

	/**

	 * Filters the escaped Global Unique Identifier (guid) of the post.

	 *

	 * @since 4.2.0

	 *

	 * @see get_the_guid()

	 *

	 * @param string $guid Escaped Global Unique Identifier (guid) of the post.

	 * @param int    $id   The post ID.

	 */

	echo apply_filters( 'the_guid', $guid, $id );

}

/**

 * Retrieve the Post Global Unique Identifier (guid).

 *

 * The guid will appear to be a link, but should not be used as an link to the

 * post. The reason you should not use it as a link, is because of moving the

 * blog across domains.

 *

 * @since 1.5.0

 *

 * @param int|WP_Post $post Optional. Post ID or post object. Default is global $post.

 * @return string

 */

function get_the_guid( $post = 0 ) {

	$post = get_post( $post );

	$guid = isset( $post->guid ) ? $post->guid : '';

	$id   = isset( $post->ID ) ? $post->ID : 0;

	/**

	 * Filters the Global Unique Identifier (guid) of the post.

	 *

	 * @since 1.5.0

	 *

	 * @param string $guid Global Unique Identifier (guid) of the post.

	 * @param int    $id   The post ID.

	 */

	return apply_filters( 'get_the_guid', $guid, $id );

}

/**

 * Display the post content.

 *

 * @since 0.71

 *

 * @param string $more_link_text Optional. Content for when there is more text.

 * @param bool   $strip_teaser   Optional. Strip teaser content before the more text. Default is false.

 */

	$content = get_the_content( $more_link_text, $strip_teaser );

	/**

	 * Filters the post content.

	 *

	 * @since 0.71

	 *

	 * @param string $content Content of the current post.

	 */

	$content = apply_filters( 'the_content', $content );

	$content = str_replace( ']]>', ']]>', $content );

	echo $content;

}

/**

 * Retrieve the post content.

 *

 * @since 0.71

 *

 * @global int   $page      Page number of a single post/page.

 * @global int   $more      Boolean indicator for whether single post/page is being viewed.

 * @global bool  $preview   Whether post/page is in preview mode.

 * @global int   $multipage Boolean indicator for whether multiple pages are in play.

 *

 * @return string

 */

	global $page, $more, $preview, $pages, $multipage;

	if ( null === $more_link_text ) {

		$more_link_text = sprintf(

			'<span aria-label="%1$s">%2$s</span>',

			sprintf(

				/* translators: %s: Name of current post */

				__( 'Continue reading %s' ),

			),

			__( '(more…)' )

		);

	}

	$has_teaser = false;

	// If post password required and it doesn't match the cookie.

	if ( preg_match( '/<!--more(.*?)?-->/', $content, $matches ) ) {

		$content = explode( $matches[0], $content, 2 );

			$more_link_text = strip_tags( wp_kses_no_null( trim( $matches[1] ) ) );

		$has_teaser = true;

	} else {

		$content = array( $content );

	}

		$strip_teaser = true;

	$teaser = $content[0];

		$teaser = '';

	$output .= $teaser;

	if ( count( $content ) > 1 ) {

		} else {

				/**

				 * Filters the Read More link text.

				 *

				 * @since 2.8.0

				 *

				 * @param string $more_link_element Read More link element.

				 * @param string $more_link_text    Read More text.

				 */

			$output = force_balance_tags( $output );

		}

	}

	return $output;

}

/**

 * Display the post excerpt.

 *

 * @since 0.71

 */

function the_excerpt() {

	/**

	 * Filters the displayed post excerpt.

	 *

	 * @since 0.71

	 *

	 * @see get_the_excerpt()

	 *

	 * @param string $post_excerpt The post excerpt.

	 */

	echo apply_filters( 'the_excerpt', get_the_excerpt() );

}

/**

 * Retrieves the post excerpt.

 *

 * @since 0.71

 * @since 4.5.0 Introduced the `$post` parameter.

 *

 * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.

 * @return string Post excerpt.

 */

function get_the_excerpt( $post = null ) {

	if ( is_bool( $post ) ) {

		_deprecated_argument( __FUNCTION__, '2.3.0' );

	}

	$post = get_post( $post );

	if ( empty( $post ) ) {

		return '';

	}

	if ( post_password_required( $post ) ) {

		return __( 'There is no excerpt because this is a protected post.' );

	}

	/**

	 * Filters the retrieved post excerpt.

	 *

	 * @since 1.2.0

	 * @since 4.5.0 Introduced the `$post` parameter.

	 *

	 * @param string $post_excerpt The post excerpt.

	 * @param WP_Post $post Post object.

	 */

	return apply_filters( 'get_the_excerpt', $post->post_excerpt, $post );

}

/**