prelumen / analytics-core

1.0.0 2026-09-18 12:51 UTC

Requires

• php: ^8.2
• psr/http-client: ^1.0
• psr/http-factory: ^1.1
• psr/http-message: ^1.1 || ^2.0

Requires (Dev)

• nyholm/psr7: ^1.8
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.0
• squizlabs/php_codesniffer: ^3.10

GPL-2.0-or-later

Published on Packagist.org on 2026-09-18 12:56 UTC

README

Platform-neutral PHP core for WordPress and TYPO3 integrations with Prelumen Analytics.

Scope

• Renders the current Proof tracker snippet for /track/{website_uuid}/script.js.
• Sends supported tracker payloads to /track/{website_uuid}/api, /js, and /identify.
• Validates site configuration, consent state, event payloads, and PII-sensitive properties.
• Provides metadata and commerce DTOs without calling undocumented upstream endpoints.
• Registers websites through the public API and supports installation-scoped hosted account onboarding, recovery, live entitlements and billing tickets.
• Provides an opt-in runtime consent loader for compatible Prelumen tracker deployments.

Non-goals

• Automatic platform metadata or commerce uploads. DTOs alone do not enable delivery.
• WordPress, TYPO3, GTM, or JavaScript SDK wrappers.

Installation

The intended stable package is prelumen/analytics-core:^1.0, requiring PHP 8.2+. Public availability is established by its Packagist listing and release tag, not by this development README. CMS adapters supply HTTP transport, permissions, consent, encrypted persistence and locking. Credentials must never be exposed in HTML or exported configuration. Runtime consent requires the matching backend tracker.

Development

composer install
vendor/bin/phpunit --coverage-text
vendor/bin/phpstan analyse -c phpstan.neon
vendor/bin/phpcs --standard=phpcs.xml.dist