Wordlift_Post_Excerpt_Helper

Complexity

Total Complexity

3

Size/Duplication

Total Lines	43
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Importance

Changes

0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	get_text_excerpt()	0	8	2
A	strip_all_shortcodes()	0	4	1

<?php
/**
 * Helpers: Post Excerpt Helper.
 *
 * The Post Excerpt Helper provides the `get_excerpt` handy function to get the
 * excerpt for any post.
 *
 * While WordPress' own `get_the_excerpt` does exactly the same only since version
 * 4.5, the function allows to specify a post id.
 *
 * Since we need to maintain compatibility with 4.2+ we need therefore this helper
 * function.
 *
 * @since   3.12.0
 * @package Wordlift
 */

/**
 * Define the {@link Wordlift_Post_Excerpt_Helper} class.
 *
 * @since   3.12.0
 * @package Wordlift
 */
class Wordlift_Post_Excerpt_Helper {

	/**
	 * Get the text excerpt for the provided {@link WP_Post}.
	 *
	 * Since anyone can hook on the excerpt generation filters, and
	 * amend it with non textual content, we play it self and generate
	 * the excerpt ourselves, mimicking the way wordpress core does it.
	 *
	 * @since 3.10.0
	 *
	 * @param WP_Post $post   The {@link WP_Post}.
	 * @param int     $length The desired excerpt length.
	 * @param string  $more   The desired more string.
	 *
	 * @return string The excerpt.
	 */
	public static function get_text_excerpt( $post, $length = 55, $more = '...' ) {

		// Get the excerpt and trim it. Use the `post_excerpt` if available.
		$excerpt = wp_trim_words( ! empty( $post->post_excerpt ) ? $post->post_excerpt : $post->post_content, $length, $more );

		// Remove shortcodes and decode html entities.
		return html_entity_decode( self::strip_all_shortcodes( $excerpt ) );
	}

	/**
	 * Remove all the shortcodes from the content. We're using our own function
	 * because WordPress' own `strip_shortcodes` only takes into consideration
	 * shortcodes for installed plugins/themes.
	 *
	 * @since 3.12.0
	 *
	 * @param string $content The content with shortcodes.
	 *
	 * @return string The content without shortcodes.
	 */
	private static function strip_all_shortcodes( $content ) {

		return preg_replace( '/\[[^]]+\]/', '', $content );
	}

}