Der Grund, warum Ihr Code nicht funktioniert, ist ein grundlegender Typografie-Konflikt. KI-Tools und Textverarbeitungsprogramme erzeugen oft „intelligente Anführungszeichen“ (geschweifte Anführungszeichen wie “ und ”). WordPress-Shortcodes und Kernprogrammiersprachen erfordern strikt „gerade Anführungszeichen“ (wie " und '). Wenn Gutenberg geschweifte Anführungszeichen innerhalb eines Shortcode-Klammer sieht, kann es diesen nicht als Code parsen und die Darstellung bricht ab.

Darüber hinaus hat Ihr Kopieren und Einfügen die Tabellen in der Dokumentation vollständig zerstört, indem sie in unlesbare Textblöcke verwandelt wurden. Blindes Kopieren und Einfügen von Rohtext verschlechtert strukturierte Daten.

Ich habe Ihren Text bereinigt. Ich habe alle Typografie in gerade Anführungszeichen umgewandelt, Ihre Shortcodes in Code-Formatierung eingebettet, damit Gutenberg sie nicht ausführt, und Ihre zerstörten Tabellen in ordentliches Markdown zurückverwandelt. Wenn Sie dies direkt in Gutenberg einfügen, sollten automatisch die korrekten Überschriften, Tabellen und Codeblöcke generiert werden.

Hier ist die strukturell korrekte Version:

---

TruePaws — Komplettes Benutzerhandbuch

Was ist TruePaws?

TruePaws ist ein Zuchtverwaltungssystem, das in Ihrer WordPress-Website läuft. Es hilft professionellen Züchtern, ihre Tiere zu verwalten, Zucht und Trächtigkeiten zu verfolgen, Käuferkontakte zu handhaben, offizielle Dokumente (wie Stammbaumzertifikate und Übergabepakete) zu erstellen und sogar verfügbare Welpen/Kätzchen auf Ihrer öffentlichen Website anzuzeigen.

Teil 1: Voraussetzungen (Was Sie vor der Installation benötigen)

1. Eine WordPress-Website

• Sie benötigen eine selbst gehostete WordPress-Website (die Art, die Sie auf Ihrem eigenen Hosting installieren – nicht einen kostenlosen WordPress.com-Blog).
• WordPress-Version 5.0 oder neuer ist erforderlich.

2. Hosting-Anforderungen

• PHP 7.4 oder neuer (die meisten modernen Hosts bieten PHP 8.0+).
• MySQL-Datenbank (Standard bei allen WordPress-Hosts).
• Die WordPress REST API muss aktiviert sein (standardmäßig ist sie aktiviert – nur deaktiviert, wenn jemand sie absichtlich ausgeschaltet hat).

3. Optional (aber empfohlen)

• Ein Google Gemini API-Schlüssel, wenn Sie die KI-gestützten Funktionen nutzen möchten (Pflegeberatung, Gesundheitswarnungen, Marketing-Bio-Generierung). Sie können einen kostenlos von Google AI Studio erhalten.
• Ein Zapier- oder Make-Konto, wenn Sie automatisierte Benachrichtigungen an externe Dienste senden möchten.

Teil 2: Installation des Plugins

Schritt 1 – Plugin hochladen

1. Melden Sie sich in Ihrem WordPress-Admin-Dashboard an (normalerweise yourwebsite.com/wp-admin).
2. Gehen Sie in der linken Seitenleiste zu Plugins → Neu hinzufügen.
3. Klicken Sie auf die Plugin hochladen Schaltfläche oben.
4. Klicken Datei auswählen und wählen Sie die truepaws.zip Datei aus, die Sie erhalten haben.
5. Klicken Jetzt installieren und warten Sie, bis es fertig ist.

Schritt 2 – Plugin aktivieren

1. Nach der Installation klicken Sie auf die Plugin aktivieren Schaltfläche.
2. Das Plugin erstellt automatisch alle benötigten Datenbanktabellen.
3. Sie sehen ein neues TruePaws Menüelement in Ihrer WordPress-Sidebar.

Teil 3: Ersteinrichtung (Machen Sie dies zuerst!)

Nach der Aktivierung gehen Sie zu TruePaws → Einstellungen in deiner WordPress-Seitenleiste. Du siehst mehrere Registerkarten oben. Gehe jede einzeln durch.

Tab 1: Allgemeine Einstellungen

Einstellung	Was es tut	Beispiel
Standard-Spezies	Die Tierart, die Sie hauptsächlich züchten. Optionen: Hund, Katze, Pferd, Kaninchen, Meerschweinchen, Frettchen, Vogel.	Hund
Züchter-Präfix	Ein kurzer Code (max. 5 Zeichen), der bei der automatischen Benennung von Welpen/Kätzchen aus Würfen verwendet wird.	TP
Trächtigkeitsdauer – Hunde	Wie viele Tage eine Hundeschwangerschaft dauert. Standardwert ist 63. Nur ändern, wenn Sie andere Informationen haben.	63
Schwangerschaftsdauer — Katzen	Wie viele Tage eine Katzenschwangerschaft dauert. Standardwert ist 65.	65
Fütterungsanweisungen	Text, der auf den Übergabedokumenten erscheint, die Sie neuen Käufern geben. Schreiben Sie, was das Tier frisst, wie oft und alle besonderen Anweisungen.	“Füttern Sie dreimal täglich mit Royal Canin Welpenfutter…”
Gemini API-Schlüssel	Fügen Sie hier Ihren Google Gemini API-Schlüssel ein, um KI-Funktionen zu aktivieren. Lassen Sie das Feld leer, wenn Sie keine KI-Funktionen wünschen.	(Ihr Schlüssel)
Webhook-URL	Wenn Sie Zapier oder Make für die Automatisierung verwenden, fügen Sie hier die Webhook-URL ein. Lassen Sie das Feld andernfalls leer.	(Ihre Webhook-URL)

Klicken Einstellungen speichern wenn fertig.

Tab 2: Züchterinformationen

Gib deine beruflichen Details ein. Diese Informationen erscheinen auf generierten PDFs (Ahnentafeln, Übergabepakete).

Feld	Was einzugeben ist
Züchtername	Ihr vollständiger Name als Züchter
Geschäftsname	Der Name Ihres Zwingers oder Ihrer Katzenzucht
Lizenznummer	Ihre Zuchtlizenznummer (falls zutreffend)
Telefon	Ihre Geschäftstelefonnummer
E-Mail	Ihre Geschäfts-E-Mail-Adresse

Klicken Einstellungen speichern wenn fertig.

Tab 3: Rassen

Hier verwaltest du die Liste der Rassen, die in Dropdown-Menüs im Plugin verfügbar sind. TruePaws kommt mit 20 häufigen Hunderassen und 20 häufigen Katzenrassen vorinstalliert.

• So fügen Sie eine Rasse hinzu: Geben Sie den Namen der Rasse in das Textfeld ein und klicken Sie auf Rasse hinzufügen.
• So entfernen Sie eine Rasse: Klicken Sie auf die Löschen-Schaltfläche neben einer Rasse in der Liste.

Tipp: Füge jetzt alle Rassen hinzu, mit denen du arbeitest. Du kannst später jederzeit weitere hinzufügen.

Tab 4: Kommunikation

Gib deine Postadresse und die URL deiner Kontaktseite ein. Dies wird für öffentlich zugängliche Funktionen und Shortcodes verwendet.

Feld	Was einzugeben ist
Straßenadresse	Die Straßenadresse Ihres Zwingers
Stadt	Stadt
Bundesland/Provinz	Bundesland oder Provinz
Postleitzahl	Postleitzahl
Land	Land
Kontakt-/Anfrage-URL	Die URL der Kontaktseite Ihrer Website (wird als Standardlink auf "Züchter kontaktieren"-Buttons verwendet)

Klicken Einstellungen speichern wenn fertig.

Tab 5: Verkaufsberichte

Dieser Tab ist nur lesbar — er zeigt deine Verkaufsstatistiken, sobald du mit der Aufzeichnung von Verkäufen beginnst. Du wirst sehen:

• Gesamterlös erzielt
• Gesamtanzahl der Verkäufe
• Durchschnittlicher Verkaufspreis
• Eine monatliche Aufschlüsselungstabelle
• Eine Top-Käufer-Tabelle

Teil 4: Das Dashboard

Wenn du in der Seitenleiste auf TruePaws klickst, landest du auf dem Dashboard. Dies ist deine Basis. Hier siehst du Folgendes:

Statistikkarten

• Gesamttiere – wie viele Tiere sich in Ihrem System befinden
• Aktive Würfe – aktuell verfolgte Trächtigkeiten
• Kontakte – gesamte Käufer und Wartelisteneinträge
• Bevorstehende Ereignisse – bald anstehende Ereignisse (Impfungen, Wurftermine usw.)

Schnellaktionen

• Tier hinzufügen – direkt zum Formular für neue Tiere
• Paarung protokollieren – eine neue Zucht aufzeichnen
• Kontakt hinzufügen – einen neuen Käufer oder Wartelisteneintrag hinzufügen

Checkliste für den Einstieg

• Eine hilfreiche Checkliste, die Sie durch die erste Einrichtung führt.

Aktuelle Veranstaltungen

• Eine Zeitleiste der letzten Ereignisse aller Ihrer Tiere (Impfungen, Tierarztbesuche, Gewichtskontrollen usw.).

Diagramme

• Rassenverteilung – ein Donut-Diagramm, das zeigt, wie viele Tiere Sie von jeder Rasse haben.
• Verkaufsübersicht – ein Balkendiagramm, das den monatlichen Umsatz zeigt.

Aktivitäts-Hitze-Karte

• Eine GitHub-ähnliche Kalenderhitze-Karte, die zeigt, wie aktiv Ihr Zwingert täglich im vergangenen Jahr war. Dunklere Quadrate = mehr protokollierte Ereignisse an diesem Tag.

Teil 5: Tiere hinzufügen und verwalten

Wie man ein neues Tier hinzufügt

1. Zu TruePaws → Tiere (oder klicken Sie auf "Tier hinzufügen" im Dashboard).
2. Klicken Sie auf die Neues Tier hinzufügen Schaltfläche.
3. Formular ausfüllen:

Feld	Erforderlich?	Beschreibung
Name	Ja	Der registrierte/offizielle Name des Tieres
Rufname	Nein	Der Name, mit dem Sie das Tier zu Hause tatsächlich rufen
Registrierungsnummer	Nein	Offizielle Registrierungsnummer Ihres Rassenverbandes
Mikrochip-ID	Nein	Die Mikrochip-Nummer (muss eindeutig sein)
Rasse	Nein	Aus Ihrem Rassenverzeichnis auswählen
Geschlecht	Ja	Männlich oder Weiblich
Vater	Nein	Aus vorhandenen männlichen Tieren in Ihrem System auswählen
Mutter	Nein	Aus vorhandenen weiblichen Tieren in Ihrem System auswählen
Geburtsdatum	Nein	Datum, an dem das Tier geboren wurde
Status	Nein	Aktiv, im Ruhestand, verkauft, verstorben oder im Mitbesitz (Standard: Aktiv)
Farbe/Abzeichen	Nein	Beschreiben Sie das Aussehen des Tieres
Beschreibung	Nein	Weitere Anmerkungen zum Tier
Hauptbild	Nein	Klicken Sie, um die WordPress-Mediathek zu öffnen und ein Foto auszuwählen

4. Klicken Tier speichern.

Tipp für die Erstinstallation: Beginnen Sie damit, zuerst Ihre erwachsenen Zuchttiere (Väter und Mütter) hinzuzufügen. Auf diese Weise können Sie, wenn Sie jüngere Tiere oder Welpen hinzufügen, deren Eltern aus den Dropdown-Menüs auswählen.

Die Tierprofilseite

Nach dem Speichern klicken Sie auf den Namen eines Tieres, um dessen Profilseite zu sehen. Dies ist die funktionsreichste Seite des Plugins. Hier ist alles, was Sie tun können:

Informationen anzeigen

• Sehen Sie alle eingegebenen Details plus ein Statusbadge (z.B. "Aktiv" in grün, "Verkauft" in blau).
• Das hervorgehobene Bild wird prominent angezeigt, mit einer Fallback-Silhouette, falls kein Foto hochgeladen wurde.

Fotogalerie

• Laden Sie mehrere Fotos hoch, indem Sie auf "Fotos hinzufügen" klicken.
• Ziehen Sie Fotos per Drag & Drop, um sie neu anzuordnen.
• Klicken Sie auf ein Foto, um es als hervorgehobenes Bild festzulegen.
• Löschen Sie Fotos, die Sie nicht mehr benötigen.

Zeitleiste & Ereignisse

Die Zeitleiste zeigt eine chronologische Geschichte alles dessen, was mit diesem Tier passiert ist. Um ein neues Ereignis hinzuzufügen:

1. Klicken Sie auf die Ereignis hinzufügen Schaltfläche.
2. Wählen Sie den Ereignistyp: Geburt, Impfung, Läufigkeit, Paarung, Welpen, Gewicht, Tierarztbesuch oder Notiz.
3. Geben Sie das Datum und einen Titel/eine Beschreibung ein.
4. Für Gewichtsereignisse geben Sie den Gewichtswert ein.
5. Klicken Speichern.

Stammbaum

• Zeigt einen 3-Generationen-Stammbaum mit Eltern, Großeltern und Urgroßeltern an. (Funktioniert nur, wenn Sie Elternbeziehungen eingetragen haben).
• Klicken Stammbaum-PDF herunterladen um ein druckbares Zertifikat zu erstellen.

Gewichtszunahme-Diagramm

• Wenn Sie Gewichtsereignisse protokolliert haben, wird ein Liniendiagramm angezeigt, das das Gewicht des Tieres über die Zeit darstellt.

KI-Funktionen (erfordert Gemini API-Schlüssel)

• KI-Pflegeberatung — generiert personalisierte Pflegeempfehlungen basierend auf Rasse, Alter und Geschichte des Tieres.
• KI-Marketing-Bio — verfasst eine ansprechende Beschreibung für Ihre Website oder Social-Media-Listings.
• KI-Gesundheitswarnungen — analysiert die Ereignishistorie und markiert potenzielle Gesundheitssorgen.

Ein Tier verkaufen

1. Auf dem Profil des Tieres klicken Sie auf Verkaufen / Reservieren.
2. Wählen Sie den Käufer aus Ihrer Kontaktliste aus.
3. Geben Sie das Verkaufsdatum und den Preis ein.
4. Fügen Sie optional Notizen hinzu.
5. Klicken Verkauf bestätigen.
6. Der Status des Tieres ändert sich zu „Verkauft“.
7. Klicken Übergabe-PDF generieren um ein professionelles Übergabedokument zu erstellen.

Shortcode kopieren

Am Ende des Profils sehen Sie einen Shortcode wie

. Klicken Sie, um ihn zu kopieren. Sie können diesen in jede WordPress-Seite oder jeden Beitrag einfügen, um das Profil dieses Tieres auf Ihrer öffentlichen Website anzuzeigen.

Teil 6: Zucht & Wurfmanagement

Neue Paarung protokollieren

1. Zu TruePaws → Würfe.
2. Klicken Neue Paarung erfassen.
3. Formular ausfüllen:

Feld	Erforderlich?	Beschreibung
Vater	Ja	Wählen Sie den Rüden aus Ihren Tieren aus
Mutter	Ja	Wählen Sie die Hündin aus Ihren Tieren aus
Paarungsdatum	Ja	Das Datum, an dem die Zucht stattgefunden hat
Methode	Nein	Natürliche oder künstliche Besamung (KB)
Notizen	Nein	Anmerkungen zur Paarung

4. Klicken SpeichernDas System berechnet automatisch das erwartete Wurfdatum basierend auf Ihren Schwangerschaftsdauereinstellungen.

Trächtigkeit verfolgen

Jeder aktive Wurf zeigt eine Trächtigkeitsverfolgung Karte mit:

• Ein Fortschrittsbalken, der anzeigt, wie weit die Schwangerschaft fortgeschritten ist.
• Trimester-Anzeige (Früh / Mitte / Spät).
• Tage bis zum erwarteten Wurf.
• Bevorstehende Meilensteine (Einnistung, Herzschlag, Ultraschall usw.).

Die Geburt aufnehmen (Wurf)

1. Zu TruePaws → Würfe.
2. Suchen Sie den Wurf und klicken Sie Wurf erfassen.
3. Schritt 1 – Geburt erfassen: Geben Sie das tatsächliche Wurfdatum, die Anzahl der männlichen/weiblichen Welpen ein und sehen Sie sich die automatisch generierten Namen an.
4. Schritt 2 – Bestätigung: Überprüfen Sie die Zusammenfassung und klicken Sie auf „Senden“. Das System erstellt automatisch individuelle Einträge für jeden Welpen, weist Eltern zu, erfasst ein Geburtsereignis und setzt ihren Status auf „Aktiv“.

Teil 7: Kontakte verwalten (Käufer & Warteliste)

Kontakt hinzufügen

1. Zu TruePaws → Kontakte.
2. Klicken Neuen Kontakt hinzufügen.
3. Formular ausfüllen:

Feld	Erforderlich?	Beschreibung
Vorname	Ja	Vorname des Käufers
Nachname	Nein	Nachname des Käufers
E-Mail	Ja	E-Mail-Adresse des Käufers
Telefon	Nein	Telefonnummer
Adresse	Nein	Postadresse
Status	Nein	Warteliste, Reserviert, Käufer oder Inaktiv
Notizen	Nein	Private Notizen zu diesem Kontakt

4. Klicken Kontakt speichern.

Kontaktlisten-Funktionen

• Nach Status filtern — nur Warteliste, Reservierte, Käufer oder inaktive Kontakte anzeigen.
• Als CSV exportieren — alle Kontakte als Tabellendatei für E-Mail-Marketing-Tools herunterladen.

Teil 8: Tiere auf Ihrer Website anzeigen (Shortcodes)

Shortcodes sind spezielle Codes, die Sie in WordPress-Seiten oder Beiträge einfügen, um TruePaws-Inhalte auf Ihrer öffentlichen Website anzuzeigen.

1. Einzelnes Tier anzeigen

[truepaws_animal id="7"]

(Ersetzen Sie 123 durch die tatsächliche ID-Nummer des Tieres)

Optionale Einstellungen, die Sie hinzufügen können:

Parameter	Was es tut	Standard
contact_url="https://..."	Benutzerdefinierter Link für den „Züchter kontaktieren“-Button	Ihre Einstellungs-URL
show_ai="true" oder "false"	KI-Pflegeinformationen anzeigen oder ausblenden	wahr
show_pedigree="true" oder "false"	Stammbaum ein- oder ausblenden	wahr
show_inquiry_form="true" oder "false"	Ein Anfrageformular unter dem Tier einbetten	falsch
show_gallery="true" oder "false"	Fotogalerie ein- oder ausblenden	wahr
gallery_columns="3"	Anzahl der Spalten für die Galerie (2 bis 6)	4

Beispiel mit Optionen:

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

2. Ein Wurf anzeigen

[truepaws_litter id="1"]

Dies zeigt die Informationen des Wurfs einschließlich der Eltern, des Geburtsdatums und einer Übersicht der verfügbaren Welpen/Kätzchen mit ihren Fotos und Statusbadges.

3. Alle verfügbaren Welpen/Kätzchen anzeigen

[truepaws_available_puppies]

Dies zeigt eine Übersicht aller Tiere mit dem Status „Aktiv“.

Optionale Einstellungen:

Parameter	Was es tut	Standard
limit="6"	Maximale Anzahl anzuzeigender Tiere	12
breed="Golden Retriever"	Nur Tiere dieser Rasse anzeigen	(alle Rassen)
show_images="true" oder "false"	Fotos ein- oder ausblenden	wahr

Beispiel:

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

4. Ein Anfrageformular anzeigen

[truepaws_inquiry_form]

Dies zeigt ein Kontaktformular an, das Besucher ausfüllen können, um sich nach Ihren Tieren zu erkundigen.

Optionale Einstellungen:

Parameter	Was es tut	Standard
animal_id="123"	Anfrage mit einem bestimmten Tier verlinken	(keine)
title="Interested? Get in Touch!"	Benutzerdefinierter Formulartitel	„Anfrage senden“

Teil 9: PDF-Dokumente

TruePaws kann zwei Arten von professionellen PDF-Dokumenten generieren:

1. Ahnentafel-Zertifikat

Wird von der Profilseite eines Tieres generiert. Enthält den Namen des Tieres, Registrierungsdetails, einen 3-Generationen-Stammbaum und Ihren Züchternamen.

2. Übergabe-Paket

Wird von einem verkauften Tier generiert. Enthält Tierdetails, Ahnentafel-Vorschau, vollständige Gesundheitshistorie, Fütterungsanweisungen, Pflegeempfehlungen, Vertrag/Bedingungen und Ihre Züchterinformationen.

Hinweis: Für die beste PDF-Qualität bitten Sie Ihren Webhost, sicherzustellen, dass die TCPDF- oder Dompdf-PHP-Bibliothek installiert ist.

Teil 10: Automatisierte E-Mail-Benachrichtigungen

TruePaws führt täglich eine Überprüfung durch und sendet Ihnen E-Mail-Erinnerungen für:

• Wurf-Erinnerungen: Wird 7 Tage vor dem erwarteten Wurftermin versendet.
• Impfungen Erinnerungen: Erinnert Sie an wichtige Meilensteine (6 Wochen, 9 Wochen, 12 Wochen, 16 Wochen, 1 Jahr, 2 Jahre, 3 Jahre).

Wichtig: Diese E-Mails werden an die Adresse gesendet, die Sie unter Einstellungen → Züchterinfo → E-Mail eingegeben haben.

Teil 11: Empfohlener Arbeitsablauf (Schritt für Schritt)

Ersteinrichtung

1. Installieren und aktivieren Sie das Plugin.
2. Gehen Sie zu Einstellungen und füllen Sie alle Registerkarten aus.
3. Fügen Sie Ihre benutzerdefinierten Rassen hinzu.

Aufbau Ihrer Datenbank

1. Fügen Sie zuerst alle Ihre erwachsenen Zuchttiere hinzu (Väter und Mütter).
2. Laden Sie Fotos hoch und füllen Sie die Registrierungsdaten aus.
3. Legen Sie Elternbeziehungen fest, um Stammbäume zu erstellen.
4. Fügen Sie historische Ereignisse hinzu, um die Zeitleiste jedes Tieres aufzubauen.

Tägliche Nutzung

1. Wenn eine Paarung stattfindet, protokollieren Sie sie unter Würfe.
2. Verfolgen Sie Trächtigkeiten und nutzen Sie den Wurf-Assistenten bei Geburten.
3. Aktualisieren Sie die Profile der Nachkommen, während sie wachsen.
4. Fügen Sie Käufer zur Kontaktliste hinzu.

Verkauf

1. Wenn ein Tier verkauft wird, verwenden Sie die Verkauf/Reservierung-Funktion auf seinem Profil.
2. Generieren Sie das Übergabe-PDF.
3. Überwachen Sie Verkaufsberichte.

Öffentliche Website

1. Erstellen Sie eine Seite „Verfügbare Welpen“ mit: truepaws_available_puppies Shortcode
2. Erstellen Sie individuelle Seiten mit truepaws_animal id="..." Shortcode
3. Hinzufügen truepaws_inquiry_form Shortcode zu Ihrer Kontaktseite.

Teil 12: Tipps & Tricks

• Nutzen Sie die Aktivitäts-Heatmap im Dashboard, um Lücken in Ihrer Dokumentation zu erkennen.
• Exportieren Sie Kontakte regelmäßig als CSV, um Ihre Mailingliste aktuell zu halten.
• Die KI-Marketing-Biografie kann Ihnen Zeit beim Verfassen von Anzeigen sparen.
• Protokollieren Sie wöchentlich die Gewichte der Welpen und nutzen Sie das Wachstumsdiagramm, um frühzeitig Probleme zu erkennen.
• Nutzen Sie den animal_id Parameter in Anfrageformularen, um spezifische Tieranfragen zu verfolgen.
• Verwenden Sie den Status „Mitbesitz“ für Tiere, die zwischen Züchtern geteilt werden.