vskstudio/takt-laravel
Composer 安装命令：
composer require vskstudio/takt-laravel
包简介
Laravel integration for Takt analytics: @takt Blade directive + Takt facade for server-side events.
README 文档
README
Laravel integration for Takt analytics. Drop a single @takt
Blade directive in your layout for privacy-friendly client-side tracking, and use the Takt
facade to send server-side events straight from your application code.
Requirements
- PHP 8.1+
- Laravel 10, 11, or 12
Installation
composer require vskstudio/takt-laravel
The service provider and the Takt facade are registered automatically through Laravel package
auto-discovery. There is nothing else to wire up.
Configuration
The package ships with sane defaults and reads everything from your environment. To customise the published config file:
php artisan vendor:publish --tag=takt-config
This writes config/takt.php. All values are environment-driven:
| Env variable | Default | Description |
|---|---|---|
TAKT_DOMAIN |
'' |
The site/domain registered in Takt that data is attributed to. |
TAKT_ENDPOINT |
https://takt.example.com |
Base URL of your Takt ingest endpoint. |
TAKT_API_KEY |
null |
Ingest-scoped API key used for server-side events (see below). |
TAKT_MODE |
inline |
Snippet delivery mode: inline, cdn, or asset. |
TAKT_OUTBOUND |
false |
Track clicks on outbound links. |
TAKT_FILES |
false |
Track file download clicks. |
TAKT_EXCLUDE_LOCALHOST |
true |
Skip tracking when running on localhost. |
Example .env:
TAKT_DOMAIN=example.com TAKT_ENDPOINT=https://ingest.takt.io TAKT_API_KEY=ingest_xxxxxxxxxxxxxxxx TAKT_MODE=inline
Client-side tracking
Add the @takt directive to the <head> of your layout:
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> @takt </head> <body> @yield('content') </body> </html>
Delivery modes
TAKT_MODE controls how the tracking script is delivered:
inline(default) — the script is embedded directly in the rendered HTML. Zero extra network requests, nothing to host.cdn— references the script from the Takt CDN.asset— references a self-hosted copy of the script served from your own application.
Server-side events
Use the Takt facade to record events from controllers, jobs, or anywhere in your application:
use Vskstudio\Takt\Laravel\Facades\Takt; use Vskstudio\Takt\Revenue; // A custom event with properties and revenue Takt::event('Signup', ['plan' => 'pro'], new Revenue('29.00', 'EUR')); // A simple pageview Takt::pageview();
Server-side events automatically attribute to the current request's IP address and User-Agent, so they are correlated with the visitor that triggered them. You can optionally pass an explicit URL as the last argument to either method.
API key scope:
TAKT_API_KEYmust be an ingest-scoped key bound to the configuredTAKT_DOMAIN. Keep it server-side only — it is never exposed to the browser.
License
MIT. See LICENSE.
统计信息
- 总下载量： 0
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 2
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-06-12