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 zurückgebaut. 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+).
• 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 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 – Laden Sie das Plugin hoch

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 Sie Datei auswählen und wählen Sie die truepaws.zip Datei aus, 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.

Tab 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 bei der automatischen Benennung von Welpen/Kätzchen aus Würfen verwendet wird.	TP
Trächtigkeitsdauer – Hunde	Wie viele Tage eine Hunde-Schwangerschaft dauert. Standard sind 63. Nur ändern, wenn Sie es besser wissen.	63
Schwangerschaftsdauer — Katzen	Wie viele Tage eine Katzen-Schwangerschaft dauert. Standard sind 65.	65
Fütterungsanweisungen	Text, der in den Übergabedokumenten für neue Käufer erscheint. Schreiben Sie, was das Tier frisst, wie oft und gegebenenfalls besondere Anweisungen.	„3-mal täglich mit Royal Canin Welpenfutter füttern…“
Gemini API-Schlüssel	Fügen Sie hier Ihren Google Gemini API-Schlüssel ein, um KI-Funktionen zu aktivieren. Leer lassen, wenn Sie keine KI-Funktionen wünschen.	(Ihr Schlüssel)
Webhook-URL	Wenn Sie Zapier oder Make für Automatisierung nutzen, fügen Sie hier die Webhook-URL ein. Ansonsten leer lassen.	(Ihre Webhook-URL)

Klicken Sie Einstellungen speichern wenn fertig.

Tab 2: Züchterinformationen

Tragen Sie Ihre 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	Ihr Zwingername oder Katzenzuchtname
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 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 Rassenamen 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ügen Sie jetzt alle Rassen hinzu, mit denen Sie arbeiten. Sie können später jederzeit weitere hinzufügen.

Tab 4: Kommunikation

Tragen Sie Ihre Postadresse und die URL Ihrer Kontaktseite ein. Dies wird für öffentlich sichtbare Funktionen und Shortcodes verwendet.

Feld	Was einzugeben ist
Straßenadresse	Die Straßenadresse Ihres Zwingers
Stadt	Stadt
Bundesland/Provinz	Bundesland oder Provinz
PLZ/Postleitzahl	Postleitzahl
Land	Land
Kontakt-/Anfrage-URL	Die URL der Kontaktseite Ihrer Website (wird als Standardlink auf "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 mit der Aufzeichnung von Verkäufen beginnen. Sie werden sehen:

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

Teil 4: Das Dashboard

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

Statistik-Karten

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

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 anlegen

Checkliste für den Einstieg

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

Aktuelle Ereignisse

• Eine Zeitleiste der jüngsten Ereignisse aller Ihrer Tiere (Impfungen, Tierarztbesuche, Gewichtskontrollen etc.).

Diagramme

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

Aktivitäts-Hitze-Karte

• Eine GitHub-ähnliche Kalender-Heatmap, die zeigt, wie aktiv Ihre Zuchtstätte an jedem Tag im vergangenen Jahr war. Dunklere Quadrate = mehr protokollierte 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. Formular ausfüllen:

Feld	Erforderlich?	Beschreibung
Name	Ja	Der registrierte/offizielle Name des Tieres
Rufname	Nein	Der Name, den Sie das Tier zu Hause tatsächlich rufen
Registrierungsnummer	Nein	Offizielle Registrierungsnummer Ihres Rasseverbands
Mikrochip-ID	Nein	Die Mikrochip-Nummer (muss eindeutig sein)
Rasse	Nein	Aus Ihrer Rassenliste 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 ist Aktiv)
Farbe/Markierungen	Nein	Beschreiben Sie das Aussehen des Tieres
Beschreibung	Nein	Weitere Notizen über das Tier
Hervorgehobenes Bild	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, 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 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/eine Beschreibung ein.
4. Für Gewichtsereignisse geben Sie den Gewichtswert ein.
5. Klicken Sie Speichern.

Stammbaum

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

Gewichtsentwicklungsdiagramm

• Wenn Sie Gewichtsereignisse erfasst haben, erscheint ein Liniendiagramm, das das Gewicht des Tieres über die Zeit anzeigt.

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 Gesundheitsbedenken.

Ein Tier verkaufen

1. Klicken Sie auf dem Profil des Tieres 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 Sie Verkauf bestätigen.
6. Der Status des Tieres ändert sich zu „Verkauft“.
7. Klicken Sie Übergabe-PDF generieren um ein professionelles Übergabedokument zu erstellen.

Shortcode kopieren

Am unteren 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 erfassen.
3. Formular ausfüllen:

Feld	Erforderlich?	Beschreibung
Vater	Ja	Wählen Sie das männliche Tier aus Ihren Tieren aus
Mutter	Ja	Wählen Sie das weibliche Tier aus Ihren Tieren aus
Paarungsdatum	Ja	Das Datum der Zucht
Methode	Nein	Natürliche oder künstliche Besamung (KB)
Notizen	Nein	Notizen über die Paarung

4. Klicken Sie Speichern.Das System berechnet automatisch das erwartete Wurfdatum basierend auf Ihren Einstellungen zur Trächtigkeitsdauer.

Trächtigkeit verfolgen

Jeder aktive Wurf zeigt eine Trächtigkeits-Tracker Karte mit:

• Eine Fortschrittsanzeige, die zeigt, wie weit die Trächtigkeit fortgeschritten ist.
• Trimester-Anzeige (Früh / Mitte / Spät).
• Tage bis zum erwarteten Wurf.
• Bevorstehende Meilensteine (Einnistung, Herzschlag, Ultraschall usw.).

Die Geburt aufzeichnen (Wurf)

1. Gehe zu TruePaws → Würfe.
2. Suchen Sie den Wurf und klicken Sie Wurf erfassen.
3. Schritt 1 – Geburt protokollieren: 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 Datensätze für jeden Nachkommen, weist Eltern zu, zeichnet ein Geburtsereignis auf und setzt ihren 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. 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	Postanschrift
Status	Nein	Warteliste, Reserviert, Käufer oder Inaktiv
Notizen	Nein	Private Notizen zu diesem Kontakt

4. Klicken Sie 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	Funktionsweise	Standard
contact_url="https://..."	Benutzerdefinierter Link für den „Züchter kontaktieren“-Button	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. Ein Wurf anzeigen

[truepaws_litter id="1"]

Dies zeigt die Informationen des Wurfs einschließlich der Eltern, des Geburtsdatums und einer Rasteransicht 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 Rasteransicht aller Tiere mit dem Status „Aktiv“.

Optionale Einstellungen:

Parameter	Funktionsweise	Standard
limit="6"	Maximale Anzahl anzuzeigender Tiere	12
breed="Golden Retriever"	Nur Tiere dieser Rasse anzeigen	(alle Rassen)
show_images="true" oder "false"	Fotos anzeigen 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 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. Übergabepaket

Wird vom Profil eines verkauften Tieres 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:

• Wurferinnerungen: Wird 7 Tage vor dem erwarteten Wurfdatum versendet.
• Impf-Erinnerungen: Erinnert Sie an wichtigen Meilensteinen (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 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 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, nutzen Sie die Funktion Verkaufen/Reservieren auf seinem Profil.
2. Generieren Sie das Übergabe-PDF.
3. Überwachen Sie Verkaufsberichte.

Öffentliche Website

1. Erstellen Sie eine "Verfügbare Welpen"-Seite 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.
• Verwenden Sie den animal_id Parameter auf Anfrageformularen, um spezifische Tieranfragen zu verfolgen.
• Verwenden Sie den Status "Gemeinsam besessen" für Tiere, die zwischen Züchtern geteilt werden.