Download the PHP package magicsunday/webtrees-fan-chart without Composer

On this page you can find all versions of the php package magicsunday/webtrees-fan-chart. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of magicsunday/webtrees-fan-chart

Informations about the package webtrees-fan-chart

Latest version License CI

Fan chart

This module provides an interactive SVG ancestor fan chart for the webtrees genealogy application. Click on any ancestor to re-center the chart on that person. Right-click to open a tooltip with detailed dates, places, and images.

Installation

Requires webtrees 2.2 and PHP 8.3 or later.

Manual installation

[!IMPORTANT] Download the right .zip file. Each GitHub release page lists two kinds of archive:

  • ✅ webtrees-fan-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-fan-chart-<version>.zip — auto-generated by GitHub from the tag. This is the raw source without bundled dependencies. Uploading it to modules_v4/ will fail with Trait/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-fan-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.

  1. Open the latest release page.
  2. Under Assets, download webtrees-fan-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-fan-chart.

You should now see a modules_v4/webtrees-fan-chart directory containing the module files.

Using Composer

Run the following command from the root of your webtrees installation:

The module will automatically install into the modules_v4 directory.

To remove the module:

If you are using the development version of webtrees (main branch):

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-fan-chart:dev-main — see Using Composer.

Update

To update to the latest version:

Configuration

  1. Go to the Control Panel (admin section) of your webtrees installation.
  2. Scroll down to the Modules section and click on Charts (under Genealogy).
  3. Enable the Fan chart module. Optionally disable the built-in fan chart to avoid confusion.
  4. Click Save.

Usage

Open the Charts menu on any individual page and select Fan chart.

The form at the top lets you choose the starting person, fan size (180-360 degrees), and number of generations (2-10).

Click Show more options to access additional settings:

Option Description
Display mode Choose between "Show names and images", "Show names only", or "Show images only". Images are only shown if the arc segment is wide enough.
Show descendants Shows partners and children as arcs below the ancestor section. The fan size is limited to 180-270 degrees when enabled.
Hide empty segments Hides chart segments for missing ancestors.
Show places Displays birth and death places in the chart arcs where space allows. For descendants with many children, places are automatically suppressed. Choose the level of detail (full name or lowest 1-3 hierarchy levels).
Show parent marriage dates Displays marriage dates in a narrow arc between each pair of parent arcs. When descendants are enabled, also shows the marriage date between the central person and their partners.
Show family colors Colors arcs by family branch. Paternal and maternal base colors are configurable via color pickers.
Birth and death date precision Show full birth and death dates (DD.MM.YYYY) for early generations. Outer generations use a compact year-only format. Marriage dates switch to year-only from generation 7 and are hidden from generation 9. Descendants with narrow arcs automatically use a compact format.
Number of inner levels Controls how many generations use the wider inner-arc layout with text along the arc path.
Font size Scales the text size (50-150%).

Interacting with the chart:

Action Effect
Click on a person Re-centers the chart on that person
Right-click on a person Opens a detailed tooltip with dates, places, and image
Ctrl + scroll Zoom in/out
Click and drag Move the chart
Click center button Reset view to center
Fullscreen button Toggle fullscreen mode
PNG / SVG buttons Export the chart as an image file

Troubleshooting

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

The chart does not appear / shows an error

Images are not displayed

Places are not shown

Development

This section is for developers who want to contribute to the module.

Building JavaScript

Using Docker (no local Node.js required):

Using local Node.js:

Running tests

All versions of webtrees-fan-chart with dependencies

PHP Build Version
Package Version
Requires php Version 8.3 - 8.5
ext-dom Version *
ext-json Version *
fisharebest/webtrees Version ~2.2.0
magicsunday/webtrees-module-base Version ^2.6
magicsunday/webtrees-module-installer-plugin Version ^2.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package magicsunday/webtrees-fan-chart contains the following files

Loading the files please wait ...