codeaken / laravel-piwiktracker
插入Piwik跟踪代码,并提供隐藏模式以隐藏跟踪服务器URL
Requires
- php: >=5.4.0
- illuminate/support: 4.2.*
This package is not auto-updated.
Last update: 2024-09-24 03:09:40 UTC
README
此Laravel 4包允许您使用新的Blade指令@piwiktracker
在模板中插入Piwik跟踪代码。
它还提供了一个功能,可以通过使用包含的代理来隐藏您的Piwik服务器URL。如果您不希望任何人通过搜索Pwik服务器URL来找到您的所有网站,这将非常棒。
安装
在您的composer.json
中要求该包,然后运行composer update
"require": {
...
"codeaken/laravel-piwiktracker": "1.*"
...
},
更新composer后,将服务提供者添加到app/config/app.php
中的providers
数组
'providers' => array(
...
'Codeaken\PiwikTracker\ServiceProvider',
...
),
同时将外观添加到app/config/app.php
中的aliases
数组
'aliases' => array(
...
'PiwikTracker' => 'Codeaken\PiwikTracker\Facade',
...
),
默认情况下,跟踪器是禁用的,因此您需要复制配置文件并启用它
$ php artisan config:publish codeaken/laravel-piwiktracker
配置文件
-
enabled
:允许您启用或禁用跟踪代码的插入。当您正在开发网站且不需要跟踪访问时很有用。默认值为false
。 -
site_id
:您正在跟踪的网站的ID。您可以在Piwik设置下的跟踪代码中找到此ID。默认值为0
。 -
tracker_url
:Piwik服务器的URL。应该是只有主机名而没有协议,例如mypiwik.com。如果您的Piwik服务器安装在子目录中,则可以添加额外的路径,例如mypiwik.com/piwik。默认为空字符串。 -
hidden
:如果您想隐藏Piwik服务器URL,请将此设置为true。然后我们将代理所有请求到tracker_url
。这需要您在token
选项中设置Piwik授权令牌。默认值为false
。 -
token
:用于访问您想要跟踪的网站的用户的Piwik授权令牌。仅在hidden
设置为true
时使用。默认为空字符串。
添加跟踪代码
在您的布局(或任何其他模板)中,在</body>
标签之前添加新的Blade指令@piwiktracker
,如果已在配置文件中将enabled
设置为true
(以及设置了有效的site_id
和tracker_url
),则应显示跟踪代码。
隐藏跟踪URL
Piwik Tracker包具有隐藏Piwik服务器URL(配置中的tracker_url
)的功能。您可以通过将hidden
设置为true
并添加有效的令牌来启用它。
然后,Piwik JavaScript的请求将发送到路由piwiktracker/js
,我们将从Piwik服务器获取JavaScript(并将其缓存)并返回它。
实际的跟踪调用将发送到piwiktracker/php
,我们通过使用配置中的token
通过Piwik API添加页面视图。我们还返回1x1的GIF文件。
许可证
Laravel Piwik Tracker是在MIT许可证下许可的。
版权所有2014年Magnus Johansson