mirror of
https://github.com/nunocoracao/blowfish.git
synced 2025-01-22 22:45:42 -06:00
enableTrackEvent default true && documents
This commit is contained in:
parent
91d24e626e
commit
d52f721c41
11 changed files with 128 additions and 13 deletions
|
@ -135,11 +135,11 @@ disableTextInHeader = false
|
||||||
# websiteid = "ABC12345"
|
# websiteid = "ABC12345"
|
||||||
# domain = "llama.yoursite.com"
|
# domain = "llama.yoursite.com"
|
||||||
# dataDomains = "yoursite.com,yoursite2.com"
|
# dataDomains = "yoursite.com,yoursite2.com"
|
||||||
# enableTrackEvent = false
|
# enableTrackEvent = true
|
||||||
|
|
||||||
[selineAnalytics]
|
[selineAnalytics]
|
||||||
# token = "XXXXXX"
|
# token = "XXXXXX"
|
||||||
# enableTrackEvent = false
|
# enableTrackEvent = true
|
||||||
|
|
||||||
[buymeacoffee]
|
[buymeacoffee]
|
||||||
# identifier = ""
|
# identifier = ""
|
||||||
|
|
|
@ -323,6 +323,14 @@ Many of the article defaults here can be overridden on a per article basis by sp
|
||||||
| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
||||||
| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. |
|
| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. |
|
||||||
| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
|
| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
|
||||||
|
| `umamiAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. |
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
| Name | Default | Description |
|
||||||
|
|-----------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
| `selineAnalytics.token` | _Not set_ | The token generated by Seline Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
||||||
|
| `selineAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. |
|
||||||
|
|
||||||
### BuyMeACoffee
|
### BuyMeACoffee
|
||||||
|
|
||||||
|
|
|
@ -322,6 +322,14 @@ Many of the article defaults here can be overridden on a per article basis by sp
|
||||||
| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
||||||
| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. |
|
| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. |
|
||||||
| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
|
| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
|
||||||
|
| `umamiAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. |
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
| Name | Default | Description |
|
||||||
|
|-----------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
| `selineAnalytics.token` | _Not set_ | The token generated by Seline Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
||||||
|
| `selineAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. |
|
||||||
|
|
||||||
### BuyMeACoffee
|
### BuyMeACoffee
|
||||||
|
|
||||||
|
|
|
@ -318,12 +318,19 @@ Many of the article defaults here can be overridden on a per article basis by sp
|
||||||
|
|
||||||
### Umami Analytics
|
### Umami Analytics
|
||||||
|
|
||||||
| Name | Default | Description |
|
| Name | Default | Description |
|
||||||
| -------------------------- | --------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
| -------------------------- |-----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
| `umamiAnalytics.websiteid` | _Not set_ | The site code generated by Umami Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
||||||
| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. |
|
| `umamiAnalytics.domain` | _Not set_ | If using a custom domain with Umami Analytics, provide it here to serve `script.js` from the custom domain. |
|
||||||
| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
|
| `umamiAnalytics.dataDomains` | _Not set_ | If you want the tracker to only run on specific domains, provide it for your tracker script. This is a comma delimited list of domain names. Such as "yoursite.com,yoursite2.com". |
|
||||||
|
| `umamiAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. |
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
| Name | Default | Description |
|
||||||
|
|-----------------------------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------|
|
||||||
|
| `selineAnalytics.token` | _Not set_ | The token generated by Seline Analytics for the website. Refer to the [Analytics docs]({{< ref "partials#analytics" >}}) for more details. |
|
||||||
|
| `selineAnalytics.enableTrackEvent` | true | When set to `true` track event will add automatically. If you do not want to add track event, set it to `false`. |
|
||||||
|
|
||||||
### BuyMeACoffee
|
### BuyMeACoffee
|
||||||
|
|
||||||
|
|
|
@ -321,11 +321,19 @@ Blowfish 提供了大量控制主题功能的配置参数,下面的表格中
|
||||||
|
|
||||||
### Umami Analytics
|
### Umami Analytics
|
||||||
|
|
||||||
| Name | Default | Description |
|
| Name | Default | Description |
|
||||||
| -------------------------- | --------- |-------------------------------------------------------------------------------------|
|
|------------------------------|-----------|-------------------------------------------------------------------------------------|
|
||||||
| `umamiAnalytics.websiteid` | _Not set_ | 支持 Umami 站点分析平台。更多详细内容请参考 [分析文档]({{< ref "partials#analytics" >}})。 |
|
| `umamiAnalytics.websiteid` | 无 | 支持 Umami 站点分析平台。更多详细内容请参考 [分析文档]({{< ref "partials#analytics" >}})。 |
|
||||||
| `umamiAnalytics.domain` | _Not set_ | 如果使用自定义域名的 Umami Analytics,请在此提供,以便从自定义域名获取 `script.js`。 |
|
| `umamiAnalytics.domain` | 无 | 如果使用自定义域名的 Umami Analytics,请在此提供,以便从自定义域名获取 `script.js`。 |
|
||||||
| `umamiAnalytics.dataDomains` | _Not set_ | 如果你只想在特别的数个域名中使用 tracker 功能,那么你需要设置它。这个参数的值是逗号分隔的域名列表,如:yoursite.com,yoursite2.com。 |
|
| `umamiAnalytics.dataDomains` | 无 | 如果你只想在特别的数个域名中使用 tracker 功能,那么你需要设置它。这个参数的值是逗号分隔的域名列表,如:yoursite.com,yoursite2.com。 |
|
||||||
|
| `umamiAnalytics.enableTrackEvent` | true | 默认会自动添加 Umami Track Event。如果你不想添加 Event,那学需要设置为 `false`。 |
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
| Name | Default | Description |
|
||||||
|
|-----------------------------------|---------|--------------------------------------------------------------------------|
|
||||||
|
| `selineAnalytics.token` | 无 | Seline 站点分析平台的 token。更多详细内容请参考 [分析文档]({{< ref "partials#analytics" >}})。 |
|
||||||
|
| `selineAnalytics.enableTrackEvent` | true | 默认会自动添加 Umami Track Event。如果你不想添加 Event,那学需要设置为 `false`。 |
|
||||||
|
|
||||||
|
|
||||||
### BuyMeACoffee
|
### BuyMeACoffee
|
||||||
|
|
|
@ -46,6 +46,10 @@ To enable Umami Analytics support, simply provide your [Umami tracking code](htt
|
||||||
If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is).
|
If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is).
|
||||||
If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and` websiteid` match.
|
If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and` websiteid` match.
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** If you enable Umami Analytics, Blowfish will support [Umami Track Event](https://umami.is/docs/track-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`.
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
# config/_default/params.toml
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
@ -53,8 +57,24 @@ If you want the tracker to only run on specific domains, you can provide the `da
|
||||||
websiteid = "ABC12345"
|
websiteid = "ABC12345"
|
||||||
domain = "llama.yoursite.com"
|
domain = "llama.yoursite.com"
|
||||||
dataDomains = "yoursite.com,yoursite2.com"
|
dataDomains = "yoursite.com,yoursite2.com"
|
||||||
|
enableTrackEvent = true
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
To enable Seline Analytics support, simply provide your [Seline token](https://seline.so/docs/install-seline) in the `config/_default/params.toml` file.
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** If you enable Seline Analytics, Blowfish will support [Seline Track Event](https://seline.so/docs/custom-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`.
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
[selineAnalytics]
|
||||||
|
token = "XXXXXX"
|
||||||
|
enableTrackEvent = true
|
||||||
|
```
|
||||||
### Custom analytics providers
|
### Custom analytics providers
|
||||||
|
|
||||||
If you wish to use a different analytics provider on your website you can also override the analytics partial and provide your own script. Simply create the file `layouts/partials/extend-head.html` in your project and it will automatically include it in the `<head>` of the website.
|
If you wish to use a different analytics provider on your website you can also override the analytics partial and provide your own script. Simply create the file `layouts/partials/extend-head.html` in your project and it will automatically include it in the `<head>` of the website.
|
||||||
|
|
|
@ -46,6 +46,10 @@ To enable Umami Analytics support, simply provide your [Umami tracking code](htt
|
||||||
If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is).
|
If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is).
|
||||||
If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and` websiteid` match.
|
If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and` websiteid` match.
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** If you enable Umami Analytics, Blowfish will support [Umami Track Event](https://umami.is/docs/track-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`.
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
# config/_default/params.toml
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
@ -53,6 +57,22 @@ If you want the tracker to only run on specific domains, you can provide the `da
|
||||||
websiteid = "ABC12345"
|
websiteid = "ABC12345"
|
||||||
domain = "llama.yoursite.com"
|
domain = "llama.yoursite.com"
|
||||||
dataDomains = "yoursite.com,yoursite2.com"
|
dataDomains = "yoursite.com,yoursite2.com"
|
||||||
|
enableTrackEvent = true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
To enable Seline Analytics support, simply provide your [Seline token](https://seline.so/docs/install-seline) in the `config/_default/params.toml` file.
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** If you enable Seline Analytics, Blowfish will support [Seline Track Event](https://seline.so/docs/custom-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`.
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
[selineAnalytics]
|
||||||
|
token = "XXXXXX"
|
||||||
|
enableTrackEvent = true
|
||||||
```
|
```
|
||||||
|
|
||||||
### Custom analytics providers
|
### Custom analytics providers
|
||||||
|
|
|
@ -45,6 +45,11 @@ googleAnalytics = "G-MEASUREMENT_ID"
|
||||||
To enable Umami Analytics support, simply provide your [Umami tracking code](https://umami.is/docs/collect-data) in the `config/_default/params.toml` file.
|
To enable Umami Analytics support, simply provide your [Umami tracking code](https://umami.is/docs/collect-data) in the `config/_default/params.toml` file.
|
||||||
If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is).
|
If you also use the custom domain feature of Umami and would like to serve their script from your domain, you can also additionally provide the `domain` configuration value. If you don't provide a `domain` value, the script will load directly from Umami DNS (analytics.umami.is).
|
||||||
If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and` websiteid` match.
|
If you want the tracker to only run on specific domains, you can provide the `dataDomains` configuration value. If you don't provide a `dataDomains` value, the script will run on any website where the `domain` and` websiteid` match.
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** If you enable Umami Analytics, Blowfish will support [Umami Track Event](https://umami.is/docs/track-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`.
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
# config/_default/params.toml
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
@ -52,6 +57,23 @@ If you want the tracker to only run on specific domains, you can provide the `da
|
||||||
websiteid = "ABC12345"
|
websiteid = "ABC12345"
|
||||||
domain = "llama.yoursite.com"
|
domain = "llama.yoursite.com"
|
||||||
dataDomains = "yoursite.com,yoursite2.com"
|
dataDomains = "yoursite.com,yoursite2.com"
|
||||||
|
enableTrackEvent = true
|
||||||
|
```
|
||||||
|
|
||||||
|
### Seline Analytics
|
||||||
|
|
||||||
|
To enable Seline Analytics support, simply provide your [Seline token](https://seline.so/docs/install-seline) in the `config/_default/params.toml` file.
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** If you enable Seline Analytics, Blowfish will support [Seline Track Event](https://seline.so/docs/custom-events) automatically. If you do not want to support Track Event, the param `enableTrackEvent` must set to `false`.
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
[selineAnalytics]
|
||||||
|
token = "XXXXXX"
|
||||||
|
enableTrackEvent = true
|
||||||
```
|
```
|
||||||
|
|
||||||
### Custom analytics providers
|
### Custom analytics providers
|
||||||
|
|
|
@ -50,6 +50,11 @@ googleAnalytics = "G-MEASUREMENT_ID"
|
||||||
如果你想使用自定义域名来获取跟踪脚本, 那么需要提供 `domain` 参数,否则会从 Umami 云服务版的地址 (analytics.umami.is) 获取脚本。
|
如果你想使用自定义域名来获取跟踪脚本, 那么需要提供 `domain` 参数,否则会从 Umami 云服务版的地址 (analytics.umami.is) 获取脚本。
|
||||||
如果你只想在特别的数个域名中使用 tracker 功能,那么需要提供 `dataDomains` 参数。否则任何一个匹配了 `websiteid` 和 `domain` 参数值的网站,Umami 脚本都会执行。
|
如果你只想在特别的数个域名中使用 tracker 功能,那么需要提供 `dataDomains` 参数。否则任何一个匹配了 `websiteid` 和 `domain` 参数值的网站,Umami 脚本都会执行。
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** 开启 Umami 网站分析后, Blowfish 会自动支持 [Umami 事件追踪](https://umami.is/docs/track-events)。如果你不想支持此功能,需要把参数 `enableTrackEvent` 设置为 `false`。
|
||||||
|
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
# config/_default/params.toml
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
@ -59,6 +64,23 @@ googleAnalytics = "G-MEASUREMENT_ID"
|
||||||
dataDomains = "yoursite.com,yoursite2.com"
|
dataDomains = "yoursite.com,yoursite2.com"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Seline
|
||||||
|
|
||||||
|
只需要在 `config/_default/params.toml` 文件提供你的 [Seline token](https://seline.so/docs/install-seline),就可以快速支持 Seline 站点分析。
|
||||||
|
|
||||||
|
{{< alert >}}
|
||||||
|
**Note:** 开启 Seline 网站分析后, Blowfish 会自动支持 [Seline 事件追踪](https://seline.so/docs/custom-events)。如果你不想支持此功能,需要把参数 `enableTrackEvent` 设置为 `false`。
|
||||||
|
{{< /alert >}}
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# config/_default/params.toml
|
||||||
|
|
||||||
|
[selineAnalytics]
|
||||||
|
token = "XXXXXX"
|
||||||
|
enableTrackEvent = true
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 提供自定义站点分析
|
### 提供自定义站点分析
|
||||||
|
|
||||||
如果你想在你的网站提供其他站点分析,你可以自己提供脚本,并覆盖 Blowfish 主题中内置的 partial。
|
如果你想在你的网站提供其他站点分析,你可以自己提供脚本,并覆盖 Blowfish 主题中内置的 partial。
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
<script async src="https://cdn.seline.so/seline.js" data-token="{{ site.Params.selineAnalytics.token }}" data-id="seline-script"></script>
|
<script async src="https://cdn.seline.so/seline.js" data-token="{{ site.Params.selineAnalytics.token }}" data-id="seline-script"></script>
|
||||||
|
|
||||||
{{ if .Site.Params.selineAnalytics.enableTrackEvent | default false }}
|
{{ if .Site.Params.selineAnalytics.enableTrackEvent | default true }}
|
||||||
<script type="text/javascript">
|
<script type="text/javascript">
|
||||||
document.querySelector('script[data-id="seline-script"]')
|
document.querySelector('script[data-id="seline-script"]')
|
||||||
.addEventListener('load', function () {
|
.addEventListener('load', function () {
|
||||||
|
|
|
@ -10,7 +10,7 @@
|
||||||
</script>
|
</script>
|
||||||
{{ end }}
|
{{ end }}
|
||||||
|
|
||||||
{{ if .Site.Params.umamiAnalytics.enableTrackEvent | default false }}
|
{{ if .Site.Params.umamiAnalytics.enableTrackEvent | default true }}
|
||||||
<script type="text/javascript">
|
<script type="text/javascript">
|
||||||
document.querySelector('script[data-id="umami-script"]')
|
document.querySelector('script[data-id="umami-script"]')
|
||||||
.addEventListener('load', function () {
|
.addEventListener('load', function () {
|
||||||
|
|
Loading…
Reference in a new issue