コードが壊れた理由は、基本的なタイポグラフィの衝突です。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: ウェブサイトで動物を表示（ショートコード）

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

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