Enhanced Links on wt-modules

Cross-Reference Overview

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

There are three types of overviews:

overview about all data for the admin (admin overview),
to one tree limited overview (user overview), and
record-specific overview on the record details view (record overview, as tab or modal).

The admin overview (Control panel → LinkEnhancer → Cross-reference overview) is a server-side paginated DataTable. It lists all records that contain classic @XREF@ cross-references or linkenhancer links, with a per-record link inventory.

Optional filters:

Renumber XREFs (with links)

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

The standard webtrees renumbering (Control panel Manage family trees → [Family tree] → Renumber XREFs) resolves cross-tree XREF collisions but does not update linkenhancer or classic links. This module provides an extended renumber that repairs all affected links in one step.

Access: Control panel → LinkEnhancer → Renumber XREFs (with links)

Workflow:

Select the tree that has XREF collisions (duplicate XREFs with other trees).
The page shows each conflicting XREF, its record type, and the number of inbound linkenhancer references from the link index.
On submit, each conflicting XREF is:
- renamed in the GEDCOM core tables (same as the standard renumber)
- all wt=@XREF@ / id=@XREF@ links in notes and blocks are updated
- the link index (le_link_index) and UID index (le_uid_index) are repaired inline or deferred to cron
Each renumbered record is logged in the edit log (Admin → Changes log), e.g. Renumbered @I456@ → @I457@ (INDI, 3 core rows, 2 links).
If the PHP time limit is reached, the run stops with partial progress — the remaining conflicts are renumbered on the next run.

Note: The standard webtrees renumber (without links) remains available and is unaffected. Use this module’s renumber when your notes or blocks contain linkenhancer links. See also: fisharebest/webtrees#5156

Data Fixes

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

The module provides a set of data-fix handlers accessible from the webtrees data-fix interface (Control panel → Data fixes → LinkEnhancer). Each handler addresses a specific link integrity issue:

Fix	What it does
XREF ⇄ UID reference swap	Converts linkenhancer link targets between XREF and UID form. Direction is selectable (XREF→UID or UID→XREF). Requires the UID index to be built.
Fix `wt=` type letter	Sets, repairs, or removes the legacy type letter in `wt=<type>@REF@` links. Modes: set (add missing type), repair (fix wrong type), remove (strip type letter).
Report dangling link targets	Report-only: lists linkenhancer links whose target record no longer exists. No changes are made.
Report ambiguous UID targets	Report-only: lists links whose UID target resolves to more than one record. No changes are made.
Report duplicate UIDs in index	Report-only: lists UIDs assigned to multiple records in the UID index. No changes are made.

Each fix follows the webtrees data-fix workflow: select fix type → preview → apply. The data-fix page also shows the current status of the link and UID indexes, and whether index updates will be deferred to the cron job.