코드가 깨진 이유는 근본적인 타이포그래피 충돌 때문입니다. 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단계 – 플러그인 활성화
- 설치가 완료되면, 플러그인 활성화 버튼을 클릭하세요.
- 플러그인은 필요한 모든 데이터베이스 테이블을 자동으로 생성합니다.
- 새로운 TruePaws 메뉴 항목이 WordPress 사이드바에 나타납니다.
3부: 초기 설정 (먼저 이 작업을 수행하세요!)
활성화 후, 트루포 → 설정 워드프레스 사이드바에서 여러 탭이 상단에 표시됩니다. 각 탭을 순서대로 작업해주세요.
탭 1: 일반 설정
| 설정 | 기능 | 예시 |
| 기본 종류 | 주로 번식하는 동물의 종류. 옵션: 개, 고양이, 말, 토끼, 기니피그, 페럿, 새. | 개 |
| 브리더 접두사 | 새끼 이름을 자동으로 지을 때 사용하는 짧은 코드(최대 5자). | TP |
| 임신 기간 — 개 | 개 임신이 지속되는 일수. 기본값은 63일입니다. 다른 값을 알고 있는 경우에만 변경하세요. | 63 |
| 임신 기간 — 고양이 | 고양이 임신이 지속되는 일수. 기본값은 65일입니다. | 65 |
| 급여 지침 | 새로운 구매자에게 제공하는 인계 문서에 표시될 텍스트입니다. 동물이 무엇을 먹는지, 얼마나 자주 먹는지, 그리고 특별한 지침이 있는지 작성하세요. | “로얄 캐닌 강아지 사료로 하루에 3회 급여…” |
| 제미니 API 키 | AI 기능을 활성화하려면 여기에 Google 제미니 API 키를 붙여넣으세요. AI 기능을 원하지 않으면 비워두세요. | (귀하의 키) |
| 웹훅 URL | 자동화를 위해 Zapier나 Make를 사용한다면 여기에 웹훅 URL을 붙여넣으세요. 그렇지 않으면 비워두세요. | (귀하의 웹훅 URL) |
클릭 설정 저장 완료 시
탭 2: 브리더 정보
전문가 정보를 입력하세요. 이 정보는 생성된 PDF(혈통 증명서, 인계 문서)에 표시됩니다.
| 필드 | 입력할 내용 |
| 브리더 이름 | 브리더로서의 귀하의 전체 이름 |
| 사업체 이름 | 귀하의 견사 또는 고양이 사육장 이름 |
| 라이선스 번호 | 귀하의 사육 라이선스 번호 (해당되는 경우) |
| 전화번호 | 귀하의 비즈니스 전화번호 |
| 이메일 | 귀하의 비즈니스 이메일 주소 |
클릭 설정 저장 완료 시
탭 3: 견종
이곳에서는 플러그인 전체의 드롭다운 메뉴에서 사용 가능한 견종 목록을 관리합니다. 트루포스는 20개의 일반적인 개 견종과 20개의 일반적인 고양이 견종을 기본으로 제공합니다.
- 품종을 추가하려면: 텍스트 상자에 품종 이름을 입력하고 품종 추가.
- 품종 제거하기 목록에서 품종 옆의 삭제 버튼을 클릭하세요.
팁: 현재 작업 중인 모든 견종을 추가하세요. 나중에 언제든지 더 추가할 수 있습니다.
탭 4: 커뮤니케이션
우편 주소와 연락처 페이지 URL을 입력하세요. 이는 공개 기능과 숏코드에 사용됩니다.
| 필드 | 입력할 내용 |
| 도로명 주소 | 귀하의 견사 도로명 주소 |
| 도시 | 도시 |
| 주/도 | 주 또는 도 |
| 우편번호 | 우편번호 |
| 국가 | 국가 |
| 연락처/문의 URL | 웹사이트 연락처 페이지 URL ("브리더 연락" 버튼의 기본 링크로 사용됨) |
클릭 설정 저장 완료 시
탭 5: 판매 보고서
이 탭은 읽기 전용입니다 — 판매 기록을 시작하면 판매 통계가 표시됩니다. 다음과 같은 내용을 확인할 수 있습니다:
- 총 수익
- 총 판매 건수
- 평균 판매 가격
- 월별 분석표
- 상위 구매자 표
4부: 대시보드
사이드바에서 트루포스를 클릭하면 대시보드로 이동합니다. 이곳이 작업의 중심이 됩니다. 다음 내용을 확인할 수 있습니다:
통계 카드
- 총 동물 수 — 시스템 내 동물 수
- 활성 분만 — 현재 추적 중인 임신
- 연락처 — 총 구매자 및 대기자 명단
- 다가오는 이벤트 — 곧 다가올 이벤트 (예방접종, 분만 예정일 등)
빠른 작업
- 동물 추가 — 새 동물 등록 폼으로 바로 이동
- 교배 기록 — 새 교배 기록
- 연락처 추가 — 새 구매자 또는 대기자 명단 추가
시작하기 체크리스트
- 첫 설정을 안내하는 유용한 체크리스트
최신 이벤트
- 모든 동물의 최근 이벤트 타임라인 (예방접종, 수의사 방문, 체중 측정 등)
차트
- 견종 분포 — 각 견종별로 보유한 동물 수를 보여주는 도넛 차트.
- 판매 개요 — 월별 매출을 보여주는 막대 그래프.
활동 히트맵
- 지난 1년 동안 켄넬의 활동을 보여주는 GitHub 스타일 캘린더 히트맵. 더 어두운 사각형 = 해당 날짜에 기록된 더 많은 이벤트.
5부: 동물 추가 및 관리
새 동물 추가 방법
- 이동 TruePaws → 동물 (또는 대시보드에서 '동물 추가'를 클릭).
- 상단의 새 동물 추가 버튼을 클릭하세요.
- 양식을 작성하세요:
| 필드 | 필수입니까? | 설명 |
| 이름 | 예 | 동물의 등록/공식 이름 |
| 애칭 | 아니오 | 집에서 실제로 부르는 이름 |
| 등록 번호 | 아니오 | 품종 등록 기관의 공식 등록 번호 |
| 마이크로칩 ID | 아니오 | 마이크로칩 번호 (고유해야 함) |
| 품종 | 아니오 | 견종 목록에서 선택 |
| 성별 | 예 | 수컷 또는 암컷 |
| 아비견(아버지) | 아니오 | 시스템에 등록된 수컷 동물 중 선택 |
| 어미견(어머니) | 아니오 | 시스템에 등록된 암컷 동물 중 선택 |
| 출생일 | 아니오 | 동물이 태어난 날짜 |
| 상태 | 아니오 | 활동중, 은퇴, 판매됨, 사망, 공동소유 (기본값: 활동중) |
| 색상/무늬 | 아니오 | 동물의 외형을 설명 |
| 설명 | 아니오 | 동물에 대한 추가 참고사항 |
| 대표 이미지 | 아니오 | WordPress 미디어 라이브러리를 열고 사진을 선택하려면 클릭하세요 |
- 클릭 동물 저장.
첫 설정 팁: 먼저 성체 번식 동물(수컷과 암컷)을 추가하세요. 그런 다음 어린 동물이나 강아지를 추가할 때 드롭다운 메뉴에서 부모를 선택할 수 있습니다.
동물 프로필 페이지
저장 후 동물 이름을 클릭하면 프로필 페이지를 볼 수 있습니다. 이 페이지는 플러그인에서 가장 기능이 풍부한 페이지입니다. 여기서 할 수 있는 모든 작업은 다음과 같습니다:
정보 보기
- 입력한 모든 세부 정보와 상태 배지(예: 녹색 '활성', 파란색 '판매됨')를 확인하세요.
- 대표 이미지가 눈에 띄게 표시되며, 사진이 업로드되지 않은 경우 대체 실루엣이 사용됩니다.
사진 갤러리
- '사진 추가'를 클릭하여 여러 사진을 업로드하세요.
- 사진을 드래그 앤 드롭하여 순서를 재정렬하세요.
- 사진을 클릭하여 대표 이미지로 설정하세요.
- 더 이상 필요하지 않은 사진을 삭제하세요.
타임라인 및 이벤트
타임라인은 이 동물에게 일어난 모든 일의 연대기적 역사를 보여줍니다. 새 이벤트를 추가하려면:
- 상단의 이벤트 추가 버튼을 클릭하세요.
- 이벤트 유형 선택: 출생, 예방접종, 발정, 교배, 출산, 체중, 수의사 방문 또는 메모.
- 날짜와 제목/설명을 입력하세요.
- 체중 이벤트의 경우 체중 값을 입력하세요.
- 클릭 저장.
가계도
- 부모, 조부모, 증조부모를 보여주는 3세대 가계도를 표시합니다. (부모 관계를 입력한 경우에만 작동합니다).
- 클릭 혈통 PDF 다운로드 인쇄 가능한 증명서를 생성합니다.
체중 성장 차트
- 체중 이벤트를 기록한 경우, 동물의 체중 변화를 보여주는 선형 차트가 나타납니다.
AI 기능(Gemini API 키 필요)
- AI 관리 조언 — 동물의 품종, 나이, 이력을 기반으로 맞춤형 관리 권장사항을 생성합니다.
- AI 마케팅 소개 — 웹사이트나 소셜 미디어 목록을 위한 매력적인 설명을 작성합니다.
- AI 건강 경고 — 이벤트 기록을 분석하고 잠재적인 건강 문제를 표시합니다.
동물 판매
- 동물 프로필에서 클릭하세요. 판매 / 예약.
- 연락처 목록에서 구매자를 선택하세요.
- 판매 날짜와 가격을 입력하세요.
- 메모를 추가하세요 (선택 사항).
- 클릭 판매 확인.
- 동물의 상태가 '판매됨'으로 변경됩니다.
- 클릭 인계 PDF 생성 전문적인 인계 문서를 작성하려면
짧은 코드 복사
프로필 하단에 다음과 같은 숏코드가 표시됩니다. . 클릭하여 복사하세요. 이 코드를 워드프레스 페이지나 포스트에 붙여넣어 공개 웹사이트에 이 동물의 프로필을 표시할 수 있습니다.
6부: 번식 및 새끼 관리
새 교배 기록
- 이동 TruePaws → 새끼.
- 클릭 새 교배 기록.
- 양식을 작성하세요:
| 필드 | 필수입니까? | 설명 |
| 아비견(아버지) | 예 | 동물 중에서 수컷을 선택하세요 |
| 어미견(어머니) | 예 | 동물 중에서 암컷을 선택하세요 |
| 교배 날짜 | 예 | 교배가 발생한 날짜 |
| 방법 | 아니오 | 자연 교배 또는 인공 수정(AI) |
| 메모 | 아니오 | 교배에 대한 메모 |
- 클릭 저장시스템이 임신 기간 설정에 따라 예상 출산 날짜를 자동으로 계산합니다.
임신 추적
각 활성 리터에는 임신 추적기 카드가 표시됩니다:
- 임신 진행 상황을 보여주는 진행 표시줄.
- 삼분기 표시기 (초기 / 중기 / 후기).
- 예상 출산까지 남은 일수.
- 예정된 이정표 (착상, 태아 심장박동, 초음파 등).
출생 기록 (분만)
- 이동 TruePaws → 새끼.
- 분양 그룹을 찾아 클릭하세요. 새끼 출생 기록.
- 1단계 — 출생 기록: 실제 출생일, 수컷/암컷 새끼 수를 입력하고 자동 생성된 이름을 미리 보세요.
- 2단계 — 확인: 요약을 확인하고 제출을 클릭하세요. 시스템은 각 새끼에 대한 개별 기록을 생성하고, 부모를 지정하며, 출생 이벤트를 기록하고 상태를 활성으로 설정합니다.
7부: 연락처 관리 (구매자 및 대기자 명단)
연락처 추가
- 이동 TruePaws → 연락처.
- 클릭 새 연락처 추가.
- 양식을 작성하세요:
| 필드 | 필수입니까? | 설명 |
| 이름 | 예 | 구매자의 이름 |
| 성 | 아니오 | 구매자의 성 |
| 이메일 | 예 | 구매자의 이메일 주소 |
| 전화번호 | 아니오 | 전화번호 |
| 주소 | 아니오 | 우편 주소 |
| 상태 | 아니오 | 대기자, 예약자, 구매자 또는 비활성 |
| 메모 | 아니오 | 이 연락처에 대한 개인 메모 |
- 클릭 연락처 저장.
연락처 목록 기능
- 상태별 필터 — 대기자 명단, 예약자, 구매자 또는 비활성 연락처만 표시합니다.
- CSV로 내보내기 — 이메일 마케팅 도구를 위해 모든 연락처를 스프레드시트 파일로 다운로드합니다.
8부: 웹사이트에 동물 표시하기 (단축 코드)
숏코드는 워드프레스 페이지나 포스트에 붙여넣어 공개 웹사이트에 TruePaws 콘텐츠를 표시하는 특수 코드입니다.
1. 단일 동물 표시
[truepaws_animal id="7"]
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. Bailey Sire: Max Dam: Lizzy
Bailey
Sold
Photos
Parents
Description
Pedigree
(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"]
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. Bailey Sire: Max Dam: Lizzy
Bailey
Sold
Photos
Parents
Description
Pedigree
2. 새끼 표시
[truepaws_litter id="1"]
No puppies available from this litter at this time. Litter: BR26LB
이것은 부모, 출생일, 그리고 사진과 상태 배지가 있는 이용 가능한 강아지/고양이의 그리드를 포함한 리터의 정보를 보여줍니다.
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는 두 가지 유형의 전문 PDF 문서를 생성할 수 있습니다:
1. 혈통서
모든 동물 프로필 페이지에서 생성됩니다. 동물의 이름, 등록 정보, 3세대 혈통 트리, 그리고 브리더 이름이 포함됩니다.
2. 인수 패킷
판매된 동물의 프로필에서 생성됩니다. 동물 세부 정보, 혈통 미리보기, 완전한 건강 기록, 급여 지침, 관리 권장 사항, 계약/약관, 그리고 브리더 정보가 포함됩니다.
참고: 최고의 PDF 품질을 위해 웹 호스트에게 TCPDF 또는 Dompdf PHP 라이브러리가 설치되어 있는지 확인하도록 요청하세요.
10부: 자동화된 이메일 알림
TruePaws는 매일 점검을 실행하고 다음과 같은 이메일 알림을 보냅니다:
- 출산 알림: 예상 출산일 7일 전에 발송됩니다.
- 예방접종 알림: 주요 시점(6주, 9주, 12주, 16주, 1년, 2년, 3년)에 알림을 보내드립니다.
중요: 이 이메일은 설정 → 브리더 정보 → 이메일에 입력한 주소로 전송됩니다.
11부: 권장 워크플로우 (단계별)
첫 설정
- 플러그인을 설치하고 활성화하세요.
- 설정으로 이동하여 모든 탭을 채우세요.
- 사용자 정의 품종을 추가하세요.
데이터베이스 구축
- 먼저 모든 성체 번식 동물(수컷과 암컷)을 추가하세요.
- 사진을 업로드하고 등록 데이터를 입력하세요.
- 부모 관계를 설정하여 혈통 트리를 구축하세요.
- 각 동물의 타임라인을 구축하기 위해 역사적 이벤트를 추가하세요.
일상 사용
- 교배가 발생하면 새끼 탭에 기록하세요.
- 임신을 추적하고 출산이 발생할 때 출산 마법사를 사용하세요.
- 자손이 성장함에 따라 프로필을 업데이트하세요.
- 구매자를 연락처 목록에 추가하세요.
판매
- 동물이 판매되면 프로필에서 판매/예약 기능을 사용하세요.
- 인수 PDF 생성하기
- 판매 보고서 모니터링
공개 웹사이트
- 다음을 사용하여 '분양 가능한 강아지들' 페이지 만들기:
truepaws_available_puppies단축코드 - 개별 페이지 생성하기
truepaws_animal id="..."단축코드 - 추가
truepaws_inquiry_form연락처 페이지에 단축코드 추가.
12부: 팁 & 트릭
- 대시보드의 활동 히트맵을 사용하여 기록의 공백을 확인하세요.
- 정기적으로 연락처를 CSV로 내보내 메일링 리스트를 최신 상태로 유지하세요.
- AI 마케팅 바이가 리스팅 작성을 도와 시간을 절약해줍니다.
- 강아지들의 체중을 매주 기록하고 성장 차트를 사용하여 문제를 조기에 발견하세요.
- 사용
animal_id문의 양식에 매개변수를 사용하여 특정 동물 요청을 추적하세요. - 브리더 간 공유 동물에는 '공동 소유' 상태를 사용하세요.