# @eeacms/volto-matomo 中文文档 规范地址：https://npmcn.com/package/%40eeacms/volto-matomo/ 版本：7\.0\.1 npm 元数据更新时间：2026-04-09T08:26:05.744Z 中文译文更新时间：2026-11-13T07:53:48.938Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40eeacms/volto-matomo 原文对照：https://npmcn.com/package/%40eeacms/volto-matomo/?lang=original 项目主页：https://github.com/eea/volto-matomo 源码仓库：https://github.com/eea/volto-matomo ## 关键信息（来自 npm 元数据） - 包体积（解压后）：57 kB，25 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：1 个 - 首次发布：2020-12-02T17:47:37.848Z - 最新版本发布：2026-04-09T08:26:05.461Z - 近 30 天下载量：4065（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：29（近 12 个月 2 个） ## 中文简介 伏尔托-马托莫:伏尔托加成 ## 安装 ```sh npm install @eeacms/volto-matomo ``` 也可以使用：`pnpm add @eeacms/volto-matomo`、`yarn add @eeacms/volto-matomo`、`bun add @eeacms/volto-matomo` ## README # 伏地马托莫 [![Releases](https://img.shields.io/github/v/release/eea/volto-matomo)](https://github.com/eea/volto-matomo/releases) [![Pipeline](https://ci.eionet.europa.eu/buildStatus/icon?job=volto-addons%2Fvolto-matomo%2Fmaster&subject=master)](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-matomo/job/master/display/redirect) [![Lines of Code](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&metric=ncloc)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo) [![Coverage](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&metric=coverage)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo) [![Bugs](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&metric=bugs)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo) [![Duplicated Lines (%)](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&metric=duplicated_lines_density)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo) [![Pipeline](https://ci.eionet.europa.eu/buildStatus/icon?job=volto-addons%2Fvolto-matomo%2Fdevelop&subject=develop)](https://ci.eionet.europa.eu/view/Github/job/volto-addons/job/volto-matomo/job/develop/display/redirect) [![Lines of Code](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&branch=develop&metric=ncloc)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo&branch=develop) [![Coverage](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&branch=develop&metric=coverage)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo&branch=develop) [![Bugs](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&branch=develop&metric=bugs)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo&branch=develop) [![Duplicated Lines (%)](https://sonarqube.eea.europa.eu/api/project_badges/measure?project=volto-matomo&branch=develop&metric=duplicated_lines_density)](https://sonarqube.eea.europa.eu/dashboard?id=volto-matomo&branch=develop) [沃尔多](https://github.com/plone/volto) 合并的加载 [马多莫](https://matomo.org/) 与 [沃尔多](https://github.com/plone/volto) 网站。 现在有一个非常基本的集成, 只需要在每一个路由器位置上调用马托莫. ## 怎么样 要配置它,请设置以下变量: - `settings.matomoSiteId` (如果无法获得,则使用: `1`(中文(简体) ) - `settings.matomoUrlBase` (如果无法获得,则使用: `https://matomo.eea.europa.eu/`(中文(简体) ) 或者说 `RAZZLE_MATOMO_SITE_ID` 财务报告和审定财务报表 `RAZZLE_MATOMO_URL` 环境变量. 在4.0.0+版本中,您可以同时使用第二个 matomo : - `settings.matomoSecondSiteId` (如果无法获得,则使用: `1`(中文(简体) ) - `settings.matomoSecondUrlBase` (如果无法获得,则使用: `https://matomo.eea.europa.eu/`(中文(简体) ) 或者说 `RAZZLE_MATOMO_SECOND_SITE_ID` 财务报告和审定财务报表 `RAZZLE_MATOMO_SECOND_URL` 环境变量. 以 6. 0. 0 版本可基于路径名设置自定义 matomo 设置 . - `settings.matomoTrackerIdFn` 有签名的函数 `(pathname) => trackerId:string` - `settings.matomoTrackers` 是绘制 `trackerId`升为 `matomo` 设置对象(所有用于 `config.settings` 可添加到此对象. ## API 密码 有四种出口 `utils.js` (可从 `volto-matomo/utils`,包括来自其他沃尔多加通: 1. `trackPageView({ href, ...options }) : void` - 带一个物体 `href` 以及其它选项并发送到 Matomo 的页面视图轨道; 2. `trackEvent(options) : void` - 来一杯 `options` 对象参数,并向 Matomo 发送事件音轨. 3. `trackSiteSearch(options) : void` - 来一杯 `options` 对象参数,并向 Matomo 发送一个站点搜索轨道. 4. `pushInstruction(name, null, ...args): void` - 取一个名字和任意的参数数, 并把它们推到马托莫. 注意,"马托莫案"是在幕后懒散地装入并被缓存. Volto-matomo的默认行为是呼叫 `trackPageView` 内 `utils.js`,与 `href` 财务报告和审定财务报表 `documentTitle` 选项,在您所记录的每个 URL 更改上 `AppExtras` 在 Volto 中组件。 这个 `href` 取自 `props.content['@id']` 收到的文件 `MatomoAppExtra.jsx` 组件。 这个 `utils.js` 文件只暴露了Matomo React API的一部分. 如果你想延长或更了解它, [此链接](https://github.com/Amsterdam/matomo-tracker/tree/master/packages/react) 也许有帮助. ## 开始 ### 和多克一起尝试伏尔托- matomo ``` git clone https://github.com/eea/volto-matomo.git cd volto-matomo make make start ``` 转到 http://localhost:3:00 `make start` 现在默认为 Volto 18. 要运行同样的设置 对沃尔多17,使用: ``` VOLTO_VERSION=17 make VOLTO_VERSION=17 make start ``` ### 在您的 Volto 工程中添加 volto- matomo 1. 确保你有 [Plone 后端](https://plone.org/download) 在http://localhost:8080/Plone上运行 ```Bash docker compose up backend ``` 2. 启动 Volto 前端 - 如果你已经有伏尔托项目,只需更新 `package.json`数字 : ```JSON "dependencies": { "@eeacms/volto-matomo": "*" } ``` 财务报告和审定财务报表 `volto.config.js`数字 : ```JavaScript const addons = ['@eeacms/volto-matomo']; ``` - 如果没有,请按照Plone官方文件对Volto 18+的建议,用 Cookieplone 创建一个: ``` uvx cookieplone project cd project-title ``` 1. 安装或更新依赖关系,然后启动项目 : ``` make install ``` 对于 Cookieplone 项目, 在单独的终端中启动后端和前端 : ``` make backend-start make frontend-start ``` 对于一个遗留下来的Volto 17项目,安装软件包 `yarn` 并像往常一样重新启动前端. 2. 转到 http://localhost:3:00 3. 剪辑愉快! ## 释放 见 [发 言](https://github.com/eea/volto-matomo/blob/master/RELEASE.md)。 。 。 . ## 如何捐款 见 [发达国家d](https://github.com/eea/volto-matomo/blob/master/DEVELOP.md)。 。 。 . ## 版权和许可证 原始守则的初始所有人是欧洲环境署. 所有权利保留. 见 [利比里亚](https://github.com/eea/volto-matomo/blob/master/LICENSE.md) 详细情况. ## 供资 [欧洲环境署(欧盟)](http://eea.europa.eu/) ## 常见问题 ### @eeacms/volto-matomo 是什么？ 伏尔托-马托莫:伏尔托加成 ### 如何安装 @eeacms/volto-matomo？ 在项目目录运行 npm install @eeacms/volto-matomo，或使用 pnpm add / yarn add / bun add。 ### @eeacms/volto-matomo 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/eeacms\_\_volto-matomo 是否存在。 ### @eeacms/volto-matomo 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @eeacms/volto-matomo 可以商用吗？ @eeacms/volto-matomo 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @eeacms/volto-matomo 的下载量有多少？ 根据 npm 官方下载统计，@eeacms/volto-matomo 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,065 次，日均约 136 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @eeacms/volto-matomo 还在维护吗？ 最新版本 7\.0\.1 发布于 2026/04/09（7 个月前）；至今共发布 29 个版本，其中过去 12 个月发布了 2 个；首次发布于 2020/12/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。