README

版本 5.0.0

• 最后更新: 2023年10月27日

这是MediaWiki软件的Mamoto（前Piwik）集成扩展。只有当您有MediaWiki安装时，此扩展才有用；它只能由站点的管理员安装。

最低要求

1. MediaWiki 1.34+

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设置为false（默认情况下机器人被忽略）

• 不要忽略系统管理员：将$wgMatomoIgnoreSysops设置为false（默认情况下系统管理员被忽略）

• 要在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的UserID功能跟踪访客的用户名（需要Matomo >= 2.7.0），请在LocalSettings.php中将$wgMatomoTrackUsernames设置为true。

故障排除

在MediaWiki 1.39.0–1.39.4和1.40.0上，跟踪代码被包含两次：可以通过升级MediaWiki到1.39.5和1.40.1来修复此问题（请参阅此Phabricator任务）。