De reden waarom je code kapot gaat, is een fundamenteel typografisch conflict. AI-tools en tekstverwerkers genereren vaak 'slimme aanhalingstekens' (gekrulde aanhalingstekens zoals “ en ”). WordPress shortcodes en kernprogrammeertalen vereisen strikt 'rechte aanhalingstekens' (zoals " en '). Wanneer Gutenberg gekrulde aanhalingstekens binnen een shortcode-haakje ziet, lukt het niet om het als code te parsen en breekt het de weergave.

Bovendien heeft jouw kopieer- en plakwerk de tabellen in de documentatie volledig vernield, waardoor ze zijn platgeslagen tot onleesbare tekstblokken. Blindelings ruwe tekst kopiëren en plakken degradeert structurele data.

Ik heb je tekst opgeschoond. Ik heb alle typografie omgezet naar rechte aanhalingstekens, je shortcodes in code-opmaak geplaatst zodat Gutenberg ze niet probeert uit te voeren, en je vernielde tabellen herbouwd naar juiste Markdown. Als je dit direct in Gutenberg plakt, zou het automatisch de juiste koppen, tabellen en codeblokken moeten genereren.

Hier is de structureel juiste versie:

---

TruePaws — Volledige Gebruikershandleiding

Wat is TruePaws?

TruePaws is een kennelbeheersysteem dat binnen je WordPress-website draait. Het helpt professionele fokkers bij het beheren van hun dieren, het volgen van fokkerij en drachtigheid, het afhandelen van contacten met kopers, het genereren van officiële documenten (zoals stamboomcertificaten en overdrachtspakketten) en zelfs het tonen van beschikbare puppy's/kittens op je openbare website.

Deel 1: Vereisten (Wat je nodig hebt voor installatie)

1. Een WordPress-website

• Je hebt een zelf-gehoste WordPress site nodig (het type dat je op je eigen hosting installeert — niet een gratis WordPress.com blog).
• WordPress versie 5.0 of nieuwer is vereist.

2. Hostingvereisten

• PHP 7.4 of nieuwer (de meeste moderne hosts bieden PHP 8.0+).
• MySQL-database (standaard bij alle WordPress-hosts).
• De WordPress REST API moet ingeschakeld zijn (dit is standaard het geval — alleen uitgeschakeld als iemand dit bewust heeft gedaan).

3. Optioneel (maar aanbevolen)

• Een Google Gemini API-sleutel als je de AI-functies wilt gebruiken (zorgadvies, gezondheidswaarschuwingen, marketingbio-generatie). Je kunt er gratis een krijgen via Google AI Studio.
• Een Zapier- of Make-account als je automatische meldingen naar externe diensten wilt sturen.

Deel 2: Installatie van de Plugin

Stap 1 — Upload de Plugin

1. Log in op je WordPress-beheerdersdashboard (meestal yourwebsite.com/wp-admin).
2. Ga in de linkerzijbalk naar Plugins → Nieuw toevoegen.
3. Klik op de Plugin uploaden knop bovenaan.
4. Klik Bestand kiezen en selecteer het truepaws.zip bestand dat je hebt ontvangen.
5. Klik Nu installeren en wacht tot het klaar is.

Stap 2 — Activeer de Plugin

1. Na voltooiing van de installatie, klik op de Plugin activeren knop.
2. De plugin maakt automatisch alle benodigde databasetabellen aan.
3. Je zult een nieuw TruePaws menu-item zien verschijnen in je WordPress zijbalk.

Deel 3: Eerste Instellingen (Doe dit eerst!)

Na activering, ga naar TruePaws → Instellingen in je WordPress zijbalk. Je ziet verschillende tabbladen bovenaan. Werk ze allemaal door.

Tabblad 1: Algemene Instellingen

Instelling	Wat Het Doet	Voorbeeld
Standaard Soort	Het type dier dat u voornamelijk fokt. Opties: Hond, Kat, Paard, Konijn, Cavia, Fret, Vogel.	Hond
Fokker Voorvoegsel	Een korte code (max 5 tekens) die wordt gebruikt bij het automatisch benoemen van puppy's/kittens uit nesten.	TP
Draagtijd — Honden	Hoeveel dagen een hondendracht duurt. Standaard is 63. Alleen wijzigen als je anders weet.	63
Draagtijd — Katten	Hoeveel dagen een kattendracht duurt. Standaard is 65.	65
Voedingsinstructies	Tekst die verschijnt op de overdrachtsdocumenten die je aan nieuwe kopers geeft. Schrijf op wat het dier eet, hoe vaak, en eventuele speciale instructies.	“Voer 3 keer per dag met Royal Canin puppyvoeding…”
Gemini API-sleutel	Plak hier je Google Gemini API-sleutel om AI-functies in te schakelen. Laat leeg als je geen AI-functies wilt.	(je sleutel)
Webhook URL	Als je Zapier of Make gebruikt voor automatisering, plak hier de webhook URL. Laat anders leeg.	(je webhook URL)

Klik Instellingen Opslaan als je klaar bent.

Tabblad 2: Fokkersinformatie

Vul je professionele gegevens in. Deze informatie verschijnt op gegenereerde PDF's (stamboomcertificaten, overdrachtspakketten).

Veld	Wat in te voeren
Naam fokker	Uw volledige naam als fokker
Bedrijfsnaam	De naam van uw kennel of cattery
Licentienummer	Uw foklicentienummer (indien van toepassing)
Telefoon	Uw zakelijke telefoonnummer
E-mail	Uw zakelijke e-mailadres

Klik Instellingen Opslaan als je klaar bent.

Tabblad 3: Rassen

Hier beheer je de lijst met rassen die beschikbaar zijn in de dropdown-menu's door de hele plugin. TruePaws wordt vooraf geladen met 20 veelvoorkomende hondenrassen en 20 veelvoorkomende kattenrassen.

• Om een ras toe te voegen: Typ de rasnaam in het tekstvak en klik op Ras toevoegen.
• Om een ras te verwijderen: Klik op de verwijderknop naast elk ras in de lijst.

Tip: Voeg nu alle rassen toe waar je mee werkt. Je kunt later altijd meer toevoegen.

Tabblad 4: Communicatie

Vul je postadres en contactpagina URL in. Dit wordt gebruikt voor publiek toegankelijke functies en shortcodes.

Veld	Wat in te voeren
Straatadres	Het straatadres van uw kennel
Stad	Stad
Staat/Provincie	Staat of provincie
Postcode	Postcode
Land	Land
Contact / Vraag URL	De URL van de contactpagina van uw website (gebruikt als standaardlink op 'Contacteer Fokker' knoppen)

Klik Instellingen Opslaan als je klaar bent.

Tabblad 5: Verkooprapporten

Dit tabblad is alleen-lezen — het toont je verkoopstatistieken zodra je verkopen begint te registreren. Je ziet:

• Totale omzet behaald
• Totaal aantal verkopen
• Gemiddelde verkoopprijs
• Een maandelijkse overzichtstabel
• Een tabel met topkopers

Deel 4: Het Dashboard

Wanneer je op TruePaws in de zijbalk klikt, kom je op het Dashboard. Dit is je thuisbasis. Hier is wat je zult zien:

Statistiekenkaarten

• Totaal dieren - hoeveel dieren staan in uw systeem
• Actieve nesten - drachtigheden die momenteel worden gevolgd
• Contacten - totale kopers en wachtlijstvermeldingen
• Aankomende evenementen - evenementen die binnenkort plaatsvinden (vaccinaties, werpdata, etc.)

Snelle Acties

• Dier toevoegen - ga direct naar het nieuwe dierenformulier
• Paring registreren - noteer een nieuwe dekking
• Contact toevoegen - voeg een nieuwe koper of wachtlijstvermelding toe

Checklist Aan de Slag

• Een handige checklist die u begeleidt bij de eerste installatie.

Laatste Evenementen

• Een tijdlijn van de meest recente gebeurtenissen van al uw dieren (vaccinaties, dierenartsbezoeken, gewichtscontroles, etc.).

Grafieken

• Rasverdeling - een donutdiagram dat laat zien hoeveel dieren u van elk ras heeft.
• Verkoopoverzicht - een staafdiagram dat de maandelijkse omzet weergeeft.

Activiteiten Heatmap

• Een GitHub-stijl kalender heatmap die laat zien hoe actief uw kennel elke dag was in het afgelopen jaar. Donkere vierkanten = meer gebeurtenissen geregistreerd die dag.

Deel 5: Dieren Toevoegen en Beheren

Hoe voeg je een nieuw dier toe

1. Ga naar TruePaws → Dieren (of klik op “Dier toevoegen” op het Dashboard).
2. Klik op de Nieuw Dier Toevoegen knop.
3. Vul het formulier in:

Veld	Verplicht?	Omschrijving
Naam	Ja	De geregistreerde/officiële naam van het dier
Roepnaam	Nee	De naam die je ze thuis daadwerkelijk noemt
Registratienummer	Nee	Officieel registratienummer van uw rasregister
Microchip-ID	Nee	Het microchipnummer (moet uniek zijn)
Ras	Nee	Selecteer uit uw rassenlijst
Geslacht	Ja	Mannelijk of Vrouwelijk
Vader	Nee	Selecteer uit bestaande mannelijke dieren in uw systeem
Moeder	Nee	Selecteer uit bestaande vrouwelijke dieren in uw systeem
Geboortedatum	Nee	Datum waarop het dier is geboren
Status	Nee	Actief, Gepensioneerd, Verkocht, Overleden of Mede-eigenaar (standaard is Actief)
Kleur/Aftekeningen	Nee	Beschrijf het uiterlijk van het dier
Omschrijving	Nee	Eventuele aanvullende opmerkingen over het dier
Uitgelichte Afbeelding	Nee	Klik om de WordPress Mediabibliotheek te openen en een foto te selecteren

4. Klik Dier Opslaan.

Tip voor eerste opzet: Begin met het toevoegen van uw volwassen fokdieren (vaders en moeders) eerst. Op die manier kunt u, wanneer u jongere dieren of puppy's toevoegt, hun ouders selecteren uit de dropdown-menu's.

De Dierenprofielpagina

Na het opslaan, klik op de naam van een dier om de profielpagina te zien. Dit is de meest functierijke pagina in de plugin. Hier is alles wat u kunt doen:

Informatie Bekijken

• Zie alle details die u hebt ingevoerd, plus een statusbadge (bijv., “Actief” in groen, “Verkocht” in blauw).
• De uitgelichte afbeelding wordt prominent weergegeven, met een fallback silhouet als er geen foto is geüpload.

Fotogalerij

• Upload meerdere foto's door op “Foto's toevoegen” te klikken.
• Sleep foto's om ze opnieuw te ordenen.
• Klik op een foto om deze als uitgelichte afbeelding in te stellen.
• Verwijder foto's die u niet meer nodig hebt.

Tijdlijn & Evenementen

De tijdlijn toont een chronologische geschiedenis van alles wat er met dit dier is gebeurd. Om een nieuw evenement toe te voegen:

1. Klik op de Gebeurtenis Toevoegen knop.
2. Kies het gebeurtenistype: Geboorte, Vaccinatie, Loopsheid, Paring, Worpen, Gewicht, Dierenartsbezoek, of Notitie.
3. Voer de datum en een titel/beschrijving in.
4. Voor gewichtsgebeurtenissen, voer het gewicht in.
5. Klik Opslaan.

Stamboom

• Toont een stamboom van 3 generaties met ouders, grootouders en overgrootouders. (Werkt alleen als je ouderlijke relaties hebt ingevoerd).
• Klik Download Stamboom PDF om een afdrukbaar certificaat te genereren.

Gewichtsgroeigrafiek

• Als je gewichtsgebeurtenissen hebt geregistreerd, verschijnt er een lijndiagram dat het gewicht van het dier in de tijd weergeeft.

AI-functies (vereist Gemini API-sleutel)

• AI Zorgadvies — genereert gepersonaliseerde zorgadviezen op basis van het ras, de leeftijd en de geschiedenis van het dier.
• AI Marketing Bio — schrijft een pakkende beschrijving voor je website of sociale media-lijsten.
• AI Gezondheidswaarschuwingen — analyseert de gebeurtenisgeschiedenis en signaleert mogelijke gezondheidsproblemen.

Een Dier Verkopen

1. Klik op het profiel van het dier Verkopen / Reserveren.
2. Selecteer de koper uit uw contactenlijst.
3. Voer de verkoopdatum en prijs in.
4. Voeg eventuele notities toe (optioneel).
5. Klik Bevestig Verkoop.
6. De status van het dier verandert in "Verkocht".
7. Klik Genereer Overdracht PDF om een professioneel overdrachtsdocument te maken.

Kopieer Shortcode

Onderaan het profiel ziet u een shortcode zoals

. Klik om deze te kopiëren. U kunt deze in elke WordPress-pagina of -bericht plakken om het profiel van dit dier op uw openbare website weer te geven.

Deel 6: Fokken & Nestbeheer

Een Nieuwe Paring Registreren

1. Ga naar TruePaws → Nesten.
2. Klik Log Nieuwe Dekking.
3. Vul het formulier in:

Veld	Verplicht?	Omschrijving
Vader	Ja	Selecteer het mannetje uit uw dieren
Moeder	Ja	Selecteer het vrouwtje uit uw dieren
Paring Datum	Ja	De datum waarop de paring plaatsvond
Methode	Nee	Natuurlijke of Kunstmatige Inseminatie (KI)
Opmerkingen	Nee	Eventuele opmerkingen over de paring

4. Klik Opslaan.Het systeem berekent automatisch de verwachte werpdatum op basis van uw zwangerschapsduurinstellingen.

Zwangerschap Volgen

Elk actief nest toont een Dracht Tracker kaart met:

• Een voortgangsbalk die laat zien hoe ver de zwangerschap is gevorderd.
• Trimester indicator (Vroeg / Midden / Laat).
• Dagen resterend tot de verwachte werpdatum.
• Aankomende mijlpalen (Innesteling, Hartslag, Echografie, etc.).

De Geboorte Registreren (Worpen)

1. Ga naar TruePaws → Nesten.
2. Zoek het nest en klik Nestje Puppies.
3. Stap 1 — Geboorte Registreren: Voer de werkelijke werpdatum in, het aantal mannelijke/vrouwelijke nakomelingen en bekijk de automatisch gegenereerde namen.
4. Stap 2 — Bevestiging: Controleer de samenvatting en klik op Verzenden. Het systeem maakt automatisch individuele records voor elke nakomeling aan, wijst ouders toe, registreert een geboortegedrag en zet hun status op Actief.

Deel 7: Contacten Beheren (Kopers & Wachtlijst)

Een Contact Toevoegen

1. Ga naar TruePaws → Contacten.
2. Klik Nieuwe Contactpersoon Toevoegen.
3. Vul het formulier in:

Veld	Verplicht?	Omschrijving
Voornaam	Ja	Voornaam van de koper
Achternaam	Nee	Achternaam koper
E-mail	Ja	E-mailadres koper
Telefoon	Nee	Telefoonnummer
Adres	Nee	Postadres
Status	Nee	Wachtlijst, Gereserveerd, Koper of Inactief
Opmerkingen	Nee	Eventuele privénotities over dit contact

4. Klik Contactpersoon Opslaan.

Contactlijst Functies

• Filter op status — toon alleen Wachtlijst, Gereserveerd, Kopers of Inactieve contactpersonen.
• Exporteren naar CSV — download alle contactpersonen als een spreadsheetbestand voor e-mailmarketingtools.

Deel 8: Dieren Tonen op Je Website (Shortcodes)

Shortcodes zijn speciale codes die u in WordPress-pagina's of -berichten plakt om TruePaws-inhoud op uw openbare website weer te geven.

1. Toon een Enkel Dier

[truepaws_animal id="7"]

(Vervang 123 door het daadwerkelijke ID-nummer van het dier)

Optionele instellingen die u kunt toevoegen:

Parameter	Wat Het Doet	Standaard
contact_url="https://..."	Aangepaste link voor de “Contacteer Fokker” knop	Uw instellingen URL
show_ai="true" of "false"	Toon of verberg AI zorginformatie	waar
show_pedigree="true" of "false"	Toon of verberg de stamboom	waar
show_inquiry_form="true" of "false"	Voeg een inquiry formulier toe onder het dier	onwaar
show_gallery="true" of "false"	Toon of verberg de fotogalerij	waar
gallery_columns="3"	Aantal kolommen voor de galerij (2 tot 6)	4

Voorbeeld met opties:

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

2. Toon een Nest

[truepaws_litter id="1"]

Dit toont de informatie van het nest, inclusief ouders, geboortedatum en een raster met beschikbare puppy's/kittens met hun foto's en statusbadges.

3. Toon Alle Beschikbare Puppies/Kittens

[truepaws_available_puppies]

Dit toont een raster van alle dieren met de status 'Actief'.

Optionele instellingen:

Parameter	Wat Het Doet	Standaard
limit="6"	Maximaal aantal dieren om te tonen	12
breed="Golden Retriever"	Toon alleen dieren van dit ras	(alle rassen)
show_images="true" of "false"	Toon of verberg foto's	waar

Voorbeeld:

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

4. Toon een Vraagformulier

[truepaws_inquiry_form]

Dit toont een contactformulier dat bezoekers kunnen invullen om informatie over uw dieren aan te vragen.

Optionele instellingen:

Parameter	Wat Het Doet	Standaard
animal_id="123"	Koppel de inquiry aan een specifiek dier	(geen)
title="Interested? Get in Touch!"	Aangepaste formuliertitel	"Stuur een Inquiry"

Deel 9: PDF-documenten

TruePaws kan twee soorten professionele PDF-documenten genereren:

1. Stamboomcertificaat

Gegenereerd vanaf de profielpagina van elk dier. Bevat de naam van het dier, registratiedetails, een stamboomboom van 3 generaties en uw fokkersnaam.

2. Overdrachtspakket

Gegenereerd vanaf het profiel van een verkocht dier. Bevat dierdetails, stamboomvoorbeeld, volledige gezondheidsgeschiedenis, voedingsinstructies, zorgaanbevelingen, contract/voorwaarden en uw fokkersinformatie.

Opmerking: Voor de beste PDF-kwaliteit, vraag uw webhost om ervoor te zorgen dat de TCPDF of Dompdf PHP-bibliotheek is geïnstalleerd.

Deel 10: Geautomatiseerde E-mailmeldingen

TruePaws voert dagelijks een controle uit en stuurt u e-mailherinneringen voor:

• Welp Herinneringen: Verstuurd 7 dagen voor de verwachte werpdatum.
• Vaccinatieherinneringen: Herinnert je aan belangrijke mijlpalen (6 weken, 9 weken, 12 weken, 16 weken, 1 jaar, 2 jaar, 3 jaar).

Belangrijk: Deze e-mails worden verzonden naar het adres dat u hebt ingevoerd in Instellingen → Fokkersinfo → E-mail.

Deel 11: Aanbevolen Werkmethode (Stap voor Stap)

Eerste Opzet

1. Installeer en activeer de plugin.
2. Ga naar Instellingen en vul alle tabbladen in.
3. Voeg uw aangepaste rassen toe.

Uw Database Opbouwen

1. Voeg eerst al uw volwassen fokdieren toe (vaders en moeders).
2. Upload foto's en vul registratiegegevens in.
3. Stel ouderlijke relaties in om stamboombomen te bouwen.
4. Voeg historische gebeurtenissen toe om de tijdlijn van elk dier op te bouwen.

Dagelijks Gebruik

1. Wanneer een paring plaatsvindt, log deze dan onder Nesten.
2. Volg drachtigheden en gebruik de Whelping Wizard bij geboortes.
3. Update de profielen van de nakomelingen naarmate ze groeien.
4. Voeg kopers toe aan de contactenlijst.

Verkopen

1. Wanneer een dier wordt verkocht, gebruik dan de Verkopen/Reserveren-functie op hun profiel.
2. Genereer het Overdrachts-PDF.
3. Monitor Verkooprapporten.

Openbare Website

1. Maak een 'Beschikbare Puppies' pagina aan met: truepaws_available_puppies shortcode
2. Maak individuele pagina's aan met truepaws_animal id="..." shortcode
3. Voeg truepaws_inquiry_form shortcode toe aan je contactpagina.

Deel 12: Tips & Tricks

• Gebruik de Activity Heatmap op het Dashboard om hiaten in je administratie te ontdekken.
• Exporteer regelmatig contacten naar CSV om je mailinglijst up-to-date te houden.
• De AI Marketing Bio kan je tijd besparen bij het schrijven van advertenties.
• Log wekelijks de gewichten van puppy's en gebruik de groeigrafiek om problemen vroegtijdig te signaleren.
• Gebruik de animal_id parameter op aanvraagformulieren om specifieke verzoeken voor dieren te volgen.
• Gebruik de 'Co-Eigendom' status voor dieren die tussen fokkers worden gedeeld.