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.
49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# Logs Plugin
|
|
|
|
Toont admin activiteitlogs en front-end request logs met filter tabs op een admin-pagina.
|
|
|
|
## Plugin type
|
|
|
|
**Systeem** plugin. De plugin-output volgt de geselecteerde **admin taal** (via `AdminPluginAPI::getPluginTranslations()` met `admin.php`).
|
|
|
|
## Bestandsstructuur
|
|
|
|
```
|
|
Logs/
|
|
├── Logs.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
|
|
|
|
- **Admin tab**: Toont admin activiteitlogs (uit `admin/storage/logs/admin.log`)
|
|
- **Requests tab**: Toont front-end request logs (uit `admin/storage/logs/requests.log`)
|
|
- Tabbladen kunnen via de instellingen in/uitgeschakeld worden
|
|
- Aantal getoonde regels is instelbaar (meest recente eerst)
|
|
|
|
## 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 |
|
|
| `max_lines` | number | `100` | Aantal logregels dat getoond wordt (meest recente eerst) |
|
|
| `show_admin_tab` | checkbox | `true` | Schakel de admin activiteit-log tab in of uit |
|
|
| `show_requests_tab` | checkbox | `true` | Schakel de front-end request-log tab 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('Logs')` 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()`. |