E.Noorlander
6d5ca7cab4
Plugin internationalisatie: plugins hebben eigen language/ mappen. Systeem plugins volgen admin taal (admin.php), content plugins volgen content taal (site.php). Fallback chain: geselecteerd -> plugin default_language -> CMS default. PluginManager/AdminPluginAPI/CMSAPI uitgebreid met getPluginTranslations()/t(). plugin.json settings ondersteunen label_key/help_key/option_label_key. Plugin uniformiteit: alle 6 plugins hebben uniforme structuur (README.md, assets/.gitkeep, language/nl|en/). plugins/README.md herschreven. guide plugin-development.md (NL+EN) volledig herschreven. Plugin editor vernieuwd: geneste bestandsbrowser zijbalk, nieuw bestand aanmaken, uploaden naar assets/, verwijderen en verplaatsen. Nieuwe routes: plugins-file-upload, plugins-file-delete, plugins-file-move. Path-traversal bescherming + protected plugins geblokkeerd. Media invoegen in editor: nieuw /admin/media-list JSON endpoint + herbruikbare _media-modal.twig include. Plugin-context scant assets/ map. editor-toolbar.js modeMap uitgebreid voor css/scss/js/json. Plugin overzicht knoppen: alleen iconen met title/aria-label. Tests: pentest 30/30, WCAG 2.1 AA 25/25.
51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
# Statistics Plugin
|
|
|
|
Toont bezoekersstatistieken: totaal aantal views, unieke bezoekers, landen en top pagina's op een admin-pagina.
|
|
|
|
## Plugin type
|
|
|
|
**Systeem** plugin. De plugin-output volgt de geselecteerde **admin taal** (via `AdminPluginAPI::getPluginTranslations()` met `admin.php`).
|
|
|
|
## Bestandsstructuur
|
|
|
|
```
|
|
Statistics/
|
|
├── Statistics.php # Hoofd plugin class
|
|
├── plugin.json # Plugin metadata + instellingen
|
|
├── README.md # Dit bestand
|
|
├── assets/ # Optionele CSS/JS (leeg)
|
|
└── language/ # Vertalingen
|
|
├── nl/admin.php # Nederlandse admin labels
|
|
└── en/admin.php # Engelse admin labels
|
|
```
|
|
|
|
## Functies
|
|
|
|
- **Totaal aantal views**: Totaal aantal paginaweergaven
|
|
- **Unieke bezoekers**: Aantal unieke bezoekers
|
|
- **Pagina views**: Totaal aantal pagina views
|
|
- **Landen**: Overzicht van bezoekers per land (met vlag-emoji)
|
|
- **Top pagina's**: Meest bezochte pagina's
|
|
|
|
Statistieken worden alleen getoond als Analytics is ingeschakeld in de site configuratie; anders wordt een waarschuwing getoond.
|
|
|
|
## Instellingen
|
|
|
|
Deze plugin heeft instelbare configuratie (`hasConfig: true`). Instellingen worden gedefinieerd in `plugin.json` onder `settings` en overschreven via `config.json`.
|
|
|
|
| Sleutel | Type | Standaard | Beschrijving |
|
|
|---------|------|-----------|--------------|
|
|
| `required_roles` | multi-select | `bi-manager, site-admin, admin` | Rollen die deze plugin mogen zien |
|
|
| `show_countries` | checkbox | `true` | Schakel het landen-overzicht in of uit |
|
|
| `show_top_pages` | checkbox | `true` | Schakel het top pagina's overzicht in of uit |
|
|
|
|
De label- en help-teksten voor instellingen worden vertaald via `label_key`/`help_key` (verwijst naar sleutels in `language/<lang>/admin.php`).
|
|
|
|
## Taal support
|
|
|
|
De plugin gebruikt `AdminPluginAPI::getPluginTranslations('Statistics')` om labels op te halen. Fallback chain:
|
|
1. Geselecteerde admin taal
|
|
2. Plugin `default_language` (`nl`)
|
|
3. Lege array (sleutel wordt ongewijzigd getoond)
|
|
|
|
Beschikbare sleutels staan in `language/<lang>/admin.php`. Het admin-menu label wordt vertaald via `label_key: 'menu_label'` in `getAdminMenu()`. |