wt-modules

CLI-Skripte

Mon, 01 Jan 0001 00:00:00 +0000

Das Modul bringt ausschließlich CLI-Skripte mit. Sie sind geschützt: bei Aufruf über HTTP (das Verzeichnis modules_v4 liegt innerhalb des Web-Roots) antworten sie mit 403 anstatt auszuführen.

Skript	Zweck	Braucht eine webtrees-Installation + DB?
`cli/build-link-index.php [--limit=N] [--tree=<id>] [--rebuild] [--flush]`	baut/aktualisiert den Link-Index für die XREF-Übersicht	ja
`cli/build-uid-index.php [--limit=N] [--tree=<id>] [--rebuild] [--flush] [--force]`	baut/aktualisiert den UID-Index für die UID-Suche	ja
`cli/refresh-wthb-toc.php [--all] [--lang=<list>] [--clear] [--force]`	aktualisiert den WTHB-Inhaltsverzeichnis-Cache (Produktion)	ja
`test-text-tag-collector.php`	eigenständige Unit-Tests für den Text-Tag-Collector	nein
`test-link-classifier.php`	eigenständige Unit-Tests für den Link-Klassifizierer (inkl. Ziel-Extraktion)	nein
`test-uid-tag-collector.php`	eigenständige Unit-Tests für den UID-Tag-Collector	nein
`test-uid-index-service.php`	eigenständige Unit-Tests für den UID-Index-Service	nein
`tests/smoke-text-tag-collector.php [limit]`	scannt Datensätze mit erweiterten Links, gibt jeden erfassten Wert aus	ja
`smoke-migration5.php`	SQLite-Smoke-Test für Migration5 (UID-Index-Schema)	ja
`tests/p1-measure.php [--tree=<id>]`	Read-only-Scaling-Messung für die XREF-Übersicht	ja

Ausführen vom webtrees-Root aus mit der gleichen PHP-Version, mit der die Instanz läuft (webtrees benötigt PHP 8.3+):

Service API

Mon, 01 Jan 0001 00:00:00 +0000

Benachbarte Module fragen den Status des Moduls über eine stabile, schreibgeschützte Schnittstelle (CronjobService) ab, anstatt auf dessen interne Dienste zurückzugreifen. Überprüfen Sie zunächst die Verfügbarkeit – das Modul ist möglicherweise nicht installiert, und die Klasse kann nur automatisch geladen werden, wenn die Datei module.php geladen wurde:

<?php
use Schwendinger\Webtrees\Module\Cronjob\Services\CronjobService;

if (class_exists(CronjobService::class) && CronjobService::isFunctional()) {
 $status = CronjobService::jobStatus('mymodule:backup'); // null = unknown job
 $age = CronjobService::lastTickAge(); // seconds since last tick
 $listened = CronjobService::listenedEvents(); // event name => job names
}

Frage	Methode(n)
Ist der Dienst funktionsfähig?	`isFunctional()`, `problems()` (Codes: `module_disabled`, `not_migrated`, `cron_library_missing`, `tick_stale`)
Welche Funktionen sind aktiviert?	`features()` (`watch`, `pseudo_events`, `route_events`), `watchStatus()`
Wann wurde der letzte Tick ausgeführt?	`lastTick()` / `lastTickAge()` – beide Trigger-Typen (Marker-Datei `data/cronjob/tick.last`)
Ist ein Job aktiviert / wann wurde er zuletzt ausgeführt?	`isJobEnabled($name)`, `jobStatus($name)`, `lastRun($name)` – Jobnamen sind mit einem Namespace versehen (`<Modul>:<Name>`)
Auf welche Ereignisse wird gewartet?	`listenedEvents()`, `listenersFor($event)`; Kataloge: `eventCatalog()`, `pseudoEvents()`, `routeEvents()`
Aktionen (die einzigen beiden)	`runJobNow($name)` (wird beim nächsten Tick in die Warteschlange gestellt), `pushEvent($name, $payload)` (Ereigniswarteschlange)

Vertrag: Schreibgeschützte Methoden lösen niemals einen Fehler aus, wenn das Schema fehlt (sichere Standardwerte), Beschreibungen sind Quelltext-Strings (werden niemals vorab übersetzt), und lastRun() schließt bewusst die Job-Ausgabe aus, da diese personenbezogene Daten enthalten kann.

Voraussetzungen

Mon, 01 Jan 0001 00:00:00 +0000

webtrees 2.2.x (PHP 8.3+)
PHP CLI mit proc_open verfügbar (Standard)
Ein Trigger: klassisches Cron, ein systemd-Timer, eine Windows Task Scheduler-Aufgabe, oder der eingebaute Watch-Daemon (kein OS-Timer nötig — siehe “Trigger-Installation”)

Voraussetzungen

Mon, 01 Jan 0001 00:00:00 +0000

Dieses Modul benötigt webtrees Version 2.2 oder 2.3 und hat dieselben Anforderungen wie webtrees#system-requirements.

Es wurde ursprünglich für Version 2.2.4 erstellt; seit LinkEnhancer 1.6.1 sollte es auch mit webtrees 2.3 funktionieren. Tests werden normalerweise mit eingebauten Themes und einigen anderen Custom-Modulen durchgeführt.

Tipp: Es wird empfohlen, das Cronjob-Modul ebenfalls zu installieren. Das erleichtert das Ausführen der CLI-Skripte zur Index-Wartung.

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Modulordner nach modules_v4/cronjob/ kopieren (ZIP-Installation geht auch). Die Cron-Bibliothek ist im Modul enthalten — nichts zu holen.
Webtrees einmal öffnen (irgendeine Seite als Admin), damit das Modul-boot() seine Tabellen erstellt.
Trigger installieren (klassisches Cron, systemd-Timer oder Windows Task Scheduler — die Admin-Seite des Moduls generiert den Block für Ihr OS mit den Pfaden dieser Installation bereits ausgefüllt).
Trigger-Installation (einmalig) — siehe unten.
Erstellen Sie Ihren ersten Job in der Admin-UI oder konfigurieren und aktivieren Sie registrierte Jobs.

Trigger-Installation (einmalig)

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Über Custom Module Manager (empfohlen)

Installieren Sie Custom Module Manager für eine einfache und bequeme Installation von webtrees Custom-Modulen.
Öffnen Sie die Custom Module Manager-Ansicht in webtrees, wählen Sie “linkenhancer” aus und klicken Sie auf die “Install Module”-Schaltfläche.

Manuelle Installation

Laden Sie die neueste Version des Moduls herunter.
Laden Sie die heruntergeladene Datei auf Ihren Webserver hoch.
Entpacken Sie das Paket in Ihr modules_v4-Verzeichnis.
Benennen Sie den Ordner in linkenhancer um.

Wenn alles erfolgreich war, sollten Sie im modules_v4-Verzeichnis einen Unterordner linkenhancer mit dem entpackten Inhalt sehen.

Mitwirken

Mon, 01 Jan 0001 00:00:00 +0000

Wenn Sie zu diesem Modul beitragen möchten, großartig! Sie können beitragen, indem Sie:

Code beisteuern — schauen Sie sich die Issues für Dinge an, die Aufmerksamkeit brauchen. Wenn Sie Änderungen vornehmen möchten, die nicht in einem Issue aufgeführt sind, erstellen Sie bitte eines, damit Sie Ihren Pull Request verlinken können.
Testen — derzeit ist alles manuell; bitte erstellen Sie ein Issue für jeden Bug, den Sie finden.

Übersetzung

Sie können zu diesem Projekt auf Codeberg Weblate beitragen. Aktualisierte Übersetzungen werden in der nächsten Version dieses Moduls enthalten sein.

Projektstruktur

Mon, 01 Jan 0001 00:00:00 +0000

Verzeichnislayout

linkenhancer/
├── module.php ← webtrees-Entry-Point
├── autoload.php ← PSR-4-Autoloader
├── cron-jobs.php ← Self-Registration-Manifest für cronjob
├── latest-version.txt ← aktuelle Version (mit LinkEnhancerModule.php synchron)
├── composer.json ← PHP-Abhängigkeiten (wt-shared-libs, phpstan)
├── package.json ← JS-Abhängigkeiten (gulp, rollup, mocha)
├── gulpfile.mjs ← Build-Tasks
├── phpstan.neon ← Konfiguration der statischen Analyse
├── phpstan-bootstrap.php ← PSR-4-Bootstrap für PHPStan
├── phpstan-baseline.neon ← bekannte Probleme
├── src/ ← PHP (PSR-4)
│ ├── LinkEnhancerModule.php
│ ├── LinkEnhancerModuleExt.php
│ ├── LinkEnhancerUtils.php
│ ├── SettingInterface.php
│ ├── CommonMark/ ← CommonMark-Extensionen
│ ├── DataFix/ ← Datenkorrektur-Handler + Dispatcher
│ ├── Factories/ ← CustomMarkdownFactory
│ ├── Http/ ← Request-Handler
│ ├── Schema/ ← Migrations + SeedHelpTable
│ └── Services/ ← Geschäftslogik
├── resources/
│ ├── js/ ← JS-Quellcode (src/) + Build-Ausgabe (bundle-*)
│ ├── css/ ← CSS-Quellcode + Build-Ausgabe
│ ├── lang/ ← .pot / .po / .php (Übersetzungen)
│ ├── views/ ← PHTML-Views
│ └── img/ ← Screenshots
├── cli/ ← CLI-Wartungsskripte
├── tests/ ← Standalone- + Smoke-Tests
└── util/ ← Build-/Wartungs-Shell-Skripte

Abhängigkeiten

PHP (composer.json ):
- bschwede/wt-shared-libs (Path-Repo ../wt-shared-libs)
- phpstan (dev).
- Konflikte mit:
  - webtrees <2.2 und
  - elysch/webtrees-mitalteli-misc-features
JS (package.json ):
- Laufzeit-Abhängigkeit tiny-markdown-editor
- Dev-Tooling — Gulp, Rollup, PostCSS (autoprefixer, cssnano), Mocha + chai + sinon, jsdom

Datenbank-Schema

Das Modul besitzt fünf Tabellen (Präfix le_), die inkrementell durch src/Schema/Migration#.php erstellt werden. Jede Migration ist additiv und idempotent, sodass das Schema bei jedem Modul-Load konvergiert.

Pseudo-Events

Mon, 01 Jan 0001 00:00:00 +0000

Webtrees hat keinen Event-Bus, daher werden Core-Aktionen (Logins, fehlgeschlagene Logins, Logouts, Datensatz-Edits, Fehler, Suchen) durch Polling der webtrees-Log-Tabelle (app/Log.php, Tabelle log) detektiert und pro neuem passenden Log-Eintrag ein Ereignis ausgelöst. Es ist standardmäßig deaktiviert: nichts läuft, bis der angebotene cronjob:pseudo-events-Job aktiviert wird.

Eingebaute Events (ein cj_event pro neuer Log-Zeile, Payload = die Zeile):

Ereignis	Log-Filter (log_type, Nachricht-Präfix)	Feuer bei
`cronjob:log-auth-failed`	`auth`, `Login failed`	ein Login-Versuch fehlgeschlagen (falsches Passwort, unbekannter Benutzer, nicht verifiziert, nicht genehmigt, keine Session-Cookies)
`cronjob:log-auth-login`	`auth`, `Login:`	ein Benutzer eingeloggt
`cronjob:log-auth-logout`	`auth`, `Logout:`	ein Benutzer ausgeloggt
`cronjob:log-error`	`error`, –	eine Ausnahme erfasst und geloggt (die Nachricht ist der Trace)
`cronjob:log-edit-update`	`edit`, `Update:`	ein Datensatz aktualisiert (`GedcomRecord::updateRecord()`)
`cronjob:log-edit-delete`	`edit`, `Delete:`	ein Datensatz gelöscht (`GedcomRecord::deleteRecord()`)
`cronjob:log-search`	`search`, –	eine Suche ausgeführt (eine Log-Zeile pro durchsuchtem Baum)

Payload: log_id, log_time, log_message (auf 250 Zeichen gekürzt, UTF-8-safe) plus gedcom_id / user_id, wenn die Log-Zeile sie trägt. Die Nachrichten-Präfixe sind die hartkodierten englischen Strings des aktuellen Cores; ein Core-Update, das sie ändert, stoppt das passende Ereignis still (kein Fallback per Design) — die Event-Katalog-Beschreibungen und die test-pseudo-events-Suite fixieren die aktuelle Zuordnung.

Selbst-Registrierung

Mon, 01 Jan 0001 00:00:00 +0000

Andere Module können ihre geplanten Jobs anbieten, damit sie in der Admin-UI erscheinen, ohne dass jemand die Registry manuell editiert. Dazu können zwei Wege beschritten werden (ein Modul kann beide verwenden) - beide werden automatisch bei jedem Tick entdeckt, wobei dies nur für aktivierte Module gilt:

Marker-Methode

getCronJobs(): array in der Modul-module.php -Klasse, die dasselbe Format zurückgibt. Entsprechend: getModuleEvents(): array, getModuleCommands(): array.

Manifest-Datei (empfohlen)

Bereitstellung einer Datei im Modulverzeichnis (modules_v4/<module>/cron-jobs.php), die ein Array von Job-Spezifikationen zurückgibt:

Admin-Einstellungen

Mon, 01 Jan 0001 00:00:00 +0000

Verfügbare Optionen auf der Admin-Seite:

Ereignis-Katalog

Die Admin-Seite (Events-Abschnitt) und die Ereignisnamen-Vorschläge im Job-Formular werden von einer Ereignis-Inventur (cj_event_catalog, vom Tick synchronisiert wie die Job-Registry) gespeist. Sie mischt in dieser Prioritätsreihenfolge:

Events, von Modulen angekündigt (Manifest-events-Abschnitt / getModuleEvents()), namespaced <module>:<name>
eingebaute Pseudo-Events (cronjob:*, von den Detektoren)
Route-Events (_route:*, abgeleitet aus der live Routentabelle)
Ereignisnamen, die derzeit abgehört werden von einem aktiven Event-Job (Quelle listening) — dies deckt Webhook-only-Namen ab

Jeder Eintrag trägt seine Quelle, eine Beschreibung (als Übersetzungsschlüssel gespeichert, nur zur Render-Zeit übersetzt) und die bekannten Payload-Parameter-Namen. Für Route-Events wird der Payload aus dem Routenpfad abgeleitet: die {param}-Platzhalter in der Reihenfolge ihres Auftretens, wobei {tree} sich zu tree + tree_name ausdehnt (spiegelnd, was der live Event-Payload trägt). Für Pseudo-Events kommen beide vom Detektor (description() / payloadKeys()). Die vollständige Liste ist auch das, was das “Ereignisname”-Datalist im Job-Formular bietet. Der Katalog wird als Client-seitige DataTables (Sortieren/Filtern/Paginieren) im Events-Abschnitt gerendert.

Admin-Einstellungen

Mon, 01 Jan 0001 00:00:00 +0000

Im oberen Bereich der Admin-Seite ist es möglich auf die administrative Querverweis-Übersicht und die Funktion xref_IDs neu nummerieren (mit Verweisen) zuzugreifen.
Ferner können die Grundfunktionen (de-)aktiviert werden:

Bei Aktivierung der ersten vier Grundfunktionen können weiter unten noch detailliertere Einstellungen vorgenommen werden. Auch gibt es zwei globale Einstellungen für Debugausgaben in der JavaScript-Konsole des Browsers und der Webserver-Fehlerlogdatei und man kann sich entscheiden, ob Links grundsätzlich in einem neuen Browsertab geöffnet werden sollen (je nach Grundfunktion differenzierte Einstellung ist auch möglich).

Klassenhierarchie

Mon, 01 Jan 0001 00:00:00 +0000

Automatisch generiert durch docs/tools/generate-class-hierarchy.php — nicht manuell bearbeiten.

Modul

LinkEnhancerModule extends AbstractModule implements MiddlewareInterface, ModuleCustomInterface, ModuleGlobalInterface, ModuleConfigInterface, ModuleDataFixInterface, ModuleListInterface, ModuleTabInterface, SettingInterface — LinkEnhancerModule.php
SettingInterface — SettingInterface.php
LinkEnhancerUtils — LinkEnhancerUtils.php
LinkEnhancerModuleExt extends LinkEnhancerModule implements ModuleExtGlobalInterface — LinkEnhancerModuleExt.php

CommonMark (Extensions)

LeImageRenderer (final) implements NodeRendererInterface, XmlNodeRendererInterface, ConfigurationAwareInterface — CommonMark/LeImageRenderer.php
SmartPunctHelper — CommonMark/SmartPunctHelper.php
LeTableOfContentsRenderer (final) implements NodeRendererInterface, XmlNodeRendererInterface — CommonMark/LeTableOfContentsRenderer.php

Factories

CustomMarkdownFactory extends MarkdownFactory — Factories/CustomMarkdownFactory.php

Request-Handler

DataFixBlocksAction implements RequestHandlerInterface — Http/RequestHandlers/DataFixBlocksAction.php
HelpWthbAction implements RequestHandlerInterface — Http/RequestHandlers/HelpWthbAction.php
XrefDetailData (final) implements RequestHandlerInterface — Http/RequestHandlers/XrefDetailData.php
XrefOverviewListData (final) implements RequestHandlerInterface — Http/RequestHandlers/XrefOverviewListData.php
GotoIdTreeAction extends GotoIdAction — Http/RequestHandlers/GotoIdTreeAction.php
GotoUidTreeAction extends GotoUidAction — Http/RequestHandlers/GotoUidTreeAction.php
GotoXrefAction implements RequestHandlerInterface — Http/RequestHandlers/GotoXrefAction.php
DataFixRebuildIndexAction implements RequestHandlerInterface — Http/RequestHandlers/DataFixRebuildIndexAction.php
RenumberActionHandler (final) — Http/RequestHandlers/RenumberActionHandler.php
HelpMdAction implements RequestHandlerInterface — Http/RequestHandlers/HelpMdAction.php
AdminXrefOverviewData (final) implements RequestHandlerInterface — Http/RequestHandlers/AdminXrefOverviewData.php
GotoIdAction extends AbstractGotoAction — Http/RequestHandlers/GotoIdAction.php
HelpWtCoreAction implements RequestHandlerInterface — Http/RequestHandlers/HelpWtCoreAction.php
WthbAdminHandler (final) — Http/RequestHandlers/WthbAdminHandler.php
GotoUidAction extends AbstractGotoAction — Http/RequestHandlers/GotoUidAction.php
AbstractGotoAction (abstract) implements RequestHandlerInterface — Http/RequestHandlers/AbstractGotoAction.php

Schema

SeedHelpTable implements SeedInterface — Schema/SeedHelpTable.php
Migration6 implements MigrationInterface — Schema/Migration6.php
Migration2 implements MigrationInterface — Schema/Migration2.php
Migration7 implements MigrationInterface — Schema/Migration7.php
Migration3 implements MigrationInterface — Schema/Migration3.php
Migration4 implements MigrationInterface — Schema/Migration4.php
Migration1 implements MigrationInterface — Schema/Migration1.php
Migration5 implements MigrationInterface — Schema/Migration5.php
Migration0 implements MigrationInterface — Schema/Migration0.php

Services

AdminSettingsBuilder (final) — Services/AdminSettingsBuilder.php
MarkdownEditorActivationService (final) — Services/MarkdownEditorActivationService.php
IndexRebuildScheduler (final) — Services/IndexRebuildScheduler.php
UidTagCollector (final) — Services/UidTagCollector.php
TextTagCollector (final) — Services/TextTagCollector.php
ContentBuilder (final) — Services/ContentBuilder.php
RenumberWithLinksService (final) — Services/RenumberWithLinksService.php
DataFiles (final) — Services/DataFiles.php
XrefOverviewColumns (final) — Services/XrefOverviewColumns.php
LinkIndexService (final) — Services/LinkIndexService.php
XrefsService (final) — Services/XrefsService.php
XrefDetailService (final) — Services/XrefDetailService.php
WthbService — Services/WthbService.php
IdResolver (final) — Services/IdResolver.php
LinkRenderer (final) — Services/LinkRenderer.php
WthbTocService (final) — Services/WthbTocService.php
UidIndexService (final) — Services/UidIndexService.php

DataFix

FixHandlerInterface — DataFix/FixHandlerInterface.php
DataFixDispatcher — DataFix/DataFixDispatcher.php
TreeLookupTrait — DataFix/TreeLookupTrait.php
DanglingLinksFix (final) implements FixHandlerInterface — DataFix/Handlers/DanglingLinksFix.php
DuplicateUidFix (final) implements FixHandlerInterface — DataFix/Handlers/DuplicateUidFix.php
WtTypeFix (final) implements FixHandlerInterface — DataFix/Handlers/WtTypeFix.php
XrefUidSwapFix (final) implements FixHandlerInterface — DataFix/Handlers/XrefUidSwapFix.php
AmbiguousUidFix (final) implements FixHandlerInterface — DataFix/Handlers/AmbiguousUidFix.php

Route-Events

Mon, 01 Jan 0001 00:00:00 +0000

Ein ergänzender, sofortiger Detektionsmechanismus: anstatt Zustand nach Zeitplan zu pollen, beobachtet das Modul die HTTP-Anfrage selbst. Wenn eine Anfrage an eine abgebildete mutierende Route erfolgreich bearbeitet wurde (2xx/3xx), queue sie das passende Ereignis in dieselbe cj_event-Queue — ein abhörender Event-Job reagiert dann beim nächsten Tick (~60 s), ohne Polling-Latenz.

Welche Routes abgebildet sind — zwei Regeln, beide abgeleitet aus der live webtrees-Routentabelle. Gemeinsame Voraussetzungen: Pfad beginnt mit /tree/{tree}/, der Handler ist im webtrees-Request-Handler-Namespace (RequestHandlers in 2.2.6, Controllers in 2.3), und die Anfrage ist eine POST-Mutation. In 2.2.6 wird dies bei der Abbildung erzwungen (GET-Seiten-Routes werden nicht abgebildet); in 2.3 trägt die Route keine HTTP-Methode, daher erfolgt die POST-Prüfung zur Auslösezeit und das GET-Formular-Load derselben Route wird ignoriert.

Verwendung

Mon, 01 Jan 0001 00:00:00 +0000

Job erstellen

Steuerungspanel → Cron Job Scheduler → Neuer Job:

Feld	Bedeutung
Name (Slug)	technischer Bezeichner, `a-z 0-9 _ -`. Nur-lesen für durch Module angebotene Jobs (deren `<module>:<name>`-Schlüssel ist fix); editierbar für selbst erstellte Jobs.
Titel	menschenlesbarer Name
Trigger	ein oder mehrere Zeit-Trigger (Cron-Zeitpläne) und/oder Ereignis-Trigger — der Job feuert, wenn irgendein Trigger feuert. Mindestens einer ist erforderlich.
Cron-Ausdruck	(Zeit-Trigger) Standard-5-Feld-Cron oder ein Makro (`@daily`, `@weekly`, …). Zeiten sind UTC.
Ereignisname	(Ereignis-Trigger) das Ereignis, auf das dieser Job reagiert. Slug oder `<domain>:slug`, max. 64 Zeichen.
Befehl	ein `modules_v4/<module>/cli/<script>.php`-Pfad oder ein erlaubter Core-Befehl.
Argumente	nur einfache Optionen/Werte (z.B. `--limit=5000`), max. 10 Tokens
Timeout	30 - 3600 s
Bei Fehler benachrichtigen	Opt-in: Admin-Konten bei Job-Fehlern benachrichtigen

Verfügbare Ereignisnamen und Befehle werden als Datalists bereitgestellt, um die Dateneingabe zu erleichtern.

Markdown-Bild-Unterstützung

Mon, 01 Jan 0001 00:00:00 +0000

Diese Funktion erlaubt es, Bilder aus GEDCOM-Mediendatensätzen (die hinter der Media-Firewall liegen) oder aus dem öffentlichen Verzeichnis in Notizen einzubetten. Wenn Restriktionsregeln auf den Datensatz zutreffen, wird statt des Bildes eine Meldung angezeigt.

Syntax:

![Alternativtext für GEDCOM-Objekt](#@id=@M1@)
![Alternativtext für Bild im öffentlichen Ordner](#@public=webtrees.png "Titel")
![Bild mit definierter Höhe, Breite und zusätzlicher CSS-Klasse](#@id=@M1@&h=200&w=200&cname=float-right)

Technisch werden die Bilder in einen div-Container zusammen mit einem Bild-Untertitel gepackt — der auch ein Link zum Mediendatensatz ist. Die Darstellung kann wie gewünscht mit den Standard-CSS-Klassen oder zusätzlichen per-Bild-CSS-Klassen angepasst werden (z.B. float-start oder float-end aus webtrees vendor.css).

Markdown-Editor

Mon, 01 Jan 0001 00:00:00 +0000

Man kann einen visuellen Markdown-Editor (mde) für Notiz-Textareas aktivieren. Unter der Haube wird das Projekt TinyMDE - A tiny, dependency-free embeddable HTML/JavaScript Markdown editor verwendet.

Neben der Syntax-Hervorhebung wird eine Icon-Leiste für gängige Formatierungsbefehle, ein Hilfe-Popup und Zeilennummerierung mitgeliefert.

Hinweis: Die On-Screen-Tastatur funktioniert leider nicht mehr wie zuvor mit dem vorherigen Texteingabefeld. Die gewählten Zeichen landen als Zwischenschritt im kleinen Textfeld unter dem Markdown-Editor und müssen manuell an die gewünschte Position kopiert werden.

Markdown-Erweiterungen

Mon, 01 Jan 0001 00:00:00 +0000

Warnung: Bitte bedenken Sie bei der Verwendung dieser Erweiterungen, dass Sie vom kleinsten gemeinsamen Markdown-Dialekt abweichen. Wenn die Bibliothek, die Markdown in HTML rendert, aus irgendeinem Grund geändert werden muss, ist es möglich, dass nicht alle hier verwendeten erweiterten Markup unterstützt werden (siehe auch #32). Da das Markup nicht aufdringlich ist, sollte der Impact nicht gravierend sein — natürlich ist es ein kleiner Nachteil.

Das Paket League\CommonMarkdown, das zur Verarbeitung von Markdown-Texten verwendet wird, bietet mehrere nützliche Erweiterungen, die optional aktiviert werden können:

Der Tick

Mon, 01 Jan 0001 00:00:00 +0000

Der Tick ist das Herz des Moduls: einmal pro Minute prüft er alle aktivierten Jobs, entscheidet, was fällig ist, und führt es aus. Weder das webtrees-Core noch das Betriebssystem planen selbst — sie starten nur tick.php .

flowchart TD
 subgraph Triggers["`⏱ Auslöser *(once per minute)*`"]
 CRON["`🕑 OS cron / systemd<br/>*every minute*`"]
 WATCH["`👁 watch-Daemon<br/>*(in-module)*`"]
 end

 subgraph Guard["🛡 Guard"]
 TP["`📄 cli/tick.php · **cron:tick**<br/>*guard(): 403 over HTTP*`"]
 OFF{"`⚠ site offline?<br/>*data/offline.txt*`"}
 BOOT["`🚀 boot()<br/>*webtrees + DB*`"]
 end

 subgraph Selection["🔎 Arbeit auswählen"]
 TIME["`📅 time-based jobs<br/>**next_run_at due** *(UTC)*`"]
 CE[("`📦 cj_event<br/>*Event-Warteschlange*`")]
 DRAIN["`🧮 drain queue<br/>*coalesced · 60 s budget*`"]
 end

 subgraph Execution["`⚙ Ausführung *(isolated child)*`"]
 RUN["`🧪 JobRunner<br/>**proc_open**`"]
 LIM["`⏲ timeout 30–3600 s<br/>last **64 KB** · exit code`"]
 end

 subgraph Storage["💾 Speicherung"]
 CJRUN[("`cj_run<br/>*Laufverlauf*`")]
 MARK["`🏷 tick.last<br/>*stale > 300 s → tick_stale*`"]
 end

 CRON --> Guard
 WATCH --> Guard
 TP --> OFF
 OFF -->|"offline"| SKIP["⏭ Tick überspringen"]
 OFF -->|"online"| BOOT
 BOOT --> TIME
 BOOT --> DRAIN
 CE --> DRAIN
 TIME --> Execution
 DRAIN --> Execution
 RUN --> LIM
 LIM --> CJRUN
 BOOT --> MARK

 classDef sourceStyle fill:#e3f2fd,stroke:#1565C0,stroke-width:2px
 classDef queueStyle fill:#fff3e0,stroke:#E65100,stroke-width:2px
 classDef tickStyle fill:#e8f5e9,stroke:#2E7D32,stroke-width:2px
 classDef execStyle fill:#fce4ec,stroke:#C2185B,stroke-width:2px
 classDef storageStyle fill:#f5f5f5,stroke:#616161,stroke-width:1px

 class CRON,WATCH sourceStyle
 class OFF,CE queueStyle
 class TP,TIME,DRAIN tickStyle
 class RUN,LIM execStyle
 class CJRUN,MARK,SKIP storageStyle

Was einen Tick startet

Einen Trigger wählen (einmalig):

Deutsches webtrees Handbuch (WTHB)

Mon, 01 Jan 0001 00:00:00 +0000

Ein kontextsensitiver Hilfe-Link zum deutschen webtrees Handbuch kann dem kleinen Navigationsmenü hinzugefügt werden. Kontext-Links sind auch für Komponenten auf Seiten von Custom-Modulen verfügbar (z.B. auf der Personenseite, der Startseite oder bei Elementen im Hauptmenü) — diese sind an den i-Symbolen in einem Kreis erkennbar.

Zur Sicherstellung, dass diese Funktion auch im Admin-Bereich verfügbar ist, muss eine modifizierte Version von views/layouts/administration.phtml registriert werden. Dieses Modul versucht, das Custom-Modul vesta_common zu verwenden (falls installiert und aktiviert) oder seine eigene Version der View-Layout-Datei. Alternativ kann auch Patch P002 auf den Core-Code angewendet werden.

Entwicklungsumgebung

Mon, 01 Jan 0001 00:00:00 +0000

Was man zum Bauen und Testen des Moduls lokal braucht.

Voraussetzungen

Komponente	Version	Hinweise
PHP	8.3+	dieselbe Version, mit der die webtrees-Instanz läuft
Composer	2.x	installiert `wt-shared-libs` + `phpstan`
Node.js	18+ (LTS)	für Gulp / Rollup / Mocha
webtrees	2.2.x oder 2.3.x	nötig für PHPStan (`app/`-Klassen) und die Smoke-Tests
wt-shared-libs	neueste Version	Schwester-Repo unter `modules_v4/wt-shared-libs` (Composer-Path-Repo)

Lage

Das Modul liegt innerhalb einer webtrees-Installation unter modules_v4/linkenhancer/. Sein composer.json zieht die Schwester-Bibliothek als lokales Path-Repository ein:

Tabellen-Zellenhöhe steuern

Mon, 01 Jan 0001 00:00:00 +0000

Für längere Markdown-Notiztexte ist es manchmal mühsam, scrollen zu müssen, wenn man sich für die Fakten darunter interessiert. Diese Funktion sollte hier weiterhelfen: Durch Aktivieren des Häkchens in der oberen rechten Ecke der Titelspalte (erste Tabellenspalte) wird die maximale Höhe der Inhaltszelle mit der langen Notiz auf ca. 80% der Viewport-Höhe gesetzt. Damit wird der Inhalt selbst scrollbar.

Wo anwendbar, kann die Funktion standardmäßig aktiviert (oder einfach verfügbar gemacht) und auch unabhängig deaktiviert werden.

Home-Link

Mon, 01 Jan 0001 00:00:00 +0000

Der Seitentitel kann ein Link zur Baum-Startseite oder zur Benutzer-Mein-Seite sein. Der Webmaster kann auch eine benutzerdefinierte URL setzen.

Dynamische CSS-Stile können angewendet werden, um dem aktuellen Theme zu entsprechen und sicherzustellen, dass die Anzeige gut kontrastiert. Natürlich ist es nicht auf den Home-Link-Fall beschränkt - Details siehe Admin-Einstellungen.

CLI-Skripte

Mon, 01 Jan 0001 00:00:00 +0000

Skripte

php modules_v4/cronjob/cli/tick.php # alle fälligen Jobs ausführen
php modules_v4/cronjob/cli/tick.php --dry-run # anzeigen, was ausgeführt würde
php modules_v4/cronjob/cli/tick.php --job=<name> # einen bestimmten Job jetzt ausführen
php modules_v4/cronjob/cli/tick.php --strict # Exit 1 wenn ein Job fehlgeschlagen ist
php modules_v4/cronjob/cli/tick.php --full-output # vollständige Job-Ausgabe echo (Debugging!)
php modules_v4/cronjob/cli/watch.php # Watch-Daemon starten

Exit-Codes: 0 = Tick lief (Job-Fehler werden in der DB protokolliert), 1 = Umgebungsproblem oder (mit --strict) mindestens ein Job fehlgeschlagen.

Log-Hygiene: stdout trägt nur Summary-Zeilen. Die vollständige Job-Ausgabe liegt in der Ausführungshistorie (nur Admin). --full-output niemals in einen weltlesbaren Ort umleiten.

Querverweis-Übersicht

Mon, 01 Jan 0001 00:00:00 +0000

Es gibt drei Arten von Übersichten:

Übersicht über alle Daten für den Admin (Admin-Übersicht),
auf einen Stammbaum begrenzte Übersicht (Benutzer-Übersicht) und
auf einen Datensatz bezogene Übersicht in der Detailansicht (Datensatz-Übersicht, als Tab oder Modal).

Die Admin-Übersicht (Verwaltung → LinkEnhancer → Querverweis-Übersicht) ist eine serverseitig paginierte DataTable. Sie listet alle Datensätze auf, die klassische @XREF@-Querverweise oder LinkEnhancer-Links enthalten, mit einer Link-Auflistung pro-Datensatz.

Optionale Filter:

referenzierte XREF (nur verfügbar, während ein frischer Link-Index aktiv ist — im Live-Scan-Modus ist das Feld ausgeblendet, da es dort nur ein grober Vorfilter wäre — keine klassischen Referenzen würden gefunden),
Datensatz-Typ,
Stammbaum und
die Anzahl der pro Link-Klasse angezeigten Token (alle / 5 / 10 / 20, Default 5).

Die XREF-Zelle zeigt den Stammbaumnamen als zweite Zeile in dezenter Schrift. Der Datensatz-Typ ist eine eigene sortierbare Spalte. Jedes Inventar-Token wird als kurzer Anzeigekontext (Snippet) mit dem Link-Token selbst in Fett angezeigt.

Build-System

Mon, 01 Jan 0001 00:00:00 +0000

Bundling, Übersetzungs-Kompilierung und Versionierung werden über Gulp-Tasks in gulpfile.mjs gesteuert, aufgerufen mit npx gulp <task>. Die npm run *-Skripte decken nur das Testing ab — siehe die Seite Testing.

Tasks

Task	Befehl	Wirkung
`build`	`npx gulp build`	`clean` → JS (Rollup) + CSS (PostCSS)
`devbuild`	`npx gulp devbuild`	wie `build`, aber Dev-Mode (kein Minify, SourceMaps)
`updatepo`	`npx gulp updatepo`	führt `update-po-files.sh` aus → `xgettext` über `src/` → `messages.pot`
`po2php`	`npx gulp po2php`	kompiliert `resources/lang/.po` → `resources/lang/.php`
`syncversion`	`npx gulp syncversion`	hält `latest-version.txt` ↔ `LinkEnhancerModule.php` synchron
`bumpversion`	`npx gulp bumpversion`	erfordert einen sauberen git-Tree → Version-Bump → `syncversion`
`archive`	`npx gulp archive`	`build` + `po2php` + `create-archive.sh` (Release-ZIP)
`forgejo:issue-refs`	`npx gulp forgejo:issue-refs[:dry]`	ergänzt Issue-Referenzen in Commit-Messages (braucht `FORGEJO_TOKEN` in `.env`) - wurde nur einmalig angewendet für die Übernahme des Repos von GitHub zu Codeberg

JS / CSS Bundling

build = clean → (parallel) JS + CSS.

Sicherheit

Mon, 01 Jan 0001 00:00:00 +0000

Nie eine Shell. Befehle werden via proc_open mit einem argv-Array ausgeführt.
Befehls-Whitelist. Modulskripte müssen modules_v4/<module>/cli/<script>.php entsprechen, existieren und sich in einem modules_v4/<module>/cli/-Verzeichnis auflösen. Core-Befehle sind auf die Read-only/Export-Allowlist beschränkt.
Argument-Validierung. Jedes Argument-Token muss eine einfache Option oder ein Wert sein — keine Shell-Metazeichen, keine Leerzeichen in Tokens, max. 10 Tokens.
Arbeitsverzeichnisse. Modulskripte laufen vom webtrees-Root; Core-Befehle laufen von data/.
Keine sensiblen Daten in stdout. Der Tick gibt nur Zusammenfassungen aus; die vollständige Ausgabe bleibt in der Ausführungshistorie (admin-only).
UI-Aktionen sind alle als *Admin* benannt (nur Admin, CSRF-geschützt).
Notaus-Schalter: Modul deaktivieren — der Tick tut dann nichts.
Der Tick ist Single-Instance (flock), und der Kindprozess eines Jobs wird nach dem Timeout hart getötet (SIGKILL).
Bündelung von Ereigniswarteschlangen. Eine Flut identischer Ereignisse wird zusammengeführt zu einem Joblauf.
Webhook-Token nur im Header. Das Token wird ausschließlich im X-Cronjob-Token-Header gesendet.

xref_IDs neu nummerieren (mit Verweisen)

Mon, 01 Jan 0001 00:00:00 +0000

Die webtrees Standardfunktion für die Umnummerierung (Verwaltung → Stammbäume verwalten → [Stammbaum] → xref_IDs neu nummerieren) löst Stammbaumübergreifende XREF-Kollisionen auf, aktualisiert aber keine LinkEnhancer- oder klassischen Links. Dieses Modul bietet eine erweiterte Umnummerierungsfunktion, die alle betroffenen Links in einem Schritt repariert.

Zugriff: Verwaltung → LinkEnhancer → xref_IDs neu nummerieren (mit Verweisen)

Ablauf:

Den Stammbaum mit XREF-Kollisionen auswählen (doppelte XREFs mit anderen Bäumen).
Die Seite zeigt jede kollidierende XREF, ihren Record-Typ und die Anzahl der eingehenden LinkEnhancer-Referenzen aus dem Link-Index.
Beim Absenden wird jede kollidierende XREF:
- in den GEDCOM-Core-Tabellen umbenannt (gleich wie die Standard-Umnummerierung)
- alle wt=@XREF@ / id=@XREF@-Links in Notizen und Blöcken aktualisiert
- der Link-Index (le_link_index) und UID-Index (le_uid_index) werden inline oder an Cron delegiert repariert
Jeder umnummerierte Datensatz wird im Edit-Log protokolliert (Admin → Änderungslog), z.B. Renumbered @I456@ → @I457@ (INDI, 3 core rows, 2 links).
Wenn die PHP-Ausführungszeitgrenze erreicht wird, stoppt der Lauf mit teilweisem Fortschritt — die verbleibenden Kollisionen werden im nächsten Lauf umnummeriert.

Hinweis: Die Standard-webtrees-Umnummerierung (ohne Links) bleibt verfügbar und ist nicht betroffen. Verwenden Sie die Umnummerierung dieses Moduls, wenn Ihre Notizen oder Blöcke LinkEnhancer-Links enthalten. Siehe auch: fisharebest/webtrees#5156

Übersetzungs-Pipeline

Mon, 01 Jan 0001 00:00:00 +0000

Das Modul bringt seine eigenen Übersetzungen über die Standard-gettext-Kette ein, gehostet auf Codeberg Weblate.

Ablauf

flowchart TB
 subgraph Extraction["1️⃣ Quellcode → POT"]
 direction LR
 PHP["📝 src/*.php"] -->|npx gulp updatepo| POT["📄 messages.pot"]
 end

 subgraph Translation["2️⃣ Übersetzung"]
 direction LR
 WEBLATE["🌐 Weblate"] -->|download| PO["🗝 <lang>.po"]
 end

 subgraph Rendering["3️⃣ Webtrees"]
 direction LR
 PHPARR["📦 lang.php"] -->|I18N| RENDER["✅ Rendering"]
 end

 POT -->|upload| Translation
 PO -->|npx gulp po2php| Rendering

 classDef sourceStyle fill:#e3f2fd,stroke:#1565C0,stroke-width:2px
 classDef fileStyle fill:#e8f5e9,stroke:#2E7D32,stroke-width:2px
 classDef weblateStyle fill:#f3e5f5,stroke:#7B1FA2,stroke-width:2px
 classDef renderStyle fill:#fce4ec,stroke:#C2185B,stroke-width:2px

 class PHP sourceStyle
 class POT,PO,PHPARR fileStyle
 class WEBLATE weblateStyle
 class RENDER renderStyle

Strings extrahieren

update-po-files.sh führt xgettext über jede *.php / *.phtml aus, außer util/, vendor/, node_modules/ und tests/:

WTHB-TOC-Language-Pipeline

Mon, 01 Jan 0001 00:00:00 +0000

Überblick

Das Paket linkenhancer-wthb-toc-lang stellt das Inhaltsverzeichnis (TOC) des deutschen webtrees-Handbuchs — samt Übersetzungen — der WTHB-Hilfefunktion zur Verfügung. Die Produktion ist ein Rundlauf, der komplett außerhalb der webtrees-Installation läuft: Er liest das Handbuch von GenWiki, erzeugt das TOC neu, schreibt das Ergebnis als MediaWiki-Template zurück nach GenWiki und — parallel — die strukturierten Daten in ein externes Codeberg-Repo, das Codeberg Pages, Weblate (Übersetzungen) und schließlich das Modul versorgt. Diese Seite dokumentiert die Produktionsseite; die Konsumenten-Seite (Cache, CLI, Rendering) steht auf der WTHB-Funktionsseite und der Seite CLI-Skripte.

Datenkorrekturen

Mon, 01 Jan 0001 00:00:00 +0000

Das Modul bietet eine Reihe von Datenkorrektur-Handlern, die über die webtrees Datenkorrektur-Schnittstelle erreichbar sind (Steuerungspanel → Datenkorrekturen → LinkEnhancer). Jeder Handler adressiert ein spezifisches Link-Integritätsproblem:

Korrektur	Was sie tut
XREF ⇄ UID Referenz-Tausch	Konvertiert LinkEnhancer-Link-Ziele zwischen XREF- und UID-Form. Richtung ist wählbar (XREF→UID oder UID→XREF). Erfordert, dass der UID-Index aufgebaut ist.
`wt=` Typ-Buchstabe korrigieren	Setzt, repariert oder entfernt den Legacy-Typ-Buchstaben in `wt=<type>@REF@`-Links. Modi: setzen (fehlenden Typ hinzufügen), reparieren (falschen Typ korrigieren), entfernen (Typ-Buchstaben streichen).
Verwaiste Link-Ziele melden	Nur Bericht: Listet LinkEnhancer-Links auf, deren Ziel-Datensatz nicht mehr existiert. Es werden keine Änderungen vorgenommen.
Mehrdeutige UID-Ziele melden	Nur Bericht: Listet Links auf, deren UID-Ziel auf mehr als einen Datensatz auflöst. Es werden keine Änderungen vorgenommen.
Doppelte UIDs im Index melden	Nur Bericht: Listet UIDs auf, die im UID-Index mehreren Datensätzen zugewiesen sind. Es werden keine Änderungen vorgenommen.

Jede Korrektur folgt dem webtrees Datenkorrektur-Workflow: Korrekturtyp wählen → Vorschau → anwenden. Die Datenkorrektur-Seite zeigt auch den aktuellen Status der Link- und UID-Indizes und ob Index-Aktualisierungen an den Cron-Job delegiert werden.

Testing

Mon, 01 Jan 0001 00:00:00 +0000

Die komplette Kette läuft mit:

npm test

Das führt test:php → analyse:php → test:js aus, wobei jeder Schritt bestehen muss, bevor der nächste läuft.

JavaScript (Mocha + jsdom)

npm run test:js
# mocha 'resources/js/tests/**/*.test.js' --require jsdom-global/register

PHP-Standalone-Unit-Tests

npm run test:php
# führt jedes tests/test-*.php mit dem System-PHP aus — ohne webtrees, ohne DB

Test	Abgedeckt
`test-text-tag-collector.php`	Text-Tag-Collector
`test-link-classifier.php`	Link-Klassifizierer (inkl. Ziel-Extraktion)
`test-uid-tag-collector.php`	UID-Tag-Collector
`test-uid-index-service.php`	UID-Index-Service
`test-i18n-mark.php`	i18n-Marker
`test-wthb-toc-service.php`	WTHB-TOC-Service

PHP-Statische Analyse

npm run analyse:php # oder: composer analyse
# PHPStan Level 6 — siehe die PHPStan-Seite

Smoke-Tests (brauchen webtrees + DB)

Diese üben eine echte Installation und sind nicht Teil von npm test:

PHPStan

Mon, 01 Jan 0001 00:00:00 +0000

Benötigt wird: PHPstan

Die statische Analyse ist über phpstan.neon konfiguriert (Level 6, Baseline in phpstan-baseline.neon).

Ausführen

composer analyse

Die Analyse benötigt eine webtrees-Installation (für die app/-Klassen + vendor/autoload.php). Ausführen vom bind-mounted-Pfad:

cd /path/to/webtrees/modules_v4/linkenhancer
composer analyse

Konfiguration

Level: 6
Baseline: phpstan-baseline.neon (bekannte Probleme)
Bootstrap: phpstan-bootstrap.php registriert die PSR-4-Namespaces direkt (umgeht den versionsgeprüften Autoloader in wt-shared-libs)
Scan-Verzeichnisse: ../../app/ (webtrees-Core-Klassen)
Ausgeschlossene Pfade: LinkEnhancerModuleExt.php (Verwendung im Zusammenhang mit Vesta-Modulen)
Speichergrenze: 1G
Parallel: deaktiviert (Single-Prozess, zuverlässiger in CI)

Wichtige Einstellungen

treatPhpDocTypesAsCertain: false — verhindert False Positives aus @var-Assertions
ignoreErrors für:
- AccessLevel Enum (nur-Klasse in WT 2.3, in der 2.2-Laufzeit nicht verfügbar)
- DB::prefix('') — beabsichtigt (Präfix ohne Identifier holen)

Baseline neu generieren

Nach beabsichtigten Änderungen, die neue (akzeptable) Fehler einführen:

UID-Suche

Mon, 01 Jan 0001 00:00:00 +0000

Eine UID (_UID in GEDCOM 5.5.1, UID in GEDCOM 7.0) ist eine persistente Kennung, die einem Datensatz zugewiesen wird. Die UID übersteht XREF-Umnummerierungen und Baum-Migrationen und ist damit ein stabiler Referenzpunkt.

Diese Funktion ermöglicht die direkte Navigation zu einem Datensatz über seine UID. Das URL-Muster ist:

/tree/{baum}/goto-uid/{uid} — auf einen Baum beschränkt
/goto-uid/{uid} — global (durchsucht alle Bäume)

Verhalten:

0 Treffer → 404
1 sichtbarer Treffer → Weiterleitung zum Datensatz
>1 sichtbarer Treffer → Auswahl-Liste (UIDs mit unterschiedlicher Groß/Klein-Schreibung oder dieselbe UID in mehreren Datensätzen)

Der UID-Vergleich ist case-insensitive (GEDCOM-Spezifikationen definieren UID nicht als case-sensitive). Der gespeicherte Wert ist wörtlich; die Übereinstimmung wird case-insensitiv geprüft, sodass UIDs mit unterschiedlicher Groß/Klein-Schreibung eine Auswahl-Liste zurückliefern statt einer möglicherweise falschen einzelnen Weiterleitung.

Patches

Mon, 01 Jan 0001 00:00:00 +0000

Die Patches können zusätzlich angewendet werden — das Modul funktioniert auch ohne sie!

Der util-Unterordner enthält kleine Patches für den webtrees-Core. Dies sind Diff-Dateien, die per Shell aus dem installierten Modulordner heraus leicht angewendet oder entfernt werden können (notwendig für die Auto-Erkennung der webtrees-Quellen):

Usage: util/wt-patch.sh [-R] [FILTER]
 -R Patch rückgängig machen (patch -R)
 FILTER '*' für alle oder spezifisch (z.B. '01')

Vergessen Sie nicht, die Patches nach einem webtrees-Update neu anzuwenden.

Es handelt sich um kleine Bugfixes oder Funktionserweiterungen — meist in einer einzelnen Datei — die dazu dienen, die Lücke bis zu einer offiziellen Behebung/Implementierung im webtrees-Core zu überbrücken.

Release

Mon, 01 Jan 0001 00:00:00 +0000

Schritte

# 1. Version erhöhen (erfordert einen sauberen git-Tree)
npx gulp bumpversion

# 2. Build + Übersetzungen kompilieren + Release-Archiv erstellen
npx gulp archive

Was `archive` tut

npx gulp archive führt build → po2php → create-archive.sh aus. Das Skript:

Liest die Version aus latest-version.txt .
rsync das Modul nach dist/linkenhancer/ und schließt alles aus, das nicht ausgeliefert wird (unten).
Erzeugt dist/linkenhancer_v<version>.zip.

Aus dem Archiv ausgeschlossen

create-archive.sh lässt unter anderem aus: node_modules/, .git*, gulpfile.mjs, package*.json, phpstan*, tests/, die util/*-Buildskripte, resources/js/src, resources/js/tests, resources/img/, resources/lang/*.po / *.mo und .env. Ausgeliefert werden nur die gebauten bundle*-JS/CSS, die kompilierten resources/lang/*.php, src/, resources/views/, resources/css/ und die Modul-Entry-Dateien.

Websiten-Informationen

Mon, 01 Jan 0001 00:00:00 +0000

Site built with Docsy v0.18.0

Build information

Suchergebnisse

Mon, 01 Jan 0001 00:00:00 +0000

wt-modules

CLI-Skripte

Service API

Voraussetzungen

Voraussetzungen

Installation

Trigger-Installation (einmalig)

Installation

Über Custom Module Manager (empfohlen)

Manuelle Installation

Mitwirken

Übersetzung

Projektstruktur

Verzeichnislayout

Abhängigkeiten

Datenbank-Schema

Pseudo-Events

Selbst-Registrierung

Marker-Methode

Manifest-Datei (empfohlen)

Admin-Einstellungen

Ereignis-Katalog

Admin-Einstellungen

Klassenhierarchie

Modul

CommonMark (Extensions)

Factories

Request-Handler

Schema

Services

DataFix

Route-Events

Verwendung

Job erstellen

Markdown-Bild-Unterstützung

Markdown-Editor

Markdown-Erweiterungen

Der Tick

Was einen Tick startet

Deutsches webtrees Handbuch (WTHB)

Entwicklungsumgebung

Voraussetzungen

Lage

Tabellen-Zellenhöhe steuern

Home-Link

CLI-Skripte

Skripte

Querverweis-Übersicht

Build-System

Tasks

JS / CSS Bundling

Sicherheit

xref_IDs neu nummerieren (mit Verweisen)

Übersetzungs-Pipeline

Ablauf

Strings extrahieren

WTHB-TOC-Language-Pipeline

Überblick

Datenkorrekturen

Testing

JavaScript (Mocha + jsdom)

PHP-Standalone-Unit-Tests

PHP-Statische Analyse

Smoke-Tests (brauchen webtrees + DB)

PHPStan

Ausführen

Konfiguration

Wichtige Einstellungen

Baseline neu generieren

UID-Suche

Patches

Release

Schritte

Was archive tut

Aus dem Archiv ausgeschlossen

Websiten-Informationen

Build information

Suchergebnisse

Was `archive` tut