返回到支持 内容和媒体 页面和文章 显示文章简码

显示文章简码

您可以使用显示文章简码向不同的页面添加博文列表。您可以使用参数按照分类或标签显示特定文章。

简码是专为 WordPress 设计的小段代码,您可以使用这些代码为您的站点或博客添加各种功能。您可以在此处查看有关简码的更多信息。

📌

如果您在升级至支持插件的付费套餐之前添加简码,则在您安装显示文章简码插件后,代码将会呈现相应内容。各种插件提供类似的功能。

另外,您也可以考虑博文最新文章区块。


显示文章简码概览

以下是您可能想要使用显示文章简码的几个原因。


添加简码

以下说明适用于编辑页面文章文本小工具。添加以下代码后,您只会在编辑器中看到代码占位符。但是当您发布页面后,您会看到简码结果。

  1. 编辑页面、文章或文本小工具。
  2. 在文章或页面中添加简码 [display-posts]
  3. 发布或更新您的页面/文章。

如果您使用的是 WordPress 区块编辑器,还可以通过添加简码区块来添加显示文章简码。

新文章和现有文章的更新最多可能需要一个小时才能在您使用此简码的所有位置显示。

显示文章简码实际显示方式
这是显示文章简码在使用 Twenty Seventeen 主题的实际页面中的显示方式。

默认情况下,显示文章简码将显示 10 篇最新文章的项目符号列表。您可以定制文章数量及风格,也可以定制列表中显示的文章要素(标题、精选图片、摘要等等)。


显示参数

参数用来定制文章的显示方式。以下是您可以添加到显示文章简码的常用参数列表,以及添加参数后简码显示方式示例。

author
指定文章作者
默认:空
示例:[display-posts author="bill"]

category
指定分类数据域(或以逗号分隔的分类数据域列表)。在此示例站点上查看实际使用的简码。
默认:空
示例:[display-posts category="fishing,hiking"]

date_format
include_date 为 true 时,指定使用的日期格式。有关详细信息,请参阅 Codex 上的设置日期和时间格式
默认:'(n/j/Y)’
示例:[display-posts include_date="true" date_format="F j, Y"]

id
指定要显示的特定文章 ID(或多个文章 ID)。
默认:空
示例:[display-posts id="9, 10"]

image_size
如果文章有图片,请指定显示特色图片时使用的图片尺寸。image_size 可以设置为 thumbnail、medium、large(均在“设置”>“媒体”下设置)。
默认:空
示例:[display-posts image_size="thumbnail"]

如果您使用的主题支持内容选项,且您已将其设置为不在页面上显示推荐图片,则 image_size 参数也不会对站点页面上使用的简码产生影响,推荐图片不会在通过简码添加的文章中显示,即使简码指示需显示也是如此。

include_content
在标题后包括完整的文章内容。
默认:空
示例:[display-posts include_content="true"]

include_date
在文章标题后包含文章的日期。默认格式为 (7/30/12),但您可以使用“date_format”参数进行定制设置。
默认:空
示例:[display-posts include_date="true"]

include_excerpt
在标题后包含文章的摘要(以及日期,如果提供)。
默认:空
示例:[display-posts include_excerpt="true"]

offset
跳过的文章数
默认:0
示例:[display-posts offset="3"]

order
指定文章是按降序 (DESC) 还是升序 (ASC) 排列。
默认:DESC
示例:[display-posts order="ASC"]

orderby
指定文章的排序方式。点击此处查看可用参数。
默认:日期
示例:[display-posts orderby="title"]

portfolio_type
如果您使用的是“文件夹”文章类型,请使用此简码从特定的文件夹类型中获取文章。

post_parent
显示特定页面的子页面。您可以指定 ID 或“current”,显示当前页面的子页面。
默认:空
示例:[display-posts post_type="page" post_parent="8"]

post_status
显示与特定文章状态相关联的文章
默认:发布
示例:[display-posts post_status="publish, future"]

post_type
指定要使用的文章类型。您可以使用默认类型(文章或页面)。如果是文件夹,请使用“jetpack-portfolio”。同样,如果是褒奖页面,请使用“jetpack-testimonial”。
默认:文章
示例:[display-posts post_type="page"]

posts_per_page
要显示的文章数。
默认:10
示例:[display-posts posts_per_page="5"]

tag
指定标签别名(或标签别名的逗号分隔列表)
默认:空
示例:[display-posts tag="tag1, tag2"]

taxonomy、tax_term 和 tax_operator
使用这些参数进行高级分类查询。针对您要查询的分类使用“taxonomy”,针对要包括的术语数据域(或术语)使用“tax_term”,并使用“operator”更改查询使用这些术语的方式(最大的可能是不需要此字段)。
默认:’taxonomy’ = empty , ‘tax_term’ = empty , ‘tax_operator’ = ‘IN’
示例:[display-posts taxonomy="color" tax_term="blue, green"]

wrapper
应使用哪种类型的 HTML 显示列表。可以是无序列表 (ul)、有序列表 (ol) 或分区 (div),您可以设计自己的风格。
默认:ul
示例:[display-posts wrapper="ol"]


定制示例

以下是结合多个参数来显示特定文章列表的一些简码示例。

[display-posts tag="advanced" posts_per_page="20"]

使用此简码将列出 20 篇标记有“advanced”标签的最新文章。

[display-posts tag="advanced" image_size="thumbnail"]

使用此简码将列出 10 篇标记有“Advanced”标签的最新文章,并使用“Thumbnail”尺寸显示文章图像。

[display-posts category="must-read" posts_per_page="-1" include_date="true" order="ASC" orderby="title"]

使用此简码将按字母顺序列出“Must Read”分类中的每篇文章,且文章尾结尾处显示日期。

[display-posts wrapper="ol"]

使用此简码会将文章显示为有序列表。无序列表(默认值)的选项为 ul,有序列表为 ol,分区为 div。

[display-posts id="14,3"]

使用此简码将仅显示 ID 为 14 和 3 的文章。


图片对齐

常见的请求是显示包含标题和摘要的文章列表,缩略图向右对齐。以下是您可能会使用的简码:

[display-posts include_excerpt="true" image_size="thumbnail" wrapper="div"]

该简码中包括摘要,添加的图片大小为“thumbnail”(您可以在“设置”>“媒体”中定制图片大小),并将它设置为显示不带项目符号的列表。

要使图片浮动在右侧,您可以将其添加到您的自定义 CSS 文件(需要购买 WordPress.com 高级版WordPress.com 商务版升级):

.display-posts-listing .alignleft {
    float: right;
    margin: 0 0 5px 5px;
}


(高级)多个分类查询

虽然大多数人只需要单个分类查询,但此简码支持无限数量的分类查询。假设您希望获取“featured”分类且同时标记为“homepage”的所有文章,我们将使用如下所示的简码:

[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="homepage"]

如果您希望获取“featured”类别且同时标记为“blue”或“green”的所有文章,您可以使用如下所示的简码:

[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="blue, green" tax_2_operator="OR" tax_relation="AND"]

您可以后缀任意多个分类字符串,最少为 2 个。在下面的字段列表中,用实际数字替换 (count)。

此处为可用字段:

taxonomy_(count)
要查询的分类
默认:空

tax_(count)_term
包含的术语(如果不止一条,请以逗号分隔)
默认:空

tax_(count)_operator
查询术语的方法(IN、NOT IN 或 AND)
默认:IN

tax_relation
描述多个分类查询之间的关系(结果应与所有查询还是其中一个相匹配)。可用选项:AND 和 OR
默认:AND


限制

显示文章简码最多可显示100 篇文章。


如何查找文章 ID

您可以在文章编辑器的“编辑文章 URL”中找到文章 ID。例如,以下示例的文章 ID 为“125”。

文章 ID
Copied to clipboard!