Guia do Usuário

Índice

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. Ele ajuda criadores profissionais a gerenciar seus animais, acompanhar reproduções e gestações, lidar com contatos de compradores, gerar documentos oficiais (como certificados de pedigree e pacotes de entrega) e até 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 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 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 baseados em IA (aconselhamento de cuidados, alertas de saúde, geração de biografia de marketing). Você pode obter uma gratuitamente em Google AI Studio.
  • Uma conta no Zapier ou Make se você deseja enviar notificações automatizadas para serviços externos.

Parte 2: Instalando o Plugin

Passo 1 — Enviar o Plugin

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

Passo 2 — Ativar o Plugin

  1. Após a conclusão da instalação, clique no botão Ativar Plugin.
  1. O plugin criará automaticamente todas as tabelas de banco de dados necessárias.
  1. Você verá um novo item de menu TruePaws 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 WordPress. Você verá várias abas na parte superior. Trabalhe em cada uma delas.

Aba 1: Configurações Gerais

Configuração O Que Ele 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 Gravidez — Cães Quantos dias dura a gravidez 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 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 ativar os recursos de IA. Deixe em branco se não desejar 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 em Salvar Configurações quando terminar.

Aba 2: Informações do Criador

Preencha seus detalhes profissionais. Estas 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 em Salvar Configurações quando terminar.

Aba 3: Raças

Aqui 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 de e-mail 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 em 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 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

Quatro cartões no topo mostrando:

  • 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
  • Eventos Próximos — eventos que estão por vir (vacinas, datas de parto, etc.)

Ações Rápidas

Três botões para as tarefas mais comuns:

  • Adicionar Animal — vá diretamente 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

Uma lista de verificação útil que guia você na configuração inicial.

Eventos Recentes

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 no estilo GitHub mostrando o 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. Vá para TruePaws → Animais (ou clique em “Adicionar Animal” no Painel).
  1. Clique no botão Adicionar Novo Animal.
  1. 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 chama 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 de nascimento do animal
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 em Destaque Não Clique para abrir a Biblioteca de Mídia do WordPress e selecionar uma foto
  1. Clique em Salvar Animal.
> Dica para configuração inicial: Comece adicionando seus animais adultos de reprodução (machos e fêmeas) primeiro. Dessa forma, quando você adicionar animais mais jovens ou filhotes, poderá 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 rica em 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 um contorno 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 e 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 botão Adicionar Evento.
  1. Escolha o tipo de evento:
  • Nascimento — registro de nascimento
  • Vacina — vacinação administrada
  • Cio — ciclo de cio observado
  • Acasalamento — evento de reprodução
  • Ninhada — deu à luz
  • Peso — medição de peso
  • Consulta Veterinária — consulta veterinária
  • Nota — nota geral
  1. Insira a data e um título/descrição.
  1. Para eventos de peso, insira o valor do peso.
  1. Clique em Salvar.
Os eventos aparecem na linha do tempo ordenados por data, com ícones indicando o tipo.

Árvore Genealógica

  • Exibe uma árvore genealógica de 3 gerações mostrando pais, avós e bisavós.
  • Isso só funciona se você tiver inserido relações de parentesco para seus animais.
  • Clique em Baixar PDF de Pedigree para gerar um certificado de pedigree imprimível.

Gráfico de Crescimento de Peso

  • Se você registrou eventos de peso, um gráfico de linha aparecerá mostrando o peso do animal ao longo do tempo.
  • Exibe o peso atual e o ganho total de peso.

Recursos de IA (requer chave de API Gemini)

Três botões com IA aparecem no perfil:

  • Conselhos de Cuidados com IA — gera recomendações de cuidados personalizadas com base na raça, idade e histórico do animal. Os resultados são armazenados em cache por 30 dias.
  • 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.

Venda de um Animal

  1. No perfil do animal, clique em Vender / Reservar.
  1. Selecione o comprador da sua lista de contatos.
  1. Insira a data da venda e o preço.
  1. Adicione quaisquer observações (opcional).
  1. Clique em Confirmar Venda.
  1. O status do animal muda para "Vendido".
  1. Agora você pode clicar em Gerar PDF de Entrega para criar um documento profissional de entrega contendo as informações do animal, histórico de saúde, prévia da linhagem, instruções de cuidados e seus detalhes como criador.

Copiar Shortcode

No final do perfil, você verá um shortcode como 
Animal não encontrado.
. Clique para copiá-lo. Você pode colar isso em qualquer página ou post do WordPress para exibir o perfil deste animal no seu site público.

Parte 6: Criação & Gerenciamento de Ninhadas

Registrando um Novo Acasalamento

  1. Vá para TruePaws → Ninhadas.
  1. Clique em Registrar Novo Acasalamento.
  1. 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 Inseminação Natural ou Artificial (IA)
Notas Não Quaisquer observações sobre o acasalamento
  1. Clique em Salvar.
  1. O sistema calcula automaticamente a data prevista do parto com base nas suas configurações de duração da gestação (padrão: 63 dias para cães, 65 para gatos).

Acompanhamento da Gravidez

Na página de Ninhadas, cada ninhada ativa (pendente) mostra um cartão de Rastreador de Gravidez com:

  • Uma barra de progresso mostrando o estágio da gestação.
  • Indicador de trimestre (Inicial / Meio / Final).
  • Dias restantes até o parto esperado.
  • Marcos futuros, como:
  • Implantação
  • Batimento cardíaco detectável
  • Período para ultrassom
  • Período seguro para raio-X
  • Comportamento de nidificação esperado

Registrando o Nascimento (Parto)

Quando a ninhada nascer:
  1. Vá para TruePaws → Ninhadas.
  1. Encontre a ninhada e clique em Parir Ninhada.
  1. O Assistente de Parto é aberto. Siga os passos:
Passo 1 — Registrar o Nascimento:

  • Insira a data real do parto.
  • Insira o número de filhotes machos.
  • Insira o número de filhotes fêmeas.
  • Visualize os nomes gerados automaticamente (ex.: “TP24AB Filhote 1”, “TP24AB Filhote 2”).
Passo 2 — Confirmação:

  • Revise o resumo.
  • Clique em Enviar.
O sistema irá automaticamente:

  • Crie registros individuais para cada filhote.
  • Defina os pais (macho e fêmea) automaticamente.
  • Registre um evento de “nascimento” em cada um.
  • Defina todos como status “Ativo”.
  • Atribua nomes gerados automaticamente usando seu prefixo de criador.
Você pode então ir ao perfil de cada filhote para atualizar o nome, adicionar fotos, registrar vacinas, etc.

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

Adicionando um Contato

  1. Vá para TruePaws → Contatos.
  1. Clique em Adicionar Novo Contato.
  1. 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 observações privadas sobre este contato
  1. Clique em Salvar Contato.

Recursos da Lista de Contatos

  • Filtrar por status — use o menu suspenso para mostrar apenas contatos em Lista de Espera, Reservados, Compradores ou Inativos.
  • Exportar para CSV — clique no botão de exportação para baixar todos os contatos como um arquivo de planilha. Isso é útil para importar em ferramentas de marketing por e-mail como Mailchimp.

Página de Perfil de Contato

Clique em qualquer contato para ver o perfil completo:

  • Informações de contato e endereço.
  • Perguntou Sobre — mostra quais animais esta pessoa perguntou (a partir do formulário de consulta do seu site).
  • Animais Comprados — lista todos os animais que você vendeu para esta pessoa.
  • Botões de ação rápida para Enviar E-mail, Ligar ou Ver Animais Disponíveis.

Parte 8: Exibindo Animais no Seu Site (Shortcodes)

Shortcodes são códigos especiais que você cola em páginas ou posts do WordPress para exibir conteúdo do TruePaws no seu site público. Aqui estão todos os shortcodes disponíveis:

1. Exibir um Único Animal

 
 
 
 <code>
ID do animal inválido.
 
Substitua 123 pelo número de ID real do animal (mostrado na página do perfil do animal).
Configurações opcionais que você pode adicionar:
Parâmetro O Que Ele 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 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:
 
 

2. Exibir uma Ninhada

 
 
Isso mostra as informações da ninhada, incluindo os pais, a data de nascimento e uma grade de filhotes disponíveis com suas fotos e selos de status, além de um botão "Contatar o Criador".

3. Exibir Todos os Filhotes Disponíveis

 
 
 
Isso mostra uma grade de todos os animais com status "Ativo" — perfeito para uma página de "Filhotes Disponíveis".
Configurações opcionais:
Parâmetro O Que Ele 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:
 
 
 
 
 

4. Exibir um Formulário de Consulta

 
 
 
 
 
Isso exibe um formulário de contato que os visitantes podem preencher para consultar sobre seus animais. As submissões são salvas na sua lista de Contatos.
Configurações opcionais:
Parâmetro O Que Ele Faz Padrão
animal_id=”123” Vincular a consulta a um animal específico (nenhum)
Interessado? Entre em Contato! Título do formulário personalizado Enviar uma Consulta
O formulário coleta:

  • Primeiro Nome (obrigatório)
  • Sobrenome
  • E-mail (obrigatório)
  • Telefone
  • Mensagem (obrigatório)

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 clicando em Baixar Pedigree PDF.
  • Contém o nome do animal, número de registro, ID do microchip, raça, sexo, data de nascimento e uma árvore genealógica de 3 gerações.
  • Inclui o nome do criador e a data de geração.

2. Pacote de Entrega

  • Gerado a partir do perfil de um animal vendido ao clicar em Gerar PDF de Entrega.
  • Contém:
  • Detalhes do animal (nome, raça, sexo, data de nascimento, registro, microchip, pais)
  • Pré-visualização da árvore genealógica
  • Histórico de saúde completo (vacinas, visitas ao veterinário, etc.)
  • Suas instruções de alimentação/cuidados (das Configurações)
  • Recomendações gerais de cuidados
  • Seção de contrato e termos
  • Suas informações de criador no rodapé
> Observação: Para a melhor qualidade de PDF, peça ao seu provedor de hospedagem para garantir que a biblioteca PHP TCPDF ou Dompdf esteja instalada. Se nenhuma estiver disponível, o TruePaws gerará uma página HTML imprimível (você pode imprimi-la em PDF usando o recurso "Imprimir para PDF" do seu navegador).

Parte 10: Notificações Automáticas 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 de parto.
  • O e-mail inclui o nome da ninhada, a data prevista e os nomes dos pais.

Lembretes de Vacinação

  • Verifica automaticamente todos os animais ativos e lembra você quando atingem as idades de marcos de vacinação:
  • 6 semanas — Primeira vacina devida
  • 9 semanas — Segunda vacina devida
  • 12 semanas — Terceira vacina devida
  • 16 semanas — Vacinação final do filhote vencida
  • 1 ano — Reforço anual vencido
  • 2 anos — Check-up de saúde bienal vencido
  • 3 anos — Check-up de saúde trienal vencido
> Importante: Esses e-mails são enviados para o endereço que você inseriu em Configurações → Informações do Criador → E-mail. Certifique-se de que isso esteja preenchido, ou você não receberá notificações.

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

Aqui está a ordem recomendada para aproveitar ao máximo o TruePaws:

Configuração Inicial

  1. Instale e ative o plugin.
  1. Vá para Configurações e preencha todas as abas (Geral, Informações do Criador, Raças, Comunicação).
  1. Adicione suas raças personalizadas se as padrão não cobrirem tudo o que você precisa.

Construindo Seu Banco de Dados

  1. Adicione primeiro todos os seus animais adultos de reprodução (machos e fêmeas).
  1. Para cada animal, faça upload de fotos e preencha os números de registro e IDs de microchip.
  1. Defina os relacionamentos parentais quando conhecidos (isso constrói suas árvores genealógicas).
  1. Adicione eventos históricos (vacinas passadas, visitas ao veterinário) para construir a linha do tempo de cada animal.

Uso Diário

  1. Quando ocorrer um acasalamento, vá para Ninhadas → Registrar Novo Acasalamento.
  1. Acompanhe a gravidez usando os cartões de Acompanhamento de Gravidez na página de Ninhadas.
  1. Quando os filhotes nascerem, use o Assistente de Parto.
  1. Atualize o perfil de cada filhote com fotos, vacinas e verificações de peso conforme eles crescem.
  1. Adicione compradores e contatos da lista de espera conforme as consultas chegarem.

Venda

  1. Quando um filhote é vendido, abra o perfil dele → clique em Vender/Reservar → vincule ao contato do comprador.
  1. Gere o PDF de Entrega para dar ao novo dono.
  1. Verifique seus Relatórios de Vendas em Configurações para acompanhar a receita.

Site Público

  1. Crie uma página chamada "Filhotes Disponíveis" e adicione 
    Disponível Sem Foto

    Filhote BR26MB 1

    Macho Raça Mista

    Da ninhada: BR26MB

    Contate-nos
    Disponível Sem Foto

    Filhote BR26MB 2

    Macho Raça Mista

    Da ninhada: BR26MB

    Contate-nos
    Disponível Sem Foto

    Filhote BR26MB 3

    Macho Raça Mista

    Da ninhada: BR26MB

    Contate-nos
    Disponível Máx

    Máx

    Macho Golden Retriever
    Contate-nos
    .
  1. Crie páginas individuais para animais especiais usando 
    ID do animal inválido.
    .
  1. Adicionar 

    Enviar uma Consulta

     à sua página de contato para que os visitantes possam entrar em contato com você.
  1. Compartilhe páginas de ninhada usando 
    ID da ninhada inválido.
    .

Parte 12: Dicas & Truques

  • Use o Mapa de Calor de Atividades no Painel para identificar lacunas no seu registro — um período de silêncio pode significar que você esqueceu de registrar eventos.
  • Exporte contatos para CSV regularmente e importe para o Mailchimp ou similar para manter sua lista de e-mails atualizada.
  • O AI Marketing Bio pode economizar seu tempo ao escrever anúncios — gere uma biografia, revise-a e cole-a em seu site ou mídia social.
  • O acompanhamento de peso é especialmente valioso para filhotes — registre os pesos semanalmente e use o gráfico de crescimento para identificar qualquer filhote que possa precisar de atenção extra.
  • O shortcode do formulário de consulta com o parâmetro animal_id permite que você crie botões de consulta específicos para cada animal, para que você saiba exatamente sobre qual animal cada pessoa está perguntando.
  • O status de Co-Proprietário é útil para animais que são compartilhados entre criadores — eles permanecem visíveis em seu sistema, mas são claramente marcados.