WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_extended()

get_extended( string $post ): string[]

In this article

Back to top

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

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.

Parameters

$poststringrequired
Post content.

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.

Source

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 all references View on Trac View on GitHub

Used byDescription
wp_xmlrpc_server::mw_getPost()wp-includes/class-wp-xmlrpc-server.php

Retrieves a post.

wp_xmlrpc_server::mw_getRecentPosts()wp-includes/class-wp-xmlrpc-server.php

Retrieves list of recent posts.

wp_xmlrpc_server::_prepare_page()wp-includes/class-wp-xmlrpc-server.php

Prepares page data for return in an XML-RPC object.

Changelog

VersionDescription
1.0.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    Codex
    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

    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.