DE EN

Custom Logo Modul

Vollständige Dokumentation

Zurück zur Übersicht

Eigenes Logo vor dem Seitentitel anzeigen

Das Custom Logo Modul ermöglicht es dir, ein individuelles Logo vor dem Titel deiner Webtrees-Website anzuzeigen. Vollständig anpassbar in Größe, Position und responsive für alle Geräte.

Quick Start – In 5 Minuten fertig!

  1. Logo vorbereiten: Deine Logo-Datei (.png, .jpg, .svg) bereithalten (empfohlen: 45x45 Pixel)
  2. Hochladen: Per FTP in /modules_v4/custom-logo/resources/logos/ hochladen
  3. Modul aktivieren: In Webtrees unter "Verwaltung → Module → Alle Module"
  4. Konfigurieren: Auf das Zahnrad-Symbol ⚙️ klicken und Logo-Datei auswählen
  5. Fertig! Dein Logo erscheint jetzt vor dem Seitentitel
Custom Logo Modul - Admin-Oberfläche
Flexible Formate

PNG, JPG, SVG, GIF

Responsive

Passt sich automatisch an

Anpassbar

Größe & Position frei wählbar

1 Modul herunterladen

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

2 Dateien hochladen

Lade den kompletten Ordner custom-logo in das Verzeichnis /modules_v4/ deiner Webtrees-Installation hoch.

Die Struktur sollte sein:
webtrees/modules_v4/custom-logo/module.php
3 Logos-Verzeichnis erstellen

Erstelle per FTP das Verzeichnis:

/modules_v4/custom-logo/resources/logos/

Setze die Berechtigungen auf 755 oder 777

4 Modul aktivieren
  1. Melde dich als Administrator in Webtrees an
  2. Gehe zu Verwaltung → Module → Alle Module
  3. Suche nach "Custom Logo"
  4. Aktiviere das Modul durch Anklicken des Schalters
Fertig! Das Modul ist jetzt installiert und einsatzbereit.

1 Logo hochladen

Lade deine Logo-Datei per FTP in das Verzeichnis:

/modules_v4/custom-logo/resources/logos/

Unterstützte Formate: .png, .jpg, .jpeg, .svg, .gif

2 Einstellungen öffnen
  1. Gehe zu Verwaltung → Module → Alle Module
  2. Klicke beim Custom Logo Modul auf das Zahnrad-Symbol (⚙️)
3 Logo konfigurieren
Einstellung Empfehlung Beschreibung
Logo-Datei - Wähle deine hochgeladene Datei aus
Breite 40-60px Standard: 45px
Höhe 40-60px Standard: 45px
Vertikale Ausrichtung -8 bis -10 Negative Werte = nach oben
Positive Werte = nach unten
Tipp: Auf mobilen Geräten wird das Logo automatisch auf maximal 40px verkleinert.
4 Speichern & Prüfen

Klicke auf Speichern und besuche deine Website, um das Logo zu sehen.

Logo wird nicht angezeigt
Mögliche Ursachen:
  • Modul ist nicht aktiviert → Prüfen unter "Verwaltung → Module"
  • Logo-Datei liegt im falschen Verzeichnis → Muss in /logos/ sein
  • Dateirechte nicht korrekt → Sollten lesbar sein (644)
  • Browser-Cache → Mit Strg+F5 neu laden
Warnung "Verzeichnis existiert nicht"

Lösung: Erstelle das Verzeichnis per FTP:

/modules_v4/custom-logo/resources/logos/
Logo ist zu groß/klein

Lösung: Passe in den Modul-Einstellungen die Werte für Breite und Höhe an.

Empfohlen: 40-60 Pixel für beide Werte
Logo ist nicht mittig ausgerichtet

Lösung: Passe die "Vertikale Ausrichtung" an:

  • Negative Werte (-8, -10) → Logo nach oben
  • Positive Werte (2, 4) → Logo nach unten
Neue Logo-Datei erscheint nicht
Checkliste:
  1. Liegt die Datei im richtigen Verzeichnis?
  2. Ist das Format unterstützt? (.png, .jpg, .svg, .gif)
  3. Admin-Seite neu laden (F5)
  4. Browser-Cache löschen

Technische Details
  • Keine Datenbankänderungen: Alle Einstellungen werden in Webtrees-Preferences gespeichert
  • Responsive Breakpoints:
    • Desktop: Konfigurierte Größe
    • Mobil (<768px): Max. 40px Breite/Höhe
  • Hover-Effekt: Logo wird bei Mouse-Over leicht transparent (opacity: 0.8)
  • Barrierefreiheit: ARIA-Labels vorhanden für Screenreader
Unterstützte Sprachen

Das Modul ist mehrsprachig und unterstützt:

🇩🇪 Deutsch
🇬🇧 English
🇫🇷 Français
🇭🇺 Magyar
Systemanforderungen
Webtrees: Version 2.2.x oder höher
PHP: Version 8.1 oder höher
Browser: Alle modernen Browser (Chrome, Firefox, Safari, Edge)

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