diff --git a/apps/docs/docs/reference/configuration.mdx b/apps/docs/docs/reference/configuration.mdx index b94b2b7..db26403 100644 --- a/apps/docs/docs/reference/configuration.mdx +++ b/apps/docs/docs/reference/configuration.mdx @@ -20,7 +20,7 @@ Each Umbraco application instance keeps its own in-memory report cache. Restart Bootstrap connections this way when deployment automation has to create them. Keep access tokens out of this file. -```json +```json appsettings.json { "WebAnalytics": { "Enabled": true, @@ -49,6 +49,8 @@ For Plausible, use `"Provider": "Plausible"` and set `SiteId` instead of `Projec ## Package settings +All keys live under the `WebAnalytics` configuration section. + | Key | Default | Description | | --- | --- | --- | | `Enabled` | `true` | Enables the Analytics section and configured document workspace views. | @@ -56,10 +58,19 @@ For Plausible, use `"Provider": "Plausible"` and set `SiteId` instead of `Projec | `DefaultRangeDays` | `30` | Initial reporting range, in days. Valid values are 1 to 730. | | `CacheDuration` | `00:05:00` | Per-instance in-memory cache duration. Valid from zero to one hour. | | `Connections` | `[]` | Provider connection definitions. The first becomes the initial default. | -| `ConnectionAccessTokens` | Empty | Optional connection-specific credential overrides, keyed by connection GUID. An override takes precedence over the shared provider credential. Set one with `WebAnalytics__ConnectionAccessTokens__{connection-guid}`. | -| `Providers:Vercel:AccessToken` | Empty | Shared Vercel access token. | -| `Providers:Plausible:AccessToken` | Empty | Shared Plausible Stats API key. | -| `Providers:Plausible:BaseUrl` | `https://plausible.io/` | Public base URL of the Plausible Cloud or self-hosted instance. It must expose `/api/v2/query`. | +| `ConnectionAccessTokens` | Empty | Optional connection-specific credential overrides, keyed by connection GUID. An override takes precedence over the shared provider credential. | + +Set a connection override with `WebAnalytics__ConnectionAccessTokens__{connection-guid}`. + +### Provider settings + +These keys live under `WebAnalytics:Providers`. + +| Key | Default | Description | +| --- | --- | --- | +| `Vercel:AccessToken` | Empty | Shared Vercel access token. | +| `Plausible:AccessToken` | Empty | Shared Plausible Stats API key. | +| `Plausible:BaseUrl` | `https://plausible.io/` | Public base URL of the Plausible Cloud or self-hosted instance. It must expose `/api/v2/query`. | ## Connection settings diff --git a/apps/docs/theme.css b/apps/docs/theme.css new file mode 100644 index 0000000..af3e928 --- /dev/null +++ b/apps/docs/theme.css @@ -0,0 +1,4 @@ +/* The docs family's prose column, a little wider than Blume's 42rem so pages sit better on wide screens. */ +:root { + --blume-content-width: 48rem; +}