WordPress.org

Function Reference/the content

Languages: English • 日本語 • (Add your language)

Description

Displays the contents of the current post. This template tag must be within The_Loop.

If the quicktag  is used in a post to designate the "cut-off" point for the post to be excerpted, the_content() tag will only show the excerpt up to the  quicktag point on non-single/non-permalink post pages. By design, the_content() tag includes a parameter for formatting the  content and look, which creates a link to "continue reading" the full post.

Note about  :

No whitespaces are allowed before the "more" in the  quicktag. In other words  will not work!
The  quicktag will not operate and is ignored in Templates where just one post is displayed, such as single.php.
Read Customizing the Read More for more details.

Usage

<?php the_content( $more_link_text, $stripteaser ); ?>

How to pass parameters to tags with PHP function-style parameters

Parameters

$more_link_text

(string) (optional) The link text to display for the "more" link.

Default: '(more...)'

$stripteaser

(boolean) (optional) Strip teaser content before the more text.

Default: false

Examples

Designating the "More" Text

Displays the content of the post and uses "Read more..." for the more link text when the  Quicktag is used.

<?php the_content('Read more...'); ?>

Include Title in "More"

Similar to the above example, but thanks to the_title() tag and the display parameter, it can show "Continue reading ACTUAL POST TITLE" when the  Quicktag is used.

<?php the_content("Continue reading " . the_title('', '', false)); ?>

Overriding Archive/Single Page Behavior

If the_content() isn't working as you desire (displaying the entire story when you only want the content above the  Quicktag, for example) you can override the behavior with global $more.

<?php 
global $more;    // Declare global $more (before the loop).
$more = 0;       // Set (inside the loop) to display content above the more tag.
the_content("More...");
?>

if you need to display all of the content:

<?php 
global $more;    // Declare global $more (before the loop).
$more = 1;       // Set (inside the loop) to display all content, including text below more.
the_content();
?>

Ignore the "More" on a Sticky Post

This will ignore the more tag in a sticky post--meaning it will display the full content even if there is a  in the content, but for all other posts it will display a more link.

<?php
if (is_sticky()) {
  global $more;    // Declare global $more (before the loop).
  $more = 1;       // Set (inside the loop) to display all content, including text below more.
  the_content();
} else {
  global $more;
  $more = 0;
  the_content('Read the rest of this entry »');
}
?>

Alternative Usage

You may use get_the_content() to return the content value instead of outputting it directly. Example:

<?php $content = get_the_content(); ?>

Please note! get_the_content will return the unfiltered content. If you want to achieve the same output that the_content() returns, use the following code:

<?php
$content = apply_filters('the_content', $content);
$content = str_replace(']]>', ']]&gt;', $content);
?>

Changelog

Since: 0.71

Source File

the_content() is located in wp-includes/post-template.php.

body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title, sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages()

See also index of Function Reference and index of Template Tags.