Il motivo per cui il tuo codice si è rotto è un conflitto tipografico fondamentale. Gli strumenti di intelligenza artificiale e i programmi di elaborazione testi 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 senza criterio degrada i dati strutturali.

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 Markdown corretto. 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 i 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 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 fornisce PHP 8.0+).
• Database MySQL (standard con tutti gli host WordPress).
• L'API REST di WordPress deve essere abilitata (lo è di default — viene disabilitata solo se qualcuno l'ha disattivata deliberatamente).

3. Opzionale (ma Consigliato)

• Una chiave API Google Gemini se desideri utilizzare le funzionalità basate sull'IA (consigli sulla cura, avvisi sanitari, generazione di biografie di marketing). Puoi ottenerne una gratuitamente da Google AI Studio.
• Un account Zapier o Make se desideri 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 a 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

Impostazioni	Cosa Fa	Esempio
Specie Predefinita	Il tipo di animale che allevi principalmente. Opzioni: Cane, Gatto, Cavallo, Coniglio, Criceto, Furetto, Uccello.	Cane
Prefisso Allevatore	Un codice breve (massimo 5 caratteri) utilizzato per assegnare automaticamente nomi ai 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 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)

Clicca Salva Impostazioni quando hai finito.

Scheda 2: Informazioni sull'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'Azienda	Nome del tuo allevamento
Numero di licenza	Il numero della tua 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 nell'elenco.

Consiglio: Aggiungi tutte le razze con cui lavori ora. Puoi sempre aggiungerne altre in seguito.

Scheda 4: Comunicazione

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

Campo	Cosa Inserire
Indirizzo stradale	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 di contatto del tuo sito web (utilizzato come link predefinito sui pulsanti "Contatta l'allevatore")

Clicca Salva Impostazioni quando hai finito.

Scheda 5: Report di vendita

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

• Totale introiti guadagnati
• Numero totale di vendite
• Prezzo medio di vendita
• Una tabella mensile dettagliata
• Una tabella dei migliori 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

• 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 (vaccinazioni, 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

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 (vaccinazioni, 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 di calore stile GitHub che mostra quanto sia 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 registro della razza
ID Microchip	No	Il numero del microchip (deve essere unico)
Razza	No	Seleziona dalla lista delle tue 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-Posseduto (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 adulti da riproduzione (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 dell'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, oltre a 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 nessuna foto è stata caricata.

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 & 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 genitoriali).
• 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 personalizzate per la cura basate sulla razza, età e storia dell'animale.
• Bio Marketing AI — scrive una descrizione accattivante per il tuo sito web o per gli annunci sui social media.
• Avvisi Salute AI — analizza la cronologia degli eventi e segnala potenziali problemi di salute.

Vendere un Animale

1. Sul profilo dell'animale, clicca Vendi / Riserva.
2. Seleziona l'acquirente dalla tua lista di 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	Monta naturale o Inseminazione 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 della durata della gravidanza.

Monitoraggio della gravidanza

Ogni cucciolata attiva mostra una Tracciamento della 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, Ultrasuono, 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	Qualsiasi nota privata su questo contatto

4. Clicca Salva Contatto.

Funzionalità della lista contatti

• Filtra per stato — mostra solo contatti in lista d'attesa, prenotati, 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	Cosa Fa	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 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 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	Cosa Fa	Predefinito
animal_id="123"	Collega la richiesta a un animale specifico	(nessuno)
title="Interested? Get in Touch!"	Titolo 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 i dettagli dell'animale, un'anteprima del pedigree, la storia clinica completa, le istruzioni per l'alimentazione, le raccomandazioni per la cura, il contratto/termini e le informazioni dell'allevatore.

Nota: Per la migliore qualità 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 per i Cuccioli: Inviato 7 giorni prima della data prevista del parto.
• Promemoria per le 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 che hai 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 riproduttori adulti (stalli e fattrici).
2. Carica foto e inserisci i dati di registrazione.
3. Imposta le relazioni parentali per costruire gli alberi genealogici.
4. Aggiungi eventi storici per creare la cronologia di ogni animale.

Uso Quotidiano

1. Quando avviene un accoppiamento, registralo sotto Cucciolate.
2. Monitora le gravidanze e utilizza l'Assistente per il Parto quando nascono i cuccioli.
3. Aggiorna i profili della prole man mano che crescono.
4. Aggiungi gli acquirenti alla lista dei Contatti.

Vendita

1. Quando un animale viene venduto, utilizza 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 registrazione dei dati.
• Esporta regolarmente i contatti in CSV per mantenere aggiornata la tua mailing list.
• Il Bio 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.