PHPackages                             dmwg/wisski\_trails - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. dmwg/wisski\_trails

ActiveDrupal-module[Utility & Helpers](/categories/utility)

dmwg/wisski\_trails
===================

Drupal module that shows a document-graph visualisation in an iframe on the entity detail page.

1.1.0(7mo ago)02[7 PRs](https://github.com/dmwg/wisski_trails/pulls)GPL-3.0-or-laterPHPPHP >=8.3CI passing

Since Oct 8Pushed 3mo agoCompare

[ Source](https://github.com/dmwg/wisski_trails)[ Packagist](https://packagist.org/packages/dmwg/wisski_trails)[ RSS](/packages/dmwg-wisski-trails/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (8)Versions (11)Used By (0)

WissKI Trails
=============

[](#wisski-trails)

[![CI](https://github.com/dmwg/wisski_trails/actions/workflows/ci.yml/badge.svg)](https://github.com/dmwg/wisski_trails/actions/workflows/ci.yml)[![PHP Version](https://camo.githubusercontent.com/d80e0aa9c8db8583e3367fcb62002c5513772559e052866337eb6deeba28c8be/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f646d77672f776973736b695f747261696c732f7068703f636f6c6f723d383839324246)](https://packagist.org/packages/dmwg/wisski_trails)[![Drupal Version](https://camo.githubusercontent.com/0b46bfcc76150b898cce160748f6b27039a10d5915536f010f4f508d1e1480de/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64727570616c2d25354531302e3325323025374325374325323025354531312d626c7565)](https://www.drupal.org)[![License](https://camo.githubusercontent.com/bd24a84bcb44d692a2d04643a7e0423dafd9d8821ac6c9354e4db4e0177e999b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f646d77672f776973736b695f747261696c73)](LICENSE)[![Latest Version](https://camo.githubusercontent.com/86de690eb2964f969a2f7e11a9735199c58052e8e00b5a37e934fa8e5061ac3b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646d77672f776973736b695f747261696c73)](https://packagist.org/packages/dmwg/wisski_trails)

A Drupal module that displays document-graph visualizations in an iframe on entity detail pages. **This module depends on hitherto unreleased data-processing infrastructure and is not usable out of the box!**

Description
-----------

[](#description)

WissKI Trails provides a configurable block that can be placed on entity detail pages to display interactive document-graph visualizations. The module integrates with the WissKI ecosystem, allowing users to explore relationships between entities through visual representations.

The visualization is loaded via an iframe from a configurable external service, with the entity ID automatically passed to construct the appropriate visualization URL.

Requirements
------------

[](#requirements)

- `php>=8.3`
- Drupal 10.3 or higher (also compatible with Drupal 11)
- Drupal Views module (core)

Installation
------------

[](#installation)

### Via Composer (recommended)

[](#via-composer-recommended)

```
composer require dmwg/wisski_trails
```

Then enable the module:

```
drush en wisski_trails
```

Or via the Drupal admin interface at `admin/modules`.

### Manual Installation

[](#manual-installation)

1. Download the module from [GitHub](https://github.com/dmwg/wisski_trails)
2. Extract to your Drupal installation's `modules/contrib` directory
3. Enable the module via Drush or the admin interface

Configuration
-------------

[](#configuration)

### Module Configuration

[](#module-configuration)

1. Navigate to **Configuration > Web Services > WissKI Trails** (`/admin/config/wisski_trails`)
2. Set the **Base URL** for your visualization service
3. Save the configuration

The iframe URL will be constructed as: `{base_url}/{entity_id}`

### Block Placement

[](#block-placement)

1. Navigate to **Structure > Block layout** (`/admin/structure/block`)
2. Click **Place block** in your desired region
3. Find and place the **WissKI Trails** block
4. Configure visibility settings as needed (typically restricted to entity detail pages)
5. Save the block configuration

Usage
-----

[](#usage)

Once configured and placed, the block will automatically:

1. Detect the current entity ID on entity detail pages
2. Construct the iframe URL using the configured base URL
3. Display the visualization iframe if an entity ID is found

Development
-----------

[](#development)

### Prerequisites

[](#prerequisites)

- Composer installed
- PHP 8.3 or 8.4
- Git

### Getting Started

[](#getting-started)

Clone the repository and install dependencies:

```
git clone https://github.com/dmwg/wisski_trails.git
cd wisski_trails
composer install
```

### Available Commands

[](#available-commands)

#### Code Quality

[](#code-quality)

Check coding style (Drupal standards):

```
composer codingstyle
# Aliases: composer cs, composer style
```

Auto-fix coding style violations:

```
composer codingstyle-fix
# Aliases: composer fix, composer csfix, composer stylefix
```

Run static analysis with PHPStan (level 5):

```
composer phpstan
# Alias: composer stan
```

Normalize composer.json:

```
composer normalize
```

#### Testing

[](#testing)

Run unit tests:

```
composer test
```

Run tests with coverage report (requires Xdebug or PCOV):

```
composer test-coverage
```

#### Pre-commit Workflow

[](#pre-commit-workflow)

Before committing changes, run all quality checks:

```
composer codingstyle-fix \
  && composer codingstyle \
  && composer phpstan \
  && composer test
```

### Coding Standards

[](#coding-standards)

- **Standard**: Drupal coding standards
- **PHPStan Level**: 5
- **Namespace**: `Drupal\wisski_trails\`
- **PSR-4 Autoloading**: `src/` directory

Maintainers
-----------

[](#maintainers)

Current maintainer:

- Oliver Baumann - [DMWG, University of Bayreuth](https://www.dmwg.uni-bayreuth.de/en/index.html)

Contributing
------------

[](#contributing)

Issues and pull requests are welcome on [GitHub](https://github.com/dmwg/wisski_trails/issues).

License
-------

[](#license)

This project is licensed under GPL-3.0-or-later. See the [LICENSE](LICENSE) file for details.

Support
-------

[](#support)

- **Issues**: [GitHub Issues](https://github.com/dmwg/wisski_trails/issues)
- **Source**: [GitHub Repository](https://github.com/dmwg/wisski_trails)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance73

Regular maintenance activity

Popularity2

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

3

Last Release

210d ago

Major Versions

0.1.0 → 1.0.02025-10-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/9c41910c650f05b98fff6b8c345bfc8b3b04d2df4631f46d8203620039893248?d=identicon)[baumanno](/maintainers/baumanno)

---

Top Contributors

[![baumanno](https://avatars.githubusercontent.com/u/1183339?v=4)](https://github.com/baumanno "baumanno (22 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/dmwg-wisski-trails/health.svg)

```
[![Health](https://phpackages.com/badges/dmwg-wisski-trails/health.svg)](https://phpackages.com/packages/dmwg-wisski-trails)
```

###  Alternatives

[farmos/farmos

A web-based farm record keeping application.

1.2k6.7k1](/packages/farmos-farmos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)