enhancely / enhancely-for-typo3
Enhancely JSON-LD integration for TYPO3 - AI-generated structured data for SEO
Package info
github.com/dkd-dobberkau/enhancely-typo3
Type:typo3-cms-extension
pkg:composer/enhancely/enhancely-for-typo3
1.2.2
2026-03-17 22:40 UTC
Requires
- php: ^8.2
- guzzlehttp/guzzle: ^7.0
- typo3/cms-core: ^12.4 || ^13.0 || ^14.0
Requires (Dev)
- phpunit/phpunit: ^10.5 || ^11.0
README
AI-generated JSON-LD structured data for improved SEO and LLM visibility.
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
- Go to Admin Tools > Settings > Extension Configuration
- Select enhancely
- 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>
- PSR-15 middleware intercepts frontend responses
- Calls Enhancely API with the page URL
- API returns AI-generated JSON-LD
- JSON-LD is injected before
</head> - 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.