codeaken/laravel-piwiktracker

插入Piwik跟踪代码,并提供隐藏模式以隐藏跟踪服务器URL

1.0 2014-08-15 21:52 UTC

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_idtracker_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