O motivo pelo qual seu código quebrou é um conflito tipográfico fundamental. Ferramentas de IA e processadores de texto frequentemente geram “aspas inteligentes” (aspas curvas como “ e ”). Shortcodes do WordPress e linguagens de programação principais exigem estritamente “aspas retas” (como " e '). Quando o Gutenberg encontra aspas curvas dentro de um bracket de shortcode, ele falha em analisá-lo como código e interrompe a renderização.

Além disso, seu copiar e colar destruiu completamente as tabelas na documentação, achatando-as em blocos de texto ilegíveis. Copiar e colar texto bruto sem cuidado degrada dados estruturados.

Eu limpei seu texto. Converti toda a tipografia para aspas retas, envolvi seus shortcodes em formatação de código para que o Gutenberg não tente executá-los, e reconstruí suas tabelas destruídas em Markdown adequado. Se você colar isso diretamente no Gutenberg, ele deve gerar automaticamente os cabeçalhos, tabelas e blocos de código corretos.

Aqui está a versão estruturalmente correta:

---

TruePaws — Guia Completo do Usuário

O que é TruePaws?

TruePaws é um sistema de gerenciamento de canil que funciona dentro do seu site WordPress. Ele ajuda criadores profissionais a gerenciar seus animais, rastrear reprodução e gravidezes, lidar com contatos de compradores, gerar documentos oficiais (como certificados de pedigree e pacotes de entrega) e até mesmo exibir filhotes disponíveis no seu site público.

Parte 1: Pré-requisitos (O que você precisa antes de instalar)

1. Um Site WordPress

• Você precisa de um site WordPress auto-hospedado (o tipo que você instala em sua própria hospedagem — não um blog gratuito WordPress.com).
• É necessária a versão 5.0 ou mais recente do WordPress.

2. Requisitos de Hospedagem

• PHP 7.4 ou mais recente (a maioria dos hosts modernos oferece PHP 8.0+).
• Banco de dados MySQL (padrão em todos os hosts WordPress).
• A API REST do WordPress deve estar habilitada (ela está por padrão — só é desativada se alguém a desligou deliberadamente).

3. Opcional (mas Recomendado)

• Uma chave de API do Google Gemini se você quiser usar os recursos com IA (aconselhamento de cuidados, alertas de saúde, geração de biografias de marketing). Você pode obter uma gratuitamente no Google AI Studio.
• Uma conta no Zapier ou Make se você quiser enviar notificações automatizadas para serviços externos.

Parte 2: Instalando o Plugin

Passo 1 – Carregar o Plugin

1. Faça login no painel de administração do WordPress (geralmente yourwebsite.com/wp-admin).
2. Na barra lateral esquerda, vá para Plugins → Adicionar Novo.
3. Clique no Carregar Plugin botão no topo.
4. Clique Escolher Arquivo e selecione o truepaws.zip arquivo que você recebeu.
5. Clique Instalar Agora e aguarde até que termine.

Passo 2 – Ativar o Plugin

1. Após a conclusão da instalação, clique no Ativar Plugin botão.
2. O plugin criará automaticamente todas as tabelas de banco de dados necessárias.
3. Você verá um novo TruePaws item de menu aparecer na barra lateral do WordPress.

Parte 3: Configuração Inicial (Faça isso primeiro!)

Após ativar, vá para TruePaws → Configurações na barra lateral do seu WordPress. Você verá várias abas na parte superior. Trabalhe em cada uma delas.

Aba 1: Configurações Gerais

Configuração	O Que Faz	Exemplo
Espécie Padrão	O tipo de animal que você cria principalmente. Opções: Cão, Gato, Cavalo, Coelho, Porquinho-da-índia, Furão, Pássaro.	Cão
Prefixo do Criador	Um código curto (máx. 5 caracteres) usado ao nomear automaticamente filhotes de ninhadas.	TP
Duração da Gestação — Cães	Quantos dias dura a gestação de uma cadela. O padrão é 63. Altere apenas se souber de outra forma.	63
Duração da Gestação — Gatos	Quantos dias dura a gestação de uma gata. O padrão é 65.	65
Instruções de Alimentação	Texto que aparecerá nos documentos de entrega que você fornece aos novos compradores. Escreva o que o animal come, com que frequência e quaisquer instruções especiais.	"Alimente 3 vezes ao dia com ração Royal Canin para filhotes…"
Chave da API Gemini	Cole sua chave da API Google Gemini aqui para ativar os recursos de IA. Deixe em branco se não quiser recursos de IA.	(sua chave)
URL do Webhook	Se você usa Zapier ou Make para automação, cole o URL do webhook aqui. Deixe em branco caso contrário.	(seu URL de webhook)

Clique Salvar Configurações quando terminar.

Aba 2: Informações do Criador

Preencha seus detalhes profissionais. Essas informações aparecem nos PDFs gerados (certificados de pedigree, pacotes de entrega).

Campo	O que Inserir
Nome do Criador	Seu nome completo como criador
Nome do Negócio	Nome do seu canil ou gatil
Número da Licença	Seu número de licença de criação (se aplicável)
Telefone	Seu número de telefone comercial
E-mail	Seu endereço de e-mail comercial

Clique Salvar Configurações quando terminar.

Aba 3: Raças

Aqui é onde você gerencia a lista de raças disponíveis nos menus suspensos em todo o plugin. O TruePaws vem pré-carregado com 20 raças de cães comuns e 20 raças de gatos comuns.

• Para adicionar uma raça: Digite o nome da raça na caixa de texto e clique em Adicionar Raça.
• Para remover uma raça: Clique no botão de exclusão ao lado de qualquer raça na lista.

Dica: Adicione todas as raças com as quais você trabalha agora. Você sempre pode adicionar mais depois.

Aba 4: Comunicação

Preencha seu endereço postal e a URL da página de contato. Isso é usado para recursos públicos e shortcodes.

Campo	O que Inserir
Endereço	Endereço do seu canil
Cidade	Cidade
Estado/Província	Estado ou província
CEP/Código Postal	Código postal
País	País
URL de Contato/Consulta	O URL da página de contato do seu site (usado como o link padrão nos botões "Contatar Criador")

Clique Salvar Configurações quando terminar.

Aba 5: Relatórios de Vendas

Esta aba é somente leitura — ela mostra suas estatísticas de vendas assim que você começar a registrar vendas. Você verá:

• Receita Total obtida
• Número total de vendas
• Preço médio de venda
• Uma tabela detalhada mensal
• Uma tabela dos Melhores Compradores

Parte 4: O Painel de Controle

Quando você clica em TruePaws na barra lateral, você aterrissa no Painel de Controle. Esta é a sua base. Aqui está o que você verá:

Cartões de Estatísticas

• Total de Animais — quantos animais estão no seu sistema
• Ninhadas Ativas — gestações atualmente sendo monitoradas
• Contatos — total de compradores e entradas na lista de espera
• Próximos Eventos — eventos que estão por vir (vacinas, datas de parto, etc.)

Ações Rápidas

• Adicionar Animal — vá direto para o formulário de novo animal
• Registrar Acasalamento — registrar um novo cruzamento
• Adicionar Contato — adicionar um novo comprador ou entrada na lista de espera

Lista de Verificação de Introdução

• Um checklist útil que guia você pela configuração inicial.

Eventos Recentes

• Uma linha do tempo dos eventos mais recentes de todos os seus animais (vacinas, visitas ao veterinário, pesagens, etc.).

Gráficos

• Distribuição de Raças — um gráfico de rosca mostrando quantos animais você tem de cada raça.
• Visão Geral de Vendas — um gráfico de barras mostrando a receita mensal.

Mapa de Calor de Atividades

• Um mapa de calor no estilo GitHub mostrando o quão ativo seu canil está a cada dia ao longo do último ano. Quadrados mais escuros = mais eventos registrados naquele dia.

Parte 5: Adicionando e Gerenciando Animais

Como Adicionar um Novo Animal

1. Ir para TruePaws → Animais (ou clique em "Adicionar Animal" no Painel).
2. Clique no Adicionar Novo Animal botão.
3. Preencha o formulário:

Campo	Obrigatório?	Descrição
Nome	Sim	O nome registrado/oficial do animal
Nome de Chamada	Não	O nome que você realmente usa para chamá-lo em casa
Número de Registro	Não	Número de registro oficial do seu registro de raça
ID do microchip	Não	O número do microchip (deve ser único)
Raça	Não	Selecione da sua lista de raças
Sexo	Sim	Macho ou Fêmea
Pai (Sire)	Não	Selecione entre os animais machos existentes no seu sistema
Mãe (Dam)	Não	Selecione entre os animais fêmeas existentes no seu sistema
Data de Nascimento	Não	Data em que o animal nasceu
Status	Não	Ativo, Aposentado, Vendido, Falecido ou Co-Possuído (padrão: Ativo)
Cor/Marcas	Não	Descreva a aparência do animal
Descrição	Não	Quaisquer notas adicionais sobre o animal
Imagem Destacada	Não	Clique para abrir a Biblioteca de Mídia do WordPress e selecionar uma foto

4. Clique Salvar Animal.

Dica para configuração inicial: Comece adicionando primeiro seus animais adultos de reprodução (machos e fêmeas). Assim, quando você adicionar animais mais jovens ou filhotes, poderá selecionar seus pais nos menus suspensos.

A Página de Perfil do Animal

Depois de salvar, clique no nome de qualquer animal para ver sua página de perfil. Esta é a página com mais recursos do plugin. Aqui está tudo o que você pode fazer:

Visualizar Informações

• Veja todos os detalhes que você inseriu, além de um selo de status (por exemplo, "Ativo" em verde, "Vendido" em azul).
• A imagem em destaque é exibida de forma proeminente, com uma silhueta padrão caso nenhuma foto tenha sido enviada.

Galeria de Fotos

• Envie várias fotos clicando em "Adicionar Fotos".
• Arraste e solte fotos para reordená-las.
• Clique em uma foto para defini-la como imagem em destaque.
• Exclua fotos que você não precisa mais.

Linha do Tempo & Eventos

A linha do tempo mostra um histórico cronológico de tudo o que aconteceu com este animal. Para adicionar um novo evento:

1. Clique no Adicionar Evento botão.
2. Escolha o tipo de evento: Nascimento, Vacina, Cio, Acasalamento, Ninhada, Peso, Visita ao Veterinário ou Nota.
3. Insira a data e um título/descrição.
4. Para eventos de peso, insira o valor do peso.
5. Clique Salvar.

Árvore Genealógica

• Exibe uma árvore genealógica de 3 gerações mostrando pais, avós e bisavós. (Funciona apenas se você tiver inserido relações parentais).
• Clique Baixar PDF de Pedigree para gerar um certificado imprimível.

Gráfico de Crescimento de Peso

• Se você registrou eventos de peso, um gráfico de linha aparece mostrando o peso do animal ao longo do tempo.

Recursos de IA (requer chave da API Gemini)

• Conselhos de Cuidados com IA — gera recomendações de cuidados personalizadas com base na raça, idade e histórico do animal.
• Biografia de Marketing com IA — escreve uma descrição atraente para o seu site ou listagens de mídia social.
• Alertas de Saúde com IA — analisa o histórico de eventos e sinaliza possíveis preocupações de saúde.

Vendendo um Animal

1. No perfil do animal, clique em Vender / Reservar.
2. Selecione o comprador da sua lista de contatos.
3. Insira a data da venda e o preço.
4. Adicione quaisquer observações (opcional).
5. Clique Confirmar Venda.
6. O status do animal muda para "Vendido".
7. Clique Gerar PDF de Entrega para criar um documento profissional de entrega.

Copiar Shortcode

No final do perfil, você verá um shortcode como

. Clique para copiá-lo. Você pode colar isso em qualquer página ou postagem do WordPress para exibir o perfil deste animal no seu site público.

Parte 6: Reprodução e Gestão de Ninhadas

Registrando um Novo Acasalamento

1. Ir para TruePaws → Ninhadas.
2. Clique Registrar Novo Acasalamento.
3. Preencha o formulário:

Campo	Obrigatório?	Descrição
Pai (Sire)	Sim	Selecione o macho entre seus animais
Mãe (Dam)	Sim	Selecione a fêmea entre seus animais
Data do Acasalamento	Sim	A data em que o acasalamento ocorreu
Método	Não	Natural ou Inseminação Artificial (IA)
Notas	Não	Quaisquer notas sobre o acasalamento

4. Clique SalvarO sistema calcula automaticamente a data prevista do parto com base nas suas configurações de duração da gestação.

Acompanhamento da Gestação

Cada ninhada ativa mostra um Rastreador de Gravidez cartão com:

• Uma barra de progresso mostrando o estágio da gestação.
• Indicador de trimestre (Início / Meio / Fim).
• Dias restantes até o parto esperado.
• Marcos futuros (Implantação, Batimento Cardíaco, Ultrassom, etc.).

Registrando o Nascimento (Parto)

1. Ir para TruePaws → Ninhadas.
2. Encontre a ninhada e clique Ninhada de Filhotes.
3. Passo 1 — Registrar o Nascimento: Insira a data real do parto, número de filhotes machos/fêmeas e visualize os nomes gerados automaticamente.
4. Passo 2 — Confirmação: Revise o resumo e clique em Enviar. O sistema cria automaticamente registros individuais para cada filhote, atribui os pais, registra um evento de nascimento e define seu status como Ativo.

Parte 7: Gerenciando Contatos (Compradores e Lista de Espera)

Adicionando um Contato

1. Ir para TruePaws → Contatos.
2. Clique Adicionar Novo Contato.
3. Preencha o formulário:

Campo	Obrigatório?	Descrição
Primeiro Nome	Sim	Primeiro nome do comprador
Sobrenome	Não	Sobrenome do comprador
E-mail	Sim	Endereço de e-mail do comprador
Telefone	Não	Número de telefone
Endereço	Não	Endereço postal
Status	Não	Lista de espera, Reservado, Comprador ou Inativo
Notas	Não	Quaisquer notas privadas sobre este contato

4. Clique Salvar Contato.

Recursos da Lista de Contatos

• Filtrar por status — mostrar apenas Lista de Espera, Reservados, Compradores ou contatos Inativos.
• Exportar para CSV — baixar todos os contatos como um arquivo de planilha para ferramentas de email marketing.

Parte 8: Exibindo Animais no Seu Site (Shortcodes)

Shortcodes são códigos especiais que você cola em páginas ou postagens do WordPress para exibir conteúdo do TruePaws no seu site público.

1. Exibir um Único Animal

[truepaws_animal id="7"]

(Substitua 123 pelo número de ID real do animal)

Configurações opcionais que você pode adicionar:

Parâmetro	O Que Faz	Padrão
contact_url="https://..."	Link personalizado para o botão "Contatar Criador"	URL das suas configurações
show_ai="true" ou "false"	Mostrar ou ocultar informações de cuidados com IA	verdadeiro
show_pedigree="true" ou "false"	Mostrar ou ocultar a árvore genealógica	verdadeiro
show_inquiry_form="true" ou "false"	Incorporar um formulário de consulta abaixo do animal	falso
show_gallery="true" ou "false"	Mostrar ou ocultar a galeria de fotos	verdadeiro
gallery_columns="3"	Número de colunas para a galeria (2 a 6)	4

Exemplo com opções:

[truepaws_animal id="45" show_inquiry_form="true" gallery_columns="3" show_ai="false"]

2. Exibir uma Ninhe

[truepaws_litter id="1"]

Isso mostra as informações da ninhada, incluindo os pais, data de nascimento e uma grade de filhotes/gatinhos disponíveis com suas fotos e selos de status.

3. Exibir Todos os Filhotes Disponíveis

[truepaws_available_puppies]

Isso mostra uma grade de todos os animais com status 'Ativo'.

Configurações opcionais:

Parâmetro	O Que Faz	Padrão
limit="6"	Número máximo de animais a mostrar	12
breed="Golden Retriever"	Mostrar apenas animais desta raça	(todas as raças)
show_images="true" ou "false"	Mostrar ou ocultar fotos	verdadeiro

Exemplo:

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

4. Exibir um Formulário de Consulta

[truepaws_inquiry_form]

Isso exibe um formulário de contato que os visitantes podem preencher para perguntar sobre seus animais.

Configurações opcionais:

Parâmetro	O Que Faz	Padrão
animal_id="123"	Vincular a consulta a um animal específico	(nenhum)
title="Interested? Get in Touch!"	Título personalizado do formulário	“Enviar uma Consulta”

Parte 9: Documentos PDF

O TruePaws pode gerar dois tipos de documentos PDF profissionais:

1. Certificado de Pedigree

Gerado a partir da página de perfil de qualquer animal. Contém o nome do animal, detalhes de registro, uma árvore genealógica de 3 gerações e o nome do criador.

2. Pacote de Entrega

Gerado a partir do perfil de um animal vendido. Contém detalhes do animal, prévia do pedigree, histórico completo de saúde, instruções de alimentação, recomendações de cuidados, contrato/termos e informações do criador.

Nota: Para a melhor qualidade do PDF, peça ao seu provedor de hospedagem para garantir que a biblioteca PHP TCPDF ou Dompdf esteja instalada.

Parte 10: Notificações Automatizadas por E-mail

O TruePaws executa uma verificação diária e envia lembretes por e-mail para:

• Lembretes de Parto: Enviado 7 dias antes da data prevista do parto.
• Lembretes de Vacinação: Lembra você em marcos importantes (6 semanas, 9 semanas, 12 semanas, 16 semanas, 1 ano, 2 anos, 3 anos).

Importante: Esses e-mails são enviados para o endereço que você inseriu em Configurações → Informações do Criador → E-mail.

Parte 11: Fluxo de Trabalho Recomendado (Passo a Passo)

Configuração Inicial

1. Instale e ative o plugin.
2. Vá para Configurações e preencha todas as abas.
3. Adicione suas raças personalizadas.

Construindo Seu Banco de Dados

1. Adicione primeiro todos os seus animais adultos de reprodução (machos e fêmeas).
2. Carregue fotos e preencha os dados de registro.
3. Defina relações parentais para construir árvores genealógicas.
4. Adicione eventos históricos para construir a linha do tempo de cada animal.

Uso Diário

1. Quando ocorrer um acasalamento, registre-o em Ninhegos.
2. Acompanhe as gestações e use o Assistente de Parto quando ocorrerem nascimentos.
3. Atualize os perfis dos filhotes conforme eles crescem.
4. Adicione compradores à lista de Contatos.

Venda

1. Quando um animal for vendido, use o recurso Vender/Reservar em seu perfil.
2. Gere o PDF de Entrega.
3. Monitore os Relatórios de Vendas.

Site Público

1. Crie uma página "Filhotes Disponíveis" usando: truepaws_available_puppies shortcode
2. Crie páginas individuais usando truepaws_animal id="..." shortcode
3. Adicionar truepaws_inquiry_form shortcode à sua página de contato.

Parte 12: Dicas e Truques

• Use o Mapa de Calor de Atividades no Painel para identificar lacunas no seu registro.
• Exporte contatos para CSV regularmente para manter sua lista de mailing atualizada.
• A Bio de Marketing com IA pode economizar seu tempo ao escrever anúncios.
• Registre pesos semanalmente para filhotes e use o gráfico de crescimento para detectar problemas cedo.
• Use o animal_id parâmetro em formulários de consulta para rastrear pedidos específicos de animais.
• Use o status "Co-Possuído" para animais compartilhados entre criadores.