# Strapi Plugin for Pirsch

A Strapi v5 plugin that provides an embedded Pirsch analytics dashboard within the Strapi admin interface.

<img src="screenshots/dashboard.png" alt="Strapi Pirsch Dashboard" style="margin: 1rem; width: calc(100% - 2rem); max-width: 800px">

## Installation

```bash
npm install @fresh.codes/strapi-plugin-pirsch
```

## Configuration

### Configure Dashboard URL

1. Navigate to **Settings** → **Pirsch Analytics** in your Strapi admin
2. Enter your [Pirsch Access Link](https://docs.pirsch.io/advanced/access#public-access) (e.g., `https://your-dashboard.pirsch.io`)
3. Click **Save Settings**

Note: There are [additional query params](https://docs.pirsch.io/advanced/embedding#ui-options) you can add to your access link (like `&ui=hide`).

### Content Security Policy (Optional)

If you have the `strapi::security` middleware enabled, update your `config/middlewares.ts`:

```typescript
export default [
  {
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        directives: {
          'frame-src': ["'self'", 'https://*.pirsch.io'],
        },
      },
    },
  },
]
```

If you're using a custom domain like `stats.example.com` then you'll need to tweak the CSP policy a bit more to allow for the pirsch api calls to work:

```typescript
export default [
  {
    name: 'strapi::security',
    config: {
      contentSecurityPolicy: {
        directives: {
          'frame-src': ["'self'", 'https://stats.example.com'],
          'connect-src': ["'self'", 'https://api.pirsch.io'],
        },
      },
    },
  },
]
```

## Permissions

The plugin registers two permissions that can be managed in **Settings → Roles & Permissions**:

- **Access the Pirsch Analytics Dashboard**: Controls who can view the main analytics dashboard
- **Update Pirsch Analytics Settings**: Controls who can configure the dashboard URL

By default, only Super Admins have access. You can grant permissions to other roles as needed.

## License

[MIT License](LICENSE)

Made by [Fresh Codes](https://fresh.codes).

Don't have Pirsch yet? [Sign up here](https://pirsch.io/ref/5kgY5GGg4m) (affiliate link).