目录
TruePaws — 完整用户指南
什么是TruePaws？
第一部分：安装前准备（所需条件）
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密钥。可免费获取于 谷歌AI工作室.
- 如需向外部服务发送自动化通知，需注册Zapier或Make账户。
第二部分：插件安装
步骤1 — 上传插件
- 登录您的WordPress管理后台（通常为yourwebsite.com/wp-admin）。
- 在左侧边栏中，前往插件→新增。
- 点击顶部的上传插件按钮。
- 点击选择文件，选取您收到的truepaws.zip文件。
- 点击立即安装并等待完成。
步骤2 — 激活插件
- 安装完成后，点击激活插件按钮。
- 插件将自动创建所需的所有数据库表。
- 您将在WordPress侧边栏看到新增的TruePaws菜单项。
第三部分：初始设置（优先完成！）
标签1：常规设置
| 设置 | 功能说明 | 示例 |
|---|---|---|
| 默认物种 | 您主要繁育的动物类型。选项：犬、猫、马、兔、豚鼠、雪貂、鸟类。 | 狗 |
| 繁育者前缀 | 自动命名幼犬/幼猫时使用的短代码（最多5个字符）。 | TP |
| 妊娠期——犬类 | 犬类妊娠持续天数。默认为63天。仅在确知不同时修改。 | 63 |
| 妊娠周期 — 猫类 | 猫类妊娠持续天数。默认为65天。 | 65 |
| 喂养说明 | 将显示在交接文件上的文字，供新买家参考。写明动物饮食内容、频率及特殊注意事项。 | “每日喂食3次皇家幼犬粮…” |
| Gemini API密钥 | 在此粘贴您的Google Gemini API密钥以启用AI功能。若不需要AI功能，请留空。 | （您的密钥） |
| Webhook网址 | 若您使用Zapier或Make进行自动化操作，请在此粘贴webhook URL。否则请留空。 | （您的webhook URL） |
标签2：繁育者信息
| 字段 | 填写内容 |
|---|---|
| 繁育者姓名 | 作为繁育者的全名 |
| 业务名称 | 您的犬舍或猫舍名称 |
| 许可证编号 | 您的繁育许可证编号（如适用） |
| 电话 | 您的业务联系电话 |
| 电子邮箱 | 您的业务电子邮箱地址 |
标签3：犬种信息
- TruePaws预载了20种常见犬种和20种常见猫种。
- 添加品种：在文本框输入品种名称并点击添加品种。
- 删除品种：点击列表中任意品种旁的删除按钮。
标签4：沟通记录
| 字段 | 填写内容 |
|---|---|
| 街道地址 | 您的犬舍街道地址 |
| 城市 | 城市 |
| 州/省 | 州/省 |
| 邮政编码 | 邮政编码 |
| 国家 | 国家 |
| 联系/咨询页面URL | 您网站联系页面的URL（将作为“联系繁育者”按钮的默认链接） |
标签5：销售报告
- 累计收入
- 销售总量
- 平均售价
- 月度明细表
- 顶级买家表
第四部分：仪表盘
统计卡片
- 动物总数——系统中现有动物数量
- 活跃窝次——当前追踪中的怀孕记录
- 联系人——买家总数与候补名单条目
- 近期事件——即将到来的事项（疫苗注射、分娩日期等）
快捷操作
- 添加动物——直接跳转至新动物表单
- 记录交配——新增繁殖记录
- 添加联系人——新增买家或候补名单条目
新手指南清单
最新动态
图表
- 品种分布——环形图展示各品种动物数量占比
- 销售概览——柱状图显示月度收入
活动热力图
第五部分：添加与管理动物
如何添加新动物
- 前往TruePaws→动物管理（或点击仪表盘“添加动物”）
- 点击“新增动物”按钮
- 填写表单：
| 字段 | 必填？ | 描述 |
|---|---|---|
| 姓名 | 是 | 动物的注册/正式名称 |
| 呼名 | 否 | 您在家中实际称呼它的名字 |
| 注册编号 | 否 | 来自您品种登记处的官方注册编号 |
| 微芯片ID | 否 | 微芯片编号（必须唯一） |
| 品种 | 否 | 从您的品种列表中选择 |
| 性别 | 是 | 雄性或雌性 |
| 父犬（父亲） | 否 | 从系统中现有的雄性动物中选择 |
| 母犬（母亲） | 否 | 从系统中现有的雌性动物中选择 |
| 出生日期 | 否 | 动物出生日期 |
| 状态 | 否 | 活跃、退役、已售、已故或共同拥有（默认为活跃） |
| 毛色/斑纹 | 否 | 描述动物的外观特征 |
| 描述 | 否 | 关于该动物的任何附加备注 |
| 特色图片 | 否 | 点击打开WordPress媒体库并选择照片 |
- 点击保存动物
动物资料页面
查看信息
- 查看已录入的所有详细信息，以及状态标识（如绿色“活跃中”、蓝色“已售出”）
- 特色图片会突出显示，若未上传照片则显示默认剪影。
照片库
- 点击“添加照片”可上传多张图片。
- 拖放照片可重新排序。
- 点击照片可将其设为特色图片。
- 删除不再需要的照片。
时间线与事件
- 点击“添加事件”按钮。
- 选择事件类型：
- 出生——出生记录
- 疫苗——接种疫苗
- 发情——观察到发情周期
- 交配——配种事件
- 分娩——生产幼崽
- 体重——体重测量
- 兽医就诊——预约兽医
- 备注——一般记录
- 输入日期及标题/描述。
- 记录体重事件时，请输入体重数值。
- 点击保存。
血统树
- 显示包含父母、祖父母和曾祖父母的三代家谱。
- 此功能需预先为动物录入亲子关系方可使用。
- 点击下载血统证书PDF可生成可打印的血统证明文件。
体重增长图表
- 若已记录体重事件，将显示该动物体重变化趋势的折线图。
- 显示当前体重及累计增重数据。
AI功能（需Gemini API密钥）
- AI养护建议——根据动物品种、年龄及历史记录生成个性化养护方案，结果缓存有效期为30天。
- AI营销文案——为您的网站或社交媒体列表撰写吸睛描述。
- AI健康预警——分析事件记录并标记潜在健康问题。
出售动物
- 在动物档案页面点击出售/预订。
- 从联系人列表中选择买家。
- 填写交易日期与价格。
- 可添加备注（选填）。
- 点击确认出售。
- 该动物的状态将变更为“已售出”。
- 您现在可以点击生成交接PDF，创建包含动物信息、健康记录、血统预览、护理说明及繁育者详细资料的专业交接文件。
复制短代码
未找到动物。
点击复制。您可将其粘贴到任何WordPress页面或文章中，以便在您的公开网站上展示该动物的资料。第六部分：繁殖与幼犬管理
记录新交配
- 前往TruePaws → 幼犬管理。
- 点击记录新配种。
- 填写表单：
| 字段 | 必填？ | 描述 |
|---|---|---|
| 父犬（父亲） | 是 | 从您的动物中选择雄性 |
| 母犬（母亲） | 是 | 从您的动物中选择雌性 |
| 配种日期 | 是 | 配种发生的日期 |
| 方式 | 否 | 自然交配或人工授精（AI） |
| 备注 | 否 | 关于此次交配的任何备注 |
- 点击保存。
- 系统会根据您设置的妊娠周期（默认：犬类63天，猫类65天）自动计算预计分娩日期。
追踪怀孕
- 显示妊娠进度的进度条。
- 妊娠阶段指示器（早期/中期/晚期）。
- 距离预计分娩剩余天数。
- 即将到来的重要阶段包括：
- 胚胎着床
- 可检测到胎心
- 超声波检查窗口期
- X光安全期
- 预计筑巢行为
记录出生（分娩）
- 前往TruePaws → 幼犬/幼猫管理
- 找到该窝次并点击“分娩”
- 分娩向导将打开，请按步骤操作：
- 输入实际分娩日期
- 输入雄性幼犬/幼猫数量
- 输入雌性幼犬/幼猫数量
- 预览自动生成的名称（例如“TP24AB幼犬1号”、“TP24AB幼犬2号”）
- 核对摘要信息
- 点击提交
- 为每只幼犬/幼猫创建独立档案
- 自动设置其父母（父犬和母犬）
- 为每只记录“出生”事件
- 将所有状态设为“活跃”
- 使用您的繁育前缀分配自动生成名称
第七部分：联系人管理（买家与等候名单）
添加联系人
- 前往TruePaws→联系人
- 点击添加新联系人
- 填写表单：
| 字段 | 必填？ | 描述 |
|---|---|---|
| 名字 | 是 | 买家名字 |
| 姓氏 | 否 | 买家姓氏 |
| 电子邮箱 | 是 | 买家电子邮箱 |
| 电话 | 否 | 电话号码 |
| 地址 | 否 | 邮寄地址 |
| 状态 | 否 | 候补名单、已预订、买家或非活跃状态 |
| 备注 | 否 | 关于此联系人的任何私人备注 |
- 点击保存联系人
联系人列表功能
- 按状态筛选——使用下拉菜单仅显示候补名单、已预订、买家或非活跃联系人
- 导出为CSV——点击导出按钮将所有联系人下载为电子表格文件，便于导入邮件营销工具如Mailchimp
联系人资料页
- 联系信息及地址
- 咨询记录——显示此人通过网站询价表单咨询过的动物
- 已购动物——列出您出售给此人的所有动物
- 快速操作按钮：发送邮件、拨打电话或查看可售动物
第八部分：在网站上展示动物（短代码）
1. 显示单个动物
<code>
无效的动物ID。
| 参数 | 功能说明 | 默认值 |
|---|---|---|
| 联系网址=”https://…” | “联系繁育者”按钮的自定义链接 | 您的设置URL |
| show_ai=”true”或“false” | 显示或隐藏人工授精护理信息 | 是 |
| 显示血统=“真”或“假” | 显示或隐藏血统树 | 是 |
| 显示查询表单=“真”或“假” | 在动物信息下方嵌入查询表单 | 否 |
| 显示图库=“真”或“假” | 显示或隐藏照片库 | 是 |
| 图库列数=“3” | 图库的列数（2至6） | 4 |
2. 显示一窝幼崽
3. 显示所有可售幼犬/幼猫
| 参数 | 功能说明 | 默认值 |
|---|---|---|
| 限制=“6” | 显示动物的最大数量 | 12 |
| 品种=“金毛寻回犬” | 仅显示此品种的动物 | （所有品种） |
| 显示图片=“真”或“假” | 显示或隐藏照片 | 是 |
4. 显示询价表单
| 参数 | 功能说明 | 默认值 |
|---|---|---|
| 动物编号=“123” | 将咨询关联至特定动物 | (无) |
| 标题=“感兴趣？联系我们！” | 自定义表单标题 | “发送咨询” |
- 名字（必填）
- 姓氏
- 邮箱（必填）
- 电话
- 留言（必填）
第九部分：PDF文档
1. 血统证书
- 通过点击动物档案页的「下载血统谱PDF」生成
- 包含动物名称、注册编号、芯片ID、品种、性别、出生日期及三代血统树
- 显示您的繁育者名称及生成日期
2. 交接资料包
- 通过点击“生成交接PDF”从已售动物档案中生成。
- 包含内容：
- 动物详情（名称、品种、性别、出生日期、注册信息、芯片号、父母信息）
- 血统预览
- 完整健康记录（疫苗、兽医就诊等）
- 您的喂养/护理说明（来自设置）
- 一般护理建议
- 合同与条款部分
- 页脚处的繁育者信息
第十部分：自动邮件通知
分娩提醒
- 在预产期前7天发送。
- 邮件包含幼崽名称、预产期及父母名称。
疫苗接种提醒
- 自动检查所有活跃动物，并在达到疫苗接种关键年龄时提醒您：
- 6周龄——首次疫苗接种到期
- 9周龄——第二次疫苗接种到期
- 12周龄——第三次疫苗接种到期
- 16周龄——幼犬最终疫苗接种到期
- 1岁龄——年度加强针到期
- 2岁龄——两年一次健康检查到期
- 3岁龄——三年一次健康检查到期
第十一部分：推荐工作流程（逐步指南）
首次设置
- 安装并激活插件
- 进入设置界面，填写所有选项卡（常规、繁育者信息、犬种、通讯）
- 若默认选项未涵盖需求，请添加您的自定义犬种
构建数据库
- 首先添加所有成年种用动物（公犬与母犬）
- 为每只动物上传照片，填写注册编号和芯片ID
- 设置已知的亲子关系（用于构建血统树）
- 添加历史事件（过往疫苗、兽医就诊）以构建每只动物的时间线
日常使用
- 当配种发生时，前往「幼犬管理」→「记录新配种」
- 通过幼犬管理页面的妊娠追踪卡片监测孕期
- 幼犬/幼猫出生时，使用分娩向导功能
- 随着幼犬成长，更新每只幼犬的档案，添加照片、疫苗记录和体重检查。
- 收到咨询时，添加买家和候补名单联系人。
销售管理
- 当幼犬售出时，打开其档案 → 点击出售/预订 → 关联买家联系人。
- 生成交接PDF文件，提供给新主人。
- 在设置中查看销售报告，追踪收入。
公开网站
- 创建一个名为“待售幼犬”的页面并添加 .
- 使用以下方式为特殊动物创建独立页面 无效的动物ID。.
- 添加 到您的联系页面，方便访客联系您。
- 使用以下方式分享幼犬页面 无效的幼犬ID。.
第十二部分：技巧与窍门
- 利用仪表盘上的活动热力图发现记录中的空白期——静默期可能意味着您忘记记录事件。
- 定期将联系人导出为CSV文件并导入Mailchimp或类似平台，以保持您的邮件列表最新。
- AI营销简介能节省您撰写列表的时间——生成简介、审阅后直接粘贴到网站或社交媒体。
- 体重追踪对幼犬尤为重要——每周记录体重并使用生长图表，及时发现需要额外关注的幼犬。
- 带有animal_id参数的询盘表单短代码可创建针对特定动物的询盘按钮，让您准确掌握每位客户咨询的具体动物。
- 共有状态适用于繁育者共享的动物——它们会保留在您的系统中并带有明确标记。