Download the PHP package magicsunday/webtrees-pedigree-chart without Composer
On this page you can find all versions of the php package magicsunday/webtrees-pedigree-chart. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download magicsunday/webtrees-pedigree-chart
More information about magicsunday/webtrees-pedigree-chart
Files in magicsunday/webtrees-pedigree-chart
Package webtrees-pedigree-chart
Short Description SVG pedigree chart module for the webtrees genealogy application — interactive D3.js tree visualization with multiple layouts and up to 25 generations.
License GPL-3.0-or-later
Informations about the package webtrees-pedigree-chart
- Pedigree chart
- Installation
- Manual installation
- Using Composer
- Latest version
- Using Git
- Update
- Configuration
- Usage
- Troubleshooting
- Development
- Run tests
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.
Fig. 1: A five-generations pedigree chart (drawn top to bottom)
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
[!IMPORTANT] Download the right
.zipfile. Each GitHub release 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 requiredvendor/dependencies (such aswebtrees-module-base).- ❌ "Source code (zip)" /
webtrees-pedigree-chart-<version>.zip— auto-generated by GitHub from the tag. This is the raw source without bundled dependencies. Uploading it tomodules_v4/will fail withTrait/Interface "MagicSunday\Webtrees\ModuleBase\…" not found(orModuleAssetUrlInterface 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-chartfolder 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 ofInterface … not founderrors right after an update.
To manually install the module, perform the following steps:
- Open the latest release page.
- Under Assets, download
webtrees-pedigree-chart.zip. - Upload the
.zipfile to your web server. - Unzip the package into your
modules_v4directory. - 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 usage.
Using Composer
Typically, to install with composer, just run the following command from the command line, from the root of your Webtrees installation.
The module will automatically install into the modules_v4 directory of your webtrees installation.
To remove the module run:
Then follow the steps described in 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:
Using Git
Clone the repository into your modules_v4 directory (a Code → Download ZIP of
the source works the same way):
A source checkout contains the module code only — it does not include the
shared webtrees-module-base library, so on its own it fails with
Trait "MagicSunday\Webtrees\ModuleBase\…" not found. Supply that library in one
of two ways:
Way A — drop-in (no code change). Download
webtrees-module-base and
copy its src/ to the location this module's module.php already expects:
Way B — shared copy (one edit). Place webtrees-module-base next to this
module in modules_v4/ (rename the extracted folder to webtrees-module-base),
then point this module's module.php at it. A single shared copy then serves
every magicsunday module installed this way:
[!IMPORTANT] Both ways are overwritten by every module update, so you must redo them after each upgrade. For a maintenance-free install without Composer, use the asset zip (it bundles all dependencies). Inside a Composer-managed webtrees, prefer
composer require magicsunday/webtrees-pedigree-chart:dev-main— see Using Composer.
Update
To update to the latest version:
- Manual installation: From the latest release Assets section, download
webtrees-pedigree-chart.zip(not "Source code (zip)"), delete the oldmodules_v4/webtrees-pedigree-chartfolder 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 ofInterface … not founderrors after an update). - Composer: Run
composer update magicsunday/webtrees-pedigree-chart --update-no-dev. - Git: Run
git pullinside themodules_v4/webtrees-pedigree-chartdirectory, then re-apply your source step (see Using Git).
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.
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.
Troubleshooting
Fatal error after a manual installation or update: Trait/Interface "MagicSunday\Webtrees\ModuleBase\…" not found (or ModuleAssetUrlInterface not found)
- You probably downloaded the GitHub-generated "Source code (zip)" (or used Code → Download ZIP) instead of the install-ready asset
webtrees-pedigree-chart.zip. The asset bundles the requiredvendor/dependencies; the source zip does not. Open the latest release, scroll to Assets, downloadwebtrees-pedigree-chart.zip, and re-extract. - If you used the asset zip, make sure you deleted the previous
modules_v4/webtrees-pedigree-chartfolder 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
To build/update the JavaScript, you can either use a local Node.js installation or Docker.
Using Docker
No local Node.js installation required. Just run:
To watch for changes and rebuild automatically:
Using local Node.js
Run tests
All versions of webtrees-pedigree-chart with dependencies
ext-dom Version *
ext-json Version *
fisharebest/webtrees Version ~2.2.0
magicsunday/webtrees-module-base Version ^2.5
magicsunday/webtrees-module-installer-plugin Version ^2.0