De reden waarom je code brak, is een fundamenteel typografisch conflict. AI-tools en tekstverwerkers genereren vaak 'slimme aanhalingstekens' (gebogen aanhalingstekens zoals “ en ”). WordPress shortcodes en kernprogrammeertalen vereisen strikt 'rechte aanhalingstekens' (zoals " en '). Wanneer Gutenberg gebogen aanhalingstekens binnen een shortcode-haakje ziet, kan het deze niet als code verwerken en breekt het de weergave.

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

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 in correcte Markdown. Als je dit direct in Gutenberg plakt, zou het automatisch de juiste koppen, tabellen en codeblokken moeten genereren.

Hier is de structureel correcte versie:

---

TruePaws — Volledige Gebruikershandleiding

Wat is TruePaws?

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

Deel 1: Vereisten (Wat u nodig heeft voor installatie)

1. Een WordPress-website

• Je hebt een zelfgehoste WordPress-site nodig (het type dat je op je eigen hosting installeert — geen 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 het bewust heeft uitgezet).

3. Optioneel (maar aanbevolen)

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

Deel 2: Het Plugin Installeren

Stap 1 – Upload de Plugin

1. Log in op je WordPress-beheerdersdashboard (meestal yourwebsite.com/wp-admin).
2. Ga in de linkersidebalk naar Plugins → Nieuwe 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. Nadat de installatie is voltooid, 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

Instellingen	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) gebruikt bij het automatisch benoemen van puppy's/kittens uit nesten.	TP
Draagtijd — Honden	Hoeveel dagen een dracht bij honden duurt. Standaard is 63. Alleen wijzigen als je weet dat het anders is.	63
Draagtijd — Katten	Hoeveel dagen een dracht bij katten 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 puppyvoer…"
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 vullen
Fokkersnaam	Uw volledige naam als fokker
Bedrijfsnaam	Uw kennel- of cattery naam
Licentienummer	Uw fokkerslicentienummer (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 van de 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 een 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 vullen
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 maandelijks 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:

Statistieken Kaarten

• Totaal dieren — hoeveel dieren er in uw systeem zitten
• Actieve nesten — drachten 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 formulier voor een nieuw dier
• Paring vastleggen — registreer 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 is elke dag 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?	Beschrijving
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 rasvereniging
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 geboren is
Status	Nee	Actief, Gepensioneerd, Verkocht, Overleden of Mede-eigendom (standaard Actief)
Kleur/Markeringen	Nee	Beschrijf het uiterlijk van het dier
Beschrijving	Nee	Eventuele aanvullende opmerkingen over het dier
Uitgelichte afbeelding	Nee	Klik om de WordPress Media-bibliotheek te openen en een foto te selecteren

4. Klik Dier Opslaan.

Tip voor eerste opzet: Begin met het toevoegen van uw volwassen fokdieren (hengsten en merries) 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 uitgebreide pagina in de plugin. Hier is alles wat u kunt doen:

Informatie Bekijken

• Zie alle ingevoerde details, 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 te herschikken.
• Klik op een foto om deze als uitgelichte afbeelding in te stellen.
• Verwijder foto's die u niet meer nodig heeft.

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, Werpen, 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 ouderrelaties hebt ingevoerd).
• Klik Download Stamboom PDF om een afdrukbaar certificaat te genereren.

Gewichtsgroeidiagram

• 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 vermeldingen.
• 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 zie je een shortcode zoals

. Klik om deze te kopiëren. Je kunt deze in elke WordPress-pagina of -bericht plakken om het profiel van dit dier op je 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?	Beschrijving
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)
Notities	Nee	Eventuele opmerkingen over de paring

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

Dracht bijhouden

Elke actieve nest toont een Zwangerschapsvolger 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, Echo, etc.).

De geboorte registreren (Werpen)

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

Deel 7: Contacten Beheren (Kopers & Wachtlijst)

Een contact toevoegen

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

Veld	Verplicht?	Beschrijving
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
Notities	Nee	Eventuele privénotities over deze contactpersoon

4. Klik Contact Opslaan.

Contactlijstfuncties

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

Deel 8: Dieren Weergeven op Uw Website (Shortcodes)

Shortcodes zijn speciale codes die je in WordPress-pagina's of -berichten plakt om TruePaws-inhoud op je 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 je kunt toevoegen:

Parameter	Wat het doet	Standaard
contact_url="https://..."	Aangepaste link voor de 'Contacteer Fokker'-knop	Jouw instellingen URL
show_ai="true" of "false"	AI zorginformatie tonen of verbergen	waar
show_pedigree="true" of "false"	Toon of verberg de stamboom	waar
show_inquiry_form="true" of "false"	Plaats een enquêteformulier 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 van beschikbare puppy's/kittens met hun foto's en statusbadges.

3. Toon alle beschikbare puppy's/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 aanvraagformulier

[truepaws_inquiry_form]

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

Optionele instellingen:

Parameter	Wat het doet	Standaard
animal_id="123"	Koppel de enquête aan een specifiek dier	(geen)
title="Interested? Get in Touch!"	Aangepaste formuliertitel	"Stuur een verzoek"

Deel 9: PDF-documenten

TruePaws kan twee soorten professionele PDF-documenten genereren:

1. Stamboomcertificaat

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

2. Overdrachtspakket

Aangemaakt vanaf het profiel van een verkocht dier. Bevat diergegevens, 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:

• Worpherinneringen: Verzonden 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 Werkwijze (Stap voor Stap)

Eerste Opstelling

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 ouderschapsrelaties in om stambomen op 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 op en gebruik de Whelping Wizard bij geboortes.
3. Werk de profielen van de nakomelingen bij 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 Overhandigings-PDF.
3. Houd verkooprapporten in de gaten.

Openbare Website

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

Deel 12: Tips & Trucs

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