コードが壊れた理由は基本的なタイポグラフィーの衝突です。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. 新しい TruePaws メニュー項目がWordPressのサイドバーに表示されます。

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

有効化後、 TruePaws → 設定 WordPressのサイドバーにいくつかのタブが表示されます。それぞれのタブを順番に操作してください。

タブ1: 一般設定

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

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

1. 単一の動物を表示

[truepaws_animal id="7"]

(123は実際の動物のID番号に置き換えてください)

追加可能な設定項目:

パラメータ	機能	デフォルト
contact_url="https://..."	「ブリーダーに連絡」ボタンのカスタムリンク	設定URL
show_ai="true" または "false"	AIケア情報を表示または非表示	true
show_pedigree="true" または "false"	血統ツリーを表示または非表示	true
show_inquiry_form="true" または "false"	動物の下に問い合わせフォームを埋め込む	false
show_gallery="true" または "false"	写真ギャラリーを表示または非表示	true
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"	写真の表示/非表示	true

例:

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