Der Grund, warum Ihr Code abgebrochen ist, ist ein grundlegender Konflikt in der Typografie. 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-Klammern sieht, kann es diesen nicht als Code parsen und bricht das Rendering ab.

Darüber hinaus hat Ihr Kopieren und Einfügen die Tabellen in der Dokumentation vollständig zerstört und sie in unlesbare Textblöcke verwandelt. 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 korrektes Markdown neu aufgebaut. Wenn Sie dies direkt in Gutenberg einfügen, sollten automatisch die richtigen Überschriften, Tabellen und Codeblöcke generiert werden.

Hier ist die strukturell korrekte Version:

---

TruePaws — Vollständige Benutzeranleitung

Was ist TruePaws?

TruePaws ist ein Zuchtverwaltungssystem, das innerhalb 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 – kein kostenloser 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+ an).
• MySQL-Datenbank (Standard bei allen WordPress-Hosts).
• Die WordPress REST API muss aktiviert sein (sie ist standardmäßig 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 bei 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 – Laden Sie das Plugin hoch

1. Melden Sie sich bei 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 Sie Datei auswählen und wählen Sie das truepaws.zip Datei, die Sie erhalten haben.
5. Klicken Sie Jetzt installieren und warten Sie, bis es fertig ist.

Schritt 2 – Aktivieren Sie das Plugin

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

Teil 3: Ersteinrichtung (Machen Sie dies zuerst!)

Nach der Aktivierung gehen Sie zu TruePaws → Einstellungen in Ihrer WordPress-Sidebar. Sie sehen mehrere Registerkarten oben. Arbeiten Sie jede durch.

Reiter 1: Allgemeine Einstellungen

Einstellungen	Funktionsweise	Beispiel
Standard-Tierart	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 verwendet wird, um Welpen/Kätzchen aus Würfen automatisch zu benennen.	TP
Trächtigkeitsdauer – Hunde	Wie viele Tage eine Hundeträchtigkeit dauert. Standard ist 63. Nur ändern, wenn Sie andere Werte kennen.	63
Trächtigkeitsdauer – Katzen	Wie viele Tage eine Katzenträchtigkeit dauert. Standard 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 Sie Einstellungen speichern wenn fertig.

Tab 2: Züchterinformationen

Geben Sie Ihre beruflichen Details ein. Diese Informationen erscheinen auf generierten PDFs (Stammbaumzertifikate, Übergabepakete).

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

Klicken Sie Einstellungen speichern wenn fertig.

Tab 3: Rassen

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

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

Tipp: Fügen Sie jetzt alle Rassen hinzu, mit denen Sie arbeiten. Sie können später jederzeit weitere hinzufügen.

Tab 4: Kommunikation

Geben Sie Ihre Postanschrift und die URL Ihrer 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 Ihrer Kontaktseite (wird als Standardlink für 'Züchter kontaktieren'-Buttons verwendet)

Klicken Sie Einstellungen speichern wenn fertig.

Tab 5: Verkaufsberichte

Diese Registerkarte ist schreibgeschützt – sie zeigt Ihre Verkaufsstatistiken an, sobald Sie beginnen, Verkäufe zu erfassen. Sie werden sehen:

• Gesamterlös erzielt
• Gesamtzahl der Verkäufe
• Durchschnittlicher Verkaufspreis
• Eine monatliche Aufstellungstabelle
• Eine Tabelle der Top-Käufer

Teil 4: Das Dashboard

Wenn Sie in der Sidebar auf TruePaws klicken, landen Sie auf dem Dashboard. Dies ist Ihre Basis. Hier ist, was Sie sehen werden:

Statistik-Karten

• Gesamtzahl der Tiere – wie viele Tiere sind in Ihrem System
• Aktive Würfe – Schwangerschaften, die derzeit verfolgt werden
• Kontakte – Gesamtzahl der Käufer und Wartelisteneinträge
• Bevorstehende Ereignisse – bald anstehende Ereignisse (Impfungen, Wurftermine usw.)

Schnelle Aktionen

• 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 Erstinstallation führt.

Neueste Ereignisse

• Eine Zeitleiste der jüngsten Ereignisse bei allen Ihren Tieren (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-Hitmap

• Ein GitHub-ähnlicher Kalender-Heatmap, der zeigt, wie aktiv Ihre Zuchtstätte jeden Tag im vergangenen Jahr war. Dunklere Quadrate = mehr Ereignisse an diesem Tag.

Teil 5: Hinzufügen und Verwalten von Tieren

Wie man ein neues Tier hinzufügt

1. Gehe zu TruePaws → Tiere (oder klicken Sie auf „Tier hinzufügen“ im Dashboard).
2. Klicken Sie auf die Neues Tier hinzufügen Schaltfläche.
3. Füllen Sie das Formular aus:

Feld	Erforderlich?	Beschreibung
Name	Ja	Der registrierte/offizielle Name des Tieres
Rufname	Nein	Der Name, den Sie zu Hause verwenden
Registrierungsnummer	Nein	Offizielle Registrierungsnummer Ihrer Rassevereinigung
Microchip-ID	Nein	Die Microchip-Nummer (muss eindeutig sein)
Rasse	Nein	Aus Ihrer Rassenliste auswählen
Geschlecht	Ja	Männlich oder Weiblich
Vater	Nein	Wählen Sie aus vorhandenen männlichen Tieren in Ihrem System
Mutter	Nein	Wählen Sie aus vorhandenen weiblichen Tieren in Ihrem System
Geburtsdatum	Nein	Datum, an dem das Tier geboren wurde
Status	Nein	Aktiv, im Ruhestand, verkauft, verstorben oder im Co-Besitz (Standard ist Aktiv)
Farbe/Markierungen	Nein	Beschreiben Sie das Aussehen des Tieres
Beschreibung	Nein	Alle zusätzlichen Notizen über das Tier
Beitragsbild	Nein	Klicken Sie, um die WordPress-Mediathek zu öffnen und ein Foto auszuwählen

4. Klicken Sie Tier speichern.

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

Die Tierprofilseite

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

Informationen anzeigen

• Sehen Sie alle eingegebenen Details sowie ein Status-Badge (z.B. „Aktiv“ in grün, „Verkauft“ in blau).
• Das Hauptbild wird prominent angezeigt, mit einer Silhouette als Fallback, falls kein Foto hochgeladen wurde.

Fotogalerie

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

Zeitleiste & Ereignisse

Die Zeitleiste zeigt eine chronologische Geschichte aller Ereignisse, die diesem Tier widerfahren sind. So fügen Sie ein neues Ereignis hinzu:

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

Stammbaum

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

Gewichtsentwicklungsdiagramm

• Wenn Sie Gewichtsereignisse protokolliert haben, wird ein Liniendiagramm angezeigt, das das Gewicht des Tieres im Zeitverlauf zeigt.

KI-Funktionen (benötigt Gemini API-Schlüssel)

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

Verkauf eines Tieres

1. Klicken Sie auf das Profil des Tieres 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 Sie Verkauf bestätigen.
6. Der Status des Tieres ändert sich auf „Verkauft“.
7. Klicken Sie Ü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

Eine neue Paarung erfassen

1. Gehe zu TruePaws → Würfe.
2. Klicken Sie Neue Paarung protokollieren.
3. Füllen Sie das Formular aus:

Feld	Erforderlich?	Beschreibung
Vater	Ja	Wählen Sie das männliche Tier aus Ihren Tieren aus
Mutter	Ja	Wählen Sie das Weibchen aus Ihren Tieren aus
Paarungsdatum	Ja	Das Datum, an dem die Zucht stattfand
Methode	Nein	Natürliche oder künstliche Besamung (KB)
Notizen	Nein	Alle Notizen zur Paarung

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

Trächtigkeit verfolgen

Jeder aktive Wurf zeigt eine Schwangerschafts-Tracker Karte mit:

• Eine Fortschrittsleiste, die zeigt, wie weit die Schwangerschaft fortgeschritten ist.
• Trimester-Indikator (Früh / Mitte / Spät).
• Tage bis zum erwarteten Wurf.
• Kommende Meilensteine (Implantation, Herzschlag, Ultraschall usw.).

Die Geburt aufzeichnen (Wurf)

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

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

Einen Kontakt hinzufügen

1. Gehe zu TruePaws → Kontakte.
2. Klicken Sie Neuen Kontakt hinzufügen.
3. Füllen Sie das Formular aus:

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	Postanschrift
Status	Nein	Warteliste, Reserviert, Käufer oder Inaktiv
Notizen	Nein	Private Notizen zu diesem Kontakt

4. Klicken Sie Kontakt speichern.

Kontaktlistenfunktionen

• Nach Status filtern — nur Warteliste, Reservierte, Käufer oder inaktive Kontakte anzeigen.
• In CSV exportieren — Laden Sie alle Kontakte als Tabellenkalkulationsdatei für E-Mail-Marketing-Tools herunter.

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. Ein 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	Funktionsweise	Standard
contact_url="https://..."	Benutzerdefinierter Link für die Schaltfläche „Züchter kontaktieren“	Ihre Einstellungs-URL
show_ai="true" oder "false"	AI-Pflegeinformationen anzeigen oder ausblenden	wahr
show_pedigree="true" oder "false"	Stammbaum anzeigen oder ausblenden	wahr
show_inquiry_form="true" oder "false"	Ein Anfrageformular unter dem Tier einbetten	falsch
show_gallery="true" oder "false"	Fotogalerie anzeigen 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. Einen 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 Status-Badges.

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

[truepaws_available_puppies]

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

Optionale Einstellungen:

Parameter	Funktionsweise	Standard
limit="6"	Maximale Anzahl der anzuzeigenden 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	Funktionsweise	Standard
animal_id="123"	Die Anfrage mit einem bestimmten Tier verknüpfen	(keine)
title="Interested? Get in Touch!"	Benutzerdefinierter Formulartitel	„Eine Anfrage senden“

Teil 9: PDF-Dokumente

TruePaws kann zwei Arten von professionellen PDF-Dokumenten erstellen:

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. Übergabepaket

Wird von der Profilseite eines verkauften Tieres generiert. Enthält Tierdetails, eine 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: 7 Tage vor dem erwarteten Wurfdatum versendet.
• Impf-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 Workflow (Schritt für Schritt)

Ersteinrichtung

1. Installieren und aktivieren Sie das Plugin.
2. Gehen Sie zu den Einstellungen und füllen Sie alle Registerkarten aus.
3. Fügen Sie Ihre eigenen 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 zu erstellen.

Tägliche Nutzung

1. Wenn eine Paarung stattfindet, protokollieren Sie sie unter Würfe.
2. Verfolgen Sie Trächtigkeiten und verwenden Sie den Wurf-Assistenten, wenn Geburten stattfinden.
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 Funktion Verkaufen/Reservieren 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 regelmäßig Kontakte in eine CSV-Datei, um Ihre Mailingliste aktuell zu halten.
• Die KI-Marketing-Bio 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.
• Verwenden Sie den animal_id Parameter auf Anfrageformularen, um spezifische Tieranfragen zu verfolgen.
• Verwenden Sie den Status „Mitbesitz“ für Tiere, die zwischen Züchtern geteilt werden.