A razão pela qual o seu código quebrou é um conflito tipográfico fundamental. Ferramentas de IA e processadores de texto frequentemente geram "aspas inteligentes" (aspas curvadas como “ e ”). Shortcodes do WordPress e linguagens de programação exigem estritamente "aspas retas" (como " e '). Quando o Gutenberg deteta aspas curvadas dentro de um shortcode, falha ao interpretá-lo como código e interrompe a renderização.

Além disso, a sua ação de copiar e colar destruiu completamente as tabelas na documentação, transformando-as em blocos de texto ilegíveis. Copiar e colar texto bruto sem atenção degrada dados estruturais.

Limpei o seu texto. Converti toda a tipografia para aspas retas, envolvi os seus shortcodes em formatação de código para que o Gutenberg não tente executá-los e reconstruí as tabelas destruídas em Markdown adequado. Se colar isto diretamente no Gutenberg, 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 é o TruePaws?

TruePaws é um sistema de gestão de canis que funciona dentro do seu site WordPress. Ajuda criadores profissionais a gerir os seus animais, monitorizar reproduções e gravidezes, lidar com contactos de compradores, gerar documentos oficiais (como certificados de pedigree e pacotes de entrega) e até exibir cachorrinhos/gatinhos 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 do 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 fornece 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 desligar deliberadamente).

3. Opcional (mas Recomendado)

• Uma chave de API do Google Gemini se você quiser usar os recursos alimentados por IA (conselhos 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 no topo. 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áximo de 5 caracteres) usado ao nomear automaticamente filhotes de ninhadas.	TP
Duração da Gestação — Cães	Quantos dias dura a gestação de um cão. 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 um gato. 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 habilitar 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 da Empresa	Nome do seu canil ou gatil
Número da Licença	Número da sua licença de criação (se aplicável)
Telefone	Número de telefone da sua empresa
Email	Endereço de e-mail da sua empresa

Clique Salvar Configurações quando terminar.

Aba 3: Raças

Aqui é onde você gerencia a lista de raças disponíveis nos menus suspensos do 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 da rua 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 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ça a registrar vendas. Você verá:

• Receita Total obtida
• Número total de Vendas
• Preço Médio de Venda
• Uma tabela de detalhamento mensal
• Uma tabela de Principais Compradores

Parte 4: O Painel de Controle

Quando você clica em TruePaws na barra lateral, você aterriza no Painel. 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 nascimento, etc.)

Ações Rápidas

• Adicionar Animal — vá diretamente para o formulário de novo animal
• Registrar Acasalamento — registrar um novo acasalamento
• 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ê através da configuração inicial.

Últimos Eventos

• Uma linha do tempo dos eventos mais recentes em todos os seus animais (vacinas, visitas ao veterinário, verificações de peso, 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 estilo GitHub mostrando quão ativo seu canil está a cada dia no ú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 da 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-proprietário (padrão é Ativo)
Cor/Marcações	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). Dessa forma, ao adicionar animais mais jovens ou filhotes, você pode selecionar seus pais nos menus suspensos.

A Página de Perfil do Animal

Após salvar, clique no nome de qualquer animal para ver sua página de perfil. Esta é a página mais avançada do plugin. Aqui está tudo que você pode fazer:

Ver Informações

• Veja todos os detalhes que você inseriu, além de um selo de status (ex.: "Ativo" em verde, "Vendido" em azul).
• A imagem destacada é exibida com destaque, com um ícone de silhueta 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 destacada.
• Exclua fotos que você não precisa mais.

Linha do Tempo e Eventos

A linha do tempo mostra um histórico cronológico de tudo 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ê inseriu relações de parentesco).
• 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 de 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 em mídias sociais.
• 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 Vender / Reservar.
2. Selecione o comprador da sua lista de contatos.
3. Insira a data da venda e o preço.
4. Adicione quaisquer notas (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: Gestão de Reprodução e 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 os 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	Inseminação Natural ou 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 gravidez.

Acompanhando a Gravidez

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

• Uma barra de progresso mostrando o estágio da gravidez.
• Indicador de trimestre (Inicial / Meio / Final).
• 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, o 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 o status deles 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
Email	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.

Funcionalidades da Lista de Contatos

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

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 "Contate o Criador"	URL das suas configurações
show_ai="true" ou "false"	Mostrar ou ocultar informações sobre 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 Ninho

[truepaws_litter id="1"]

Isso mostra as informações da ninhada, incluindo os pais, a 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 para 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 de 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 realiza uma verificação diária e envia lembretes por e-mail para:

• Lembretes de Parto: Enviado 7 dias antes da data prevista para o parto.
• Lembretes de Vacinação: Lembra-te 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. Instala e ativa o plugin.
2. Vai para Definições e preenche todos os separadores.
3. Adiciona as tuas raças personalizadas.

Construindo Seu Banco de Dados

1. Adiciona primeiro todos os teus animais adultos de reprodução (machos e fêmeas).
2. Carrega fotografias e preenche os dados de registo.
3. Define relações parentais para construir árvores genealógicas.
4. Adiciona eventos históricos para construir a linha do tempo de cada animal.

Uso Diário

1. Quando ocorre um acasalamento, regista-o em Ninhadas.
2. Acompanha as gestações e usa o Assistente de Parto quando ocorrem nascimentos.
3. Atualiza os perfis das crias à medida que crescem.
4. Adiciona compradores à lista de Contactos.

Venda

1. Quando um animal é vendido, usa a funcionalidade Vender/Reservar no seu perfil.
2. Gerar o PDF de Transferência.
3. Monitorar Relatórios de Vendas.

Site Público

1. Criar uma página de "Filhotes Disponíveis" usando: truepaws_available_puppies shortcode
2. Criar 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 e-mails atualizada.
• O Bio de Marketing por IA pode economizar seu tempo ao escrever anúncios.
• Registre pesos semanalmente para filhotes e use o gráfico de crescimento para identificar problemas precocemente.
• Use o animal_id parâmetro em formulários de consulta para rastrear pedidos de animais específicos.
• Use o status "Co-Possuído" para animais compartilhados entre criadores.