Il motivo per cui il tuo codice si è rotto è un conflitto tipografico fondamentale. Gli strumenti di intelligenza artificiale e i word processor spesso generano “virgolette intelligenti” (virgolette curve come “ e ”). Gli shortcode di WordPress e i linguaggi di programmazione di base richiedono rigorosamente “virgolette diritte” (come " e '). Quando Gutenberg vede virgolette curve all'interno di una parentesi di shortcode, non riesce a interpretarlo come codice e interrompe il rendering.

Inoltre, il tuo copia-incolla ha completamente distrutto le tabelle nella documentazione, appiattendole in blocchi di testo illeggibili. Copiare e incollare testo grezzo alla cieca degrada i dati strutturati.

Ho pulito il tuo testo. Ho convertito tutta la tipografia in virgolette diritte, ho racchiuso i tuoi shortcode in formattazione di codice in modo che Gutenberg non tenti di eseguirli e ho ricostruito le tue tabelle distrutte in un corretto Markdown. Se incolli direttamente questo in Gutenberg, dovrebbe generare automaticamente le intestazioni, le tabelle e i blocchi di codice corretti.

Ecco la versione strutturalmente corretta:

---

TruePaws — Guida Utente Completa

Cos'è TruePaws?

TruePaws è un sistema di gestione di allevamenti che funziona all'interno del tuo sito WordPress. Aiuta gli allevatori professionisti a gestire i loro animali, monitorare l'allevamento e le gravidanze, gestire i contatti con gli acquirenti, generare documenti ufficiali (come certificati di pedigree e pacchetti di consegna) e persino visualizzare cuccioli/gattini disponibili sul tuo sito web pubblico.

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 5.0 o più recente di WordPress.

2. Requisiti di Hosting

• PHP 7.4 o più recente (la maggior parte degli hosting moderni offre PHP 8.0+).
• Database MySQL (standard con tutti gli hosting WordPress).
• L'API REST di WordPress deve essere abilitata (lo è per impostazione predefinita — disabilitata solo se qualcuno l'ha disattivata deliberatamente).

3. Opzionale (ma Consigliato)

• Una chiave API di 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

1. Accedi alla tua dashboard di amministrazione WordPress (di solito yourwebsite.com/wp-admin).
2. Nella barra laterale sinistra, vai su Plugin → Aggiungi nuovo.
3. Clicca il Carica Plugin pulsante in alto.
4. Clicca Scegli File e seleziona il truepaws.zip file che hai ricevuto.
5. Clicca Installa Ora e attendi che termini.

Passo 2 – Attiva il Plugin

1. Dopo il completamento dell'installazione, clicca il Attiva Plugin pulsante.
2. Il plugin creerà automaticamente tutte le tabelle del database necessarie.
3. Vedrai apparire una nuova TruePaws voce di menu nella tua sidebar di WordPress.

Parte 3: Configurazione Iniziale (Fai Questo Prima!)

Dopo l'attivazione, vai a TruePaws → Impostazioni nella barra laterale del tuo WordPress. Vedrai diverse schede nella parte superiore. Completa ciascuna di esse.

Scheda 1: Impostazioni Generali

Impostazioni	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 nominare automaticamente cuccioli/gattini delle cucciolate.	TP
Durata della Gravidanza — Cani	Quanti giorni dura la gravidanza di un cane. Il valore predefinito è 63. Modifica 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 specifiche.	"Nutri 3 volte al giorno con cibo per cuccioli Royal Canin..."
Chiave API di Gemini	Incolla qui la tua chiave API Google Gemini per abilitare le funzionalità AI. Lascia vuoto se non vuoi utilizzare le funzionalità AI.	(la tua chiave)
URL del Webhook	Se utilizzi Zapier o Make per l'automazione, incolla qui l'URL del webhook. Lascia vuoto altrimenti.	(il tuo URL webhook)

Clicca Salva Impostazioni quando hai finito.

Scheda 2: Info Allevatore

Inserisci i tuoi dettagli professionali. Queste informazioni appariranno sui PDF generati (certificati di pedigree, pacchetti di consegna).

Campo	Cosa Inserire
Nome dell'Allevatore	Il tuo nome completo come allevatore
Nome dell'Attività	Nome del tuo allevamento
Numero di licenza	Il numero della tua licenza di allevamento (se applicabile)
Telefono	Il numero di telefono della tua attività
Email	L'indirizzo email della tua attività

Clicca Salva Impostazioni quando hai finito.

Scheda 3: Razze

Qui gestisci l'elenco delle razze disponibili nei menu a tendina del plugin. TruePaws viene pre-caricato con 20 razze di cani 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 di eliminazione accanto a qualsiasi razza nell'elenco.

Suggerimento: Aggiungi tutte le razze con cui lavori ora. Potrai sempre aggiungerne altre in seguito.

Scheda 4: Comunicazione

Inserisci il tuo indirizzo postale e l'URL della pagina di contatto. Questi dettagli sono utilizzati per le funzionalità pubbliche e gli shortcode.

Campo	Cosa Inserire
Indirizzo	L'indirizzo del tuo allevamento
Città	Città
Stato/Provincia	Stato o provincia
CAP/Codice Postale	Codice postale
Paese	Paese
URL di contatto/richiesta	L'URL della pagina dei contatti del tuo sito web (utilizzato come link predefinito sui pulsanti "Contatta l'Allevatore")

Clicca Salva Impostazioni quando hai finito.

Scheda 5: Report Vendite

Questa scheda è di sola lettura — mostra le statistiche delle vendite una volta che inizierai a registrarle. Vedrai:

• Entrate totali guadagnate
• Numero totale di vendite
• Prezzo medio di vendita
• Una tabella mensile dettagliata
• Una tabella dei principali acquirenti

Parte 4: La Dashboard

Quando clicchi su TruePaws nella barra laterale, arrivi alla Dashboard. Questa è la tua base operativa. Ecco cosa vedrai:

Schede Statistiche

• Totale animali — 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 nuovo animale
• Registra accoppiamento — registra un nuovo accoppiamento
• Aggiungi contatto — aggiungi un nuovo acquirente o voce in lista d'attesa

Checklist Iniziale

• Un'utile lista di controllo che ti guida nella configurazione iniziale.

Ultimi Eventi

• Una cronologia degli eventi più recenti tra tutti i tuoi animali (vaccini, visite veterinarie, controlli del peso, ecc.).

Grafici

• Distribuzione delle Razze — un grafico a ciambella che mostra quanti animali hai per ciascuna razza.
• Panoramica delle Vendite — un grafico a barre che mostra i ricavi mensili.

Mappa Termica delle Attività

• Una mappa termica di tipo GitHub che mostra quanto è attivo il tuo allevamento ogni giorno nell'ultimo anno. Quadrati più scuri = più eventi registrati quel giorno.

Parte 5: Aggiungere e Gestire gli Animali

Come Aggiungere un Nuovo Animale

1. Vai a TruePaws → Animali (o clicca "Aggiungi Animale" nel Dashboard).
2. Clicca il Aggiungi Nuovo Animale pulsante.
3. Compila il modulo:

Campo	Obbligatorio?	Descrizione
Nome	Sì	Il nome registrato/ufficiale dell'animale
Nome di chiamata	No	Il nome che usi per chiamarli a casa
Numero di registrazione	No	Numero di registrazione ufficiale dal registro della razza
ID Microchip	No	Il numero del microchip (deve essere univoco)
Razza	No	Seleziona dalla lista delle razze
Sesso	Sì	Maschio o Femmina
Stallone (Padre)	No	Seleziona tra i maschi esistenti nel tuo sistema
Femmina (Madre)	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 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

4. Clicca Salva Animale.

Consiglio per il primo setup: Inizia aggiungendo prima i tuoi animali adulti da riproduzione (stalloni e fattrici). In questo modo, quando aggiungerai animali più giovani o cuccioli, potrai selezionare i loro genitori dai menu a discesa.

La Pagina del Profilo Animale

Dopo aver salvato, clicca sul nome di un animale per vedere la sua pagina del profilo. Questa è la pagina con più funzionalità del plugin. Ecco tutto ciò che puoi fare:

Visualizza Informazioni

• Vedi tutti i dettagli inseriti, oltre a 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 non è stata caricata alcuna foto.

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

La cronologia mostra una storia cronologica di tutto ciò che è accaduto a questo animale. Per aggiungere un nuovo evento:

1. Clicca il Aggiungi Evento pulsante.
2. Scegli il tipo di evento: Nascita, Vaccino, Calore, Accoppiamento, Parto, Peso, Visita Veterinaria o Nota.
3. Inserisci la data e un titolo/descrizione.
4. Per gli eventi di peso, inserisci il valore del peso.
5. Clicca Salva.

Albero Genealogico

• Mostra un albero genealogico di 3 generazioni che mostra genitori, nonni e bisnonni. (Funziona solo se sono state inserite le relazioni parentali).
• Clicca Scarica Pedigree PDF per generare un certificato 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.

Funzionalità AI (richiede chiave API Gemini)

• Consigli di Cura AI — genera consigli di cura personalizzati basati sulla razza, l'età e la storia dell'animale.
• Bio di Marketing AI — scrive una descrizione coinvolgente per il tuo sito web o gli annunci sui social media.
• Avvisi di Salute AI — analizza la cronologia degli eventi e segnala potenziali problemi di salute.

Vendita di un Animale

1. Sul profilo dell'animale, clicca Vendi / Prenota.
2. Seleziona l'acquirente dalla tua rubrica.
3. Inserisci la data e il prezzo della vendita.
4. Aggiungi eventuali note (opzionali).
5. Clicca Conferma vendita.
6. Lo stato dell'animale cambia in "Venduto".
7. Clicca Genera PDF di consegna per creare un documento professionale di consegna.

Copia Shortcode

In fondo al profilo, vedrai uno shortcode come

. Clicca per copiarlo. Puoi incollarlo in qualsiasi pagina o articolo di WordPress per visualizzare il profilo di questo animale sul tuo sito web pubblico.

Parte 6: Riproduzione e Gestione delle Cucciolate

Registrare un Nuovo Accoppiamento

1. Vai a TruePaws → Cucciolate.
2. Clicca Registra nuovo accoppiamento.
3. Compila il modulo:

Campo	Obbligatorio?	Descrizione
Stallone (Padre)	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	Monta naturale o inseminazione artificiale (IA)
Note	No	Qualsiasi nota riguardante l'accoppiamento

4. Clicca SalvaIl sistema calcola automaticamente la data prevista del parto in base alle tue impostazioni di durata della gravidanza.

Monitoraggio della Gravidanza

Ogni cucciolata attiva mostra una Tracciatore di Gravidanza scheda con:

• Una barra di avanzamento che mostra lo stato della gravidanza.
• Indicatore del trimestre (Inizio / Metà / Fine).
• Giorni rimanenti alla data prevista del parto.
• Prossime tappe (Impianto, Battito cardiaco, Ecografia, ecc.).

Registrazione della Nascita (Parto)

1. Vai a TruePaws → Cucciolate.
2. Trova la cucciolata e clicca Registra Cucciolata.
3. Passo 1 — Registra la Nascita: Inserisci la data effettiva del parto, il numero di cuccioli maschi/femmine e visualizza in anteprima i nomi generati automaticamente.
4. Passo 2 — Conferma: Rivedi il riepilogo e clicca su Invia. Il sistema crea automaticamente record individuali per ogni cucciolo, assegna i genitori, registra un evento di nascita e imposta il loro stato su Attivo.

Parte 7: Gestione dei Contatti (Acquirenti e Lista d'Attesa)

Aggiungere un Contatto

1. Vai a TruePaws → Contatti.
2. Clicca Aggiungi Nuovo Contatto.
3. Compila il modulo:

Campo	Obbligatorio?	Descrizione
Nome	Sì	Nome dell'acquirente
Cognome	No	Cognome dell'acquirente
Email	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

4. Clicca Salva Contatto.

Funzioni della Lista Contatti

• Filtra per stato — mostra solo contatti in Lista d'attesa, Riservati, Acquirenti o Inattivi.
• Esporta in CSV — scarica tutti i contatti come file di foglio di calcolo per strumenti di email marketing.

Parte 8: Mostrare gli Animali sul Tuo Sito Web (Shortcodes)

Gli shortcode sono codici speciali che incolli nelle pagine o articoli di WordPress per visualizzare il contenuto di TruePaws sul tuo sito web pubblico.

1. Visualizza un Singolo Animale

[truepaws_animal id="7"]

(Sostituisci 123 con il numero ID effettivo dell'animale)

Impostazioni opzionali che puoi aggiungere:

Parametro	Cosa Fa	Predefinito
contact_url="https://..."	Link personalizzato per il pulsante "Contatta l'allevatore"	Il tuo URL delle impostazioni
show_ai="true" o "false"	Mostra o nascondi le informazioni sulla cura AI	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

Esempio con opzioni:

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

2. Visualizza una Cucciolata

[truepaws_litter id="1"]

Questo mostra le informazioni della cucciolata, inclusi i genitori, la data di nascita e una griglia di cuccioli/gattini disponibili con le loro foto e badge di stato.

3. Visualizza Tutti i Cuccioli/Gattini Disponibili

[truepaws_available_puppies]

Questo mostra una griglia di tutti gli animali con stato "Attivo".

Impostazioni opzionali:

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

Esempio:

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

4. Visualizza un Modulo di Richiesta

[truepaws_inquiry_form]

Questo mostra un modulo di contatto che i visitatori possono compilare per richiedere informazioni sui tuoi animali.

Impostazioni opzionali:

Parametro	Cosa Fa	Predefinito
animal_id="123"	Collega la richiesta a un animale specifico	(nessuno)
title="Interested? Get in Touch!"	Titolo del modulo personalizzato	"Invia una richiesta"

Parte 9: Documenti PDF

TruePaws può generare due tipi di documenti PDF professionali:

1. Certificato di Pedigree

Generato dalla pagina del profilo di qualsiasi animale. Contiene il nome dell'animale, i dettagli di registrazione, un albero genealogico di 3 generazioni e il nome dell'allevatore.

2. Pacchetto di Consegna

Generato dal profilo di un animale venduto. Contiene dettagli dell'animale, anteprima del pedigree, storia clinica completa, istruzioni alimentari, raccomandazioni per la cura, contratto/termini e informazioni sull'allevatore.

Nota: Per la migliore qualità dei PDF, chiedi al tuo host web di assicurarsi che la libreria PHP TCPDF o Dompdf sia installata.

Parte 10: Notifiche Email Automatiche

TruePaws esegue un controllo giornaliero e invia promemoria via email per:

• Promemoria Parto: Inviato 7 giorni prima della data prevista del parto.
• Promemoria Vaccinazioni: Ti ricorda le tappe fondamentali (6 settimane, 9 settimane, 12 settimane, 16 settimane, 1 anno, 2 anni, 3 anni).

Importante: Queste email vengono inviate all'indirizzo inserito in Impostazioni → Info Allevatore → Email.

Parte 11: Flusso di Lavoro Consigliato (Passo dopo Passo)

Configurazione Iniziale

1. Installa e attiva il plugin.
2. Vai su Impostazioni e compila tutte le schede.
3. Aggiungi le tue razze personalizzate.

Costruzione del Tuo Database

1. Aggiungi prima tutti i tuoi animali adulti da riproduzione (stalloni e fattrici).
2. Carica fotografie e inserisci i dati di registrazione.
3. Imposta le relazioni parentali per costruire gli alberi genealogici.
4. Aggiungi eventi storici per costruire la cronologia di ogni animale.

Uso Quotidiano

1. Quando avviene un accoppiamento, registralo sotto Cucciolate.
2. Segui le gravidanze e usa il Maghetto del Parto quando avvengono le nascite.
3. Aggiorna i profili della prole man mano che cresce.
4. Aggiungi i compratori alla lista Contatti.

Vendita

1. Quando un animale viene venduto, usa la funzione Vendi/Prenota sul suo profilo.
2. Genera il PDF di consegna.
3. Monitora i rapporti di vendita.

Sito Web Pubblico

1. Crea una pagina "Cuccioli Disponibili" utilizzando: truepaws_available_puppies shortcode
2. Crea pagine individuali utilizzando truepaws_animal id="..." shortcode
3. Aggiungi truepaws_inquiry_form shortcode alla tua pagina dei contatti.

Parte 12: Suggerimenti e Trucchi

• Usa la Mappa Termica delle Attività nella Dashboard per identificare lacune nella gestione dei tuoi record.
• Esporta regolarmente i contatti in CSV per mantenere aggiornata la tua mailing list.
• La Biografia di Marketing con AI può farti risparmiare tempo nella scrittura degli annunci.
• Registra settimanalmente i pesi dei cuccioli e utilizza il grafico di crescita per individuare problemi in anticipo.
• Usa il animal_id parametro sui moduli di richiesta per tracciare richieste specifiche di animali.
• Usa lo stato "In Co-proprietà" per animali condivisi tra allevatori.