/webtrees-pedigree-chart

SVG based pedigree chart module for webtrees genealogy application.

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Latest version License PHPStan PHPCodeSniffer CodeQL

Pedigree chart

This module provides an SVG pedigree chart for the webtrees 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 Fig. 1: A five-generations pedigree chart (drawn top to bottom)

pedigree-chart-5-generations Fig. 2: A five-generations pedigree chart (drawn left to right)

Installation

Requires webtrees 2.2.

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

Manual installation

To manually install the module, perform the following steps:

  1. Download the latest release of the module.
  2. Upload the downloaded file to your web server.
  3. Unzip the package into your modules_v4 directory.
  4. 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.

Now the module has to be activated within Webtrees.

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 Fig. 3: Control panel - Module administration

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.

Using Composer

Typically, to install with composer, 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 and usage.

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-master --update-no-dev

Using Git

If you are using git, you could also clone the current master 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 and usage.

Development

To build/update the javascript, run the following commands:

nvm install node
npm install --unsafe-perm --save-dev
npm run prepare

Run tests

composer update
vendor/bin/phpstan analyse --memory-limit=-1 -c phpstan.neon
vendor/bin/phpcs src/ --standard=PSR12