PHPackages                             magicsunday/webtrees-pedigree-chart - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. magicsunday/webtrees-pedigree-chart

ActiveWebtrees-module[Utility & Helpers](/categories/utility)

magicsunday/webtrees-pedigree-chart
===================================

SVG pedigree chart module for the webtrees genealogy application — interactive D3.js tree visualization with multiple layouts and up to 25 generations.

2.7.2(yesterday)5626115[1 issues](https://github.com/magicsunday/webtrees-pedigree-chart/issues)[1 PRs](https://github.com/magicsunday/webtrees-pedigree-chart/pulls)GPL-3.0-or-laterJavaScriptPHP 8.3 - 8.5CI passing

Since Jan 7Pushed yesterday8 watchersCompare

[ Source](https://github.com/magicsunday/webtrees-pedigree-chart)[ Packagist](https://packagist.org/packages/magicsunday/webtrees-pedigree-chart)[ Fund](https://paypal.me/magicsunday)[ RSS](/packages/magicsunday-webtrees-pedigree-chart/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (31)Versions (43)Used By (0)

[![Latest version](https://camo.githubusercontent.com/95ac064b7b37f97936bddfc987a2a3684c1a8f0b76e9c0d61ffccb6d1b6932a5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6d6167696373756e6461792f77656274726565732d70656469677265652d63686172743f736f72743d73656d766572)](https://github.com/magicsunday/webtrees-pedigree-chart/releases/latest)[![License](https://camo.githubusercontent.com/51257b38c056cc0d6270d0651f7d1f11feca848b8044980ab38ba309803db0ae/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6167696373756e6461792f77656274726565732d70656469677265652d6368617274)](https://github.com/magicsunday/webtrees-pedigree-chart/blob/main/LICENSE)[![CI](https://github.com/magicsunday/webtrees-pedigree-chart/actions/workflows/ci.yml/badge.svg)](https://github.com/magicsunday/webtrees-pedigree-chart/actions/workflows/ci.yml)

- [Pedigree chart](#pedigree-chart)
    - [Installation](#installation)
        - [Manual installation](#manual-installation)
        - [Using Composer](#using-composer)
            - [Latest version](#latest-version)
        - [Using Git](#using-git)
    - [Update](#update)
    - [Configuration](#configuration)
    - [Usage](#usage)
    - [Troubleshooting](#troubleshooting)
    - [Development](#development)
        - [Run tests](#run-tests)

Pedigree chart
==============

[](#pedigree-chart)

This module provides an SVG pedigree chart for the [webtrees](https://www.webtrees.net) genealogy application. It is capable of displaying up to 25 generations of ancestors from an individual.

**But beware, if you select too many generations, it may take a while and even slow down your system significantly.**

[![pedigree-chart-3-generations](assets/pedigree-chart-top-bottom.png)](assets/pedigree-chart-top-bottom.png)*Fig. 1: A five-generations pedigree chart (drawn top to bottom)*

[![pedigree-chart-5-generations](assets/pedigree-chart-5-generations.png)](assets/pedigree-chart-5-generations.png)*Fig. 2: A five-generations pedigree chart (drawn left to right)*

Installation
------------

[](#installation)

Requires webtrees 2.2.

There are several ways to install the module. The method using [composer](#using-composer) is suitable for experienced users, as a developer you can also use [git](#using-git) to get a copy of the repository. For all other users, however, manual installation is recommended.

### Manual installation

[](#manual-installation)

Important

**Download the right `.zip` file.** Each [GitHub release](https://github.com/magicsunday/webtrees-pedigree-chart/releases/latest) page lists two kinds of archive:

- ✅ **`webtrees-pedigree-chart.zip`** — listed under **Assets** at the bottom of the release. This is the install-ready archive: it bundles the required `vendor/` dependencies (such as `webtrees-module-base`).
- ❌ **"Source code (zip)" / `webtrees-pedigree-chart-.zip`** — auto-generated by GitHub from the tag. This is the raw source *without* bundled dependencies. Uploading it to `modules_v4/` will fail with `Interface "MagicSunday\Webtrees\ModuleBase\…" not found` (or `ModuleAssetUrlInterface not found`).

**Always pick the asset zip, never "Source code (zip)".**

Important

**If a previous version of this module is already installed:** delete the entire `modules_v4/webtrees-pedigree-chart` folder *before* extracting the new ZIP. Extracting on top of an existing folder leaves stale files behind that can clash with the new release — a common cause of `Interface … not found` errors right after an update.

To manually install the module, perform the following steps:

1. Open the [latest release](https://github.com/magicsunday/webtrees-pedigree-chart/releases/latest) page.
2. Under **Assets**, download `webtrees-pedigree-chart.zip`.
3. Upload the `.zip` file to your web server.
4. Unzip the package into your `modules_v4` directory.
5. Rename the folder to `webtrees-pedigree-chart`.

If everything was successful, you should see a subdirectory `webtrees-pedigree-chart` with the unpacked content in the `modules_v4` directory.

Then follow the steps described in [configuration](#configuration) and [usage](#usage).

### Using Composer

[](#using-composer)

Typically, to install with [composer](https://getcomposer.org/), just run the following command from the command line, from the root of your Webtrees installation.

```
composer require magicsunday/webtrees-pedigree-chart --update-no-dev
```

The module will automatically install into the `modules_v4` directory of your webtrees installation.

To remove the module run:

```
composer remove magicsunday/webtrees-pedigree-chart --update-no-dev
```

Then follow the steps described in [configuration](#configuration) and [usage](#usage).

#### Latest version

[](#latest-version)

If you are using the development version of Webtrees (main branch), you may also need to install the development version of the module. For this, please use the following command:

```
composer require magicsunday/webtrees-pedigree-chart:dev-main --update-no-dev
```

### Using Git

[](#using-git)

If you are using `git`, you could also clone the current main branch directly into your `modules_v4` directory by calling:

```
git clone https://github.com/magicsunday/webtrees-pedigree-chart.git modules_v4/webtrees-pedigree-chart
```

Then follow the steps described in [configuration](#configuration) and [usage](#usage).

Update
------

[](#update)

- **Manual installation**: From the [latest release](https://github.com/magicsunday/webtrees-pedigree-chart/releases/latest) **Assets** section, download `webtrees-pedigree-chart.zip` (not "Source code (zip)"), **delete the old `modules_v4/webtrees-pedigree-chart` folder first**, and extract the new one. Extracting on top of an existing folder leaves stale files behind that can clash with the new release (a common cause of `Interface … not found` errors after an update).
- **Composer**: Run `composer update magicsunday/webtrees-pedigree-chart --update-no-dev`.
- **Git**: Run `git pull` inside the `modules_v4/webtrees-pedigree-chart` directory.

Configuration
-------------

[](#configuration)

Go to the control panel (admin section) of your installation and scroll down to the `Modules` section. Click on `Charts` (in subsection Genealogy). Enable the `Pedigree chart` custom module (optionally disable the original installed pedigree chart module) and save your settings.

[![control-panel-modules](assets/control-panel-modules.png)](assets/control-panel-modules.png)*Fig. 3: Control panel - Module administration*

Usage
-----

[](#usage)

At the charts' menu, you will find a new link called `Pedigree chart`. Use the provided configuration options to adjust the layout of the charts according to your needs.

Troubleshooting
---------------

[](#troubleshooting)

**Fatal error after a manual installation or update: `Interface "MagicSunday\Webtrees\ModuleBase\…" not found` (or `ModuleAssetUrlInterface not found`)**

- You probably downloaded the GitHub-generated **"Source code (zip)"** instead of the install-ready asset **`webtrees-pedigree-chart.zip`**. The asset bundles the required `vendor/` dependencies; the source zip does not. Open the [latest release](https://github.com/magicsunday/webtrees-pedigree-chart/releases/latest), scroll to **Assets**, download `webtrees-pedigree-chart.zip`, and re-extract.
- If you used the asset zip, make sure you **deleted the previous `modules_v4/webtrees-pedigree-chart` folder before extracting**. Stale files from an older version can shadow the new bundled vendor code and produce the same error.

**The chart does not appear / shows an error**

- Make sure the module is enabled in the Control Panel under Modules > Charts.
- Check that your PHP version is 8.3 or later.
- Clear your browser cache and reload the page.

Development
-----------

[](#development)

To build/update the JavaScript, you can either use a local Node.js installation or Docker.

### Using Docker

[](#using-docker)

No local Node.js installation required. Just run:

```
make install
make build
```

To watch for changes and rebuild automatically:

```
make watch
```

### Using local Node.js

[](#using-local-nodejs)

```
nvm install node
npm install
npm run prepare
```

### Run tests

[](#run-tests)

```
composer update

composer ci:test
composer ci:test:php:phpstan
composer ci:test:php:lint
composer ci:test:php:rector
```

###  Health Score

61

—

FairBetter than 99% of packages

Maintenance100

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 93.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~57 days

Recently: every ~2 days

Total

35

Last Release

1d ago

Major Versions

1.4.0 → 2.0.x-dev2022-05-02

1.7.3 → 2.0.02024-12-02

PHP version history (3 changes)1.0.0PHP ~7.1

1.2.2PHP ^7.3 || ^8.0

2.1.0PHP 8.3 - 8.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/1979dde7200fccc0e21e18a29b5566f22fa01ad104e577254fe74e14ae04a297?d=identicon)[magicsunday](/maintainers/magicsunday)

---

Top Contributors

[![magicsunday](https://avatars.githubusercontent.com/u/564393?v=4)](https://github.com/magicsunday "magicsunday (379 commits)")[![06Games](https://avatars.githubusercontent.com/u/24252743?v=4)](https://github.com/06Games "06Games (7 commits)")[![TheDutchJewel](https://avatars.githubusercontent.com/u/46184729?v=4)](https://github.com/TheDutchJewel "TheDutchJewel (5 commits)")[![gudjonsi](https://avatars.githubusercontent.com/u/100283838?v=4)](https://github.com/gudjonsi "gudjonsi (4 commits)")[![ddrury](https://avatars.githubusercontent.com/u/104515?v=4)](https://github.com/ddrury "ddrury (3 commits)")[![slavkoja](https://avatars.githubusercontent.com/u/5506544?v=4)](https://github.com/slavkoja "slavkoja (3 commits)")[![papjul](https://avatars.githubusercontent.com/u/1449159?v=4)](https://github.com/papjul "papjul (2 commits)")[![zaharchenko-yurka](https://avatars.githubusercontent.com/u/17779489?v=4)](https://github.com/zaharchenko-yurka "zaharchenko-yurka (1 commits)")[![DaPoHou](https://avatars.githubusercontent.com/u/26761596?v=4)](https://github.com/DaPoHou "DaPoHou (1 commits)")[![frenzeldk](https://avatars.githubusercontent.com/u/1295777?v=4)](https://github.com/frenzeldk "frenzeldk (1 commits)")[![jakubcabal](https://avatars.githubusercontent.com/u/8996062?v=4)](https://github.com/jakubcabal "jakubcabal (1 commits)")

---

Tags

ancestorschartd3d3jsdata-visualizationfamily-treegenealogymodulepedigree-chartsvgvisualizationwebtreeswebtrees-modulesvgmodulechartd3.jsdata visualizationvisualizationd3ancestorsgenealogywebtreesFamily-treepedigree-chart

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/magicsunday-webtrees-pedigree-chart/health.svg)

```
[![Health](https://phpackages.com/badges/magicsunday-webtrees-pedigree-chart/health.svg)](https://phpackages.com/packages/magicsunday-webtrees-pedigree-chart)
```

###  Alternatives

[novus/nvd3

A reusable charting library written in d3.js

7.2k207.7k2](/packages/novus-nvd3)[benpickles/peity

Peity (sounds like deity) is a jQuery plugin that converts an element's content into a mini `<svg>` pie, donut, line or bar chart.

4.2k2.8k](/packages/benpickles-peity)[fisharebest/webtrees

webtrees online genealogy

73710.5k13](/packages/fisharebest-webtrees)[professional-wiki/network

MediaWiki extension for adding interactive network visualizations to your wiki pages

3211.9k](/packages/professional-wiki-network)[antoineaugusti/easyphpcharts

A PHP class for chartjs.org charts.

252.8k](/packages/antoineaugusti-easyphpcharts)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)