PHPackages                             cywolf/page\_link\_insights - 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. cywolf/page\_link\_insights

ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility)

cywolf/page\_link\_insights
===========================

A TYPO3 extension that adds a backend module with a D3.js force diagram visualization for understanding page relationships and content themes

2.0.0(4mo ago)22.3k—8.3%2[7 issues](https://github.com/friteuseb/page_link_insights/issues)GPL-2.0-or-laterPHPPHP ^8.2

Since Feb 25Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/friteuseb/page_link_insights)[ Packagist](https://packagist.org/packages/cywolf/page_link_insights)[ RSS](/packages/cywolf-page-link-insights/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (6)Versions (23)Used By (0)

TYPO3 Page Link Insights Extension
==================================

[](#typo3-page-link-insights-extension)

[![Force Diagram Example](Resources/Public/Images/force-diagram-example.png)](Resources/Public/Images/force-diagram-example.png)

This TYPO3 extension helps you optimize your website's internal linking structure by providing a powerful visual representation of content-based page connections. Page Link Insights focuses specifically on links within your content elements, helping you understand and improve your site's semantic link structure and SEO performance.

Features
--------

[](#features)

### Comprehensive Link Analysis

[](#comprehensive-link-analysis)

- **Interactive Force Diagram**: Visualize page relationships with D3.js
- **Content-Based Analysis**: Focus on actual content links rather than navigation
- **Link Type Detection**: Identify different types of page references (HTML, typolink, content elements)
- **Fullscreen Mode**: Maximize graph visibility with one click (ESC to exit)
- **Linkvalidator Integration**: Optional integration with TYPO3's cms-linkvalidator for accurate broken link detection

### Advanced Page Metrics

[](#advanced-page-metrics)

- **PageRank Calculation**: See which pages carry the most authority
- **Centrality Scores**: Identify key junction pages in your content
- **Inbound/Outbound Links**: Track connection counts for each page
- **Broken Link Detection**: Automatically identify and visualize broken references (enhanced with linkvalidator data when available)

### Thematic Analysis

[](#thematic-analysis)

- **Keyword Extraction**: Automatically identify significant terms on each page
- **Theme Clustering**: Group related content by detected themes
- **Page-Theme Association**: See which themes are relevant to each page
- **NLP Integration**: Uses NlpTools for advanced text analysis

### Global Statistics

[](#global-statistics)

- **Network Density**: Understand overall interconnection level
- **Orphaned Pages**: Find pages with no incoming links
- **Link Averages**: Track average connections per page
- **SEO Insights**: Identify structural improvements

### Solr Integration

[](#solr-integration)

- **Enhanced Relevance**: Boost search results based on PageRank and link metrics
- **Custom Fields**: Add link metrics to Solr index
- **Sorting Options**: Allow sorting by page importance

### Scheduler Task

[](#scheduler-task)

- **Automated Analysis**: Schedule regular site structure analysis
- **Theme Processing**: Update thematic groupings automatically
- **Historical Tracking**: Maintain metrics history for trend analysis

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

[](#requirements)

- TYPO3 12.4 - 13.4
- PHP 8.1 - 8.4
- NlpTools extension (for thematic analysis)

### Optional

[](#optional)

- **cms-linkvalidator**: For enhanced broken link detection with actual HTTP validation
- **semantic\_suggestion**: For AI-powered semantic content relationships

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

[](#installation)

### Via Composer

[](#via-composer)

```
composer require cywolf/page_link_insights
```

### Via TYPO3 Extension Manager

[](#via-typo3-extension-manager)

1. Login to TYPO3 Backend
2. Go to Admin Tools > Extensions
3. Click on "Get Extensions"
4. Search for "page\_link\_insights"
5. Click "Import and Install"

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

[](#configuration)

The extension can be configured through the Extension Configuration in TYPO3 Backend:

[![Extension Configuration](Resources/Public/Images/extension-configuration.png)](Resources/Public/Images/extension-configuration.png)

1. Go to Admin Tools > Settings > Extension Configuration
2. Select "page\_link\_insights"
3. Configure the following options:

### Basic Options

[](#basic-options)

OptionDefaultDescription`colPosToAnalyze``0,2`Comma-separated list of content column positions to analyze`includeHidden``false`Include hidden pages and content elements`includeSemanticSuggestions``true`Show semantic suggestions in diagram (requires semantic\_suggestion extension)### Advanced Options

[](#advanced-options)

OptionDefaultDescription`includeShortcuts``false`Include shortcut pages (doktype 4) in diagrams`includeExternalLinks``false`Include external link pages (doktype 3) in diagrams`useLinkvalidator``true`Use TYPO3 linkvalidator for broken link detection (if available)> **Note**: The `useLinkvalidator` option provides more accurate broken link detection when cms-linkvalidator is installed and its scheduler task has been run. If linkvalidator is not available, the extension falls back to checking if target pages exist in the database.

### Scheduler Task

[](#scheduler-task-1)

To set up automatic link analysis:

1. Go to Scheduler module
2. Add a new task
3. Select "Analyze Page Links and Themes"
4. Configure the root page ID
5. Set your preferred frequency

[![Scheduler Task](Resources/Public/Images/scheduler_task.png)](Resources/Public/Images/scheduler_task.png)

Usage
-----

[](#usage)

### Visualizing Page Links

[](#visualizing-page-links)

1. Open the TYPO3 Backend
2. Navigate to the Web > Page Link Insights module
3. Select a page in the page tree
4. Explore the force diagram visualization:
    - Larger nodes indicate pages with more incoming links
    - Colors represent different link types
    - Dashed red lines indicate broken links
    - Hover over elements for detailed information

### Interactive Features

[](#interactive-features)

- **Zoom and Pan**: Navigate through complex diagrams using mouse wheel and drag
- **Drag Nodes**: Reposition elements for better visualization
- **Ctrl+Click**: Open the page directly in TYPO3 backend
- **Right-Click**: Remove node from visualization (temporary)
- **Tooltips**: Show detailed page and link information on hover

### Toolbar Buttons

[](#toolbar-buttons)

- **Filters**: Filter links by type (standard, semantic, broken, menu, HTML, typolink)
- **Help**: Display diagram legend and interaction guide
- **Fit to Window**: Auto-zoom to show all nodes
- **Fullscreen**: Maximize graph area (press ESC to exit)

### Compact Header

[](#compact-header)

The module header displays status badges that can be dismissed:

- **colPos badge**: Shows which column positions are being analyzed
- **Semantic badge**: Indicates if semantic suggestions are enabled/available

### Understanding Thematic Analysis

[](#understanding-thematic-analysis)

The extension now includes thematic analysis capabilities that:

- Automatically extract significant keywords from your pages
- Group these keywords into global themes
- Associate themes with relevant pages
- Visualize themes in the D3.js force diagram with color coding

Pages with similar content will be grouped together and colored according to their dominant theme, providing instant visual insights into your content structure.

#### NLP Support

[](#nlp-support)

- If the `cywolf/nlp-tools` extension is installed, it will be used for advanced linguistic analysis
- If this extension is not available or encounters errors, a fallback method is automatically used
- In all cases, relevant themes will be generated for your pages

The clustering visualization works in both TYPO3 v12 and v13, and is compatible with PHP 8.1 to 8.4.

### Linkvalidator Integration

[](#linkvalidator-integration)

When `cms-linkvalidator` is installed and configured:

1. Run the linkvalidator scheduler task to populate broken link data
2. Page Link Insights will automatically use this data for more accurate broken link detection
3. Broken links are marked with their source:
    - `linkvalidator`: Detected by TYPO3's linkvalidator (HTTP validated)
    - `page_not_found`: Target page doesn't exist in database (fallback method)

To disable linkvalidator integration, set `useLinkvalidator = 0` in extension configuration.

### Solr Integration

[](#solr-integration-1)

For search functionality enhancement, see [README\_SOLR.md](README_SOLR.md).

Troubleshooting
---------------

[](#troubleshooting)

- **Empty Visualization**: Ensure selected page has content with page references
- **Missing Links**: Check if links are in the analyzed column positions
- **Performance Issues**: Large sites may need higher PHP memory limits
- **Theme Analysis Errors**: Verify NlpTools extension is installed
- **Linkvalidator Not Working**: Ensure cms-linkvalidator scheduler task has been run at least once
- **Semantic Suggestions Missing**: Install and configure the semantic\_suggestion extension

Support and Contribution
------------------------

[](#support-and-contribution)

For bug reports and feature requests, please use the issue tracker on GitHub: [Project Issue Tracker](https://github.com/friteuseb/page_link_insights/issues)

License
-------

[](#license)

This project is licensed under the GNU General Public License v2.0.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance58

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 67.3% 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 ~19 days

Recently: every ~8 days

Total

17

Last Release

145d ago

Major Versions

v1.7.0 → 2.0.02025-12-25

PHP version history (2 changes)1.0.3PHP >=8.2

2.0.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1471455?v=4)[Cyril Wolfangel](/maintainers/friteuseb)[@friteuseb](https://github.com/friteuseb)

---

Top Contributors

[![friteuseb](https://avatars.githubusercontent.com/u/1471455?v=4)](https://github.com/friteuseb "friteuseb (70 commits)")[![cyril-wolfangelTalanCOP](https://avatars.githubusercontent.com/u/220198517?v=4)](https://github.com/cyril-wolfangelTalanCOP "cyril-wolfangelTalanCOP (33 commits)")[![taieb123](https://avatars.githubusercontent.com/u/29729164?v=4)](https://github.com/taieb123 "taieb123 (1 commits)")

### Embed Badge

![Health badge](/badges/cywolf-page-link-insights/health.svg)

```
[![Health](https://phpackages.com/badges/cywolf-page-link-insights/health.svg)](https://phpackages.com/packages/cywolf-page-link-insights)
```

###  Alternatives

[aimeos/aimeos-typo3

Professional, full-featured and high performance TYPO3 e-commerce extension for online shops and complex B2B projects

1.5k91.2k4](/packages/aimeos-aimeos-typo3)[fluidtypo3/flux

The flux package from FluidTYPO3

152982.2k20](/packages/fluidtypo3-flux)[fluidtypo3/vhs

This is a collection of ViewHelpers for performing rendering tasks that are not natively provided by TYPO3's Fluid templating engine.

1954.1M49](/packages/fluidtypo3-vhs)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

96374.6k23](/packages/friendsoftypo3-content-blocks)[typo3/testing-framework

The TYPO3 testing framework provides base classes for unit, functional and acceptance testing.

675.0M775](/packages/typo3-testing-framework)[eliashaeussler/typo3-form-consent

Extension for TYPO3 CMS that adds double opt-in functionality to EXT:form

1481.0k](/packages/eliashaeussler-typo3-form-consent)

PHPackages © 2026

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