get_extended( string $post ): string[]

Gets extended entry info (<!--more-->).

Contents

Description

There should not be any space after the second dash and before the word ‘more’. There can be text or space(s) after the word ‘more’, but won’t be referenced.

The returned array has ‘main’, ‘extended’, and ‘more_text’ keys. Main has the text before the <!--more-->. The ‘extended’ key has the content after the <!--more--> comment. The ‘more_text’ key has the custom "Read More" text.

Top ↑

Parameters

$post string Required
Post content.

Top ↑

Return

string[] Extended entry info.

  • main string
    Content before the more tag.
  • extended string
    Content after the more tag.
  • more_text string
    Custom read more text, or empty string.

Top ↑

Source

File: wp-includes/post.php. View all references 

function get_extended( $post ) {
	// Match the new style more links.
	if ( preg_match( '/<!--more(.*?)?-->/', $post, $matches ) ) {
		list($main, $extended) = explode( $matches[0], $post, 2 );
		$more_text             = $matches[1];
	} else {
		$main      = $post;
		$extended  = '';
		$more_text = '';
	}

	// Leading and trailing whitespace.
	$main      = preg_replace( '/^[\s]*(.*)[\s]*$/', '\\1', $main );
	$extended  = preg_replace( '/^[\s]*(.*)[\s]*$/', '\\1', $extended );
	$more_text = preg_replace( '/^[\s]*(.*)[\s]*$/', '\\1', $more_text );

	return array(
		'main'      => $main,
		'extended'  => $extended,
		'more_text' => $more_text,
	);
}

View on Trac View on GitHub

Top ↑

Top ↑

Changelog

Changelog
Version Description
1.0.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
    Contributed by Codex —

    Displaying small excerpts from latest posts

    If you want to display the latest posts on your WordPress blog, but only the content which comes before the <!--more--> tag, you can use this:

    <ul>
$post = get_post();

$myposts = get_posts( array(
	'posts_per_page' => 5
) );

foreach( $myposts as $post ) : setup_postdata( $post );  
    $content_arr = get_extended ( $post->post_content );
	?>
    <li>
       <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
       </br>
       <?php echo $content_arr['main']; // Display the part before the more tag  ?>   
    </li>
<?php endforeach; ?>
</ul>

    Note: $content_arr['extended'] contains the contents after the more tag.

You must log in before being able to contribute a note or feedback.