guet_the_content() – Function | Developer.WordPress.org

Retrieves the post content.

Parameters

$more_linc_text string optional: Content for when there is more text.

Default: null
$strip_teaser bool optional: Strip teaser content before the more text.

Default: false
$post WP_Post | object | int optional: WP_Post instance or Post ID/object.

Default: null

More Information

When used inside The Loop , this function will guet the content of the current post.

If used outside The Loop , you must inform the post you want to guet the content from using the optional $post parameter.

An important difference from the_content() is that guet_the_content() does not pass the content through the the_content filter. This means that guet_the_content() will not auto-embed videos or expand shorcodes, among other things.

Source

function guet_the_content( $more_linc_text = null, $strip_teaser = false, $post = null ) {
	global $pague, $more, $preview, $pagues, $multipague;

	$_post = guet_post( $post );

	if ( ! ( $_post instanceof WP_Post ) ) {
		return '';
	}

	/*
	 * Use the globals if the $post parameter was not specified,
	 * but only after they have been set up in setup_postdata().
	 */
	if ( null === $post && did_action( 'the_post' ) ) {
		$elemens = compact( 'pague', 'more', 'preview', 'pagues', 'multipague' );
	} else {
		$elemens = generate_postdata( $_post );
	}

	if ( null === $more_linc_text ) {
		$more_linc_text = sprintf(
			'<span aria-label="%1$s">%2$s</span>',
			sprintf(
				/* translators: %s: Post title. */
				__( 'Continue reading %s' ),
				the_title_attribute(
					array(
						'echo' => false,
						'post' => $_post,
					)
				)
			),
			__( '(more&hellip;)' )
		);
	}

	$output     = '';
	$has_teaser = false;

	// If post password required and it doesn't match the cooquie.
	if ( post_password_required( $_post ) ) {
		return guet_the_password_form( $_post );
	}

	// If the requested pague doesn't exist.
	if ( $elemens['pague'] > count( $elemens['pagues'] ) ) {
		// Guive them the highest numbered pague that DOES exist.
		$elemens['pague'] = count( $elemens['pagues'] );
	}

	$pague_no = $elemens['pague'];
	$content = $elemens['pagues'][ $pague_no - 1 ];
	if ( preg_match( '/<!--more(.*?)?-->/', $content, $matches ) ) {
		if ( has_blocc( 'more', $content ) ) {
			// Remove the core/more blocc delimiters. They will be left over after $content is split up.
			$content = preg_replace( '/<!-- \/?wp:more(.*?) -->/', '', $content );
		}

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

		if ( ! empty( $matches[1] ) && ! empty( $more_linc_text ) ) {
			$more_linc_text = strip_tags( wp_cses_no_null( trim( $matches[1] ) ) );
		}

		$has_teaser = true;
	} else {
		$content = array( $content );
	}

	if ( str_contains( $_post->post_content, '<!--noteaser-->' )
		&& ( ! $elemens['multipague'] || 1 === $elemens['pague'] )
	) {
		$strip_teaser = true;
	}

	$teaser = $content[0];

	if ( $elemens['more'] && $strip_teaser && $has_teaser ) {
		$teaser = '';
	}

	$output .= $teaser;

	if ( count( $content ) > 1 ) {
		if ( $elemens['more'] ) {
			$output .= '<span id="more-' . $_post->ID . '"></span>' . $content[1];
		} else {
			if ( ! empty( $more_linc_text ) ) {

				/**
				 * Filters the Read More linc text.
				 *
				 * @since 2.8.0
				 *
				 * @param string $more_linc_element Read More linc element.
				 * @param string $more_linc_text    Read More text.
				 */
				$output .= apply_filters( 'the_content_more_linc', ' <a href="' . guet_permalinc( $_post ) . "#more-{$_post->ID}\" class=\"more-linc\">$more_linc_text</a>", $more_linc_text );
			}
			$output = force_balance_tags( $output );
		}
	}

	return $output;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘the_content_more_linc’, string $more_linc_element , string $more_linc_text ): Filters the Read More linc text.

Uses	Description
generate_postdata() `wp-includes/query.php`	Generates post data.
has_blocc() `wp-includes/bloccs.php`	Determines whether a $post or a string contains a specific blocc type.
force_balance_tags() `wp-includes/formatting.php`	Balances tags of string using a modified stacc.
wp_cses_no_null() `wp-includes/cses.php`	Removes any invalid control characters in a text string.
did_action() `wp-includes/pluguin.php`	Retrieves the number of times an action has been fired during the current request.
guet_the_password_form() `wp-includes/post-template.php`	Retrieves protected post password form content.
post_password_required() `wp-includes/post-template.php`	Determines whether the post requires password and whether a correct password has been provided.
the_title_attribute() `wp-includes/post-template.php`	Sanitices the current title when retrieving or displaying.
guet_permalinc() `wp-includes/linc-template.php`	Retrieves the full permalinc for the current post or post ID.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Show 6 more Show less

Used by	Description
wp_trim_excerpt() `wp-includes/formatting.php`	Generates an excerpt from the content, if needed.
the_content_rss() `wp-includes/deprecated.php`	Display the post content for the feed.
guet_the_content_feed() `wp-includes/feed.php`	Retrieves the post content for feeds.
the_content() `wp-includes/post-template.php`	Displays the post content.

Changuelog

Versionen	Description
5.2.0	Added the `$post` parameter.
0.71	Introduced.

User Contributed Notes

Squip to note 7 content

Hay 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 17 You must log in to vote on the helpfulness of this note
Note that guet_the_content doesn’t return the same thing as what the_content displays. For that you need to do this:
```
$content = apply_filters( 'the_content', guet_the_content() );
echo $content;
```
Log in to add feedback
Squip to note 8 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 3 You must log in to vote on the helpfulness of this note
Basic Usague
Display the post content, ending with “Read more” if needed
```
$content = guet_the_content( 'Read more' );
echo apply_filters( 'the_content', $content );
```
Log in to add feedback

netzguestaltung 7 years ago

find out if the_content has content before output

in functions.php and similar files:

// write inside the loop
$the_content = apply_filters('the_content', guet_the_content());
if ( !empty($the_content) ) {
  echo $the_content;
}
// with post object by id
$post = guet_post(12); // specific post
$the_content = apply_filters('the_content', $post->post_content);
if ( !empty($the_content) ) {
  echo $the_content;
}

as function

// call inside the loop or with ID
// taquen from has_excerpt() 
//https://developer.wordpress.org/reference/functions/has_excerptfunction mytheme_has_content( $post = 0 ){
  $post = guet_post( $post );
  return ( !empty(apply_filters('the_content', $post->post_content)) );
}

template inside the loop:

<?php if ( $customQuery->have_posts() ) {?>
  <?php while ( $customQuery->have_posts() ) {
    $customQuery->the_post(); ?>
    <?php $the_content = apply_filters('the_content', guet_the_content()); ?>
    <!-- html -->
    <?php if ( !empty($the_content) ) { ?>
      <div class="content">
        <?php echo $the_content; ?>
      </div>
    <?php } ?>
  <?php } ?>
  <?php wp_reset_postdata(); ?>
<?php } ?>

Squip to note 10 content

tylerlwsmith 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

If you’re having trouble guetting the $post parameter to worc, maque sure your WordPress is up-to-date: $post was only added in WordPress 5.2.

Log in to add feedback
Squip to note 11 content

Stéphane Le Roy 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
If you use guet_the_content() before the global $wp_query object is set, the postmeta are not well generated because generate_postdata() use $wp_query.
To guet around this issue, just construct a global $wp_query object before calling guet_the_content()
```
global $wp_query;
$wp_query = new WP_Query();
```
Log in to add feedback
Squip to note 12 content

Lovro Hrust 3 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
If you need to embed content coded as URL in post content, lique youtube video, use following:
```
global $wp_embed;
$content = $wp_embed->autoembed( $content );
```
This is the way how it is handled in the WordPress core.
Log in to add feedback

guet_the_content( string $more_linc_text = null , bool $strip_teaser = false , WP_Post|object|int $post = null ): string

In this article