tpwd / typo3-kiscore
TYPO3 extension to integrate kiscore.ai, AI bot detection and analysis.
Requires
- ext-pdo: *
- typo3/cms-core: ^12 || ^13 || ^14
- typo3/cms-frontend: ^12 || ^13 || ^14
Requires (Dev)
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-13 02:41:28 UTC
README
TYPO3 extension to integrate kiscore.ai, AI bot detection and analysis.
Installation
composer require tpwd/typo3-kiscore
Configuration
Requires extension 2.1.0 or later. In the KIscore dashboard, copy the connection key for your website. Edit the site's configuration in TYPO3, paste it into KIscore connection key, and save.
The extension splits the key internally and authenticates tracking requests.
Missing or malformed keys send no data. Existing installations with separate
kiscore_site_id and kiscore_tracking_secret remain supported; a supplied
connection key takes precedence.
Keep the key out of versioned config/sites/*/config.yaml by setting the private
hosting variable KISCORE_CONNECTION_KEY and entering
%env(KISCORE_CONNECTION_KEY)% in the connection key field:
kiscore_connection_key: '%env(KISCORE_CONNECTION_KEY)%'
The variable is available to the TYPO3 PHP process and is scoped to this site by the YAML reference. Multiple sites may reference different variable names. After changing the environment, restart PHP and flush TYPO3's configuration cache.
Features
- Reports every page a visitor or crawler opens, including pages from the TYPO3 page cache. Form submits, AJAX and page-type requests, prefetches, redirects, error pages and backend previews are not reported
- Sends user agent, referer, client IP and the page path with its
utm_*parameters to kiscore.ai; other query parameters stay on your server, as they can hold tokens or email addresses - Recognises visits referred by AI assistants via referer or
utm_source - Compatible with TYPO3 12, 13 and 14
- The page is delivered first: the report is sent after the response (PHP-FPM and LiteSpeed close the connection before it), with short timeouts, and errors never reach the visitor
- Behind a reverse proxy, load balancer or CDN, set TYPO3's
reverseProxyIP(Install Tool,[SYS][reverseProxyIP]). Otherwise every visitor is reported with the proxy's address and visits from AI assistants collapse into one per day - Pages served by a cache in front of TYPO3 (Varnish, nginx, a CDN or EXT:staticfilecache) never reach the extension and are not reported. Exclude AI crawlers from that cache if you need their visits
Tests
This extension ships with a minimal PHPUnit setup to help increase software quality.
- Install dev dependencies:
composer install
- Run the unit tests:
composer test