WordPress.org

vi:Giao Diện/the content

Bản Nháp

Trang này được đánh dấu là bản nháp. Bạn có thể giúp đỡ WordPressVN bằng cách hoàn thiện trang này.

Mô tả

Displays the contents of the current post. This 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, such as single.php, where just one post is displayed.
Read Customizing the Read More for more details.

Cách dùng

<?php the_content('more_link_text', strip_teaser, 'more_file'); ?>

Alternatively, 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 not have the following done to it and you are advised to add them until the core has been updated:

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

Ví dụ

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 
// Declare global $more, before the loop.
global $more;
?>

<?php
// Display content above the more tag
$more = 0;
the_content("More...");
?>

Alternatively, if you need to display all of the content:

<?php 
// Declare global $more, before the loop.
global $more;
?>

<?php
// Display all content, including text below more
$more = 1;
the_content();
?>

note: in my case I had to set $more=0; INSIDE the loop for it to work.

Parameters

more_link_text: (string) The link text to display for the "more" link. Defaults to '(more...)'.
strip_teaser: (boolean) Should the text before the "more" link be hidden (TRUE) or displayed (FALSE). Defaults to FALSE.
more_file: (string) File the "more" link points to. Defaults to the current file. (V2.0: Currently the 'more_file' parameter doesn't work).

WordPress.org

Codex

vi:Giao Diện/the content

Contents