DE EN

Event Filter Modul

Vollständige Dokumentation

Zurück zur Übersicht

Ereignisse auf Personenseiten intelligent filtern

Das Event Filter Modul ermöglicht es dir, Ereignisse auf Personenseiten gezielt zu filtern. Mit intelligenter ODER-Logik, automatischer Typ-Erkennung und localStorage-Persistenz.

Quick Start – Sofort loslegen!

  1. Modul herunterladen: ZIP-Datei von der Startseite laden
  2. Hochladen: Entpacken nach /modules_v4/wt-event-filter/
  3. Aktivieren: In Webtrees unter "Verwaltung → Module → Alle Module"
  4. Nutzen: Öffne eine Personenseite – die Filterleiste erscheint automatisch!
Event Filter Modul - Filteransicht
Client-seitig

Ohne Server-Reload

Automatisch

Nur vorhandene Typen

Persistent

Auswahl wird gespeichert

1 Modul herunterladen

Lade das ZIP-Archiv von der Startseite herunter und entpacke es.

2 Dateien hochladen

Lade den Ordner wt-event-filter in das Verzeichnis /modules_v4/ deiner Webtrees-Installation hoch.

Die Struktur sollte sein:
webtrees/modules_v4/wt-event-filter/module.php
3 Modul aktivieren
  1. Melde dich als Administrator in Webtrees an
  2. Gehe zu Verwaltung → Module → Alle Module
  3. Suche nach "WT Event Filter"
  4. Aktiviere das Modul durch Anklicken des Schalters
Fertig! Das Modul ist sofort einsatzbereit – keine weitere Konfiguration nötig!

Grundlegende Nutzung
  1. Öffne eine Personenseite in Webtrees
  2. Oberhalb der Ereignisliste erscheint automatisch eine Filterleiste
  3. Wähle einen oder mehrere Ereignistypen durch Anklicken aus
  4. Die Ereignisliste wird sofort gefiltert
  5. Klicke "Alle löschen", um den Filter zurückzusetzen
Filterlogik verstehen
Beispiel 1 - Keine Auswahl:
✓ Alle Ereignisse werden angezeigt
Beispiel 2 - Eine Auswahl (z.B. "Geburt"):
✓ Nur Geburts-Ereignisse werden angezeigt
✗ Alle anderen Ereignisse sind ausgeblendet
Beispiel 3 - Mehrere Auswahlen (z.B. "Beruf" + "Ausbildung"):
✓ Alle Berufs-Ereignisse werden angezeigt
✓ Alle Ausbildungs-Ereignisse werden angezeigt
✗ Alle anderen Ereignisse sind ausgeblendet
→ ODER-Verknüpfung: Zeigt Ereignisse, die EINEM der Filter entsprechen
Persistenz (Speicherung)
Automatisches Speichern: Deine Filterauswahl wird pro Person gespeichert. Wenn du die gleiche Personenseite später wieder besuchst, wird deine vorherige Auswahl wiederhergestellt.
Kompatibilität

Das Modul funktioniert mit:

  • ✓ Standard Webtrees "Facts and events" Tab
  • ✓ Vesta Facts and events Modul
  • ✓ Allen gängigen Themes

Filter erscheint nicht
Checkliste:
  1. Ist das Modul aktiviert? → "Verwaltung → Module → Alle Module"
  2. Ist JavaScript im Browser aktiviert?
  3. Hat die Personenseite Ereignisse?
  4. Browser-Konsole prüfen (F12) auf Fehlermeldungen
Filter funktioniert nicht mit meinem Theme

Das Modul verwendet konfigurierbare DOM-Selektoren. Bei Problemen:

  1. Öffne die Browser-Konsole (F12)
  2. Suche nach Warnungen wie "Could not find facts tab container"
  3. Kontaktiere den Support mit Screenshots der Fehler
Filterauswahl wird nicht gespeichert
Das Modul verwendet localStorage. Stelle sicher, dass:
  • Der Browser localStorage unterstützt (alle modernen Browser tun dies)
  • Keine Browser-Erweiterungen localStorage blockieren
  • Der Browser nicht im privaten/Inkognito-Modus läuft
  • Cookies und Website-Daten nicht nach jedem Schließen gelöscht werden
Ereignisse werden nicht gefiltert
Mögliche Ursachen:
  • JavaScript-Fehler → Browser-Konsole prüfen (F12)
  • Theme-Inkompatibilität → Support kontaktieren
  • Anderes Modul verursacht Konflikt → Andere Module testweise deaktivieren

Technische Eigenschaften
  • Client-seitig: Gesamte Filterung läuft im Browser, keine Server-Anfragen
  • Performance: Debouncing (75ms) für große Ereignislisten
  • Keine Abhängigkeiten: Pure JavaScript, kein jQuery erforderlich
  • Defensive Programmierung: Funktioniert auch bei DOM-Abweichungen
  • Barrierefrei: Proper labels, keyboard navigation, ARIA-attributes
DOM-Selektoren anpassen

Falls das Modul mit deinem Theme nicht funktioniert, kannst du die DOM-Selektoren anpassen:

Die Selektoren befinden sich in:
/modules_v4/wt-event-filter/resources/js/filter.js
Kontaktiere den Support für Hilfe bei Anpassungen.
Unterstützte Sprachen

Das Modul ist mehrsprachig und unterstützt:

🇩🇪 Deutsch
🇬🇧 English
🇫🇷 Français
🇭🇺 Magyar
Systemanforderungen
Webtrees: Version 2.2.1 oder höher (getestet mit 2.2.4)
PHP: Version 8.0 oder höher (empfohlen: 8.3+)
Browser: Alle modernen Browser mit JavaScript aktiviert

Lizenz

Dieses Modul ist freie Software und wird unter der GNU General Public License v3.0 veröffentlicht.

webtrees: online genealogy
Copyright (C) 2025 webtrees development team

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

Die vollständige Lizenz findest du unter: https://www.gnu.org/licenses/gpl-3.0.html

Support

Bei Fragen oder Problemen:

Nützliche Links
Zurück zur Übersicht