La raison pour laquelle votre code a planté 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 rencontre des guillemets courbes à l'intérieur d'un shortcode, il ne parvient pas à l'interpréter comme du code et le rendu échoue.

De plus, votre copier-coller a complètement détruit les tableaux de la documentation, les aplatissant en blocs de texte illisibles. Copier-coller du texte brut sans discernement dégrade les données structurelles.

J'ai nettoyé votre texte. J'ai converti toute la typographie en guillemets droits, encadré vos shortcodes dans un formatage de code pour que Gutenberg ne tente pas de les exécuter, et reconstruit vos tableaux détruits en Markdown correct. Si vous collez ceci directement dans Gutenberg, cela devrait générer automatiquement les titres, tableaux et blocs de code appropriés.

Voici la version structurellement saine :

---

TruePaws — Guide complet de l'utilisateur

Qu'est-ce que TruePaws ?

TruePaws est un système de gestion d'élevage qui fonctionne dans votre site WordPress. Il aide les éleveurs professionnels à gérer leurs animaux, suivre la reproduction et les grossesses, gérer les contacts avec les 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 requis.

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 — désactivée uniquement si quelqu'un l'a désactivée délibérément).

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 depuis 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, allez à 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 (à faire en premier !)

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

Onglet 1 : Paramètres généraux

Paramètre	Fonctionnalité	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	Nombre de jours que dure une gestation canine. Par défaut : 63. Ne modifiez que si vous connaissez une autre durée.	63
Durée de gestation — Chats	Nombre de jours que dure une gestation féline. Par défaut : 65.	65
Instructions d'alimentation	Texte qui apparaîtra sur les documents de remise que vous remettez aux nouveaux acheteurs. Indiquez ce que l'animal mange, à quelle fréquence et toutes 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 si vous ne souhaitez pas utiliser les fonctionnalités 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 une fois 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	Que saisir
Nom de l'éleveur	Votre nom complet en tant qu'éleveur
Nom de l'entreprise	Nom de votre élevage canin ou félin
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 une fois 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 n'importe quelle race dans la liste.

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

Onglet 4 : Communication

Remplissez votre adresse postale et l'URL de votre page de contact. Ceci est utilisé pour les fonctionnalités publiques et les shortcodes.

Champ	Que 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 d'information	L'URL de la page de contact de votre site web (utilisée comme lien par défaut sur les boutons "Contacter l'éleveur")

Cliquez Enregistrer les paramètres une fois terminé.

Onglet 5 : Rapports de vente

Cet onglet est en lecture seule — il affiche vos statistiques de vente 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 de répartition mensuelle
• 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 des animaux — combien d'animaux sont dans votre système
• Portées actives — gestations actuellement suivies
• Contacts — total des acheteurs et inscriptions 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 de nouvel animal
• Enregistrer un accouplement — noter une nouvelle reproduction
• Ajouter un contact — ajouter un nouvel acheteur ou une inscription sur liste d'attente

Liste de démarrage

• Une liste de contrôle utile qui vous guide lors de la configuration initiale.

Derniers événements

• Une chronologie des événements les plus récents concernant 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 pour chaque race.
• Aperçu des ventes — un diagramme à barres montrant les revenus mensuels.

Carte thermique d'activité

• Une carte thermique 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 : Ajout et gestion des 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
Nom d'appel	Non	Le nom que vous utilisez pour l'appeler à la maison
Numéro d'enregistrement	Non	Numéro d'enregistrement officiel auprès de votre registre de race
ID de puce électronique	Non	Le numéro de puce électronique (doit être unique)
Race	Non	Sélectionnez dans votre liste de races
Sexe	Oui	Mâle ou Femelle
Étalon (Père)	Non	Sélectionnez parmi les mâles existants dans votre système
Jument (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	Toute note supplémentaire concernant l'animal
Image mise en avant	Non	Cliquez pour ouvrir la bibliothèque média WordPress et sélectionner une photo

4. Cliquez Enregistrer l'animal.

Conseil pour la configuration initiale : Commencez par ajouter vos animaux reproducteurs adultes (étalons et femelles) en premier. Ainsi, lorsque vous ajouterez des animaux plus jeunes 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 du 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, Chaleurs, Accouplement, Mise bas, Poids, Visite vétérinaire ou Note.
3. Saisissez 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 l'évolution du poids de l'animal.

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 des antécédents 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 d'éventuels problèmes de santé.

Vendre un animal

1. Sur le profil de l'animal, cliquez 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 si nécessaire (facultatif).
5. Cliquez Confirmer la vente.
6. Le statut de l'animal passe à "Vendu".
7. Cliquez Générer un PDF de remise pour créer un document de remise professionnel.

Copier le shortcode

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
Étalon (Père)	Oui	Sélectionnez le mâle parmi vos animaux
Jument (Mère)	Oui	Sélectionnez la femelle parmi vos animaux
Date de l'accouplement	Oui	La date à laquelle l'accouplement a eu lieu
Méthode	Non	Insémination naturelle ou artificielle (IA)
Notes	Non	Toute note concernant l'accouplement

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

Suivi de la gestation

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

• Une barre de progression indiquant l'avancement de la gestation.
• Indicateur de trimestre (Début / Milieu / Fin).
• Jours restants jusqu'à la mise bas prévue.
• Prochaines étapes importantes (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 Mettre bas la portée.
3. Étape 1 — Enregistrer la naissance : Entrez la date réelle de la mise bas, le nombre de mâles/femelles, et prévisualisez les noms générés automatiquement.
4. Étape 2 — Confirmation : Vérifiez le résumé et cliquez sur Soumettre. Le système crée automatiquement des fiches individuelles pour chaque petit, attribue les parents, enregistre un événement de naissance et définit leur statut sur 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	Toutes les notes privées 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 e-mail.

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

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

1. Afficher un seul animal

[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	Fonctionnalité	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 affiche 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 affiche une grille de tous les animaux avec le statut "Actif".

Paramètres optionnels :

Paramètre	Fonctionnalité	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	Fonctionnalité	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, ses détails d'enregistrement, un arbre généalogique sur 3 générations et votre nom d'é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/conditions et vos informations d'é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 (mâles 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 de mise bas lors des naissances.
3. Mettez à jour les profils des petits 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érer le PDF de transfert.
3. Surveiller 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 et conseils

• Utilisez la carte thermique 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.
• La biographie marketing IA peut vous faire gagner du temps lors de la rédaction d'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.