{"id":13597740,"url":"https://github.com/magicsunday/webtrees-descendants-chart","last_synced_at":"2026-05-02T22:09:27.379Z","repository":{"id":40468089,"uuid":"347900239","full_name":"magicsunday/webtrees-descendants-chart","owner":"magicsunday","description":"SVG descendants chart module for the webtrees genealogy application — interactive D3.js tree visualization with spouse display and up to 25 generations.","archived":false,"fork":false,"pushed_at":"2026-04-30T16:09:58.000Z","size":1899,"stargazers_count":36,"open_issues_count":7,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-30T18:09:25.139Z","etag":null,"topics":["chart","d3","d3js","data-visualization","descendants","descendants-chart","family-tree","genealogy","module","svg","visualization","webtrees"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/magicsunday.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"custom":"https://paypal.me/magicsunday"}},"created_at":"2021-03-15T09:02:01.000Z","updated_at":"2026-04-30T16:10:05.000Z","dependencies_parsed_at":"2024-01-13T11:56:08.375Z","dependency_job_id":"accd2c0e-8bb6-4360-af86-18757b007cb0","html_url":"https://github.com/magicsunday/webtrees-descendants-chart","commit_stats":{"total_commits":113,"total_committers":10,"mean_commits":11.3,"dds":"0.22123893805309736","last_synced_commit":"e419f752c0b7f0202e4103f6a5685aa2c17af0b7"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/magicsunday/webtrees-descendants-chart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicsunday%2Fwebtrees-descendants-chart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicsunday%2Fwebtrees-descendants-chart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicsunday%2Fwebtrees-descendants-chart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicsunday%2Fwebtrees-descendants-chart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/magicsunday","download_url":"https://codeload.github.com/magicsunday/webtrees-descendants-chart/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/magicsunday%2Fwebtrees-descendants-chart/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32551009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T21:31:48.061Z","status":"ssl_error","status_checked_at":"2026-05-02T21:31:46.574Z","response_time":132,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chart","d3","d3js","data-visualization","descendants","descendants-chart","family-tree","genealogy","module","svg","visualization","webtrees"],"created_at":"2024-08-01T17:00:40.095Z","updated_at":"2026-05-02T22:09:27.367Z","avatar_url":"https://github.com/magicsunday.png","language":"JavaScript","funding_links":["https://paypal.me/magicsunday"],"categories":["JavaScript"],"sub_categories":[],"readme":"[![Latest version](https://img.shields.io/github/v/release/magicsunday/webtrees-descendants-chart?sort=semver)](https://github.com/magicsunday/webtrees-descendants-chart/releases/latest)\n[![License](https://img.shields.io/github/license/magicsunday/webtrees-descendants-chart)](https://github.com/magicsunday/webtrees-descendants-chart/blob/main/LICENSE)\n[![CI](https://github.com/magicsunday/webtrees-descendants-chart/actions/workflows/ci.yml/badge.svg)](https://github.com/magicsunday/webtrees-descendants-chart/actions/workflows/ci.yml)\n\n\n\u003c!-- TOC --\u003e\n* [Descendants chart](#descendants-chart)\n  * [Installation](#installation)\n    * [Manual installation](#manual-installation)\n    * [Using Composer](#using-composer)\n      * [Latest version](#latest-version)\n    * [Using Git](#using-git)\n  * [Configuration](#configuration)\n  * [Usage](#usage)\n  * [Development](#development)\n    * [Run tests](#run-tests)\n\u003c!-- TOC --\u003e\n\n\n# Descendants chart\nThis module provides an SVG descendant chart for the [webtrees](https://www.webtrees.net) genealogical application.\nIt is capable of displaying up to 25 generations of descendants from an individual.\n\n**But beware, if you select too many generations, it may take a while and even slow down your system significantly.**\n\nIn addition to the descendants, the respective spouses are also displayed for a person. The display can be\ndeactivated via the configuration form so that only the direct descendants are displayed.\n\n![descendants-chart-4-generations](assets/descendants-chart-4-generations.png)\n\n*Fig. 1: A four generations descendants chart with spouses (drawn top to bottom)*\n\n\n## Installation\nRequires webtrees 2.2.\n\nThere are several ways to install the module. The method using [composer](#using-composer) is suitable\nfor experienced users, as a developer you can also use [git](#using-git) to get a copy of the repository. For all other users,\nhowever, manual installation is recommended.\n\n### Manual installation\nTo manually install the module, perform the following steps:\n\n1. Download the [latest release](https://github.com/magicsunday/webtrees-descendants-chart/releases/latest) of the module.\n2. Upload the downloaded file to your web server.\n3. Unzip the package into your ``modules_v4`` directory.\n4. Rename the folder to ``webtrees-descendants-chart``\n\nIf everything was successful, you should see a subdirectory ``webtrees-descendants-chart`` with the unpacked content\nin the ``modules_v4`` directory.\n\nThen follow the steps described in [configuration](#configuration) and [usage](#usage).\n\n\n### Using Composer\nTypically, to install with [composer](https://getcomposer.org/), just run the following command from the command line,\nfrom the root of your Webtrees installation.\n\n```shell\ncomposer require magicsunday/webtrees-descendants-chart --update-no-dev\n```\n\nThe module will automatically install into the ``modules_v4`` directory of your webtrees installation. \nTo make this possible, the \"magicsunday/webtrees-module-base\" package is used. Approval within Composer\nmay be required here to authorize the execution of the package.\n\nTo remove the module run:\n```shell\ncomposer remove magicsunday/webtrees-descendants-chart --update-no-dev\n```\n\nThen follow the steps described in [configuration](#configuration) and [usage](#usage).\n\n#### Latest version\nIf you are using the development version of Webtrees (main branch), you may also need to install the development\nversion of the module. For this, please use the following command:\n```shell\ncomposer require magicsunday/webtrees-descendants-chart:dev-main --update-no-dev\n```\n\n\n### Using Git\nIf you are using ``git``, you could also clone the current main branch directly into your ``modules_v4`` directory \nby calling:\n\n```shell\ngit clone https://github.com/magicsunday/webtrees-descendants-chart.git modules_v4/webtrees-descendants-chart\n```\n\nThen follow the steps described in [configuration](#configuration) and [usage](#usage).\n\n\n## Configuration\nGo to the control panel (admin section) of your installation and scroll down to the ``Modules`` section. Click \non ``Charts`` (in subsection Genealogy). Enable the ``Descendants chart`` custom module (optionally disable the original\ninstalled descendant chart module) and save your settings.\n\n![Control panel - Module administration](assets/control-panel-modules.png)\n\n*Fig. 2: Control panel - Module administration*\n\n## Usage\nAt the charts' menu, you will find a new link called `Descendants chart`. Use the provided configuration options\nto adjust the layout of the charts according to your needs.\n\nFurthermore, it is possible to export the generated tree diagram as an SVG or PNG image\nin order to be able to use it elsewhere.\n\n\n## Development\nTo build/update the JavaScript, you can either use a local Node.js installation or Docker.\n\n### Using Docker\nNo local Node.js installation required. Just run:\n\n```shell\nmake install\nmake build\n```\n\nTo watch for changes and rebuild automatically:\n```shell\nmake watch\n```\n\n### Using local Node.js\n```shell\nnvm install node\nnpm install\nnpm run prepare\n```\n\n### Run tests\n```shell\ncomposer update\n\ncomposer ci:test\ncomposer ci:test:php:phpstan\ncomposer ci:test:php:lint\ncomposer ci:test:php:rector\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicsunday%2Fwebtrees-descendants-chart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmagicsunday%2Fwebtrees-descendants-chart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmagicsunday%2Fwebtrees-descendants-chart/lists"}