查看并下载特定Matomo版本的插件:

一些额外的cli命令来帮助维护Matomo。还在管理部分提供了phpinfo页面。介绍新的控制台命令:

  • archive:列表
  • 配置:
  • 备份数据库:
  • 数据库:创建
  • 数据库:下降
  • 数据库:进口
  • 日志:删除
  • 日志:显示
  • matomo:安装
  • 段:管理
  • 段:列表
  • 网站:添加
  • 网站:删除
  • 网站:列表
  • 网站:网址
  • 访问:
  • customdimensions: configure-new-dimension

背景

做这个插件的主要原因是让自动安装与Matomo一起工作,包括自动更新和版本控制交付配置json或yaml。

已知的错误

添加一个站点作为matomo:安装目前已损坏,但您可以在命令后运行网站:添加命令:

./console站点:add——name=Foo——urls=https://foo.bar

依赖关系

sin版本4.1.0-beta1我们依赖于PHP 8.1

主机:

  • Mysql-client或mariadb-client(用于数据库任务)
  • PHP json扩展

在作曲家。json (Matomo root):

从版本4.1.0-beta1: *symfony/yaml:~2.6.0(从dev中移动)*作曲家需要symfony/过程:^5.4

早期版本:*symfony/yaml:~2.6.0(从dev中移动)*作曲家需要symfony/过程:^3.4

安装

Git克隆插件到你的插件文件夹:

git克隆https://github.com/digitalist-se/extratools.git ExtraTools

配置

激活ExtraTools -在UI中,或者更好-在控制台中:

控制台插件:激活extrtools

设置一个db备份路径,使用控制台(使用你想要的路径):

./console配置:设置ExtraTools.db_backup_path="/var/www/html/tmp"

或者手动添加到config.ini.php:

[ExtraTools] db_backup_path = "/var/www/html/tmp"

命令

archive:列表

获取正在进行或已计划的核心存档程序的列表(如果存在)。

配置:

获取一个节配置。@todo -让它更像config:set -这样你就有更多的选项。

备份数据库:

备份db。

数据库:创建

创建i config.ini.php定义的db。添加——force标志将停止询问问题的命令。

数据库:下降

如果需要,首先删除数据库定义的i config.ini.php - backup。添加——force标志将停止询问问题的命令。

数据库:进口

导入数据库转储到config.ini.php中定义的数据库,所以如果你已经安装了-它会覆盖它。

日志:删除

从数据库中删除日志条目,即Matomo中的内部日志记录,而不是对站点的访问。

日志:显示

显示日志记录和数据库日志的查询项,输出可以导出到CSV。

matomo:安装

要使用matomo:install,您需要ExtraTools始终处于启用状态always_load_commands_from_plugin = ExtraToolscommon.config.ini.php

以下是我们如何在广告docker图像构建中做到这一点:

> /var/www/html/config/common.config.ini.php;\ echo "always_load_commands_from_plugin=ExtraTools" >> /var/www/html/config/common.config.ini.php;\

安装Matamo。删除当前安装-默认使用config.ini.php文件中的设置-但所有值都可能被参数或环境变量覆盖。

如果您有Matomo Premium插件的许可证,请设置环境变量MATOMO_LICENSE使用正确的许可令牌。环境变量被设置为正常的环境变量,在shell中使用export,在docker-compose文件中,在环境数组中等等。如果设置了该变量,Matomo将在安装时设置许可密钥。

段:管理

段的管理,目前唯一的选择是删除或激活一个段,删除的段以后可以再次激活。

段:列表

列出所有段,包括ID、定义、创建日期和最新更新。

网站:添加

添加一个要跟踪的新站点。

网站:删除

删除提供ID的站点。

网站:列表

列出站点,使用可选的format参数-支持的输出是text(默认),json和yaml。

网站:网址

向站点添加一个或多个url。

访问:

获取所有的存档访问,为一个网站或所有。对于一个部分或所有部分,对于今天,或另一天等等。

customdimensions: configure-new-dimension

配置一个新的自定义维度。β。

需求

Matomo需要一个MySQL/MariaDB主机,用户设置允许删除该数据库。第一个用户被创建为超级用户,需要有一个超级用户来设置Matomo。如果您没有在环境变量或选项中添加值到matomo:install命令中,它将使用用户的默认值-非常重要,因此您在安装后更改用户密码。Matomo还创建了一个要跟踪的第一个站点,这也有默认值,您可以用环境变量或选项覆盖。

你也可以使用json文件进行配置——就像上面提到的那样——以及安装插件。在这个插件的docs文件夹中可以找到一个json文件的示例。

环境变量

官方Matomo docker容器支持的默认环境变量:

Matomo_database_host matomo_database_port matomo_database_tables_prefix matomo_database_username matomo_database_password matomo_database_dbname matomo_database_adapter

这些可以被(历史原因)覆盖:

Matomo_db_host matomo_db_prefix matomo_db_username matomo_db_password matomo_db_name

其他环境变量:

Matomo_first_user_name matomo_first_user_email matomo_first_user_password matomo_first_site_name matomo_first_site_url matomo_log_timestamp

安装准备工作

如果你在config目录下有一个config.ini.php,删除它。运行:

控制台插件:激活extrtools

然后学习下面的一个例子。

示例install 1(推荐)

控制台matomo:install——install-file=install.json

示例install 2

console matomo:install——db-username=myuser——db-pass=password \——db-host=localhost——db-port=3306——db-name=matomo——first-site-name=Foo \——first-site-url=https// Foo。bar——first-user='Mr Foo bar ' \——first-user-email=foo@bar.com——first-user-pass=secret

示例install 3

使用环境变量,docker-compose。yml例子。

环境:—MATOMO_DB_USERNAME=myuser—MATOMO_DB_PASSWORD=secret—MATOMO_DB_HOST=mysql—MATOMO_DB_PORT=3306—MATOMO_DB_NAME=matomo—MATOMO_FIRST_USER_NAME=Mr Foo Bar—MATOMO_FIRST_USER_EMAIL=foo@bar.com—MATOMO_FIRST_USER_PASSWORD=secret—MATOMO_FIRST_SITE_NAME=Foo—MATOMO_FIRST_SITE_URL=https://foo.bar

值的顺序

最高数字=接管。如果你在环境变量中有mysql服务器设置,并提供选项——db-username=myuser,后者用于db用户名。

1) config.ini.php(第一次安装时创建)2)环境变量3)选项(matomo:install——db-username=myuser) 4)文件覆盖(matomo -install——install- File =install.json)

谨慎!

  • matamo:安装擦除当前安装。
  • 数据库:下降-正如它所说的-删除整个数据库,如果你想保存数据,首先进行备份,并检查是否正常。
  • 数据库:进口-重写当前数据库。
  • 网站:删除-真正删除你在Matomo设置的站点。

这个插件自带没有担保。但它是免费和开源的。所以,让我们做得更好!

版本支持

这是从3.8.1版测试的,应该与最新的稳定版本一起工作。

谢谢你!

这个插件是基于本·埃文斯在https://github.com/nebev/piwik-cli-setup中,也可以重用Matomo core中的代码。

我的问题吗?

我的答案

查看并下载特定Matomo版本的插件:


请分享

Baidu