README

此插件通过Piwik跟踪API将Piwik分析集成到Roundcube中。此插件与Roundcube Webmail piwik分析插件非常不同，后者添加了客户端的JavaScript跟踪标签。此插件的目标是在服务器端添加Piwik集成，以绕过同源策略。

如果你的Piwik安装与你的Roundcube安装在同一域名上，并且两者都使用相同的协议，那么这个插件可能不是你需要的，因为它不会比JavaScript跟踪标签增加任何显著的价值。以下是一些此插件大放异彩的示例情况

Piwik位于http://analytics.company.com，Roundcube位于https://webmail.company.com
Piwik位于http://analytics.company.com，Roundcube位于http://webmail.othercompany.com

安装

使用Composer安装或手动下载并安装到plugins/piwik_tracking_api中。将config.inc.php.dist复制到同一目录下的config.inc.php，并使用以下选项编辑文件。

将piwik_tracking_api添加到你的Roundcube配置中的$config['plugins']以启用插件。

将config.inc.php.dist复制到config.inc.php并编辑配置变量。未使用的可选变量设置为null。

piwik_tracking_api_url [字符串]

将其设置为Piwik安装的URL。此URL必须可以从Roundcube安装中访问。

piwik_tracking_api_site_id [整数|数组(string => int)]

配置Piwik站点ID。此变量的值可以是单个整数或包含多个服务器名和ID的数组，在单个Roundcube安装为多个主机服务的情况下。

要设置多个主机，请使用服务器名和Piwik网站ID的键/值对。例如

$rcmail_config['piwik_tracking_api_site_id'] = array(
    'webmail.foo.com' => 42,
    'webmail.bar.com' => 13
);

piwik_tracking_api_track_user_id [布尔值]

启用时，将使用用户的电子邮件地址来连接多个设备和浏览器。有关更多信息，请参阅Piwik用户指南中的用户ID的好处。

piwik_tracking_api_token_auth [字符串] (可选)

将此设置为Piwik用户的token auth密钥，以便利用高级跟踪。如果提供，则当前使用以下内容