Zinn® ChatZinn® Chat 简码：每个简码和属性
Zinn® Chat 和知识库短代码的完整列表、各自显示的内容、接受的每个属性、默认值及示例。
每个 Zinn® Chat 元素都是适用于主流页面构建器的短代码、区块和模块，并具有相同的选项。此页面列出了每个短代码及其所有属性。所有属性均为可选。
用于开启或关闭某项功能的属性接受 yes、no、1、0、true 或 false。分类和文章可以通过别名（slug）或 ID 指定，多个项目之间用逗号分隔。
[zinn_chat_support]
整个支持页面：面向访客的提交工单表单，以及已登录客户本人的请求及其回复。
此短代码没有任何属性。
示例： [zinn_chat_support]
[zinn_chat_ticket_form]
仅工单提交表单。
| 属性 | 默认 | 功能说明 |
|---|---|---|
title | (空) | 表单上方的标题。 |
subject | (空) | 为客户填写的预设主题，例如在产品页面上。 |
button | (空) | 发送按钮的文本。 |
show_subject | yes | 显示主题字段（是）或隐藏该字段（否）。 |
示例： [zinn_chat_ticket_form title="Contact support" button="Send" show_subject="no"]
[zinn_chat_my_tickets]
已登录客户的支持请求，每项均包含其状态及指向对话的链接。
此短代码没有任何属性。
示例： [zinn_chat_my_tickets]
[zinn_chat_button]
打开聊天的按钮。任何指向 #zinn-chat 的链接，或带有 zinn-chat-open 类的任何元素，都具有相同的效果。
| 属性 | 默认 | 功能说明 |
|---|---|---|
label | Chat with us | 按钮文本。 |
示例： [zinn_chat_button label="Ask us anything"]
[zinn_kb]
Zinn® Chat Pro
知识库首页：标题、搜索框以及包含文章的分类卡片。
| 属性 | 默认 | 功能说明 |
|---|---|---|
title | (空) | 标题。留空则使用设置中的知识库标题。 |
categories | (空) | 仅显示这些类别。 |
exclude | (空) | 排除这些类别。 |
columns | (空) | 分类列，1 到 4。留空则使用设置。 |
articles | (空) | 每个分类下列出的文章数量。0 表示不列出任何内容。 |
show_count | (空) | 显示每个类别包含的文章数量。 |
search | yes | 显示搜索框。 |
示例： [zinn_kb title="Help centre" columns="3" articles="5"]
[zinn_kb_search]
Zinn® Chat Pro
知识库搜索框。结果会在访客输入时显示；在没有 JavaScript 的情况下，它会打开网站的搜索结果。
| 属性 | 默认 | 功能说明 |
|---|---|---|
placeholder | (空) | 空搜索框内的文本。 |
button | (空) | 搜索按钮的文本。 |
category | (空) | 仅搜索此类别及其子类别。 |
live | yes | 在访客输入时显示结果。 |
示例： [zinn_kb_search placeholder="How can we help?" category="billing"]
[zinn_kb_categories]
Zinn® Chat Pro
分类卡片，包含描述、数量以及每个分类的前几篇文章。
| 属性 | 默认 | 功能说明 |
|---|---|---|
include | (空) | 仅显示这些类别。 |
exclude | (空) | 排除这些类别。 |
parent | (空) | 显示此类别的子类别。留空则显示顶级。 |
columns | (空) | 列，1 至 4。 |
articles | 0 | 每个卡片中列出的文章数。 |
show_count | (空) | 显示每个类别包含的文章数量。 |
show_description | yes | 显示每个类别的描述。 |
orderby | order | 排序：排序（各分类的“排序”字段）、名称或数量（文章数最多的排在最前）。 |
hide_empty | yes | 隐藏尚无文章的分类。 |
示例： [zinn_kb_categories include="shipping,returns" columns="2" articles="3"]
[zinn_kb_category]
Zinn® Chat Pro
一个分类页面：面包屑导航、其描述、该分类的搜索框、其子分类及其文章。
| 属性 | 默认 | 功能说明 |
|---|---|---|
category | (空) | 要显示的分类。若留空，则使用当前正在查看的分类页面。 |
title | (空) | 标题。留空则使用分类名称。 |
limit | (空) | 文章数量。留空则显示全部。 |
orderby | order | 排序规则：order（每篇文章的 Order 字段）、title、date、modified 或 helpful。 |
show_excerpt | yes | 在每篇文章下方显示简短摘要。 |
subcategories | yes | 在文章上方显示子分类。 |
示例： [zinn_kb_category category="shipping" limit="10"]
[zinn_kb_articles]
Zinn® Chat Pro
文章列表或网格：来自某个分类、按 ID 选取、最新的、最有用的或最近更新的。
| 属性 | 默认 | 功能说明 |
|---|---|---|
category | (空) | 仅限此分类下的文章。 |
ids | (空) | 这些文章，按 ID，依此顺序。 |
limit | 10 | 多少篇文章，最多 100 篇。 |
orderby | date | 排序：日期（最新的排在前面）、修改时间（最近更新）、标题、排序或有帮助（“是”投票最多）。 |
show_excerpt | no | 在每篇文章下方显示简短摘要。 |
layout | list | 列表或网格。 |
columns | (空) | 网格列，1 至 4。 |
title | (空) | 列表上方的标题。 |
示例： [zinn_kb_articles orderby="helpful" limit="5" title="Most helpful"]
[zinn_kb_article]
Zinn® Chat Pro
网站上任意位置的一篇文章的内容，例如在产品描述中。
| 属性 | 默认 | 功能说明 |
|---|---|---|
id | (空) | 文章，按 ID 或别名。 |
show_title | yes | 在其上方将文章标题显示为链接。 |
示例： [zinn_kb_article id="return-an-item" show_title="no"]
[zinn_kb_breadcrumbs]
Zinn® Chat Pro
访客在知识库中的位置（帮助中心、分类、文章）。自动显示在知识库页面上；您可以在自己的模板中使用它。
此短代码没有任何属性。
示例： [zinn_kb_breadcrumbs]
在块编辑器和 Page Builder Sandwich 中，请在块插入器中搜索 Zinn® Chat。在 Elementor、Beaver Builder、Divi 和 Bricks 中，相同的元素位于 Zinn® Chat 下的小部件列表中。
包含在 Zinn Digital® 托管服务中
已预装在我们托管的每个 WordPress 网站上
我们托管在自家服务器上的每个 WordPress 站点均已预装并激活免费的 Zinn® Chat 插件，因此只需轻轻一切换即可开启聊天。当您需要更多功能时，可以按站点升级至 Premium。