Reptilien Manager releases

=== Reptilien Manager === Contributors: feroxz Tags: reptilien, bartagame, zucht, genetik, futterplan Requires at least: 6.0 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.21.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Verwaltung von Reptilien – Bartagame und Grüner Leguan: Tiere mit Fotos und Daten, artspezifische Genetik-Vorschau und artgerechte Futterplanung.

== Description ==

Reptilien Manager hilft Haltern und Züchtern von Reptilien bei der Verwaltung ihres Bestands. Genetik und Futterplan sind artspezifisch – aktuell für Bartagame (Pogona vitticeps, Allesfresser) und Grünen Leguan (Iguana iguana, strikter Pflanzenfresser):

Tierverwaltung

• Eigene Tiere als eigener Inhaltstyp „Reptilien“ mit Profilfoto und Fotogalerie
• Stammdaten: Geschlecht, Schlupfdatum (mit automatischer Altersberechnung), Herkunft/Züchter, Erwerbsdatum, Kennzeichnung, Gesamtlänge
• Erweiterte Morphologie & Kondition: KRL, Schwanzlänge, Umfang, Körperkonditions-Score (BCS 1–5), Temperament (1–5), Farbintensität und Häutungs-Intervall
• Gewichtsverlauf als interaktive Chart.js-Graphik (Alter × Gewicht) mit erwarteter Referenz-Wachstumskurve pro Art, Anomalie-Erkennung (unter-/übergewichtig) und CSV-Export
• Freitext für Haltung, Gesundheit und Besonderheiten
• Tierart direkt im Tier-Formular auswählbar (aus den angelegten Arten); die Genetik-Felder aktualisieren sich sofort per AJAX passend zur Art, ohne Zwischenspeichern
• Arten-Taxonomie mit vorbereiteten Profilen: Bartagame (Pogona vitticeps) und Grüner Leguan (Iguana iguana) – Genetik-Set und Futterplan richten sich automatisch nach der zugeordneten Art
• Beitrags-Vorlagen: Steckbrief (Tabelle), Ausführliches Porträt, Zuchttier-Präsentation und Kurzprofil – der Beitragstext wird per Klick automatisch aus den eingetragenen Daten erzeugt, inklusive Profilfoto und Galerie (Gutenberg-Blöcke, Classic-Editor-kompatibel)
• Die Vorlagen zeigen automatisch Verpaarungen und Nachzuchten des Tieres – mit Verlinkung zum Partner und zu den Nachzucht-Tieren sowie Gelege-Übersicht (Eier, geschlüpft, erwarteter Schlupf)
• Ansprechendes Layout: Banner-Karte mit Name und Morph, Foto neben Datentabelle, gestreifte Tabellen, Galerie-Raster und Abschnitts-Icons
• Direkter Bild-Upload in der Fotogalerie des Tieres (zusätzlich zur Mediathek-Auswahl)

Genetik & Verpaarung

• Artspezifische Genanlagen pro Tier:
  • Bartagame: Hypo, Translucent, Zero, Witblits, Genetic Stripe (rezessiv), Leatherback/Silkback (unvollständig dominant), Dunner (dominant); Kombi-Morph Wero (Zero × Witblits)
  • Grüner Leguan: Albino (amelanistisch), Axanthic/Blau, Hypomelanistisch, Erythristisch/Rot, Leucistisch/Weiß (alle rezessiv); Kombi-Morphe Snow (Albino × Axanthic), Sunglow (Albino × Erythristisch) und Ghost (Hypo × Axanthic)
• Die Genetik-Vorschau nutzt automatisch das Gen-Set der Art; bei Elterntieren unterschiedlicher Arten wird gewarnt
• Verpaarungen planen: Vater und Mutter auswählen, Verpaarungsdatum und Inkubationstemperatur festhalten
• Gelege-Verwaltung pro Verpaarung: mehrere Gelege mit Ablagedatum, Anzahl gelegter Eier, tatsächlich geschlüpfter Anzahl und automatisch berechnetem ungefähren Schlupfdatum (Ablage + 60 Tage)
• Gelege-Verwaltung 2.0: pro Gelege Inkubationstemperatur, unbefruchtete und abgestorbene Eier (mit Absterbe-Tag); temperaturabhängige Schlupf-Vorhersage (z. B. 28 °C ≈ Tag 58–65, 31 °C ≈ Tag 50–54) mit grafischer Timeline; Schlupfquote in Prozent inkl. Vergleich zum Bestands-Durchschnitt
• Nachzuchten werden beim Speichern automatisch als Tier-Entwürfe angelegt (pro Gelege entsprechend der geschlüpften Anzahl) – verknüpft mit der Verpaarung, inkl. Schlupfdatum und Art
• Abstammung am Tier: eigene Nachzuchten können ihrer Eltern-Verpaarung (und dem Gelege) zugeordnet werden
• Genetik-Vorschau der Jungtiere nach Mendelscher Vererbung (Punnett): kombinierte Ergebnisse mit Wahrscheinlichkeiten sowie Aufschlüsselung pro Gen, inkl. Kombi-Morph Wero (Zero × Witblits)
• Eigenständiger Genetik-Rechner zum Durchspielen beliebiger Paarungen
• Inzucht-Koeffizient (COI nach Wright) für jede geplante Verpaarung – berechnet aus der hinterlegten Abstammung, mit Warnstufen (Geschwister/Halbgeschwister/entfernt)
• Verpaarungs-Empfehlungen: alle Kombinationen nach genetischer Vielfalt (niedriger COI), Artgleichheit und Zuchtreife sortiert; Zuchtstatistik pro Tier (Verpaarungen, Nachkommen, Ø Schlupfquote, eigener COI)
• Genetik-Export: Punnett-Ergebnis als JSON (Austausch mit anderen Züchtern) oder als druckbare Ansicht zum Speichern als PDF über den Browser
• Erwartet vs. Tatsächlich: Vergleich der erwarteten Morph-Verteilung mit den real eingetragenen Nachzuchten je Verpaarung (Lernfeedback, markiert unerwartete Morphe)

Futterplanung

• Artgerechter, altersgerechter Futterplan – Bartagame (Allesfresser: Insekten + Grünfutter) und Grüner Leguan (strikter Pflanzenfresser: Blattgrün, kein tierisches Eiweiß, MBD-/Gicht-Hinweise) – mit Supplement-Empfehlungen (Calcium, Calcium+D3, Vitamine)
• Schnell-Eintrag direkt auf der Futterplan-Seite: mehrere Tiere (oder „Alle Tiere“) und mehrere Futterarten gleichzeitig in einem Eintrag, plus Menge, Supplemente und Notizen
• Serien-Erfassung: wahlweise einzelner Tag oder ganzer Zeitraum – „Von/Bis“ plus optionale Wochentags-Auswahl (z. B. jeden Mo/Mi/Fr für vier Wochen), mit Schnellwahl für die nächsten 7/14/30 Tage und Live-Vorschau, wie viele Einträge entstehen. Angelegt wird ein Eintrag pro Tag, damit Auswertung, Nährstoff-Bilanz und Kosten-Tracking unverändert korrekt rechnen (max. 90 Tage je Vorgang). Auch im Frontend-Formular ([reptilien-verwaltung], Reiter „Fütterung“) verfügbar
• Fütterungs-Auswertung: vergleicht die protokollierten Fütterungen der letzten 14 Tage pro Tier mit dem art- und altersgerechten Optimum (Insekten-, Grünfutter- und Calcium-Frequenz pro Woche) und zeigt farbige Status-Chips (optimal / zu wenig / zu viel) – beim Leguan wird jede Insektenfütterung als „zu viel“ markiert
• Nährstoff-Bilanz pro Tier: Calcium-, Vitamin-D3- und Vitamin-Frequenz gegen das art-/altersgerechte Ziel, inkl. Toxizitäts-Warnung bei Überdosierung (z. B. Vitamine/D3 zu häufig)
• Kosten-Tracking: Preis je Futterart hinterlegen; monatliche Gesamtkosten, Prognose sowie Aufschlüsselung pro Futterart und pro Tier
• Fütterungsprotokoll mit automatisch erzeugten Titeln („Fütterung 24.07.2026 – Alle Tiere“)
• Übersichtsseite mit Empfehlung, Auswertung, Nährstoff-Bilanz und letzter Fütterung pro Tier

Terrarien, Besatz & Strom

• Eigener Inhaltstyp „Terrarien“: Maße (L × B × H mit automatisch berechnetem Volumen), Bauart, Standort/Raum und Notizen
• Besatz-Verwaltung: Tiere werden einem Terrarium zugeordnet – wahlweise von der Terrarium-Seite (Mehrfachauswahl) oder direkt in den Stammdaten des Tieres. Ein Tier kann systembedingt immer nur in einem Terrarium stehen; eine Zuordnung zieht es automatisch aus dem bisherigen ab
• Haltungs-Hinweise: warnt bei Vergesellschaftung (Bartagamen und Grüne Leguane sind Einzelgänger) und wenn das Terrarium die empfohlenen Mindestmaße für die gehaltene Art unterschreitet (Bartagame 150 × 80 × 80 cm, Grüner Leguan 300 × 150 × 200 cm)
• Technik je Terrarium: Geräteliste mit Leistung (W), Betriebsstunden pro Tag und Einschaltdauer in Prozent – letztere bildet Thermostat-/Dimmer-Betrieb ab, bei dem ein Gerät nur einen Teil der Zeit tatsächlich Strom zieht. Vorlagen für typische Technik (Wärmespot, UV-Metalldampflampe, T5, LED, Heizmatte) sind hinterlegt
• Strom-Kalkulation: kWh und Kosten je Gerät, je Terrarium und als Gesamtsumme über alle Terrarien – pro Monat und pro Jahr, auf Basis eines frei hinterlegbaren Strompreises (€/kWh)
• Freier Strom-Kalkulator auf der Seite „Terrarien & Strom“ zum Durchrechnen einzelner Geräte, ohne sie einem Terrarium zuzuordnen (z. B. um zwei Lampen zu vergleichen)
• Übersicht „Tiere ohne Terrarium“, damit keine Zuordnung vergessen wird

Automatische Titel & Texte

• Beitragstitel und -text werden auf Wunsch automatisch aus den Tierdaten erzeugt und bei jeder Änderung aktualisiert – etwa wenn sich Morph oder Geschlecht ändern
• Frei konfigurierbares Titel-Muster mit Platzhaltern: {name}, {morph}, {sex} (Zuchtnotation 1.0 / 0.1 / 0.0.1), {species}, {year}, {identifier}. Leere Platzhalter werden samt überflüssiger Trennzeichen automatisch entfernt
• Der Text nutzt die vorhandenen Beitrags-Vorlagen (Steckbrief, Porträt, Zuchttier-Präsentation, Kurzprofil) – die gewünschte Vorlage ist global wählbar
• Niemals destruktiv: sobald du einen Titel oder Text von Hand änderst, lässt die Automatik ihn dauerhaft in Ruhe. Sie erkennt das daran, dass der Inhalt nicht mehr dem entspricht, was sie zuletzt selbst erzeugt hat
• Pro Tier ein- und ausschaltbar (Seitenleiste), global vorbelegbar unter „Reptilien → Titel & Text“
• Der „Rufname“ bleibt als eigenes Feld erhalten, damit der generierte Titel jederzeit rekonstruiert werden kann

Gesundheits-Logbuch

• Eigener Eintragstyp „Gesundheits-Eintrag“ je Tier: Datum, Symptome (Stau, Bindehautentzündung, Zahnstein, Durchfall, Apathie – Mehrfachauswahl), Diagnose, Behandlung, Tierarzt-Kontakt sowie Ausgeheilt-Status mit Ausheilungsdatum
• Auto-Titel „Gesundheit [Tier] [Datum]“, solange kein eigener Titel vergeben wird
• Übersichtsseite „Gesundheits-Logbuch“: alle Einträge, filterbar nach Tier, Symptom und Status (aktiv/gelöst), neueste zuerst
• Im Tierprofil ([reptil id="123"]) erscheint für den Tier-Besitzer eine Timeline der letzten 5 Einträge inkl. Kurzfassung „Letzte Symptome: X, Y (vor 30 Tagen)“ – für alle anderen Besucher unsichtbar
• Streng auf den Tier-Besitzer beschränkt: nur wer das zugehörige Tier verwaltet (bzw. edit_others_posts hat), darf dessen Gesundheitsdaten lesen oder schreiben
• Gesundheits-Trends (Reptilien → Gesundheit: Trends) mit wählbarem Zeitraum: Balkendiagramm der häufigsten Symptome, Zeitverlauf über die Monate als Liniendiagramm, Behandlungs-Erfolgsrate (Anteil ausgeheilter Fälle unter den behandelten), Tabelle der am häufigsten betroffenen Tiere inkl. Morph
• Automatische Alerts „Tier XY hatte 3x Stau dieses Jahr“, sobald ein Tier ein Symptom im laufenden Kalenderjahr eine wählbare Mindestanzahl erreicht
• Tierarzt-Kontakt-Verzeichnis: Name, Telefon, E-Mail und Notizen hinterlegen; das Feld „Tierarzt-Kontakt“ am Eintrag schlägt gespeicherte Kontakte automatisch vor
• Trend-Auswertung ist 1 Stunde im Objekt-Cache gehalten (nur mit persistentem Objekt-Cache-Plugin wirksam über mehrere Requests hinweg)

REST-API

• Vollständige REST-API unter /wp-json/reptilien/v1/ – Tiere (Liste, Detail, Anlegen, Aktualisieren, Löschen), Verpaarungen (Liste), Genetik-Rechner (Punnett-Kreuzung), Fütterungen (Liste) und Bestands-Statistik
• Authentifizierung per API-Key (Header X-Reptilien-API-Key), verwaltbar unter „Reptilien → API“ (erzeugen/widerrufen); ein gültiger Key wirkt wie ein Login des zugehörigen Nutzers – dieselben Berechtigungen wie im Backend gelten 1:1 (eigene Tiere, fremde nur mit edit_others_posts)
• Rate-Limiting: 60 Anfragen pro Minute und API-Key (HTTP 429 bei Überschreitung)
• ETag-Unterstützung bei allen Lese-Endpunkten (If-None-Match → 304 Not Modified bei unverändertem Inhalt)
• CORS deaktiviert per Standard, aktivierbar über den Filter rm_api_cors_allowed_origin
• Fehlerantworten einheitlich als {"code": "...", "message": "...", "data": {"status": ...}}
• Selbst-dokumentierend: GET /wp-json/reptilien/v1/openapi.json liefert die vollständige OpenAPI-3.0-Beschreibung aller Endpunkte (kein API-Key nötig)
• Ändert nichts an der bestehenden Backend-/Frontend-Verwaltung – die API ist ein zusätzlicher, vollständig optionaler Zugang zu denselben Daten

= REST-API: Endpunkte =

GET /wp-json/reptilien/v1/animals?per_page=20&page=1 – paginierte Liste eigener Tiere (bzw. aller mit edit_others_posts)

curl -H "X-Reptilien-API-Key: DEIN_KEY" \
  "https://deine-seite.test/wp-json/reptilien/v1/animals?per_page=20&page=1"

GET /wp-json/reptilien/v1/animals/{id} – Detailansicht inkl. Genetik

curl -H "X-Reptilien-API-Key: DEIN_KEY" \
  "https://deine-seite.test/wp-json/reptilien/v1/animals/123"

POST /wp-json/reptilien/v1/animals – Tier anlegen

curl -X POST -H "X-Reptilien-API-Key: DEIN_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Susi","species":"Pogona vitticeps","sex":"female","hatch_date":"2023-01-15"}' \
  "https://deine-seite.test/wp-json/reptilien/v1/animals"

PUT /wp-json/reptilien/v1/animals/{id} – Tier aktualisieren

curl -X PUT -H "X-Reptilien-API-Key: DEIN_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Susi Updated"}' \
  "https://deine-seite.test/wp-json/reptilien/v1/animals/123"

DELETE /wp-json/reptilien/v1/animals/{id} – Tier löschen (Standard: Papierkorb; ?force=true löscht endgültig)

curl -X DELETE -H "X-Reptilien-API-Key: DEIN_KEY" \
  "https://deine-seite.test/wp-json/reptilien/v1/animals/123"

GET /wp-json/reptilien/v1/pairings?per_page=20&page=1 – Verpaarungen auflisten

curl -H "X-Reptilien-API-Key: DEIN_KEY" \
  "https://deine-seite.test/wp-json/reptilien/v1/pairings"

POST /wp-json/reptilien/v1/genetics/calculate – Punnett-Kreuzung zweier Tiere berechnen

curl -X POST -H "X-Reptilien-API-Key: DEIN_KEY" -H "Content-Type: application/json" \
  -d '{"parent1_id":1,"parent2_id":2}' \
  "https://deine-seite.test/wp-json/reptilien/v1/genetics/calculate"

GET /wp-json/reptilien/v1/feedings?animal_id=123 – Fütterungen auflisten, optional nach Tier gefiltert

curl -H "X-Reptilien-API-Key: DEIN_KEY" \
  "https://deine-seite.test/wp-json/reptilien/v1/feedings?animal_id=123"

POST /wp-json/reptilien/v1/feedings – Fütterung anlegen (seit 1.19.0, für die PWA-Quick-Feeding-Funktion)

curl -X POST -H "X-Reptilien-API-Key: DEIN_KEY" -H "Content-Type: application/json" \
  -d '{"animal_ids":[123],"foods":["heimchen"],"amount":"10 Heimchen"}' \
  "https:/