在做企业主题开发的时候,一般都会有几种文章类型,对于WordPress而言,设置摘要长度比较规范的用法是通过钩子 excerpt_length 去实现。
he_exceprt 和 the_content 之间的差异
大多数 WordPress 主题使用 The Loop 内部的the_content()
来显示预览内容,然后使用Read More样式链接到本文的其余部分。使用the_content 时 ,将输出<--more-->
标记之前出现的文章中的所有内容,然后输出指向文章其余部分的链接。如果没有更多标签,则输出整篇文章。
当负责输出文章 WordPress 模板使用the_excerpt
时 ,流程略有不同。 此标记 - the_excerpt
- 必须在 The Loop 中使用。
如果文章或自定义文章类型有手动摘要 ,那么将输出, 然后在方括号内输出省略号 。
如果文章没有手动摘要,则文章前 55 个单词将用作摘要内容。 这个默认长度为 55 个单词是我们想要改变的,有几种方法可以做到这一点。
设置摘要长度
比如常用代码范例如下:
/** * 通过钩子设置摘要长度为 30 * * @param int $length Excerpt length. * @return int (Maybe) modified excerpt length. */ function jszbug_excerpt_length( $length ) { return 30; } add_filter( 'excerpt_length', 'jszbug_excerpt_length');
设置摘要的更多字符
通常,我们还需要借助 excerpt_more 钩子去自定义摘要后面的字符,默认为 […]
,如果要改为 …
,可以使用下面的代码范例:
/** * 钩子设置摘要后的更多字符 */ function jszbug_excerpt_more( $more ) { return '...'; } add_filter( 'excerpt_more', 'jszbug_excerpt_more' );
另一种获取自定义摘录长度的方法是使用 WordPress Codex 上提供的自定义摘要长度功能 。 此代码段直接进入您的functions.php
文件。
如果您在文章或自定义文章类型上启用了手动摘要,并且通过模板中的the_excerpt()
调用这些the_excerpt()
, 那些将覆盖此功能并显示您在其中输入的内容。
下面的这种情况下,我们将显示文章内容的前十个单词。除非您在主题中添加了自定义“阅读更多”链接功能 ,否则将会显示[...]
。
/** * 通过钩子设置摘要长度为 10 * * @param int $length Excerpt length. * @return int (Maybe) modified excerpt length. */ function jszbug_excerpt_length( $length ) { return 10; } add_filter( 'excerpt_length', 'jszbug_excerpt_length');
不同文章类型设置不同摘要长度
言归正传,要为不同的文章类型设置不同的摘要长度,可以通过判断文章类型来分别定义,代码范例如下:
/** * 不同文章类型设置不同摘要长度 */ function jszbug_variable_excerpt_length( $length ) { // 使用全局变量 $post 检测当前文章所属的文章类型 global $post; // 针对不同的文章类型设置不同长度 if ( 'post' === $post->post_type ) { return 32; } else if ( 'page' === $post->post_type ) { return 65; } else if ( 'products' === $post->post_type ) { return 75; } else { return 80; } } add_filter( 'excerpt_length', 'jszbug_variable_excerpt_length');
以上就是WordPress 不同文章类型设置不同摘要长度的全部内容!