---
title: "Zinn® Chat 简码：每个简码和属性 — Zinn® Chat"
description: "Zinn® Chat 和知识库短代码的完整列表、各自显示的内容、接受的每个属性、默认值及示例。"
url: "https://zinnchat.com/zh/%E7%9F%A5%E8%AF%86%E5%BA%93/%E5%B8%AE%E5%8A%A9%E5%8F%B0-%E6%8F%92%E4%BB%B6-%E7%AE%80%E7%A0%81-%E5%8F%82%E8%80%83"
lang: "zh"
dir: "ltr"
---

# Zinn® 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。

[查看主机方案](https://zinndigital.com/zh/%E6%89%98%E7%AE%A1%E6%9C%8D%E5%8A%A1)