コードが壊れた理由は基本的なタイポグラフィの競合です。AIツールやワードプロセッサは「スマートクォート」（例えば “ や ”のような曲がった引用符）を生成します。WordPressのショートコードや主要なプログラミング言語では「ストレートクォート」（例えば " や 'のような直線の引用符）が厳密に必要です。Gutenbergがショートコードの括弧内に曲がった引用符を見つけると、コードとして解析できずにレンダリングが失敗します。

さらに、コピー＆ペーストによってドキュメント内のテーブルが完全に破壊され、読みにくいテキストの塊に平坦化されました。構造化データを無頓着にコピー＆ペーストすると劣化します。

私はあなたのテキストを整理しました。全てのタイポグラフィをストレートクォートに変換し、Gutenbergが実行しないようにショートコードをコードフォーマットで囲み、破壊されたテーブルを適切なMarkdownに再構築しました。これを直接Gutenbergに貼り付ければ、正しい見出し、テーブル、コードブロックが自動生成されるはずです。

以下は構造的に整合性が取れたバージョンです：

---

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 ― プラグインをアップロード

1. WordPress管理ダッシュボードにログインします（通常は yourwebsite.com/wp-admin）。
2. 左サイドバーで、 プラグイン → 新規追加.
3. をクリックし、 プラグインをアップロード ボタンを押します。
4. クリック ファイルを選択 を選択し、 truepaws.zip 受け取ったファイル
5. クリック 今すぐインストール 完了するまで待ちます

ステップ2 ― プラグインを有効化

1. インストールが完了したら、 プラグインを有効化 ボタンをクリックします
2. プラグインは必要なデータベーステーブルを自動的に作成します
3. 新しい トゥルーポーズ メニュー項目がWordPressのサイドバーに表示されます

パート3: 初期設定（最初にこれを行ってください！）

有効化後、 TruePaws → 設定 WordPressのサイドバーに表示されます。上部にはいくつかのタブがあります。それぞれ順番に進めてください。

タブ1: 一般設定

設定	機能	例
デフォルトの種別	主に繁殖する動物の種類。オプション: 犬、猫、馬、ウサギ、モルモット、フェレット、鳥。	犬
ブリーダープレフィックス	子犬や子猫を自動命名する際に使用する短いコード（最大5文字）。	TP
妊娠期間 — 犬	犬の妊娠期間の日数。デフォルトは63日。変更する場合は正しい値を入力してください。	63
妊娠期間 — 猫	猫の妊娠期間の日数。デフォルトは65日。	65
給餌指示	新しい購入者に渡す引渡し書類に表示されるテキストです。動物が何を食べるか、どのくらいの頻度で、特別な指示があるかを記入してください。	「1日3回、ロイヤルカニンの子犬用フードを与えてください…」
Gemini APIキー	AI機能を有効にするために、ここにGoogle Gemini APIキーを貼り付けてください。AI機能を使用しない場合は空白のままにしてください。	(あなたのキー)
ウェブフックURL	ZapierまたはMakeを使用して自動化する場合は、ここにWebhook URLを貼り付けてください。それ以外の場合は空白のままにしてください。	(あなたのWebhook URL)

クリック 設定を保存 完了したら

タブ2: ブリーダー情報

プロフェッショナルな詳細情報を入力してください。この情報は生成されるPDF（血統証明書、引渡しパッケージ）に表示されます。

フィールド	入力内容
ブリーダー名	ブリーダーとしてのあなたのフルネーム
事業名	ケネルまたはキャットリー名
ライセンス番号	繁殖ライセンス番号（該当する場合）
電話番号	事業用電話番号
メールアドレス	事業用メールアドレス

クリック 設定を保存 完了したら

タブ3: 犬種

ここでは、プラグイン全体のドロップダウンメニューで利用可能な品種のリストを管理します。TruePawsには、20の一般的な犬種と20の一般的な猫種が事前に読み込まれています。

• 犬種を追加するには: テキストボックスに犬種名を入力し、 犬種を追加.
• 犬種を削除するには： リスト内の任意の犬種の横にある削除ボタンをクリックします

ヒント: 今扱っているすべての品種を追加してください。後でいつでも追加できます。

タブ4: コミュニケーション

郵送先住所と連絡先ページのURLを入力してください。これは公開向けの機能やショートコードで使用されます。

フィールド	入力内容
住所	ケネルの住所
市区町村	市区町村
都道府県	都道府県
郵便番号	郵便番号
国	国
問い合わせURL	あなたのウェブサイトの連絡先ページのURL（「ブリーダーに連絡」ボタンのデフォルトリンクとして使用されます）

クリック 設定を保存 完了したら

タブ5: 販売レポート

このタブは読み取り専用です — 販売記録を開始すると、販売統計が表示されます。表示される内容は次のとおりです:

• 総収益
• 販売総数
• 平均販売価格
• 月別内訳表
• 上位購入者一覧

パート4: ダッシュボード

サイドバーのTruePawsをクリックすると、ダッシュボードに移動します。ここがあなたのホームベースです。表示される内容は次のとおりです:

統計カード

• 総動物数 — システム内の動物数
• 活動中の子犬 — 追跡中の妊娠
• 連絡先 — 購入者とウェイトリストの総数
• 今後の予定 — 近づいているイベント（予防接種、出産予定日など）

クイックアクション

• 動物を追加 — 新しい動物フォームに直接移動
• 交配を記録 — 新しい繁殖を登録
• 連絡先を追加 — 新しい購入者またはウェイトリストを追加

はじめにチェックリスト

• 初回セットアップをガイドする便利なチェックリスト。

最新イベント

• すべての動物における最新のイベント（予防接種、動物病院の訪問、体重チェックなど）のタイムライン。

グラフ

• 品種分布 — 各品種の動物がどのくらいいるかを示すドーナツチャート。
• 売上概要 — 月ごとの収益を示す棒グラフ。

行動ヒートマップ

• GitHubスタイルのカレンダーヒートマップで、過去1年間のケンネルの日々の活動状況を示します。色が濃い四角 = その日に記録されたイベントが多い。

パート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. ステップ1 ― 出産記録: 実際の出産日、雄雌の仔犬数を入力し、自動生成された名前を確認できます。
4. ステップ2 ― 確認: 概要を確認して「送信」をクリックすると、システムは各仔犬の個別記録を作成し、親を割り当て、出生イベントを記録し、ステータスを「アクティブ」に設定します。

パート7: コンタクト管理（購入者＆ウェイティングリスト）

連絡先の追加

1. 移動 TruePaws → コンタクト.
2. クリック 新しいコンタクトを追加.
3. フォームに記入：

フィールド	必須ですか？	説明
名	はい	購入者の名
姓	いいえ	購入者の姓
メールアドレス	はい	購入者のメールアドレス
電話番号	いいえ	電話番号
住所	いいえ	郵送先住所
ステータス	いいえ	ウエイトリスト、予約済み、購入者、または非アクティブ
備考	いいえ	この連絡先に関するプライベートなメモ

4. クリック コンタクトを保存.

連絡先リストの機能

• ステータスでフィルタ ― 待機リスト、予約済み、購入者、非アクティブなコンタクトのみ表示
• CSVにエクスポート ― すべてのコンタクトをスプレッドシートファイルとしてダウンロード（メールマーケティングツール用）

パート8: サイト上で動物を表示する（ショートコード）

ショートコードは、TruePawsのコンテンツを公開ウェブサイトに表示するためにWordPressのページや投稿に貼り付ける特別なコードです。

1. 単一の動物を表示

[truepaws_animal id="7"]

（123を実際の動物のID番号に置き換えてください）

追加可能な設定オプション：

パラメータ	機能	デフォルト
contact_url="https://..."	「ブリーダーに連絡」ボタンのカスタムリンク	設定URL
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では2種類のプロフェッショナルなPDF文書を生成できます：

1. 血統証明書

どの動物のプロファイルページからも生成可能です。動物の名前、登録詳細、3世代の血統図、ブリーダー名が含まれます。

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 問い合わせフォームのパラメーターで特定の動物のリクエストを追跡。
• ブリーダー間で共有する動物には「共同所有」ステータスを使用。