La raison pour laquelle votre code a cassé est un conflit typographique fondamental. Les outils d'IA et les traitements de texte génèrent souvent des « guillemets intelligents » (guillemets courbes comme “ et ”). Les shortcodes WordPress et les langages de programmation de base exigent strictement des « guillemets droits » (comme " et '). Lorsque Gutenberg voit des guillemets courbes à l'intérieur d'un crochet de shortcode, il ne parvient pas à l'interpréter comme du code et casse le rendu.

De plus, votre copier-coller a entièrement détruit les tables dans la documentation, les aplatissant en blocs de texte illisibles. Copier-coller du texte brut aveuglément dégrade les données structurelles.

J'ai nettoyé votre texte. J'ai converti toute la typographie en guillemets droits, j'ai encapsulé vos shortcodes dans un formatage de code pour que Gutenberg n'essaie pas de les exécuter, et j'ai reconstruit vos tables détruites en Markdown correct. Si vous collez cela directement dans Gutenberg, il devrait générer automatiquement les titres, tables et blocs de code corrects.

Voici la version structurellement solide :

---

TruePaws — Guide complet de l'utilisateur

Qu'est-ce que TruePaws ?

TruePaws est un système de gestion de chenil qui fonctionne à l'intérieur de votre site WordPress. Il aide les éleveurs professionnels à gérer leurs animaux, à suivre la reproduction et les grossesses, à gérer les contacts des acheteurs, à générer des documents officiels (comme les certificats de pedigree et les dossiers de remise), et même à afficher les chiots/chatons disponibles sur votre site public.

Partie 1 : Prérequis (Ce dont vous avez besoin avant l'installation)

1. Un site WordPress

• Vous avez besoin d'un site WordPress auto-hébergé (le type que vous installez sur votre propre hébergement — pas un blog WordPress.com gratuit).
• WordPress version 5.0 ou plus récente est requise.

2. Exigences d'hébergement

• PHP 7.4 ou plus récent (la plupart des hébergeurs modernes fournissent PHP 8.0+).
• Base de données MySQL (standard avec tous les hébergeurs WordPress).
• L'API REST de WordPress doit être activée (elle l'est par défaut — elle n'est désactivée que si quelqu'un l'a délibérément désactivée).

3. Optionnel (mais recommandé)

• Une clé API Google Gemini si vous souhaitez utiliser les fonctionnalités alimentées par l'IA (conseils de soins, alertes de santé, génération de biographies marketing). Vous pouvez en obtenir une gratuitement sur Google AI Studio.
• Un compte Zapier ou Make si vous souhaitez envoyer des notifications automatisées à des services externes.

Partie 2 : Installation du plugin

Étape 1 – Téléverser le Plugin

1. Connectez-vous à votre tableau de bord d'administration WordPress (généralement yourwebsite.com/wp-admin).
2. Dans la barre latérale gauche, accédez à Extensions → Ajouter une nouvelle.
3. Cliquez sur le Téléverser une extension bouton en haut.
4. Cliquez Choisir un fichier et sélectionnez le truepaws.zip fichier que vous avez reçu.
5. Cliquez Installer maintenant et attendez qu'il se termine.

Étape 2 – Activer le Plugin

1. Une fois l'installation terminée, cliquez sur le Activer le plugin bouton.
2. Le plugin créera automatiquement toutes les tables de base de données dont il a besoin.
3. Vous verrez un nouvel TruePaws élément de menu apparaître dans la barre latérale de WordPress.

Partie 3 : Configuration initiale (Faites ceci en premier !)

Après activation, allez à TruePaws → Paramètres dans la barre latérale de WordPress. Vous verrez plusieurs onglets en haut. Traitez chacun d'eux.

Onglet 1 : Paramètres généraux

Paramètre	Ce que cela fait	Exemple
Espèce par défaut	Le type d'animal que vous élevez principalement. Options : Chien, Chat, Cheval, Lapin, Cochon d'Inde, Furet, Oiseau.	Chien
Préfixe d'éleveur	Un code court (max 5 caractères) utilisé pour nommer automatiquement les chiots/chatons des portées.	TP
Durée de gestation — Chiens	Durée de gestation chez la chienne. Par défaut 63 jours. À modifier seulement si vous êtes sûr des jours exacts.	63
Durée de gestation — Chats	Durée de gestation chez la chatte. Par défaut 65 jours.	65
Instructions alimentaires	Texte qui apparaîtra sur les documents remis aux nouveaux propriétaires. Indiquez la nourriture, la fréquence et les instructions spéciales.	"À nourrir 3 fois par jour avec des croquettes Royal Canin pour chiots…"
Clé API Gemini	Collez ici votre clé API Google Gemini pour activer les fonctionnalités IA. Laissez vide sans IA.	(votre clé)
URL de webhook	Si vous utilisez Zapier ou Make pour l'automatisation, collez ici l'URL du webhook. Laissez vide sinon.	(votre URL de webhook)

Cliquez Enregistrer les paramètres lorsque vous avez terminé.

Onglet 2 : Informations sur l'éleveur

Remplissez vos informations professionnelles. Ces informations apparaissent sur les PDF générés (certificats de pedigree, dossiers de remise).

Champ	Quoi saisir
Nom de l'éleveur	Votre nom complet en tant qu'éleveur
Nom de l'entreprise	Nom de votre élevage ou chatterie
Numéro de licence	Votre numéro de licence d'élevage (le cas échéant)
Téléphone	Votre numéro de téléphone professionnel
Email	Votre adresse email professionnelle

Cliquez Enregistrer les paramètres lorsque vous avez terminé.

Onglet 3 : Races

C'est ici que vous gérez la liste des races disponibles dans les menus déroulants du plugin. TruePaws est préchargé avec 20 races de chiens et 20 races de chats courantes.

• Pour ajouter une race : Tapez le nom de la race dans la zone de texte et cliquez sur Ajouter une race.
• Pour supprimer une race : Cliquez sur le bouton de suppression à côté de toute race dans la liste.

Astuce : Ajoutez toutes les races avec lesquelles vous travaillez maintenant. Vous pouvez toujours en ajouter plus tard.

Onglet 4 : Communication

Remplissez votre adresse postale et l'URL de votre page de contact. Ces informations sont utilisées pour les fonctionnalités publiques et les shortcodes.

Champ	Quoi saisir
Adresse postale	Adresse postale de votre élevage
Ville	Ville
État/Province	État ou province
Code postal	Code postal
Pays	Pays
URL de contact / demande	L'URL de la page de contact de votre site (utilisée comme lien par défaut sur les boutons "Contacter l'éleveur")

Cliquez Enregistrer les paramètres lorsque vous avez terminé.

Onglet 5 : Rapports de ventes

Cet onglet est en lecture seule — il affiche vos statistiques de ventes une fois que vous commencez à enregistrer des ventes. Vous verrez :

• Revenu total généré
• Nombre total de ventes
• Prix de vente moyen
• Un tableau récapitulatif mensuel
• Un tableau des meilleurs acheteurs

Partie 4 : Le tableau de bord

Lorsque vous cliquez sur TruePaws dans la barre latérale, vous arrivez sur le tableau de bord. C'est votre base. Voici ce que vous verrez :

Cartes de statistiques

• Total d'animaux — combien d'animaux sont dans votre système
• Portées actives — gestations actuellement suivies
• Contacts — total des acheteurs et entrées sur liste d'attente
• Événements à venir — événements prochains (vaccins, dates de mise bas, etc.)

Actions rapides

• Ajouter un animal — accéder directement au formulaire nouvel animal
• Enregistrer un accouplement — noter une nouvelle reproduction
• Ajouter un contact — ajouter un nouvel acheteur ou une entrée sur liste d'attente

Liste de démarrage

• Une checklist utile qui vous guide lors de la configuration initiale.

Derniers événements

• Une chronologie des événements les plus récents pour tous vos animaux (vaccins, visites vétérinaires, contrôles de poids, etc.).

Graphiques

• Répartition des races — un diagramme en anneau montrant le nombre d'animaux que vous avez par race.
• Aperçu des ventes — un diagramme en barres montrant les revenus mensuels.

Carte thermique d'activité

• Une heatmap de type GitHub montrant l'activité de votre élevage chaque jour au cours de l'année écoulée. Les carrés plus foncés = plus d'événements enregistrés ce jour-là.

Partie 5 : Ajouter et gérer les animaux

Comment ajouter un nouvel animal

1. Aller à TruePaws → Animaux (ou cliquez sur "Ajouter un animal" dans le Tableau de bord).
2. Cliquez sur le Ajouter un nouvel animal bouton.
3. Remplissez le formulaire :

Champ	Obligatoire ?	Description
Nom	Oui	Le nom enregistré/officiel de l'animal
Surnom	Non	Le nom que vous lui donnez à la maison
Numéro d'enregistrement	Non	Numéro d'enregistrement officiel de votre registre de race
Numéro de puce électronique	Non	Le numéro de la puce électronique (doit être unique)
Race	Non	Sélectionnez dans votre liste de races
Sexe	Oui	Mâle ou Femelle
Père	Non	Sélectionnez parmi les mâles existants dans votre système
Mère	Non	Sélectionnez parmi les femelles existantes dans votre système
Date de naissance	Non	Date de naissance de l'animal
Statut	Non	Actif, Retraité, Vendu, Décédé ou en Co-propriété (par défaut Actif)
Couleur/Marques	Non	Décrivez l'apparence de l'animal
Description	Non	Toutes notes supplémentaires concernant l'animal
Image à la une	Non	Cliquez pour ouvrir la bibliothèque média WordPress et sélectionner une photo

4. Cliquez Enregistrer l'animal.

Astuce pour la configuration initiale : Commencez par ajouter vos animaux reproducteurs adultes (étalons et femelles) en premier. Ainsi, lorsque vous ajouterez des jeunes animaux ou des chiots, vous pourrez sélectionner leurs parents dans les menus déroulants.

La page de profil de l'animal

Après avoir enregistré, cliquez sur le nom d'un animal pour voir sa page de profil. C'est la page la plus riche en fonctionnalités dans le plugin. Voici tout ce que vous pouvez faire :

Voir les informations

• Voir tous les détails que vous avez saisis, ainsi qu'un badge de statut (par exemple, "Actif" en vert, "Vendu" en bleu).
• L'image mise en avant s'affiche de manière prominente, avec une silhouette par défaut si aucune photo n'a été téléchargée.

Galerie photo

• Téléchargez plusieurs photos en cliquant sur "Ajouter des photos".
• Glissez-déposez les photos pour les réorganiser.
• Cliquez sur une photo pour la définir comme image mise en avant.
• Supprimez les photos dont vous n'avez plus besoin.

Chronologie et événements

La chronologie montre un historique chronologique de tout ce qui est arrivé à cet animal. Pour ajouter un nouvel événement :

1. Cliquez sur le Ajouter un événement bouton.
2. Choisissez le type d'événement : Naissance, Vaccin, Chaleur, Accouplement, Mise bas, Poids, Visite chez le vétérinaire ou Note.
3. Entrez la date et un titre/description.
4. Pour les événements de poids, entrez la valeur du poids.
5. Cliquez Enregistrer.

Arbre généalogique

• Affiche un arbre généalogique sur 3 générations montrant les parents, grands-parents et arrière-grands-parents. (Fonctionne uniquement si vous avez saisi les relations parentales).
• Cliquez Télécharger le PDF du pedigree pour générer un certificat imprimable.

Courbe de croissance du poids

• Si vous avez enregistré des événements de poids, un graphique linéaire apparaît montrant le poids de l'animal au fil du temps.

Fonctionnalités IA (nécessite une clé API Gemini)

• Conseils de soins IA — génère des recommandations de soins personnalisées en fonction de la race, de l'âge et de l'historique de l'animal.
• Bio marketing IA — rédige une description convaincante pour votre site web ou vos annonces sur les réseaux sociaux.
• Alertes santé IA — analyse l'historique des événements et signale les problèmes de santé potentiels.

Vendre un animal

1. Sur le profil de l'animal, cliquez sur Vendre / Réserver.
2. Sélectionnez l'acheteur dans votre liste de contacts.
3. Entrez la date de vente et le prix.
4. Ajoutez des notes (facultatif).
5. Cliquez Confirmer la vente.
6. Le statut de l'animal passe à "Vendu".
7. Cliquez Générer un PDF de prise en charge pour créer un document de prise en charge professionnel.

Copier le code court

Au bas du profil, vous verrez un shortcode comme

. Cliquez pour le copier. Vous pouvez le coller dans n'importe quelle page ou article WordPress pour afficher le profil de cet animal sur votre site public.

Partie 6 : Gestion de la reproduction et des portées

Enregistrer un nouvel accouplement

1. Aller à TruePaws → Portées.
2. Cliquez Enregistrer un nouvel accouplement.
3. Remplissez le formulaire :

Champ	Obligatoire ?	Description
Père	Oui	Sélectionnez le mâle parmi vos animaux
Mère	Oui	Sélectionnez la femelle parmi vos animaux
Date d'accouplement	Oui	La date à laquelle l'accouplement a eu lieu
Méthode	Non	Insémination naturelle ou artificielle (IA)
Notes	Non	Toutes notes concernant l'accouplement

4. Cliquez EnregistrerLe système calcule automatiquement la date de mise bas prévue en fonction de vos paramètres de durée de gestation.

Suivi de la grossesse

Chaque portée active affiche une Suivi de gestation carte avec :

• Une barre de progression montrant l'avancement de la gestation.
• Indicateur de trimestre (Début / Milieu / Fin).
• Jours restants jusqu'à la mise bas prévue.
• Étapes à venir (Implantation, Battement de cœur, Échographie, etc.).

Enregistrement de la naissance (Mise bas)

1. Aller à TruePaws → Portées.
2. Trouvez la portée et cliquez Portée de Chiots.
3. Étape 1 — Enregistrement de la Naissance : Entrez la date effective de la mise bas, le nombre de mâles/femelles dans la portée, et prévisualisez les noms générés automatiquement.
4. Étape 2 — Confirmation : Revoyez le résumé et cliquez sur Soumettre. Le système crée automatiquement des enregistrements individuels pour chaque chiot, assigne les parents, enregistre l'événement de naissance, et définit leur statut comme Actif.

Partie 7 : Gestion des contacts (acheteurs et liste d'attente)

Ajouter un contact

1. Aller à TruePaws → Contacts.
2. Cliquez Ajouter un Nouveau Contact.
3. Remplissez le formulaire :

Champ	Obligatoire ?	Description
Prénom	Oui	Prénom de l'acheteur
Nom de famille	Non	Nom de famille de l'acheteur
Email	Oui	Adresse e-mail de l'acheteur
Téléphone	Non	Numéro de téléphone
Adresse	Non	Adresse postale
Statut	Non	Liste d'attente, Réservé, Acheteur ou Inactif
Notes	Non	Toute note privée concernant ce contact

4. Cliquez Enregistrer le Contact.

Fonctionnalités de la liste de contacts

• Filtrer par statut — afficher uniquement les contacts en Liste d'attente, Réservés, Acheteurs, ou Inactifs.
• Exporter en CSV — télécharger tous les contacts sous forme de fichier tableur pour les outils de marketing par email.

Partie 8 : Affichage des animaux sur votre site web (shortcodes)

Les shortcodes sont des codes spéciaux que vous collez dans des pages ou articles WordPress pour afficher le contenu de TruePaws sur votre site public.

1. Afficher un animal unique

[truepaws_animal id="7"]

(Remplacez 123 par le numéro d'identification réel de l'animal)

Paramètres optionnels que vous pouvez ajouter :

Paramètre	Ce que cela fait	Par défaut
contact_url="https://..."	Lien personnalisé pour le bouton "Contacter l'éleveur"	URL de vos paramètres
show_ai="true" ou "false"	Afficher ou masquer les informations sur les soins IA	vrai
show_pedigree="true" ou "false"	Afficher ou masquer l'arbre généalogique	vrai
show_inquiry_form="true" ou "false"	Intégrer un formulaire de demande sous l'animal	faux
show_gallery="true" ou "false"	Afficher ou masquer la galerie photo	vrai
gallery_columns="3"	Nombre de colonnes pour la galerie (2 à 6)	4

Exemple avec options :

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

2. Afficher une portée

[truepaws_litter id="1"]

Cela montre les informations de la portée, y compris les parents, la date de naissance et une grille des chiots/chatons disponibles avec leurs photos et badges de statut.

3. Afficher tous les chiots/chatons disponibles

[truepaws_available_puppies]

Cela montre une grille de tous les animaux avec le statut "Actif".

Paramètres optionnels :

Paramètre	Ce que cela fait	Par défaut
limit="6"	Nombre maximum d'animaux à afficher	12
breed="Golden Retriever"	Afficher uniquement les animaux de cette race	(toutes races)
show_images="true" ou "false"	Afficher ou masquer les photos	vrai

Exemple :

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

4. Afficher un formulaire de demande

[truepaws_inquiry_form]

Cela affiche un formulaire de contact que les visiteurs peuvent remplir pour s'informer sur vos animaux.

Paramètres optionnels :

Paramètre	Ce que cela fait	Par défaut
animal_id="123"	Lier la demande à un animal spécifique	(aucun)
title="Interested? Get in Touch!"	Titre personnalisé du formulaire	« Envoyer une demande »

Partie 9 : Documents PDF

TruePaws peut générer deux types de documents PDF professionnels :

1. Certificat de Pedigree

Généré à partir de la page de profil de n'importe quel animal. Contient le nom de l'animal, les détails d'enregistrement, un arbre généalogique sur 3 générations et le nom de l'éleveur.

2. Dossier de Remise

Généré à partir du profil d'un animal vendu. Contient les détails de l'animal, un aperçu du pedigree, l'historique complet de santé, les instructions d'alimentation, les recommandations de soins, le contrat/les conditions et les informations de l'éleveur.

Remarque : Pour une qualité PDF optimale, demandez à votre hébergeur web de s'assurer que la bibliothèque PHP TCPDF ou Dompdf est installée.

Partie 10 : Notifications par e-mail automatisées

TruePaws effectue une vérification quotidienne et vous envoie des rappels par email pour :

• Rappels de Mise Bas : Envoyé 7 jours avant la date prévue de mise bas.
• Rappels de vaccination : Vous rappelle aux étapes clés (6 semaines, 9 semaines, 12 semaines, 16 semaines, 1 an, 2 ans, 3 ans).

Important : Ces emails sont envoyés à l'adresse que vous avez saisie dans Paramètres → Informations de l'éleveur → Email.

Partie 11 : Flux de travail recommandé (étape par étape)

Configuration Initiale

1. Installez et activez l'extension.
2. Allez dans Paramètres et remplissez tous les onglets.
3. Ajoutez vos races personnalisées.

Construction de Votre Base de Données

1. Ajoutez d'abord tous vos animaux reproducteurs adultes (étalons et femelles).
2. Téléchargez des photos et remplissez les données d'enregistrement.
3. Définissez les relations parentales pour construire les arbres généalogiques.
4. Ajoutez des événements historiques pour construire la chronologie de chaque animal.

Utilisation Quotidienne

1. Lorsqu'un accouplement a lieu, enregistrez-le sous Portées.
2. Suivez les grossesses et utilisez l'Assistant Mise bas lors des naissances.
3. Mettez à jour les profils des progénitures au fur et à mesure de leur croissance.
4. Ajoutez les acheteurs à la liste des contacts.

Vente

1. Lorsqu'un animal est vendu, utilisez la fonction Vendre/Réserver sur son profil.
2. Générez le PDF de remise.
3. Surveillez les rapports de ventes.

Site Web Public

1. Créez une page « Chiots disponibles » en utilisant : truepaws_available_puppies shortcode
2. Créez des pages individuelles en utilisant truepaws_animal id="..." shortcode
3. Ajouter truepaws_inquiry_form shortcode à votre page de contact.

Partie 12 : Astuces & Conseils

• Utilisez la Heatmap d'activité sur le Tableau de bord pour repérer les lacunes dans votre tenue de registres.
• Exportez régulièrement les contacts en CSV pour maintenir votre liste de diffusion à jour.
• Le Bio Marketing IA peut vous faire gagner du temps pour rédiger des annonces.
• Enregistrez les poids des chiots chaque semaine et utilisez le graphique de croissance pour détecter les problèmes tôt.
• Utilisez le animal_id paramètre sur les formulaires de demande pour suivre les demandes spécifiques d'animaux.
• Utilisez le statut « Co-Propriété » pour les animaux partagés entre éleveurs.