Decent Comments 插件教程：展示 WordPress 最新评论

数臻源码
2026-08-05
4:47 下午
分类：插件教程
标签： Decent Comments

Decent Comments 是一款用来展示 WordPress 最新评论的免费插件。它可以把评论者头像、评论摘要、发布时间和对应文章链接组合成更清晰的评论列表，适合放在博客侧边栏、首页、文章底部或 Elementor 页面中。

这篇 Decent Comments 插件教程将从安装、区块和小工具设置讲起，并提供短代码、Elementor 用法、中文摘要设置和 CSS 美化示例。即使不懂代码，也可以先用区块或小工具快速完成配置。

一、Decent Comments 插件教程：先了解它是什么

WordPress 自带“近期评论”小工具，但默认展示内容比较简单。Decent Comments 的定位不是替换 WordPress 评论系统，而是把已经通过审核的评论以更友好的方式展示出来。

显示评论者头像、名称和评论日期
显示完整评论或指定长度的评论摘要
限制评论数量并按时间等字段排序
只显示某篇文章、某个文章类型或某个分类下的评论
支持 Gutenberg 区块、小工具、短代码和 PHP API
可以在同一网站放置多个不同配置的评论列表

截至 2026 年 8 月，WordPress.org 提供的稳定版为 3.0.2，要求 WordPress 6.5 或更高版本、PHP 7.4 或更高版本。3.0 版本新增了 Decent Comments 区块和 REST API，并调整了前端结构与样式。

二、哪些网站适合使用 Decent Comments？

如果网站有真实评论，并且希望访客快速看到最近的讨论，这款 WordPress 评论展示插件会比较实用。例如：

教程博客：在侧边栏展示读者最新提问
产品网站：展示用户对产品或服务的反馈
会员社区：让新讨论获得更多曝光
多内容类型网站：分别展示文章、案例或自定义文章类型的评论

如果网站完全关闭评论，或者目前只有垃圾评论，安装它不会带来明显价值。建议先做好评论审核和反垃圾设置，再考虑把评论展示到显眼位置。

三、安装并启用 Decent Comments

进入 WordPress 后台，依次打开：插件 → 安装新插件，搜索 Decent Comments，确认作者为 itthinx，然后点击“立即安装”和“启用”。

插件启用后通常不需要先进入一个全局设置页面。你可以直接在区块编辑器中添加 Decent Comments 区块，或者到“外观 → 小工具”中添加对应小工具。使用 Elementor 时，则可以通过 Shortcode 小工具插入短代码。

四、Decent Comments 的四种使用方式

Decent Comments 区块、小工具、短代码和 API 使用方式 — Decent Comments 支持区块、小工具、短代码和 PHP API 四种放置方式。

对于大多数用户，推荐顺序是：

Gutenberg 页面或文章优先使用“区块”
传统侧边栏和页脚使用“小工具”
Elementor、模板或特殊位置使用“短代码”
主题开发和自定义插件再考虑 PHP API

五、使用 Gutenberg 区块展示最新评论

编辑一篇文章或页面，点击区块添加按钮，搜索 Decent Comments。插入区块后，可以在右侧面板调整评论数量、排序、文章类型、作者、日期、头像、摘要长度和文章链接等选项。

新手可以先使用下面这组配置：

Number：5
Order：Descending
Order by：Date
Show author：开启
Show avatar：开启，尺寸 40–48px
Show date：开启
Show excerpt：开启
Show link to post：开启

六、使用小工具放到侧边栏或页脚

如果主题仍然提供小工具区域，进入“外观 → 小工具”，找到 Decent Comments 并添加到侧边栏或页脚。每个小工具都可以保存独立设置，因此你可以在侧边栏显示全站最新评论，在另一个区域只显示指定分类的评论。

Decent Comments 小工具设置选项 — itthinx 官方文档中的小工具设置示例。新版后台外观可能不同，但主要字段含义基本一致。

中文网站特别要注意 Number of characters in excerpts。中文不像英文那样使用空格分词，单纯限制单词数量可能得不到理想长度。官方文档也明确说明，字符数限制更适合中文等不依赖空格分词的语言。

七、Decent Comments 短代码示例

插件同时注册了 decent_comments 和 decent-comments 两种短代码名称。下面的代码适合显示 5 条最新评论，包含头像、作者、日期和最多 80 个字符的摘要：

[decent_comments number="5" show_avatar="true" avatar_size="48" show_author="true" show_date="true" excerpt="true" max_excerpt_characters="80" show_link="true" /]

只显示当前文章的评论

[decent_comments post_id="{current}" number="5" max_excerpt_characters="100" /]

只显示“插件教程”分类下的评论

[decent_comments taxonomy="category" terms="plugin-tutorial" number="6" /]

只显示自定义文章类型的评论

[decent_comments post_type="effect-display" number="6" show_date="true" /]

如果你经常调整普通文章和自定义文章类型，可以同时参考本站的 Post Type Switcher 插件使用教程。切换文章类型后，也要记得检查这里填写的 post_type 是否仍然正确。

八、如何在 Elementor 中使用？

Decent Comments 目前没有专门的 Elementor 小工具，但可以直接使用 Elementor 自带的 Shortcode 小工具：

使用 Elementor 打开目标页面或模板
拖入 Shortcode 小工具
粘贴上一节中的 Decent Comments 短代码
更新页面并在前台检查显示结果

如果要放在全站文章侧边栏，建议直接编辑 Elementor Theme Builder 的单篇文章模板，不必逐篇添加。正式修改模板前先备份，并分别检查桌面端与手机端。

九、适合中文网站的推荐配置

设置项	建议值	说明
评论数量	5–8 条	避免侧边栏过长
排序	日期倒序	优先显示最新讨论
摘要字符数	60–100	比单词数更适合中文
头像尺寸	40–48px	兼顾清晰度和体积
显示日期	开启	帮助判断评论时效
作者网站链接	按需关闭	减少不必要的外部链接
Pingback/Trackback	通常关闭	避免把引用通知当作普通评论展示

十、用 CSS 美化评论列表

3.0 版本已经提供基础网格样式。如果还想让评论更像卡片，可以把下面的 CSS 放进子主题样式表或站点自定义 CSS。不要直接修改插件文件，否则更新插件后代码会被覆盖。

.decent-comments-list .comment-entry {
  margin-bottom: 14px;
}

.decent-comments-list .comment-content {
  padding: 14px;
  border: 1px solid rgba(15, 23, 42, 0.08);
  border-radius: 14px;
  background: #fff;
  box-shadow: 0 8px 24px rgba(15, 23, 42, 0.06);
}

.decent-comments-list .comment-avatar img {
  border-radius: 50%;
}

.decent-comments-list .comment-excerpt {
  color: #475569;
  line-height: 1.75;
}

十一、常见问题排查

1. 添加后没有显示任何评论

先到“评论”页面确认存在已批准评论。然后清空 Post ID、Post Type、Taxonomy 和 Terms 等筛选条件再测试。如果填写了 Taxonomy，却没有填写有效 Terms，官方文档说明不会显示评论。

2. 中文评论摘要太长或太短

开启摘要后，优先设置 max_excerpt_characters，例如 80；不要只依赖 max_excerpt_words。

3. 修改设置后前台没有变化

依次清理页面缓存、对象缓存和 CDN 缓存。使用 Elementor 时，还可以重新生成 Elementor CSS 与数据，然后用无痕窗口检查。

4. 头像无法显示

WordPress 默认头像通常来自 Gravatar。检查“设置 → 讨论”中的头像选项、服务器是否能访问头像服务，以及隐私或安全插件是否阻止了外部头像请求。

十二、性能、安全和卸载说明

Decent Comments 只负责查询并展示 WordPress 评论，不会替代评论表单或评论审核。建议把显示数量控制在 5–10 条，不要在同一页面放置过多实例；评论较多的网站应配合页面缓存或对象缓存。

插件 3.0.2 已移除 REST 响应中的评论作者邮箱，并改用作者显示名称。无论使用哪个版本，都应保持插件更新，并只从 WordPress.org 或开发者官方渠道下载安装包。

停用或删除 Decent Comments 不会删除 WordPress 原有评论，只会让区块、小工具和短代码停止输出。删除前应先移除页面里的相关区块或短代码，避免前台留下未解析内容。

十三、总结

Decent Comments 的优点是功能集中、配置方式灵活，而且不需要替换 WordPress 原生评论系统。对于希望在侧边栏、首页或文章底部展示最新评论的网站，区块和小工具已经足够；Elementor 用户则可以通过短代码快速接入。

按照这篇 Decent Comments 插件教程完成基础设置后，建议先显示 5 条评论、使用 60–100 个字符的中文摘要，并在手机端检查头像、换行和卡片宽度。如果你还想继续完善网站互动区域，可以浏览本站的 WordPress 插件教程。

参考资料：WordPress.org 插件页面、itthinx 官方小工具文档。