您的代码出错的根本原因是排版冲突。AI工具和文字处理器常生成“智能引号”（如弯引号 “ 和 ”），而WordPress短代码和核心编程语言严格要求使用“直引号”（如 " 和 '）。当古腾堡编辑器在短代码括号内遇到弯引号时，会无法将其解析为代码并导致渲染中断。

此外，您的粘贴操作完全破坏了文档中的表格，将其压平成难以阅读的文本块。盲目粘贴原始文本会破坏数据结构。

我已为您清理文本：将所有引号转换为直引号，用代码格式包裹短代码防止古腾堡执行，并将损毁的表格重建为规范的Markdown格式。若直接粘贴到古腾堡编辑器，应能自动生成正确的标题、表格和代码块。

以下是结构完整的版本：

---

TruePaws — 完整用户指南

什么是 TruePaws？

TruePaws是运行在您WordPress网站内的犬舍管理系统。它帮助专业繁育者管理动物、追踪配种与妊娠、处理买家联系、生成正式文件（如血统证书和交接资料包），甚至能在公开网站上展示待售幼犬/幼猫。

第1部分：先决条件（安装前需要准备的内容）

1. WordPress网站

• 您需要一个自托管的WordPress网站（需安装在您自己的主机上——而非免费的WordPress.com博客）。
• 需要WordPress 5.0或更高版本。

2. 主机要求

• PHP 7.4 或更高版本（大多数现代主机提供 PHP 8.0+）。
• MySQL 数据库（所有 WordPress 主机标准配置）。
• 必须启用 WordPress REST API（默认已启用——仅当有人手动关闭时才会禁用）。

3. 可选（但推荐）

• 如需使用 AI 功能（护理建议、健康警报、营销简介生成），需准备 Google Gemini API 密钥。可从 Google AI Studio 免费获取。
• 如需向外部服务发送自动化通知，需注册 Zapier 或 Make 账户。

第2部分：安装插件

第一步 — 上传插件

1. 登录您的 WordPress 管理后台（通常位于 yourwebsite.com/wp-admin）。
2. 在左侧边栏中，进入 插件 → 添加新插件.
3. 点击顶部 上传插件 按钮。
4. 点击 选择文件 并选择您收到的 truepaws.zip 文件。
5. 点击 立即安装 并等待其完成。

第二步 — 激活插件

1. 安装完成后，点击 激活插件 按钮。
2. 插件将自动创建所有需要的数据库表。
3. 您会看到一个新的 真爪 菜单项出现在WordPress侧边栏中。

第3部分：初始设置（首先完成此步骤！）

激活后请前往 TruePaws → 设置 在WordPress侧边栏中。您会看到顶部有几个标签页。请逐一进行操作。

标签1：常规设置

设置	功能说明	示例
默认物种	您主要培育的动物类型。可选：犬、猫、马、兔、豚鼠、雪貂、鸟类。	犬
繁育前缀	为幼犬/幼猫自动命名时使用的简短代码（最多5个字符）。	TP
妊娠周期——犬类	狗的妊娠期有多少天。默认是63天。除非您知道确切数字，否则请勿更改。	63
妊娠期 — 猫	猫的妊娠期有多少天。默认是65天。	65
喂养指南	这将会出现在您提供给新买家的交接文档中。请写明动物的饮食内容、喂养频率及任何特殊指示。	“每日3次，喂食皇家幼犬粮……”
Gemini API密钥	在此粘贴您的Google Gemini API密钥以启用AI功能。若不需要AI功能，请留空。	(您的密钥)
Webhook网址	如果您使用Zapier或Make进行自动化操作，请在此粘贴webhook网址。若无需要，请留空。	(您的webhook网址)

点击 保存设置 完成后。

标签2：繁育者信息

填写您的专业资料。这些信息将显示在生成的PDF文件上（如血统证书、交接资料包）。

字段	填写内容
繁育者姓名	请填写您的全名作为繁育者
商业名称	您的犬舍或猫舍名称
许可证编号	您的繁育许可证号码（如适用）
电话	您的业务联系电话
电子邮件	您的业务电子邮箱地址

点击 保存设置 完成后。

标签3：犬种

这里管理插件中各下拉菜单可选的品种列表。TruePaws预装了20种常见犬类和20种常见猫类品种。

• 添加品种的方法： 在文本框中输入品种名称并点击 添加品种.
• 删除品种的方法： 点击列表中任意品种旁的删除按钮。

提示： 现在添加您经营的所有品种。之后随时可以补充更多。

标签4：通讯

填写您的邮寄地址和联系页面网址。这些信息将用于面向公众的功能和短代码。

字段	填写内容
街道地址	您的犬舍街道地址
城市	城市
州/省	州或省
邮政编码	邮政编码
国家	国家
联系/查询网址	您网站联系页面的网址（用作“联系饲养员”按钮的默认链接）

点击 保存设置 完成后。

标签5：销售报告

此标签页为只读模式——当您开始记录销售数据后，这里会显示销售统计信息。您将看到：

• 总收入
• 总销售量
• 平均售价
• 月度细分表
• 顶级买家表

第4部分：仪表盘

点击侧边栏中的TruePaws时，您将进入控制面板。这里是您的主要工作区，包含以下内容：

统计卡片

• 动物总数——系统中现有动物数量
• 活跃繁殖窝——当前正在追踪的孕期
• 联系人——买家与候补名单总数
• 即将来临的事件——近期计划事项（疫苗接种、分娩日期等）

快捷操作

• 添加动物——直接跳转至新增动物表单
• 记录交配——新增一次配种记录
• 添加联系人——新增买家或候补名单条目

新手指南清单

• 一站式指导清单助您完成首次设置

最新动态

• 所有动物最新事件时间线（疫苗、兽医检查、体重监测等）

图表

• 品种分布图——环形图展示各品种动物数量
• 销售概览——柱状图显示月度收入

活动热力图

• 一个类似GitHub风格的热度日历图，展示过去一年中您的犬舍每日活跃程度。颜色越深的方块代表当日记录的事件越多。

第5部分：添加和管理动物

如何添加新动物

1. 前往 TruePaws → 动物管理 （或在仪表盘点击“添加动物”）。
2. 点击顶部 新增动物 按钮。
3. 填写表格：

字段	必填？	描述
名称	是	动物的注册/官方名称
昵称	否	您在家中实际称呼它们的名字
注册编号	否	品种注册机构颁发的官方注册编号
微芯片ID	否	微芯片编号（必须唯一）
品种	否	从您的品种列表中选择
性别	是	雄性或雌性
父亲（种公）	否	从系统中现有的雄性动物中选择
母亲（母犬）	否	从系统中现有的雌性动物中选择
出生日期	否	动物的出生日期
状态	否	活跃、退役、已售、已故或共有（默认为活跃）
颜色/斑纹	否	描述动物的外观
描述	否	关于动物的额外备注
特色图片	否	点击打开WordPress媒体库并选择照片

4. 点击 保存动物信息.

首次设置提示： 首先添加您的成年种犬（公犬和母犬）。这样，当您添加幼犬时，可以从下拉菜单中选择它们的父母。

动物档案页

保存后，点击任意动物的名称可查看其资料页。这是插件中功能最丰富的页面，您可以在此进行以下操作：

查看信息

• 查看您输入的所有详细信息，以及状态徽章（例如，绿色的“活跃中”，蓝色的“已售出”）。
• 特色图片将醒目显示，若未上传照片则显示默认轮廓图。

照片库

• 点击“添加照片”可上传多张图片。
• 拖放照片可调整排序。
• 点击照片可将其设为特色图片。
• 删除不再需要的照片。

时间线及事件

时间线按时间顺序展示该动物的所有历史事件。添加新事件的方法：

1. 点击顶部 添加事件 按钮。
2. 选择事件类型：出生、疫苗接种、发情期、交配、分娩、体重记录、兽医就诊或备注。
3. 输入日期及标题/描述。
4. 对于体重事件，请输入体重数值。
5. 点击 保存.

血统谱系树

• 显示包含父母、祖父母及曾祖父母的3代家族谱系。（仅在有录入父母关系时生效）
• 点击 下载血统证书PDF 以生成可打印证书。

体重增长曲线

• 若已记录体重事件，将显示该动物体重随时间变化的折线图。

AI功能（需Gemini API密钥）

• AI养护建议 ——根据动物品种、年龄及历史记录生成个性化养护建议。
• AI营销简介 ——为您的网站或社交媒体列表撰写引人注目的描述文案。
• AI健康预警 ——分析事件历史并标记潜在健康问题。

出售动物

1. 在动物档案页点击 出售/预定.
2. 从联系人列表中选择买家。
3. 输入销售日期和价格。
4. 添加任何备注（可选）。
5. 点击 确认销售.
6. 动物的状态更改为“已售出”。
7. 点击 生成交接PDF 以创建专业的交接文件。

复制短代码

在资料页面的底部，您会看到一个类似

的短代码。点击复制它。您可以将其粘贴到任何WordPress页面或文章中，以便在您的公开网站上显示该动物的资料。

第6部分：繁殖与幼犬管理

记录新配种

1. 前往 TruePaws → 幼犬.
2. 点击 记录新交配.
3. 填写表格：

字段	必填？	描述
父亲（种公）	是	从您饲养的动物中选择雄性
母亲（母犬）	是	从您饲养的动物中选择雌性
交配日期	是	繁殖发生的日期
方式	否	自然交配或人工授精(AI)
备注	否	关于此次交配的任何备注

4. 点击 保存系统根据您的怀孕持续时间设置自动计算预计分娩日期。

追踪妊娠期

每个活跃的窝次都会显示一个 孕期追踪器 卡片，包含：

• 显示怀孕进度的进度条。
• 孕期指示器（早期/中期/晚期）。
• 距离预计分娩的天数。
• 即将到来的里程碑（着床、心跳、超声波等）。

记录分娩（生产）

1. 前往 TruePaws → 幼犬.
2. 找到幼犬并点击 幼犬窝.
3. 第一步 —— 记录出生： 填写实际分娩日期、公/母幼犬数量，并预览自动生成的命名。
4. 第二步 —— 确认： 核对摘要后点击提交。系统将自动为每只幼犬创建独立档案，指定父母，记录出生事件，并将其状态设为活跃。

第7部分：管理联系人（买家与候补名单）

添加联系人

1. 前往 TruePaws → 联系人.
2. 点击 新增联系人.
3. 填写表格：

字段	必填？	描述
名	是	买家的名字
姓氏	否	买家姓氏
电子邮件	是	买家电子邮件地址
电话	否	电话号码
地址	否	邮寄地址
状态	否	候补名单、已预留、买家或未激活
备注	否	有关此联系人的任何私人备注

4. 点击 保存联系人.

联系列表功能

• 按状态筛选 —— 仅显示候补名单、已预订、买家或非活跃联系人。
• 导出为CSV —— 将所有联系人导出为电子表格文件，用于邮件营销工具。

第8部分：在网站上展示动物（短代码）

短代码是您可以粘贴到WordPress页面或文章中的特殊代码，用于在您的公开网站上显示TruePaws内容。

1. 显示单个动物

[truepaws_animal id="7"]

（将123替换为实际动物的ID号）

您可以添加的可选设置：

参数	功能说明	默认
contact_url="https://..."	“联系繁殖者”按钮的自定义链接	您的设置网址
show_ai="true" 或 "false"	显示或隐藏AI护理信息	是
show_pedigree="true" 或 "false"	显示或隐藏血统树	是
show_inquiry_form="true" 或 "false"	在动物信息下方嵌入咨询表单	假
show_gallery="true" 或 "false"	显示或隐藏照片库	是
gallery_columns="3"	照片库的列数（2至6）	4

带选项的示例：

[truepaws_animal id="45" show_inquiry_form="true" gallery_columns="3" show_ai="false"]

2. 显示一窝幼崽

[truepaws_litter id="1"]

这将显示窝次的信息，包括父母、出生日期以及可用幼犬/幼猫的照片和状态徽章的网格。

3. 显示所有可售幼犬/幼猫

[truepaws_available_puppies]

这将显示所有状态为“活跃”的动物的网格。

可选设置：

参数	功能说明	默认
limit="6"	最多显示的动物数量	12
breed="Golden Retriever"	仅显示此品种的动物	（所有品种）
show_images="true" 或 "false"	显示或隐藏照片	是

示例：

[truepaws_available_puppies breed="Labrador Retriever" limit="8"]

4. 显示查询表单

[truepaws_inquiry_form]

这将显示一个联系表单，访客可以填写以询问您的动物。

可选设置：

参数	功能说明	默认
animal_id="123"	将咨询链接到特定动物	（无）
title="Interested? Get in Touch!"	自定义表单标题	“发送咨询”

第9部分：PDF 文档

TruePaws可以生成两种类型的专业PDF文档：

1. 血统证书

可从任意动物资料页面生成。包含动物姓名、注册详情、三代血统树及您的繁育者姓名。

2. 交接文件包

从已售动物资料生成。包含动物详情、血统预览、完整健康记录、喂养指南、护理建议、合同条款及您的繁育者信息。

注意： 为确保最佳PDF质量，请要求您的网络主机安装TCPDF或Dompdf PHP库。

第10部分：自动电子邮件通知

TruePaws每日自动检查并发送邮件提醒以下事项：

• 分娩提醒： 预计分娩日期前7天发送。
• 疫苗接种提醒： 在关键时间节点提醒您（6周、9周、12周、16周、1年、2年、3年）。

重要提示： 这些邮件会发送至您在设置→繁育者信息→邮箱中填写的地址。

第11部分：推荐工作流程（逐步指南）

首次设置

1. 安装并激活插件。
2. 前往设置并填写所有选项卡。
3. 添加您的自定义品种。

建立数据库

1. 首先添加所有成年繁殖动物（公犬和母犬）。
2. 上传照片并填写注册数据。
3. 设定亲缘关系以构建血谱树。
4. 添加历史事件以构建每只动物的时间线。

日常使用

1. 当交配发生时，在“窝次”下记录。
2. 跟踪妊娠情况，并在分娩时使用“分娩向导”。
3. 随着幼崽成长更新其档案。
4. 将买家添加到联系人列表。

销售管理

1. 动物售出时，在其档案中使用“售卖/预定”功能。
2. 生成交接PDF文件。
3. 监控销售报告。

公开网站

1. 使用以下方式创建“待售幼犬”页面： truepaws_available_puppies 短代码
2. 使用创建独立页面 truepaws_animal id="..." 短代码
3. 添加 truepaws_inquiry_form 短代码至您的联系页面。

第12部分：技巧与窍门

• 使用仪表盘上的活动热力图发现记录中的遗漏。
• 定期将联系人导出为CSV以保持邮件列表更新。
• AI营销简介可节省您编写列表的时间。
• 每周记录幼犬体重，并通过生长图表及早发现问题。
• 使用 animal_id 参数在询问表单中追踪特定动物需求。
• 为繁殖者间共享的动物使用“共同所有”状态。