README

版本 4.0.1

• 最后更新：2019年2月28日

这是MediaWiki软件的Mamoto（前Piwik）集成扩展。该扩展仅适用于已安装MediaWiki的情况；它只能由站点的管理员安装。

最低要求

1. MediaWiki 1.25+

2. 配置好的Matomo（0.4+）安装

安装说明

请仔细阅读。它们并不难理解，但 所有 步骤都是必要的

1. 在您的扩展目录中创建一个名为 "Matomo" 的文件夹

2. 将 extension.json 和 Matomo.hooks.php 上传到您刚刚创建的 "Matomo" 文件夹中

3. 编辑您的 LocalSettings.php 文件，并在文件末尾添加以下内容

    wfLoadExtension( 'Matomo' );
   

4. 配置Matomo URL和site-id。为此，编辑LocalSettings并设置以下变量

   $wgMatomoURL = "matomo-host.tld/dir/";

   $wgMatomoIDSite = "matomo_idsite";

   重要 请不要在$wgMatomoURL中定义协议

注意：将$wgMatomoURL的值更改为URL，不包含协议但包括域名，其中您已安装Matomo。请记住添加尾部斜杠！

1. 享受我们的扩展！

注意：要检查扩展是否成功安装，请访问您的wiki并检查Matomo扩展是否出现在Wiki源代码的底部。

自定义变量

• 通过将$wgMatomoDisableCookies变量设置为false来禁用cookie。

  例如：$wgMatomoDisableCookies = false;

• 忽略常规编辑器：将$wgMatomoIgnoreEditors设置为true

• 忽略机器人：将$wgMatomoIgnoreBots设置为true

• 忽略sysop用户：将$wgMatomoIgnoreSysops设置为true

• 要定义Matomo JavaScript代码中的自定义javascript标签，可以定义$wgMatomoCustomJS变量。例如，如果您要插入单个设置，请使用以下代码

  $wgMatomoCustomJS = "_paq.push(['trackGoal', '1']);"

  如果您要定义多个变量，请使用数组。例如

  $wgMatomoCustomJS = array( "_paq.push(['setCustomVariable', '1','environment','production']);", "_paq.push(['setCustomVariable', '1','is_user','yes']);" );

• 如果您想更改Matomo跟踪器内页面的标题，可以在LocalSettings.php文件中设置$wgMatomoActionName。

• 如果您想将标题包含在内，例如 "wiki/页面的标题"，可以将$wgMatomoUsePageTitle设置为true，并将$wgMatomoActionName设置为"wiki/"。扩展将打印matomo_action_name = 'wiki/页面的标题';

• 如果您想使用Matomo的用户ID功能跟踪访客的用户名（需要Matomo >= 2.7.0），请在LocalSettings.php中将$wgMatomoTrackUsernames设置为true。