Skip to content

SVG based descendants chart module for webtrees genealogy application.

License

Notifications You must be signed in to change notification settings

ddrury/webtrees-descendants-chart

 
 

Repository files navigation

Latest version License PHPStan PHPCodeSniffer CodeQL

Scrutinizer Code Quality Build Status Code Climate Issue Count

Descendants chart

This module provides an SVG descendants chart for the webtrees genealogy application. It is capable to display up to 25 descendants generations of an individual.

descendants-chart-5-generations Fig. 1: A six generations descendants chart (drawn top to bottom)

Caution: If you are rendering a lot of generations it may take a while and even slow down your system.

Installation

Requires webtrees 2.1.

Using Composer

To install using composer, just run the following command from the command line at the root directory of your webtrees installation.

composer require magicsunday/webtrees-descendants-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-descendants-chart --update-no-dev

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-descendants-chart.git modules_v4/webtrees-descendants-chart

Manual installation

To manually install the module, perform the following steps:

  1. Download the latest release.
  2. Upload the downloaded file to your web server.
  3. Unzip the package into your modules_v4 directory.
  4. Rename the folder to webtrees-descendants-chart

Enable module

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 Descendants chart custom module (optionally disable the original installed descendants chart module) and save your settings.

Control panel - Module administration Fig. 2: Control panel - Module administration

Usage

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

Development

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

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

Run tests

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

About

SVG based descendants chart module for webtrees genealogy application.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 70.5%
  • PHP 20.5%
  • HTML 6.2%
  • CSS 2.8%