enhancely/enhancely-for-typo3

Enhancely JSON-LD integration for TYPO3 - AI-generated structured data for SEO

Maintainers

Package info

github.com/dkd-dobberkau/enhancely-typo3

Type:typo3-cms-extension

pkg:composer/enhancely/enhancely-for-typo3

Statistics

Installs: 28

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.2.2 2026-03-17 22:40 UTC

This package is auto-updated.

Last update: 2026-03-17 22:40:47 UTC


README

AI-generated JSON-LD structured data for improved SEO and LLM visibility.

TYPO3 PHP License

What is Enhancely?

Enhancely automatically generates Schema.org JSON-LD structured data for your web pages using AI. This helps search engines and AI platforms better understand your content, improving SEO and visibility.

Installation

Composer (recommended)

composer require enhancely/enhancely-for-typo3
vendor/bin/typo3 database:updateschema

In TYPO3 v12 (Classic Mode), activate the extension additionally via Admin Tools > Extensions.

Configuration

  1. Go to Admin Tools > Settings > Extension Configuration
  2. Select enhancely
  3. Configure:
Setting Description Default
API Key Your Enhancely API key from enhancely.ai -
Enabled Enable/disable JSON-LD generation true
API Base URL Base URL without path (leave empty for default) https://api.enhancely.ai
Excluded Page Types Comma-separated doktypes to skip (e.g., 404,403) -
Cache Lifetime Cache duration in seconds 86400 (24h)

How It Works

Request → Middleware → Enhancely API → JSON-LD injected in <head>
  1. PSR-15 middleware intercepts frontend responses
  2. Calls Enhancely API with the page URL
  3. API returns AI-generated JSON-LD
  4. JSON-LD is injected before </head>
  5. ETags are cached to minimize API calls

Features

  • Automatic JSON-LD: No manual schema markup required
  • ETag Caching: Conditional requests minimize API usage
  • TYPO3 Cache Integration: Uses native caching framework
  • Graceful Degradation: Page renders normally if API fails
  • URL Normalization: Strips query params and fragments for consistent caching

API Response Handling

Status Meaning Action
200 JSON-LD ready Inject and cache
201/202 Processing Skip, retry on next request
412 Not modified Use cached version

Requirements

  • TYPO3 12.4+, 13.x or 14.x
  • PHP 8.2+
  • Enhancely API key

Development

# Install dependencies
composer install

# Run tests
composer test

License

GPL-2.0-or-later. See LICENSE.

Links