Indice dei Contenuti
TruePaws — Guida Utente Completa
Cos'è TruePaws?
Parte 1: Prerequisiti (Cosa Ti Serve Prima dell'Installazione)
1. Un sito WordPress
- Hai bisogno di un sito WordPress self-hosted (il tipo che installi sul tuo hosting — non un blog gratuito WordPress.com).
- È richiesta la versione di WordPress 5.0 o più recente.
2. Requisiti di hosting
- PHP 7.4 o più recente (la maggior parte degli host moderni fornisce PHP 8.0+).
- Database MySQL (standard con tutti gli host WordPress).
- L'API REST di WordPress deve essere abilitata (lo è di default — disabilitata solo se qualcuno l'ha disattivata deliberatamente).
3. Opzionale (ma consigliato)
- Una chiave API Google Gemini se vuoi utilizzare le funzionalità basate sull'IA (consigli di cura, avvisi sanitari, generazione di biografie per il marketing). Puoi ottenerne una gratuitamente da Google AI Studio.
- Un account Zapier o Make se vuoi inviare notifiche automatizzate a servizi esterni.
Parte 2: Installazione del Plugin
Passo 1 — Carica il plugin
- Accedi alla tua dashboard di amministrazione di WordPress (solitamente iltuosito.com/wp-admin).
- Nella barra laterale sinistra, vai a Plugin → Aggiungi nuovo.
- Clicca il pulsante Carica Plugin in alto.
- Clicca Scegli File e seleziona il file truepaws.zip che hai ricevuto.
- Clicca Installa Ora e attendi che il processo sia completato.
Passo 2 — Attiva il plugin
- Dopo il completamento dell'installazione, clicca il pulsante Attiva Plugin.
- Il plugin creerà automaticamente tutte le tabelle del database necessarie.
- Vedrai apparire una nuova voce di menu TruePaws nella barra laterale di WordPress.
Parte 3: Configurazione Iniziale (Fai Questo Prima!)
Scheda 1: Impostazioni generali
| Impostazione | Cosa Fa | Esempio |
|---|---|---|
| Specie Predefinita | Il tipo di animale che allevi principalmente. Opzioni: Cane, Gatto, Cavallo, Coniglio, Porcellino d'India, Furetto, Uccello. | Cane |
| Prefisso Allevatore | Un codice breve (max 5 caratteri) utilizzato per la denominazione automatica di cuccioli/gattini provenienti da cucciolate. | TP |
| Durata della Gravidanza — Cani | Quanti giorni dura la gravidanza di un cane. Il valore predefinito è 63. Modificalo solo se sai diversamente. | 63 |
| Durata della Gravidanza — Gatti | Quanti giorni dura la gravidanza di un gatto. Il valore predefinito è 65. | 65 |
| Istruzioni per l'Alimentazione | Testo che apparirà sui documenti di consegna che dai ai nuovi acquirenti. Scrivi cosa mangia l'animale, con quale frequenza e eventuali istruzioni speciali. | "Nutrire 3 volte al giorno con cibo per cuccioli Royal Canin…" |
| Chiave API Gemini | Incolla qui la tua chiave API Google Gemini per abilitare le funzionalità AI. Lascia vuoto se non desideri utilizzare le funzionalità AI. | (la tua chiave) |
| URL Webhook | Se utilizzi Zapier o Make per l'automazione, incolla qui l'URL del webhook. Lascia vuoto altrimenti. | (il tuo URL webhook) |
Scheda 2: Informazioni Allevatore
| Campo | Cosa Inserire |
|---|---|
| Nome dell'Allevatore | Il tuo nome completo come allevatore |
| Nome dell'Attività | Il nome del tuo allevamento o gattile |
| Numero di licenza | Il numero della tua licenza di allevamento (se applicabile) |
| Telefono | Il numero di telefono della tua attività |
| Il tuo indirizzo email aziendale |
Scheda 3: Razze
- TruePaws viene pre-caricato con 20 razze di cani comuni e 20 razze di gatti comuni.
- Per aggiungere una razza: Digita il nome della razza nella casella di testo e clicca Aggiungi Razza.
- Per rimuovere una razza: Clicca il pulsante elimina accanto a qualsiasi razza nella lista.
Scheda 4: Comunicazione
| Campo | Cosa Inserire |
|---|---|
| Indirizzo | Indirizzo stradale del tuo allevamento |
| Città | Città |
| Stato/Provincia | Stato o provincia |
| CAP/Codice postale | Codice postale |
| Paese | Paese |
| URL contatti / richieste | L'URL della pagina dei contatti del tuo sito web (utilizzato come link predefinito sui pulsanti "Contatta l'Allevatore") |
Scheda 5: Report di vendita
- Totale Ricavi guadagnati
- Numero totale di vendite
- Prezzo medio di vendita
- Una tabella di riepilogo mensile
- Una tabella dei principali acquirenti
Parte 4: La Dashboard
Carte statistiche
- Animali totali — quanti animali sono nel tuo sistema
- Cucciolate attive — gravidanze attualmente monitorate
- Contatti — totale acquirenti e voci in lista d'attesa
- Eventi imminenti — eventi in arrivo (vaccini, date di parto, ecc.)
Azioni Rapide
- Aggiungi animale — vai direttamente al modulo per nuovi animali
- Registra accoppiamento — registra un nuovo accoppiamento
- Aggiungi contatto — aggiungi un nuovo acquirente o voce in lista d'attesa
Lista di Controllo per Iniziare
Ultimi Eventi
Grafici
- Distribuzione delle razze — un grafico a ciambella che mostra quanti animali hai per ogni razza.
- Panoramica delle vendite — un grafico a barre che mostra il fatturato mensile.
Mappa Termica delle Attività
Parte 5: Aggiunta e Gestione degli Animali
Come aggiungere un nuovo animale
- Vai a TruePaws → Animali (o clicca “Aggiungi animale” nella Dashboard).
- Clicca il pulsante Aggiungi nuovo animale.
- Compila il modulo:
| Campo | Obbligatorio? | Descrizione |
|---|---|---|
| Nome | Sì | Il nome registrato/ufficiale dell'animale |
| Nome di chiamata | No | Il nome con cui li chiami davvero a casa |
| Numero di registrazione | No | Numero di registrazione ufficiale del tuo registro di razza |
| ID Microchip | No | Il numero del microchip (deve essere unico) |
| Razza | No | Seleziona dalla tua lista di razze |
| Sesso | Sì | Maschio o Femmina |
| Padre (Genitore maschio) | No | Seleziona tra i maschi esistenti nel tuo sistema |
| Madre (Genitore femmina) | No | Seleziona tra le femmine esistenti nel tuo sistema |
| Data di nascita | No | Data di nascita dell'animale |
| Stato | No | Attivo, Ritirato, Venduto, Deceduto o in Co-proprietà (predefinito: Attivo) |
| Colore/Marcature | No | Descrivi l'aspetto dell'animale |
| Descrizione | No | Eventuali note aggiuntive sull'animale |
| Immagine in evidenza | No | Clicca per aprire la Libreria Media di WordPress e selezionare una foto |
- Clicca Salva animale.
La pagina del profilo dell'animale
Visualizza Informazioni
- Vedi tutti i dettagli inseriti, più un badge di stato (es., “Attivo” in verde, “Venduto” in blu).
- L'immagine in evidenza viene visualizzata in modo prominente, con una silhouette di riserva se nessuna foto è stata caricata.
Galleria Fotografica
- Carica più foto cliccando su "Aggiungi Foto".
- Trascina e rilascia le foto per riordinarle.
- Clicca su una foto per impostarla come immagine in evidenza.
- Elimina le foto che non ti servono più.
Cronologia & Eventi
- Clicca sul pulsante "Aggiungi Evento".
- Scegli il tipo di evento:
- Nascita — registrazione della nascita
- Vaccino — vaccinazione somministrata
- Calore — ciclo di calore osservato
- Accoppiamento — evento di riproduzione
- Parto — ha partorito
- Peso — misurazione del peso
- Visita Veterinaria — appuntamento veterinario
- Nota — nota generale
- Inserisci la data e un titolo/descrizione.
- Per gli eventi di peso, inserisci il valore del peso.
- Clicca Salva.
Albero Genealogico
- Mostra un albero genealogico di 3 generazioni che include genitori, nonni e bisnonni.
- Funziona solo se hai inserito le relazioni parentali per i tuoi animali.
- Clicca Scarica Pedigree PDF per generare un certificato di pedigree stampabile.
Grafico della Crescita del Peso
- Se hai registrato eventi di peso, apparirà un grafico a linee che mostra il peso dell'animale nel tempo.
- Mostra il peso attuale e il peso totale guadagnato.
Funzionalità AI (richiede una chiave API Gemini)
- Consigli di Cura AI — genera raccomandazioni di cura personalizzate basate sulla razza, età e storia dell'animale. I risultati vengono memorizzati per 30 giorni.
- Bio Marketing AI — scrive una descrizione accattivante per il tuo sito web o le tue inserzioni sui social media.
- Avvisi di Salute AI — analizza la cronologia degli eventi e segnala potenziali problemi di salute.
Vendere un Animale
- Sul profilo dell'animale, clicca Vendi / Prenota.
- Seleziona l'acquirente dalla tua lista di contatti.
- Inserisci la data e il prezzo della vendita.
- Aggiungi eventuali note (opzionale).
- Clicca su Conferma Vendita.
- Lo stato dell'animale cambia in "Venduto".
- Ora puoi cliccare su Genera PDF di Consegna per creare un documento professionale di consegna contenente le informazioni dell'animale, la storia sanitaria, l'anteprima del pedigree, le istruzioni per la cura e i tuoi dettagli come allevatore.
Copia Shortcode
Animale non trovato.
. Clicca per copiarlo. Puoi incollarlo in qualsiasi pagina o post di WordPress per visualizzare il profilo di questo animale sul tuo sito web pubblico.Parte 6: Riproduzione & Gestione Cucciolate
Registrare un nuovo accoppiamento
- Vai a TruePaws → Cucciolate.
- Clicca su Registra Nuovo Accoppiamento.
- Compila il modulo:
| Campo | Obbligatorio? | Descrizione |
|---|---|---|
| Padre (Genitore maschio) | Sì | Seleziona il maschio tra i tuoi animali |
| Femmina (Madre) | Sì | Seleziona la femmina tra i tuoi animali |
| Data dell'accoppiamento | Sì | La data in cui è avvenuto l'accoppiamento |
| Metodo | No | Inseminazione Naturale o Artificiale (IA) |
| Note | No | Eventuali note sull'accoppiamento |
- Clicca Salva.
- Il sistema calcola automaticamente la data prevista del parto in base alle tue impostazioni della durata della gravidanza (predefinito: 63 giorni per i cani, 65 per i gatti).
Monitoraggio della gravidanza
- Una barra di avanzamento che mostra a che punto è la gravidanza.
- Indicatore del trimestre (Inizio / Metà / Fine).
- Giorni rimanenti fino al parto previsto.
- Prossime tappe come:
- Impianto
- Battito cardiaco rilevabile
- Finestra per l'ecografia
- Periodo sicuro per i raggi X
- Comportamento di nidificazione previsto
Registrazione della nascita (Parto)
- Vai a TruePaws → Cucciolate.
- Trova la cucciolata e clicca su Parto Cucciolata.
- Si apre la Procedura Guidata per il Parto. Segui i passaggi:
- Inserisci la data effettiva del parto.
- Inserisci il numero di cuccioli maschi/gattini maschi.
- Inserisci il numero di cuccioline femmine/gattine femmine.
- Anteprima dei nomi generati automaticamente (es., “TP24AB Cucciolo 1”, “TP24AB Cucciolo 2”).
- Rivedi il riepilogo.
- Clicca su Invia.
- Crea record individuali per ogni cucciolo/gattino.
- Imposta automaticamente i loro genitori (padre e madre).
- Registra un evento di “nascita” per ognuno.
- Imposta tutti su stato “Attivo”.
- Assegna i nomi generati automaticamente utilizzando il tuo prefisso di allevatore.
Parte 7: Gestione Contatti (Acquirenti & Lista d'Attesa)
Aggiungere un Contatto
- Vai a TruePaws → Contatti.
- Clicca su Aggiungi Nuovo Contatto.
- Compila il modulo:
| Campo | Obbligatorio? | Descrizione |
|---|---|---|
| Nome | Sì | Nome dell'acquirente |
| Cognome | No | Cognome dell'acquirente |
| Sì | Indirizzo email dell'acquirente | |
| Telefono | No | Numero di telefono |
| Indirizzo | No | Indirizzo postale |
| Stato | No | Lista d'attesa, Riservato, Acquirente o Inattivo |
| Note | No | Eventuali note private su questo contatto |
- Clicca su Salva Contatto.
Funzionalità della Lista dei Contatti
- Filtra per stato — usa il menu a tendina per mostrare solo contatti in Lista d'Attesa, Prenotati, Acquirenti o Inattivi.
- Esporta in CSV — clicca il pulsante di esportazione per scaricare tutti i contatti come file di foglio di calcolo. Utile per l'importazione in strumenti di email marketing come Mailchimp.
Pagina del Profilo del Contatto
- Informazioni di contatto e indirizzo.
- Interessato a — mostra quali animali questa persona ha chiesto informazioni (dal modulo di richiesta del tuo sito web).
- Animali Acquistati — elenca tutti gli animali che hai venduto a questa persona.
- Pulsanti di azione rapida per Inviare Email, Chiamare o Visualizzare Animali Disponibili.
Parte 8: Visualizzazione Animali sul Tuo Sito (Shortcodes)
1. Visualizza un Singolo Animale
<code>
ID animale non valido.
| Parametro | Cosa Fa | Predefinito |
|---|---|---|
| contact_url=”https://…” | Link personalizzato per il pulsante "Contatta l'Allevatore" | L'URL delle tue impostazioni |
| show_ai=”true” o ”false” | Mostra o nascondi le informazioni sulla cura IA | vero |
| show_pedigree=”true” o ”false” | Mostra o nascondi l'albero genealogico | vero |
| show_inquiry_form=”true” o ”false” | Incorpora un modulo di richiesta sotto l'animale | falso |
| show_gallery=”true” o ”false” | Mostra o nascondi la galleria fotografica | vero |
| gallery_columns=”3” | Numero di colonne per la galleria (da 2 a 6) | 4 |
2. Visualizza una Cucciolata
3. Visualizza Tutti i Cuccioli/Gattini Disponibili
| Parametro | Cosa Fa | Predefinito |
|---|---|---|
| limit=”6” | Numero massimo di animali da mostrare | 12 |
| breed=”Golden Retriever” | Mostra solo animali di questa razza | (tutte le razze) |
| show_images=”true” o ”false” | Mostra o nascondi le foto | vero |
4. Visualizza un Modulo di Richiesta
| Parametro | Cosa Fa | Predefinito |
|---|---|---|
| animal_id=”123” | Collega la richiesta a un animale specifico | (nessuno) |
| title="Interessato? Mettiti in Contatto!" | Titolo modulo personalizzato | "Invia una Richiesta" |
- Nome (obbligatorio)
- Cognome
- Email (obbligatorio)
- Telefono
- Messaggio (obbligatorio)
Parte 9: Documenti PDF
1. Certificato di Pedigree
- Generato dalla pagina del profilo di qualsiasi animale cliccando su Scarica Pedigree PDF.
- Contiene il nome dell'animale, numero di registrazione, ID microchip, razza, sesso, data di nascita e un albero genealogico di 3 generazioni.
- Include il tuo nome di allevatore e la data di generazione.
2. Pacchetto di Consegna
- Generato dal profilo di un animale venduto cliccando su Genera PDF di consegna.
- Contiene:
- Dettagli dell'animale (nome, razza, sesso, data di nascita, registrazione, microchip, genitori)
- Anteprima del pedigree
- Storico sanitario completo (vaccini, visite veterinarie, ecc.)
- Le tue istruzioni di alimentazione/cura (dalle Impostazioni)
- Raccomandazioni generali di cura
- Sezione del contratto e dei termini
- Le tue informazioni come allevatore nel piè di pagina
Parte 10: Notifiche Email Automatiche
Promemoria Parto
- Inviato 7 giorni prima della data prevista del parto.
- L'email include il nome della cucciolata, la data prevista e i nomi dei genitori.
Promemoria Vaccinazioni
- Controlla automaticamente tutti gli animali attivi e ti ricorda quando raggiungono le età delle vaccinazioni:
- 6 settimane — Prima vaccinazione dovuta
- 9 settimane — Seconda vaccinazione dovuta
- 12 settimane — Terza vaccinazione dovuta
- 16 settimane — Scadenza vaccinazione finale del cucciolo
- 1 anno — Scadenza richiamo annuale
- 2 anni — Scadenza controllo sanitario biennale
- 3 anni — Scadenza controllo sanitario triennale
Parte 11: Flusso di lavoro consigliato (Passo dopo passo)
Configurazione Iniziale
- Installa e attiva il plugin.
- Vai su Impostazioni e compila tutte le schede (Generale, Info Allevatore, Razze, Comunicazione).
- Aggiungi le tue razze personalizzate se quelle predefinite non coprono tutto ciò di cui hai bisogno.
Costruzione del Tuo Database
- Aggiungi prima tutti i tuoi animali adulti da riproduzione (stalli e fattrici).
- Per ogni animale, carica foto e inserisci i numeri di registrazione e gli ID del microchip.
- Imposta le relazioni parentali dove conosciute (questo costruisce i tuoi alberi genealogici).
- Aggiungi eventi storici (vaccinazioni passate, visite veterinarie) per costruire la cronologia di ogni animale.
Uso Quotidiano
- Quando avviene un accoppiamento, vai su Cucciolate → Registra nuovo accoppiamento.
- Segui la gravidanza utilizzando le schede del Tracker di Gravidanza nella pagina Cucciolate.
- Quando nascono cuccioli/gattini, utilizza la Procedura guidata per il parto.
- Aggiorna il profilo di ogni cucciolo con foto, vaccini e controlli del peso man mano che crescono.
- Aggiungi acquirenti e contatti in lista d'attesa man mano che arrivano le richieste.
Vendita
- Quando un cucciolo viene venduto, apri il suo profilo → clicca su Vendi/Riserva → collega al contatto dell'acquirente.
- Genera il PDF di consegna da dare al nuovo proprietario.
- Controlla i tuoi Rapporti di Vendita nelle Impostazioni per monitorare i ricavi.
Sito Web Pubblico
- Crea una pagina chiamata "Cuccioli Disponibili" e aggiungi .Nessuna FotoNessuna FotoNessuna Foto
- Crea pagine individuali per animali speciali utilizzando ID animale non valido..
- Aggiungi alla tua pagina dei contatti così i visitatori possono contattarti.
- Condividi le pagine delle cucciolate utilizzando ID cucciolata non valido..
Parte 12: Suggerimenti e trucchi
- Usa la Mappa Termica delle Attività sulla Dashboard per individuare lacune nella tenuta dei registri — un periodo di inattività potrebbe significare che hai dimenticato di registrare eventi.
- Esporta regolarmente i contatti in CSV e importali in Mailchimp o simili per mantenere aggiornata la tua mailing list.
- AI Marketing Bio può farti risparmiare tempo nella scrittura degli annunci — genera una biografia, rivedila e incollala sul tuo sito web o sui social media.
- Il monitoraggio del peso è particolarmente utile per i cuccioli — registra i pesi settimanalmente e utilizza il grafico di crescita per individuare eventuali cuccioli che potrebbero aver bisogno di attenzioni extra.
- Il shortcode del modulo di richiesta con il parametro animal_id ti permette di creare pulsanti di richiesta specifici per ogni animale, così saprai esattamente di quale animale ogni persona sta chiedendo.
- Lo stato di Co-Proprietà è utile per gli animali condivisi tra allevatori — rimangono visibili nel tuo sistema ma sono chiaramente contrassegnati.