완전한 사용자 가이드

코드가 깨진 이유는 근본적인 타이포그래피 충돌 때문입니다. AI 도구와 워드 프로세서는 종종 '스마트 따옴표'(구부러진 따옴표, 예: 그리고 )를 생성합니다. WordPress 단축 코드와 핵심 프로그래밍 언어는 엄격하게 '직선 따옴표'(예: " 그리고 ')를 요구합니다. Gutenberg이 단축 코드 괄호 안에 구부러진 따옴표를 보면 코드로 파싱하지 못하고 렌더링이 깨집니다.

또한, 복사-붙여넣기로 인해 문서의 테이블이 완전히 파괴되어 읽을 수 없는 텍스트 블록으로 평평해졌습니다. 원시 텍스트를 맹목적으로 복사-붙여넣으면 구조적 데이터가 저하됩니다.

텍스트를 정리했습니다. 모든 타이포그래피를 직선 따옴표로 변환하고, 단축 코드를 코드 형식으로 감싸 Gutenberg이 실행하지 못하도록 했으며, 파괴된 테이블을 적절한 마크다운으로 재구성했습니다. 이를 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
임신 기간 — 고양이고양이의 임신 기간(일 단위). 기본값은 입니다.65
급여 지침새 주인에게 제공하는 인계 문서에 표시될 내용입니다. 동물이 먹는 사료, 급여 횟수, 특별 지침 등을 작성하세요."하루에 3회 로얄 캐닌 강아지 사료를 급여하세요…"
Gemini API 키AI 기능을 사용하려면 여기에 Google Gemini API 키를 붙여넣으세요. AI 기능을 원하지 않으면 비워두세요.(API 키)
웹후크 URLZapier나 Make를 사용하여 자동화를 설정한 경우, 여기에 웹후크 URL을 붙여넣으세요. 그렇지 않으면 비워두세요.(웹후크 URL)

클릭 설정 저장 완료 시

탭 2: 브리더 정보

전문가 정보를 입력하세요. 이 정보는 생성된 PDF(혈통서, 인계 패킷)에 표시됩니다.

필드입력 내용
브리더 이름브리더의 본명
사업체 이름견적 또는 고양이집 이름
라이센스 번호번식 라이센스 번호 (해당되는 경우)
전화번호사업장 전화번호
이메일사업장 이메일 주소

클릭 설정 저장 완료 시

탭 3: 품종

이곳에서는 플러그인 전체의 드롭다운 메뉴에서 사용 가능한 품종 목록을 관리합니다. TruePaws는 일반적인 개 품종 20개와 고양이 품종 20개를 기본으로 제공합니다.

  • 품종을 추가하려면: 품종 이름을 텍스트 상자에 입력하고 품종 추가.
  • 견종 제거하기 목록에서 삭제하려는 품종 옆의 삭제 버튼을 클릭하세요.

팁: 현재 작업 중인 모든 품종을 추가하세요. 나중에 더 추가할 수 있습니다.

탭 4: 커뮤니케이션

우편 주소와 연락처 페이지 URL을 입력하세요. 이 정보는 공개 기능과 단축 코드에 사용됩니다.

필드입력 내용
도로명 주소견적의 도로명 주소
도시도시
주/도주 또는 도
우편번호우편번호
국가국가
연락처 / 문의 URL웹사이트 연락처 페이지의 URL ("브리더 연락" 버튼의 기본 링크로 사용됨)

클릭 설정 저장 완료 시

탭 5:판매 보고서

이 탭은 읽기 전용입니다 — 판매 기록을 시작하면 판매 통계가 표시됩니다. 다음을 확인할 수 있습니다:

  • 총 수익
  • 총 판매 건수
  • 평균 판매 가격
  • 월별 분할표
  • 상위 구매자 표

4부: 대시보드

사이드바에서 TruePaws를 클릭하면 대시보드로 이동합니다. 이곳은 홈 베이스입니다. 다음을 확인할 수 있습니다:

통계 카드

  • 총 동물 수 — 시스템 내 동물 수
  • 활동 중인 분만 — 현재 추적 중인 임신
  • 연락처 — 총 구매자 및 대기자 명단
  • 다가오는 이벤트 — 곧 있을 이벤트(예방접종, 출산 예정일 등)

빠른 작업

  • 동물 추가 — 새 동물 입력 폼으로 바로 이동
  • 교배 기록 — 새 번식 기록하기
  • 연락처 추가 — 새 구매자 또는 대기자 명단 추가

시작하기 체크리스트

  • 처음 설정 시 도움이 되는 체크리스트

최신 이벤트

  • 모든 동물의 최근 이벤트 타임라인(예방접종, 수의사 방문, 체중 체크 등).

차트

  • 견종 분포 — 각 견종별 보유 동물 수를 보여주는 도넛 차트.
  • 판매 개요 — 월별 수익을 보여주는 막대 그래프.

활동 히트맵

  • 지난 1년간 매일의 켄넬 활동량을 보여주는 GitHub 스타일의 캘린더 히트맵. 어두운 사각형은 해당 일자에 기록된 이벤트가 많음을 의미합니다.

5부: 동물 추가 및 관리

새 동물 추가 방법

  1. 이동 TruePaws → 동물 (또는 대시보드에서 "동물 추가" 클릭).
  2. 를 클릭하세요. 새 동물 추가 버튼을 클릭하세요.
  3. 양식 작성:
필드필수?설명
이름동물의 등록된/공식 이름
애칭아니오집에서 실제로 부르는 이름
등록 번호아니오브리드 레지스트리에서 발급한 공식 등록 번호
마이크로칩 ID아니오마이크로칩 번호 (고유해야 함)
품종아니오품종 목록에서 선택
성별수컷 또는 암컷
아버지 (Sire)아니오시스템에 등록된 수컷 동물 중 선택
어머니 (Dam)아니오시스템에 등록된 암컷 동물 중 선택
출생일아니오동물의 출생일
상태아니오활성, 은퇴, 판매, 사망 또는 공동 소유 (기본값: 활성)
색상/무늬아니오동물의 외모를 설명
설명아니오동물에 대한 추가 메모
대표 이미지아니오WordPress 미디어 라이브러리를 열고 사진을 선택하려면 클릭하세요
  1. 클릭 동물 저장.

첫 설정 팁: 먼저 성견(수컷과 암컷)을 추가하세요. 그런 다음 어린 개나 강아지를 추가할 때 드롭다운 메뉴에서 부모를 선택할 수 있습니다.

동물 프로필 페이지

저장 후 동물 이름을 클릭하면 프로필 페이지를 볼 수 있습니다. 이 페이지는 플러그인에서 가장 기능이 풍부한 페이지입니다. 여기서 할 수 있는 모든 작업은 다음과 같습니다:

정보 보기

  • 입력한 모든 세부 정보와 상태 배지(예: 녹색 "활성", 파란색 "판매 완료")를 확인합니다.
  • 특정 이미지가 두드러지게 표시되며, 사진이 업로드되지 않은 경우 대체 실루엣이 사용됩니다.

사진 갤러리

  • "사진 추가"를 클릭하여 여러 사진을 업로드하세요.
  • 사진을 드래그 앤 드롭하여 순서를 변경하세요.
  • 사진을 클릭하여 특정 이미지로 설정하세요.
  • 필요 없는 사진은 삭제하세요.

타임라인 및 이벤트

타임라인은 이 동물에게 일어난 모든 일을 시간순으로 보여줍니다. 새 이벤트를 추가하려면:

  1. 를 클릭하세요. 이벤트 추가 버튼을 클릭하세요.
  2. 이벤트 유형 선택: 출생, 예방접종, 발정기, 교배, 출산, 체중, 수의사 방문 또는 메모.
  3. 날짜와 제목/설명을 입력하세요.
  4. 체중 이벤트의 경우 체중 값을 입력하세요.
  5. 클릭 저장.

가계도

  • 부모, 조부모, 증조부모를 보여주는 3세대 가계도를 표시합니다. (부모 관계를 입력한 경우에만 작동합니다).
  • 클릭 혈통서 PDF 다운로드 인쇄 가능한 증명서를 생성합니다.

체중 성장 차트

  • 체중 이벤트를 기록한 경우, 동물의 체중 변화를 보여주는 선 그래프가 나타납니다.

AI 기능 (Gemini API 키 필요)

  • AI 관리 조언 — 동물의 품종, 나이, 이력을 기반으로 맞춤형 관리 권장 사항을 생성합니다.
  • AI 마케팅 소개 — 웹사이트나 소셜 미디어 목록을 위한 매력적인 설명을 작성합니다.
  • AI 건강 경고 — 이벤트 기록을 분석하고 잠재적인 건강 문제를 표시합니다.

동물 판매

  1. 동물 프로필에서 클릭하세요 판매 / 예약.
  2. 연락처 목록에서 구매자를 선택하세요.
  3. 판매 날짜와 가격을 입력하세요.
  4. 참고 사항 추가 (선택 사항).
  5. 클릭 판매 확인.
  6. 동물의 상태가 '판매됨'으로 변경됩니다.
  7. 클릭 인계 PDF 생성 전문적인 인계 문서를 생성하려면

단축코드 복사

프로필 하단에 다음과 같은 단축코드가 표시됩니다.

Animal not found.
. 클릭하여 복사하세요. 이 코드를 워드프레스 페이지나 포스트에 붙여넣으면 공개 웹사이트에 이 동물의 프로필을 표시할 수 있습니다.

6부: 번식 및 새끼 관리

새 교배 기록

  1. 이동 TruePaws → 새끼들.
  2. 클릭 새 교배 기록.
  3. 양식 작성:
필드필수?설명
아버지 (Sire)동물 중 수컷을 선택하세요
어머니 (Dam)동물 중 암컷을 선택하세요
교배 날짜교배가 발생한 날짜
방법아니오자연 교배 또는 인공 수정(AI)
메모아니오교배에 대한 메모
  1. 클릭 저장.시스템은 설정한 임신 기간을 기반으로 예상 출산일을 자동으로 계산합니다.

임신 추적

각 활성 리터는 다음과 같은 임신 추적기 카드를 표시합니다:

  • 임신 진행 상황을 보여주는 진행 표시줄.
  • 삼분기 표시기 (초기 / 중기 / 후기).
  • 예상 출산일까지 남은 일수.
  • 예정된 주요 단계(착상, 태아 심장박동, 초음파 검사 등)

출생 기록 (분만)

  1. 이동 TruePaws → 새끼들.
  2. 분만 예정 리터를 찾아 클릭하세요 분만 기록하기.
  3. 단계 1 — 출생 기록: 실제 분만 날짜, 수컷/암컷 새끼 수를 입력하고 자동 생성된 이름을 미리 볼 수 있습니다.
  4. 단계 2 — 확인: 요약을 확인한 후 제출을 클릭하세요. 시스템이 각 새끼에 대한 개별 기록을 자동으로 생성하고 부모를 할당하며 출생 이벤트를 기록한 후 상태를 '활성'으로 설정합니다.

7부: 연락처 관리 (구매자 및 대기자 명단)

연락처 추가

  1. 이동 트루포 → 연락처.
  2. 클릭 새 연락처 추가.
  3. 양식 작성:
필드필수?설명
이름구매자의 이름
아니오구매자의 성
이메일구매자의 이메일 주소
전화번호아니오전화번호
주소아니오우편 주소
상태아니오대기자, 예약자, 구매자 또는 비활성
메모아니오이 연락처에 대한 개인 메모
  1. 클릭 연락처 저장.

연락처 목록 기능

  • 상태별 필터링 — 대기 목록, 예약자, 구매자 또는 비활성 연락처만 표시합니다.
  • CSV로 내보내기 — 이메일 마케팅 도구를 위해 모든 연락처를 스프레드시트 파일로 다운로드합니다.

8부: 웹사이트에 동물 표시하기 (단축 코드)

단축코드는 워드프레스 페이지나 포스트에 붙여넣어 공개 웹사이트에 TruePaws 콘텐츠를 표시하는 특수 코드입니다.

1. 단일 동물 표시

[truepaws_animal id="7"]

Bailey

Bailey

Sold

Breed: Golden Retriever

Sex: Female

Born: February 17, 2026

Registration: H13-ZZ-AB-2231

Microchip: 250269123456789

Parents

Sire: Max
Dam: Lizzy

Description

She loves exploring the garden, chasing her favorite toys, and cuddling up after a long day of adventure. Vivamus pretium quam sed velit tempor, eget facilisis nulla sagittis. Her friendly personality and bright eyes make her a joy to everyone around. Donec ultricies, magna sed bibendum suscipit, sapien orci euismod nisl, non tempor felis nisi a justo.

Pedigree

Bailey

Sire: Max

Dam: Lizzy

(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"]

Bailey

Bailey

Sold

Breed: Golden Retriever

Sex: Female

Born: February 17, 2026

Registration: H13-ZZ-AB-2231

Microchip: 250269123456789

Parents

Sire: Max
Dam: Lizzy

Description

She loves exploring the garden, chasing her favorite toys, and cuddling up after a long day of adventure. Vivamus pretium quam sed velit tempor, eget facilisis nulla sagittis. Her friendly personality and bright eyes make her a joy to everyone around. Donec ultricies, magna sed bibendum suscipit, sapien orci euismod nisl, non tempor felis nisi a justo.

Pedigree

Bailey

Sire: Max

Dam: Lizzy

Inquire about Bailey

2. 한 배 새끼 표시

[truepaws_litter id="1"]

Litter: BR26LB

Lizzy × Bailey Born: February 12, 2026

No puppies available from this litter at this time.

이것은 부모, 출생일, 그리고 사진과 상태 배지가 있는 사용 가능한 강아지/고양이의 그리드를 포함한 리터의 정보를 보여줍니다.

3. 이용 가능한 모든 강아지/고양이 표시

[truepaws_available_puppies]

Available No Photo

BR26MB Puppy 1

Male Mixed Breed

From litter: BR26MB

Contact Us
Available No Photo

BR26MB Puppy 2

Male Mixed Breed

From litter: BR26MB

Contact Us
Available No Photo

BR26MB Puppy 3

Male Mixed Breed

From litter: BR26MB

Contact Us
Available Max

Max

Male Golden Retriever
Contact Us

이것은 '활성' 상태인 모든 동물의 그리드를 보여줍니다.

선택적 설정:

매개변수기능 소개기본값
limit="6"표시할 최대 동물 수12
breed="Golden Retriever"이 품종의 동물만 표시(모든 품종)
show_images="true" 또는 "false"사진 표시 또는 숨기기

예시:

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

No puppies available at this time.

4. 문의 양식 표시

[truepaws_inquiry_form]

Send an Inquiry

이것은 방문자가 동물에 대해 문의할 수 있는 연락처 양식을 표시합니다.

선택적 설정:

매개변수기능 소개기본값
animal_id="123"문의를 특정 동물에 연결(없음)
title="Interested? Get in Touch!"사용자 정의 양식 제목"문의 보내기"

9부: PDF 문서

TruePaws는 두 가지 유형의 전문 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 문의 양식에 매개변수를 사용해 특정 동물 요청을 추적하세요.
  • 브리더 간 공유 동물에 대해 "공동 소유" 상태를 사용하세요.