코드가 깨진 근본적인 이유는 타이포그래피 충돌 때문입니다. 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 – 플러그인 업로드

WordPress 관리자 대시보드에 로그인하세요(일반적으로 yourwebsite.com/wp-admin).
왼쪽 사이드바에서 플러그인 → 새로 추가.
상단의 플러그인 업로드 버튼을 클릭하세요.
클릭 파일 선택 를 선택하고 truepaws.zip 받은 파일을 선택하세요.
클릭 지금 설치 완료될 때까지 기다리세요.

단계 2 – 플러그인 활성화

설치가 완료된 후, 플러그인 활성화 버튼을 클릭하세요.
플러그인은 필요한 모든 데이터베이스 테이블을 자동으로 생성합니다.
새로운 트루포즈 메뉴 항목이 WordPress 사이드바에 나타납니다.

파트 3: 초기 설정 (먼저 이걸 하세요!)

플러그인을 활성화한 후 다음으로 이동하세요: TruePaws → 설정 워드프레스 사이드바에서. 상단에 여러 탭이 표시됩니다. 각 탭을 순서대로 진행하세요.

탭 1: 일반 설정

설정	기능 설명	예시
기본 동물 종류	주로 번식하는 동물의 종류. 옵션: 개, 고양이, 말, 토끼, 기니피그, 페럿, 새.	개
번식자 접두사	분만으로 태어난 새끼들에게 자동으로 이름을 지을 때 사용하는 짧은 코드(최대 5자).	TP
임신 기간 — 개	강아지 임신 기간은 며칠인가요? 기본값은 63일입니다. 다른 값을 알고 있는 경우에만 변경하세요.	63
임신 기간 — 고양이	고양이 임신 기간은 며칠인가요? 기본값은 65일입니다.	65
급여 방법 안내	새로운 구매자에게 전달하는 문서에 표시될 내용입니다. 동물이 먹는 사료, 급여 빈도, 특별한 주의사항 등을 작성하세요.	“로얄 캐닌 강아지 사료로 하루 3회 급여…”
Gemini API 키	AI 기능을 사용하려면 Google Gemini API 키를 여기에 붙여넣으세요. AI 기능을 원하지 않으면 빈칸으로 두세요.	(귀하의 키)
웹훅 URL	Zapier나 Make를 사용하는 경우 웹훅 URL을 여기에 붙여넣으세요. 사용하지 않으면 빈칸으로 두세요.	(귀하의 웹훅 URL)

클릭 설정 저장 완료 시.

탭 2: 브리더 정보

귀하의 전문적인 세부 정보를 입력하세요. 이 정보는 생성된 PDF(혈통증명서, 인수 문서)에 표시됩니다.

필드	입력 내용
브리더 이름	브리더 본인의 전체 이름
사업체명	켄넬이나 캐터리 이름
면허 번호	브리딩 면허 번호(해당되는 경우)
전화번호	사업용 전화번호
이메일	사업용 이메일 주소

클릭 설정 저장 완료 시.

탭 3: 품종

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

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

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

탭 4: 커뮤니케이션

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

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

클릭 설정 저장 완료 시.

탭 5: 판매 보고서

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

총 수익
총 판매 수
평균 판매 가격
월별 세부 내역 테이블
상위 구매자 테이블

파트 4: 대시보드

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

통계 카드

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

빠른 실행

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

시작하기 체크리스트

첫 설정을 안내하는 유용한 체크리스트.

최근 이벤트

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

차트

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

활동 히트맵

지난 1년간 켄널 활동량을 보여주는 GitHub 스타일의 캘린더 히트맵. 어두운 사각형일수록 해당 날짜에 더 많은 이벤트가 기록되었음을 나타냅니다.

파트 5: 동물 추가 및 관리

새 동물 추가 방법

이동하기 TruePaws → 동물 관리 (또는 대시보드에서 '동물 추가' 클릭).
상단의 새 동물 추가 버튼을 클릭하세요.
양식 작성:

필드	필수인가요?	설명
이름	예	동물의 공식 등록명
애칭	아니요	집에서 실제로 부르는 이름
등록 번호	아니요	견종 협회 공식 등록 번호
마이크로칩 ID	아니요	마이크로칩 번호 (고유한 값이어야 함)
견종	아니요	견종 목록에서 선택
성별	예	수컷 또는 암컷
부견(아버지)	아니요	시스템에 등록된 수컷 동물 중 선택
모견(어머니)	아니요	시스템에 등록된 암컷 동물 중 선택
출생일	아니요	동물의 출생일
상태	아니요	활동 중, 은퇴, 판매됨, 사망 또는 공동 소유 (기본값: 활동 중)
색상/무늬	아니요	동물의 외형을 설명해주세요
설명	아니요	동물에 대한 추가적인 참고 사항
대표 이미지	아니요	클릭하여 WordPress 미디어 라이브러리를 열고 사진을 선택하세요

클릭 동물 저장.

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

동물 프로필 페이지

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

정보 보기

입력한 모든 세부 정보와 상태 배지(예: 초록색 '활동 중', 파란색 '판매 완료')를 확인하세요.
특정 이미지가 크게 표시되며, 사진이 업로드되지 않은 경우 대체 실루엣이 보입니다.

사진 갤러리

'사진 추가'를 클릭해 여러 장의 사진을 업로드하세요.
사진을 드래그 앤 드롭하여 순서를 재배치하세요.
사진을 클릭해 특정 이미지로 설정하세요.
더 이상 필요하지 않은 사진은 삭제하세요.

타임라인 & 이벤트

타임라인은 이 동물에게 일어난 모든 일의 연대기적 기록을 보여줍니다. 새 이벤트를 추가하려면:

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

계보 트리

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

체중 성장 차트

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

AI 기능 (Gemini API 키 필요)

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

동물 판매

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

단축코드 복사

프로필 하단에

Animal not found.

와 같은 짧은 코드가 표시됩니다. 클릭하여 복사할 수 있습니다. 이 코드를 워드프레스 페이지나 포스트에 붙여넣어 공개 웹사이트에서 이 동물의 프로필을 표시할 수 있습니다.

파트 6: 번식 & 새끼 관리

새 교배 기록

이동하기 TruePaws → 출산.
클릭 새 교배 기록.
양식 작성:

필드	필수인가요?	설명
부견(아버지)	예	당신의 동물 중 수컷을 선택하세요
모견(어머니)	예	당신의 동물 중 암컷을 선택하세요
교배 일자	예	교배가 이루어진 날짜
방법	아니요	자연 교배 또는 인공 수정 (AI)
참고 사항	아니요	교배에 대한 참고 사항

클릭 저장시스템이 설정한 임신 기간을 기반으로 예상 출산일을 자동으로 계산합니다.

임신 추적

각 활성 리터에는 임신 추적기 카드가 표시됩니다:

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

출생 기록 (분만)

이동하기 TruePaws → 출산.
출산 기록을 찾아 클릭하세요. 새끼 분양.
1단계 — 출산 기록: 실제 출산 일자, 수컷/암컷 새끼 수를 입력하고 자동 생성된 이름을 미리 확인하세요.
2단계 — 확인: 요약을 확인하고 제출을 클릭하세요. 시스템은 각 새끼에 대한 개별 기록을 자동으로 생성하고, 부모를 지정하며, 출생 이벤트를 기록하고, 상태를 '활성'으로 설정합니다.

파트 7: 연락처 관리 (구매자 & 대기자 명단)

연락처 추가

이동하기 TruePaws → 연락처.
클릭 새 연락처 추가.
양식 작성:

필드	필수인가요?	설명
이름	예	구매자의 이름
성	아니요	구매자 성
이메일	예	구매자 이메일 주소
전화번호	아니요	전화번호
주소	아니요	우편 주소
상태	아니요	대기자, 예약자, 구매자 또는 비활성
참고 사항	아니요	이 연락처에 대한 비공개 메모

클릭 연락처 저장.

연락처 목록 기능

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

파트 8: 웹사이트에 동물 표시하기 (숏코드)

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

1. 단일 동물 표시

[truepaws_animal id="7"]


            
                
                                                                                

                
                    Bailey
                                            Sold
                                                            
                        Breed: Golden Retriever
                        Sex: Female
                                                    Born: February 17, 2026
                                                                            Registration: H13-ZZ-AB-2231
                                                                            Microchip: 250269123456789
                                            
                
            

                            
                    Photos
                    
                                                
                                                
                                                
                                                
                                            
                    
                        
                        
                        
                        
                    
                    
                
            
                            
                    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 / Contact

(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
                                            Sold
                                                            
                        Breed: Golden Retriever
                        Sex: Female
                                                    Born: February 17, 2026
                                                                            Registration: H13-ZZ-AB-2231
                                                                            Microchip: 250269123456789
                                            
                
            

                            
                    Photos
                    
                                                
                                                
                                                
                                                
                                            
                    
                        
                        
                        
                        
                    
                    
                
            
                            
                    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
                
                                    
                
                
                    
                        First Name *
                        
                    
                    
                        Last Name
                        
                    
                

                
                    Email *
                    
                

                
                    Phone
                    
                

                
                    Message *

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
                            
                                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
                
                
                
                    
                        First Name *
                        
                    
                    
                        Last Name
                        
                    
                

                
                    Email *
                    
                

                
                    Phone
                    
                

                
                    Message *

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

선택적 설정:

매개변수	기능 설명	기본값
`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: 권장 작업流程 (단계별)

첫 설정

플러그인을 설치하고 활성화하세요.
설정으로 이동하여 모든 탭을填写하세요.
사용자 정의 품종을 추가하세요.

데이터베이스 구축

먼저 모든 번식 가능한 성견(수컷과 암컷)을 추가하세요.
사진을 업로드하고 등록 데이터를 입력하세요.
혈통 트리를 구축하기 위해 부모 관계를 설정하세요.
각 동물의 타임라인을 구축하기 위해 역사적 이벤트를 추가하세요.

일상적인 사용

교배가 발생하면 새끼 탭에 기록하세요.
임신을 추적하고 출산이 발생하면 Whelping Wizard를 사용하세요.
새끼들이 자람에 따라 프로필을 업데이트하세요.
구매자를 연락처 목록에 추가하세요.

판매

동물이 판매되면 프로필에서 판매/예약 기능을 사용하세요.
Handover PDF를 생성하세요.
판매 보고서를 모니터링하세요.

공식 웹사이트

"분양 가능 강아지" 페이지를 생성하려면: truepaws_available_puppies 숏코드
개별 페이지 생성에 사용 truepaws_animal id="..." 숏코드
추가 truepaws_inquiry_form 연락처 페이지에 숏코드를 추가하세요.

파트 12: 팁 & 트릭

대시보드의 활동 히트맵을 사용하여 기록 관리의 공백을 확인하세요.
정기적으로 연락처를 CSV로 내보내 메일링 리스트를 최신 상태로 유지하세요.
AI 마케팅 바이오는 리스팅 작성을 시간을 절약해줍니다.
매주 강아지 체중을 기록하고 성장 차트를 사용하여 문제를 조기에 발견하세요.
사용 animal_id 문의 양식에 파라미터를 사용하여 특정 동물 요청을 추적하세요.
번식가 간 공유 동물에는 "공동 소유" 상태를 사용하세요.