WordPress里的the_content()函数分析

模板标签 the_content() 显示当前文章的内容。该标签必须在 WordPress 主循环（loop）中。若文章使用快速标签 <!--more--> 来截取摘要，the_content()标签将只在非单篇文章或非固定链接文章上显示 <!--more-->前的摘要部分。the_content()标签可包含一个规定 <!--more-->内容和样式的参数，该参数会生成“继续阅读全文”的链接。

关于 <!--more--> 标签有以下三条规定：

<!--more-->快速标签中的more前不得有空格。否则 <!--more-->将无法发挥作用。

<!--more-->快速标签无法在模板中运行（会被模板忽略），如single.php只会显示一篇文章。

改变“Read More”的样式

我们在博客首页显示日志摘要时，总希望读者能够点击日志标题或某个链接，继续阅读日志全文。WordPress就为我们提供了自定义“Read More（阅读全文）”链接样式的机会。

WordPress通过两种方法显示日志摘要。第一种，用模板标签 the_excerpt()代替 the_content()，之后我们在管理页面中“添加新文章”下的“摘要”中输入的内容就会出现在博客首页上。如果没有在“摘要”中输入内容，日志的前55个单词会作为摘要被显示在首页上。当访问者阅读摘要后，希望了解更多相关信息时，可以点击日志标题阅读全文。

而在WordPress中，显示日志的最常用方法是：保留the_content()模板标签，在日志中选择一个适当的位置（预设一个摘要截取位置），插入一个名为more的快速标签（quicktag）。

控制板“添加新文章”中编辑窗口上方的小图标被称为快速标签。这些图标包括加粗、斜体、添加链接等，以及大名鼎鼎的“插入more标签”。把光标放在日志中希望结束摘要的位置上，点击“（插入more标签）”。在日志被截断的地方会插入类似下面的代码：

and I told him that he should get moving or I'd be
on him like a limpet.  He looked at me with shock on
his face and said
<!--more-->

代码后是日志的剩余部分，但如果在存档、类别、首页以及搜索结果等非单页型/非永久链接型页面上，日志会只显示“more”标签前的内容，作为摘要。

模板标签the_content()的参数如下：

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

$more_link_text将链接文本设置为类似“Read More”的内容。第二个参数$strip_teaser决定是（TRUE）否（FALSE）隐藏“more”链接，该参数的默认值为FALSE——不隐藏more链接。最后一个参数$more_file将链接连接到我们所希望的“Read More”被链接到的内容中。默认情况下，$more_file链接到当前日志文件。

如果不希望显示摘要，那么可以将index.php中的the_content();更改为（例如让第二个参数控制属性值）：

the_content('',FALSE,'');

或者在在 <!--more-->后的日志正文中立即包含<!--noteaser-->。

默认情况下，访问者点击“Read More”链接时，网页会加载日志内容并将访问者带领到日志中<--more-->标签的位置上。如果我们不希望将访问者导向到这个位置，可以在主题的functions.php文件中加入以下代码：

function remove_more_jump_link($link)
{
$offset = strpos($link, '#more-');
if ($offset)
{
$end = strpos($link, '"',$offset);
}
if ($end)
{
$link = substr_replace($link, '', $offset, $end-$offset);
}
return $link;
}
add_filter('the_content_more_link', 'remove_more_jump_link');

在WP 2.7.1以及之前的版本中，可以在wp-includes/post-template.php中编辑以下代码行，以此改变控制more指向内容的默认函数（注意：在WP 2.1之前，以下代码出现在 wp-includes/template-functions-post.php中）。

注意：升级WordPress时，该文件会被复原，因此我们需要保存所做修改，升级完毕后再重新修改文件。

我们需要将：

$output .= ' <a href="'. get_permalink() ."#more-$id">$more_link_text</a>";

改为

$output .= ' <a href="'. get_permalink() ."">$more_link_text</a>";

或

$output .= ' $more_link_text';

具体实现函数如下：

/**
* Retrieve the post content.
*
* @since 0.71
*
* @param string $more_link_text Optional. Content for when there is more text.
* @param string $stripteaser Optional. Teaser content before the more text.
* @return string
*/
function get_the_content($more_link_text = null, $stripteaser = 0) {
global $id, $post, $more, $page, $pages, $multipage, $preview, $pagenow;
if ( null === $more_link_text )
$more_link_text = __( '(more...)' );
$output = '';
$hasTeaser = false;
// If post password required and it doesn't match the cookie.
if ( post_password_required($post) ) {
$output = get_the_password_form();
return $output;
}
if ( $page > count($pages) ) // if the requested page doesn't exist
$page = count($pages); // give them the highest numbered page that DOES exist
$content = $pages[$page-1];
if ( preg_match('/<!--more(.*?)?-->/', $content, $matches) ) {
$content = explode($matches[0], $content, 2);
if ( !empty($matches[1]) && !empty($more_link_text) )
$more_link_text = strip_tags(wp_kses_no_null(trim($matches[1])));
$hasTeaser = true;
} else {
$content = array($content);
}
if ( (false !== strpos($post->post_content, '<!--noteaser-->') && ((!$multipage) || ($page==1))) )
$stripteaser = 1;
$teaser = $content[0];
if ( ($more) && ($stripteaser) && ($hasTeaser) )
$teaser = '';
$output .= $teaser;
if ( count($content) > 1 ) {
if ( $more ) {
$output .= '<span id="more-' . $id . '"></span>' . $content[1];
} else {
if ( ! empty($more_link_text) )
$output .= apply_filters( 'the_content_more_link', ' <a href="' . get_permalink() . "#more-$id" class="more-link" target="_blank">$more_link_text</a>", $more_link_text );
$output = force_balance_tags($output);
}
}
if ( $preview ) // preview fix for javascript bug with foreign languages
$output =	preg_replace_callback('/%u([0-9A-F]{4})/', create_function('$match', 'return "" . base_convert($match[1], 16, 10) . ";";'), $output);
return $output;
}

如果想点击 more 时弹出新页面，可以修改以上函数，加入 target="_blank" 即可。

了解“Read More”的运行原理后，我们可以尝试把“Read More”内容变得更有趣些，激发访问者的阅读兴趣。

经过设计， the_content()标签包含了一个可以设计<!--more--> 内容和样式的参数，而<!--more--> 标签生成“continue reading（继续阅读全文）”的链接。

默认情况下，一个带有“more”的摘要可以是下面这样：

and I told him that he should get moving or I'd be on him
like a limpet. He looked at me with shock on his face and
said more...

如果希望将more换成其它单词，只要在标签中输入新单词就可以了：

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

也可以将more换成幽默的句子：

<?php the_content('...on the edge of your seat? Click
here to solve the mystery.'); ?>

还可以在标签中设计文本样式：

<?php the_content('<span class="moretext">...on the edge of
your seat? Click here to solve the mystery.</span>'); ?>

之后在style.css样式表单中，将moretext设为自己想要显示的内容。下面的摘要示例使用了加粗字体与斜体，比默认文本字号稍小，示例用font-variant: small-caps强制摘要内容显示为小写字母：

and I told him that he should get moving or I'd be on him
like a limpet. He looked at me with shock on his face and
said ...On the Edge of Your Seat? Click Here to Solve the
Mystery.

有些用户不希望在摘要中显示“Read More”等文本，他们希望用扩展字符或HTML字符实体将读者导向到日志全文。

<?php the_content('» » » »'); ?>

模板标签the_content() 中还有一个参数可以在more的位置上显示日志标题。用the_title()标签包含日志标题：

<?php the_content("...continue reading the story
called " . get_the_title('', '', false)); ?>

根据上文的描述，我们通常从模板中调用带有标准文本的 the_content()。但我们可以为一些日志设置其它的“more”显示方式。在可视化编辑器中，输入<!--more Your custom text -->。

CSS为我们提供了无限的设计可能，WordPress也允许我们在很多模板标签中使用图片，包括more标签。有两种方法可以在more标签中插入图片。简单的方法是——在 模板标签the_content() 中展示图片。

<?php the_content('Read more...<img src="/images/leaf.gif"
alt="read more" title="Read more..." />'); ?>

注意：上述代码在图片标签中使用了ALT和TITLE属性。这是为了符合网络标准以及保证图片的可访问性，因为图片不仅是图片，同时也是一个链接。

我们甚至可以根据上一个章节中的描述进一步改造图片和more标签。如果只想使用图片二不想显示“Read More”，可以删除“Read More”字样。

第二个示例使用的是CSS背景图片。我们在之前的例子中以及论述过怎样使用样式类。这个例子稍微复杂一些。容器的样式必须设为允许背景图片显示在文本后。如果我们用上一个示例做背景图，其style.css样式表单应该显示为：

.moretext {
width: 100px;
height: 45px;
background:url(/images/leaf.gif) no-repeat right middle;
padding: 10px 50px 15px 5px}
}

页面右边50像素的内边距能够保证文本与图片间的距离，保证两者不相覆盖。而高度则保证容器有足够的宽度容纳图片，因为背景图并不是“实际存在”的，也不可能与容器的边框相抵。我们需要将图片的大小和形状都考虑进去，用最适当的方式显示图片。

掌握这其中的基本原理后，我们就可以随心所欲地开始设计了。

切记，网站首页 ( is_home() == TRUE )是不显示 <!--more-->标签的，除非我们用以下代码来激活显示：

<?php
global $more;
$more = 0;
?>

总结，模板标签-the_content()用法如下：

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

$more_link_text：
（字符串）（可选）“more”链接的链接文本，
默认值： '(more...)'

$strip_teaser：（布尔型）（可选）显示（FALSE）或隐藏（TRUE）more链接前的文本。默认值：FALSE

$more_file：
（字符串）（可选）more链接所指向的文件
默认值：当前文件

使用以下方式在“More”中加入标题，在the_title()标签和display参数的帮助下，若文章使用 ，该示例可以显示"Continue reading ACTUAL POST TITLE"（继续阅读当前文章标题）。

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

如果the_content()不能按计划运行（如当你希望显示<!--more--> 标签前的内容，the_content()却显示了全文内容），你可以用全局变量$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...");
?>

如果需要显示所有正文：

<?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();
?>

你可以用get_the_content函数返回文章内容的值，而非直接输出文章内容。示例如下：

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

请注意！get_the_content 无法进行以下操作，因此你最好手动添加以下代码，直到核心程序升级成功：

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

the_content()位于wp-includes/post-template.php