ZooDesk Handbuch

✨Willkommen bei ZooDesk

ZooDesk ist eine Webanwendung zur Verwaltung eines Tierbestands – vom einzelnen Tier über Gehege und Zucht bis zur Jahresinventur. Diese Anleitung führt dich durch die Installation, die ersten Schritte und beantwortet häufige Fragen.

🧰Voraussetzungen

• Webserver mit PHP 7.4 oder höher (z. B. Apache), empfohlen wird PHP 8.x.
• MySQL-Datenbank (oder kompatibel, z. B. MariaDB) und ein Datenbankbenutzer mit Rechten zum Anlegen von Tabellen.
• Schreibrechte für die Verzeichnisse uploads/, documents/, enclosure_photos/ und backups/.
• Empfohlen: HTTPS (SSL-Zertifikat) – wird u. a. für die Links in „Passwort vergessen“-E-Mails verwendet.
• Für „Passwort vergessen“: ein SMTP-Postfach oder eine funktionierende PHP-mail()-Funktion.
• Ein aktueller Browser (z. B. Chrome, Firefox, Edge, Safari).

🚀Installation

1. Dateien hochladen

   Lade alle Dateien und Ordner des ZooDesk-Systems in ein Verzeichnis auf deinem Webserver hoch (z. B. /var/www/zoo oder public_html/zoo). Achte darauf, dass auch die versteckten .htaccess-Dateien in den Unterordnern mit hochgeladen werden.

2. config.php anpassen

   Öffne die Datei config.php und trage deine Datenbank-Zugangsdaten ein:

   $db_host = 'localhost';      // Dein Datenbank-Host
   $db_user = 'dein_benutzer';  // Dein Datenbank-Benutzername
   $db_pass = 'dein_passwort';  // Dein Datenbank-Passwort
   $db_name = 'datenbank_name'; // Name der Datenbank

   Optional (für „Passwort vergessen“) im selben File die SMTP-Daten:

   define('SMTP_HOST', 'smtp.dein-provider.de');
   define('SMTP_PORT', 587);
   define('SMTP_USER', 'noreply@deine-domain.de');
   define('SMTP_PASS', 'dein-smtp-passwort');
   define('SMTP_ENCRYPTION', 'tls'); // 'tls', 'ssl' oder ''
   define('MAIL_FROM', 'noreply@deine-domain.de');
   define('MAIL_FROM_NAME', 'ZooDesk');

   💡

   Bleibt SMTP_HOST auf dem Platzhalter smtp.dein-provider.de, versendet ZooDesk E-Mails über die PHP-Funktion mail() des Servers.

   Stelle sicher, dass der Webserver in uploads/, documents/, enclosure_photos/ und backups/ schreiben darf (z. B. chmod 775 uploads).

3. Installer aufrufen und Sprache wählen

   Öffne install.php im Browser (z. B. https://deinserver.de/zoo/install.php). Wähle ganz oben die Sprache (Deutsch oder English) – der Installer wechselt sofort in die gewählte Sprache und ZooDesk wird in dieser Sprache eingerichtet, inklusive Beispieldaten wie Ereignistypen und Behandlungskategorien.

   install.php

   

4. Seitennamen und Konten festlegen

   • Seitenname, z. B. „Tierpark Sonnental“ (max. 100 Zeichen).
   • Admin-Konto und Leser-Konto: jeweils Benutzername (max. 50 Zeichen), E-Mail-Adresse und Passwort. Die beiden Benutzernamen müssen sich unterscheiden.
   • Passwörter: mindestens 8 Zeichen, mindestens ein Großbuchstabe und ein Sonderzeichen.

   Klicke auf „Installation starten“. Der Installer legt alle Tabellen an (Einstellungen, Benutzer, Gruppen/Rechte, Tierarten, Tiere, Notizen, Gewichte, Behandlungen, Dokumente, Gehege, Ereignisse …), erstellt deine beiden Konten und fügt Testdaten hinzu (Tierarten Zebra und Elefant mit je drei Tieren).

5. install.php löschen

   🔒

   Lösche die Datei install.php nach der Installation, damit niemand den Installer erneut aufrufen kann.

   Es gibt keine Standard-Zugangsdaten – du hast sie im Installer selbst vergeben. Bewahre sie sicher auf, besonders die des Kontos admin: dieser Benutzer kann nicht gelöscht werden.

👣Erste Schritte

Nach der Installation hilft dir dieser Rundgang, ZooDesk in wenigen Minuten produktiv zu nutzen. Die Screenshots stammen aus einer Demo-Installation mit Beispieldaten.

1. Anmelden

   Öffne login.php (z. B. https://deinserver.de/zoo/login.php) und melde dich mit deinem Admin-Konto an. Nach 5 Fehlversuchen wird die Anmeldung für 15 Minuten gesperrt; inaktive Sitzungen enden nach 2 Stunden.

   login.php

   

2. Einstellungen & Sprache

   Unter Einstellungen → Allgemeine Einstellungen änderst du den Seitennamen, die Sprache (gilt für alle Benutzer), die Tierarten-Ansicht (alphabetisch oder nach Gehege) und verwaltest Backups.

   settings.php

   

3. Tierart anlegen

   Auf der Startseite klickst du unter Aktionen auf Neue Tierart. Über die Symbole neben einer Tierart kannst du sie bearbeiten, die Inventur öffnen oder sie löschen. Rechts oben findest du die Suche nach Tierart oder Tiername.

   index.php

   

4. Tiere hinzufügen

   Öffne eine Tierart und wähle Tier hinzufügen. Die Liste lässt sich nach Name, Geburtsdatum oder Geschlecht sortieren. Mehrere Tiere kannst du per Massenaktion gleichzeitig als verstorben, abgegeben oder verfüttert markieren oder löschen. Verstorbene, abgegebene und verfütterte Tiere bleiben unten in eigenen Listen erhalten.

   animal_type.php

   

5. Tierprofil

   Ein Klick auf ein Tier öffnet das Profil mit Foto, Markierung/Chip, Geburtsdatum, Geschlecht, Status, letztem Gewicht, Nachwuchs und Notizen. Über Bearbeiten änderst du die Stammdaten und den Status.

   animal_profile.php

   

6. Gewichte, Behandlungen & Dokumente

   Im Profil unter Aktionen: Gewichte zeigt einen Verlauf als Diagramm, Behandlungen werden in Kategorien (z. B. Entwurmungen, Impfungen) geführt, die für die ganze Tierart gelten, und unter Dokumente lädst du Dateien hoch (PDF, Bilder, Word, Excel, TXT, CSV; max. 50 MB).

   animal_weights.php

   

   animal_treatments.php

   

7. Gehege verwalten

   Über Gehege auf der Startseite legst du Gehege mit Fläche, Beschreibung, Foto und technischen Notizen an und ordnest ihnen Tiere bzw. Tierarten zu. Stellst du in den Einstellungen die Ansicht auf „Nach Gehege“, wird die Startseite danach gruppiert.

   enclosures.php

   

8. Stammbaum & Inzuchtprüfung

   Im Tierprofil öffnet Stammbaum die Abstammung des Tieres. Dort kannst du Nachwuchs hinzufügen, Paarungsvorschläge ansehen und den Stammbaum speichern. Bei der Auswahl von Vater und Mutter prüft ZooDesk automatisch auf Inzucht und blockiert das Speichern, bis du es ausdrücklich erlaubst.

   family_tree.php

   

9. Ereignisse planen

   Der Ereignis Kalender verwaltet Termine wie Verpaarung, Trächtigkeit, Quarantäne oder Winterschlaf – für einzelne Tiere oder eine ganze Tierart – mit Erinnerungsfrist. Fällige Ereignisse werden rot markiert und als Zähler auf der Startseite angezeigt. Ereignistypen kannst du selbst anlegen.

   manage.php

   

10. Inventur, Druck & CSV

    Inventur zeigt pro Tierart und Jahr Anfangsbestand, Zugänge, Geburten, Abgänge und den aktuellen Bestand nach Geschlecht. Die Gesamt Inventur fasst alle Tierarten zusammen, die chronologische Inventur listet jede Bewegung und bietet einen CSV-Download. Die meisten Seiten haben eine eigene Druckansicht.

    inventory.php

    

11. Benutzer & Gruppen

    Unter Einstellungen → Benutzerverwaltung legst du Kolleginnen und Kollegen an und ordnest sie einer Gruppe zu. Unter Benutzergruppen & Rechte passt du die Rechte der Gruppen an oder legst eigene Gruppen an (siehe Benutzergruppen & Rechte).

12. Backup erstellen

    Klicke unter Einstellungen → Backup-Verwaltung auf Neues Backup. Mach das regelmäßig und vor jedem Update (siehe Backups).

👥Benutzergruppen & Rechte

ZooDesk enthält vier Standardgruppen. Bei der Installation werden ein Admin- und ein Leser-Konto angelegt; weitere Benutzer ordnest du unter Einstellungen einer Gruppe zu. Die Standardrechte im Überblick:

🌐Sprache ändern

Die Sprache der Oberfläche (Deutsch oder English) kann jederzeit unter Einstellungen → Allgemeine Einstellungen → Sprache geändert werden. Die Einstellung gilt für alle Benutzer und wird in der Datenbank gespeichert – auch E-Mails, Druckansichten und CSV-Exporte erscheinen in der gewählten Sprache.

💾Backups

Unter Einstellungen → Backup-Verwaltung erstellst du mit Neues Backup eine vollständige Sicherung der Datenbank als SQL-Datei im Ordner backups/. Über die Auswahlliste kannst du ein Backup einspielen oder löschen.

🔒Sicherheit

• install.php löschen, sobald die Installation abgeschlossen ist.
• HTTPS verwenden. ZooDesk erkennt HTTPS (auch hinter Reverse-Proxys), setzt dann sichere Cookies und HSTS.
• .htaccess-Dateien behalten: backups/ ist komplett gesperrt, in uploads/, documents/ und enclosure_photos/ wird das Ausführen von PHP-Dateien verhindert. Unter nginx musst du gleichwertige Regeln selbst anlegen.
• Starke Passwörter vergeben und Rechte nach dem Prinzip „so wenig wie nötig“ verteilen.
• Regelmäßig Backups erstellen und außerhalb des Servers aufbewahren.

❓Häufige Fragen (FAQ)

🛠️Problembehandlung

🗂️Ordnerstruktur