ngx-matomo 客户端安装与使用指南

ngx-matomo 客户端安装与使用指南

ngx-matomoMatomo (aka. Piwik) web analytics for Angular applications项目地址:https://gitcode.com/gh_mirrors/ng/ngx-matomo

1. 项目目录结构及介绍

请注意，所提及的项目地址实际上指向的是 EmmanuelRoux/ngx-matomo-client，而非原问题中提供的 arnaud73/ngx-matomo.git（该链接可能有误或不存在）。基于现有信息，以下结构基于 EmmanuelRoux/ngx-matomo-client 的一般Angular库结构来说明：

• src: 核心源代码所在目录。
  • lib: 包含所有核心功能模块，如跟踪页面视图、事件等的核心逻辑。
  • core: 可能含有不依赖于路由器的核心服务和组件。
  • router: 如存在，将包含与Angular路由器集成的功能。
• projects: 这个目录在Angular workspace模式下常见，用于存放可发布的npm包。
• package.json: 描述了项目的依赖和脚本命令。
• README.md: 项目的快速入门和基本指导文档。

2. 项目的启动文件介绍

在 ngx-matomo-client 这类作为库的项目中，并没有直接的“启动文件”用于运行一个独立应用。然而，开发时，主要关注点是其构建和测试流程，这通常通过npm scripts或者Angular CLI命令管理。例如，贡献者可能会使用npm start或ng serve（如果工作空间支持）来进行本地开发服务器的搭建，以测试库的功能。

对于使用者来说，启动过程涉及将其集成到自己的Angular应用中。通常，集成始于执行ng add ngx-matomo-client命令，该命令自动处理安装与基本配置。

3. 项目的配置文件介绍

配置主要发生在应用程序集成阶段而不是库本身。当使用ng add ngx-matomo-client命令时，会要求提供Matomo服务器地址和站点ID。这些配置项通常被注入到你的Angular应用中。

手动配置时，需在应用的根模块（通常是AppModule）导入并配置provideMatomo()函数，示例代码如下：

import { provideMatomo } from 'ngx-matomo-client';

await bootstrapApplication(AppRootComponent, {
  providers: [
    provideMatomo({
      siteId: 1, // 替换为你的站点ID
      trackerUrl: 'http://your-matomo-instance-url', // 替换成你的Matomo实例URL
    }),
  ],
});

如果使用@NgModule方式，可以使用MatomoModule.forRoot()进行配置，类似于：

import { MatomoModule } from 'ngx-matomo-client';

@NgModule({
  imports: [
    MatomoModule.forRoot({
      siteId: 1,
      trackerUrl: 'http://your-matomo-instance-url',
    }),
  ],
})
export class AppModule {}

记住，具体的配置选项和细节可能随库版本更新而变化，因此始终查阅最新版的README.md或官方文档来获取详细配置说明。

ngx-matomoMatomo (aka. Piwik) web analytics for Angular applications项目地址:https://gitcode.com/gh_mirrors/ng/ngx-matomo