Il motivo per cui il tuo codice si è rotto è un conflitto tipografico fondamentale. Gli strumenti di intelligenza artificiale e i programmi di videoscrittura 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-incollare testo grezzo alla cieca degrada i dati strutturali.

Ho ripulito 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 dei canili 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 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 personale — non un blog gratuito su 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 host moderni offre 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 di Google Gemini se vuoi utilizzare le funzionalità basate sull'IA (consigli di cura, avvisi sanitari, generazione di biografie di 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 finisca.

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 di cui ha bisogno.
3. Vedrai apparire una nuova TruePaws voce di menu nella barra laterale di WordPress.

Parte 3: Configurazione Iniziale (Fai Questo Prima!)

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

Scheda 1: Impostazioni Generali

Impostazione	Funzionalità	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 (massimo 5 caratteri) utilizzato per la denominazione automatica di cuccioli/gattini delle cucciolate.	TP
Durata della Gravidanza — Cani	Quanti giorni dura la gravidanza di un cane. Il valore predefinito è 63. Modifica solo se conosci un valore diverso.	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 vuoi 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)

Clicca Salva Impostazioni quando hai finito.

Scheda 2: Informazioni Allevatore

Inserisci i tuoi dettagli professionali. Queste informazioni appaiono 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 tuo numero di licenza di allevamento (se applicabile)
Telefono	Il tuo numero di telefono aziendale
Email	Il tuo indirizzo email aziendale

Clicca Salva Impostazioni quando hai finito.

Scheda 3: Razze

Qui gestisci l'elenco delle razze disponibili nei menu a discesa del plugin. 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 di eliminazione accanto a qualsiasi razza nella lista.

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

Scheda 4: Comunicazione

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

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

Clicca Salva Impostazioni quando hai finito.

Scheda 5: Report Vendite

Questa scheda è di sola lettura: mostra le tue statistiche di vendita una volta che inizi a registrarle. Vedrai:

• Fatturato totale generato
• Numero totale di vendite
• Prezzo medio di vendita
• Una tabella riepilogativa mensile
• 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:

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

Lista di Controllo per Iniziare

• Una lista di controllo utile 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 ogni razza.
• Panoramica delle Vendite — un grafico a barre che mostra il fatturato mensile.

Mappa Termica delle Attività

• Una mappa termica stile 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" nella 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 con cui lo chiami effettivamente a casa
Numero di Registrazione	No	Numero di registrazione ufficiale del tuo registro di razza
ID Microchip	No	Il numero del microchip (deve essere univoco)
Razza	No	Seleziona dalla tua lista di 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 in cui l'animale è nato
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 la configurazione iniziale: Inizia aggiungendo prima i tuoi animali riproduttori adulti (stalloni e fattrici). In questo modo, quando aggiungi animali più giovani o cuccioli, puoi selezionare i loro genitori dai menu a tendina.

La Pagina del Profilo Animale

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

Visualizza Informazioni

• Vedi tutti i dettagli inseriti, più un badge di stato (es., "Attivo" in verde, "Venduto" in blu).
• L'immagine in evidenza viene mostrata in primo piano, con una silhouette di riserva se non è stata caricata alcuna foto.

Galleria Fotografica

• Carica più foto cliccando "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 ed 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 include genitori, nonni e bisnonni. (Funziona solo se sono state inserite le relazioni parentali).
• Clicca Scarica PDF Pedigree 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 raccomandazioni di cura personalizzate basate sulla razza, età e storia dell'animale.
• Bio Marketing AI — scrive una descrizione accattivante per il tuo sito web o gli annunci sui social media.
• Avvisi Salute AI — analizza la cronologia degli eventi e segnala potenziali problemi di salute.

Vendere un Animale

1. Nel profilo dell'animale, clicca Vendi / Prenota.
2. Seleziona l'acquirente dalla tua lista contatti.
3. Inserisci la data di vendita e il prezzo.
4. Aggiungi eventuali note (opzionale).
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 un 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: Gestione dell'Allevamento e 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	Inseminazione naturale o artificiale (IA)
Note	No	Eventuali note sull'accoppiamento

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

Monitoraggio Gravidanza

Ogni cucciolata attiva mostra una Tracciatore di Gravidanza scheda con:

• Una barra di avanzamento che mostra quanto è avanzata la gravidanza.
• Indicatore di trimestre (Inizio / Metà / Fine).
• Giorni rimanenti fino al parto previsto.
• Prossime tappe (Impianto, Battito cardiaco, Ecografia, ecc.).

Registrazione della Nascita (Parto)

1. Vai a TruePaws → Cucciolate.
2. Trova la cucciolata e clicca Cucciolata Partorita.
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.

Funzionalità 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: Visualizzazione degli Animali sul Tuo Sito Web (Shortcodes)

Gli shortcode sono codici speciali che incolli nelle pagine o negli articoli di WordPress per visualizzare i contenuti 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	Funzionalità	Predefinito
contact_url="https://..."	Link personalizzato per il pulsante "Contatta l'Allevatore"	URL delle tue impostazioni
show_ai="true" o "false"	Mostra o nascondi le informazioni sulla cura dell'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

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	Funzionalità	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 visualizza un modulo di contatto che i visitatori possono compilare per richiedere informazioni sui tuoi animali.

Impostazioni opzionali:

Parametro	Funzionalità	Predefinito
animal_id="123"	Collega la richiesta a un animale specifico	(nessuno)
title="Interested? Get in Touch!"	Titolo personalizzato del modulo	"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 i dettagli dell'animale, un'anteprima del pedigree, la storia clinica completa, le istruzioni per l'alimentazione, i consigli per la cura, il contratto/termini e le informazioni sull'allevatore.

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

Parte 10: Notifiche Email Automatiche

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

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

Importante: Queste email vengono inviate all'indirizzo inserito in Impostazioni → Informazioni 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 (stalli e fattrici).
2. Carica foto e compila 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. Tieni traccia delle gravidanze e usa la Procedura Guidata 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/Riserva sul suo profilo.
2. Genera il PDF di consegna.
3. Monitora i report 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 di contatto.

Parte 12: Suggerimenti e Trucchi

• Usa la Mappa Termica delle Attività nella Dashboard per individuare lacune nella tenuta dei registri.
• Esporta regolarmente i contatti in CSV per mantenere aggiornata la tua mailing list.
• La Bio di Marketing AI può farti risparmiare tempo nella scrittura degli annunci.
• Registra i pesi settimanalmente per i 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.