# Beheeromgeving

Het dashboard, resourceschermen, instellingen, geschiedenis, jobs en rollen.

De admin op `/nb-admin/` hoort bij elke Nimbly-site. Hij wordt gemaakt uit de resourcedefinities, dus een nieuwe resource heeft zijn schermen zodra de `.meta` bestaat. Wat een gebruiker ziet, volgt uit zijn rol.

## Dashboard

Het dashboard toont wat aandacht nodig heeft en wat de site bevat:

- **Needs attention**: mislukte jobs, een recente fatale fout, weinig schijfruimte, of assets die na een core-update opnieuw gebouwd moeten worden.
- **Site status**: wanneer de data voor het laatst veranderde, of core en de applicatie bijgewerkt zijn, met een update-actie voor rollen die mogen bijwerken, en het geheugen en de schijf van de server.
- **Visits**: bezoeken, paginaweergaven en botverkeer over de afgelopen 30 dagen, voor rollen met `view-stats`.
- **Your data**: elke resource die de gebruiker mag zien, met het aantal records, de grootte en de laatste wijziging, en een link naar de geschiedenis.
- **Manage**: gebruikers en rollen, de mediabibliotheek, en de jobwachtrij met de onderhoudsacties.

Een applicatie voegt een eigen paneel toe met een `dashboard-band.tpl` in `ext/tpl/` of in de `tpl/` van een module.

## Resourceschermen

| Adres | Scherm |
|---|---|
| `/nb-admin/<resource>` | Overzicht met de kolommen, zoeken, filters en pagina's die de `.meta` bepaalt |
| `/nb-admin/<resource>/add` | Formulier om een record toe te voegen, met documentimport waar ingesteld |
| `/nb-admin/<resource>/<uuid>` | Formulier om een record te bewerken, met het actiepaneel |
| `/nb-admin/<resource>/<uuid>/history` | Elke wijziging van het record, met terugzetten |
| `/nb-admin/<resource>/history` | De laatste wijzigingen van de hele resource, inclusief verwijderde records |

Het actiepaneel naast een record bevat de laatste wijzigingen en de acties van het record. Een resource voegt eigen acties toe, zoals een voorbeeldlink, met `record_actions` in de `.meta`; `actions.url` voegt een link toe naar het record op de site.

Met een wisselaar spring je naar het volgende record zonder terug te gaan naar het overzicht.

## Geschiedenis

Elk aanmaken, wijzigen en verwijderen door een ingelogde gebruiker, een API-gebruiker of een agent wordt bewaard, met wie het deed, wanneer en welke velden veranderden. **Restore** zet een record terug zoals het vóór een wijziging was, en een verwijderd record kun je terugzetten vanuit de geschiedenis van de resource. Geschiedenis wordt 90 dagen bewaard. Paginateksten die ter plekke zijn bewerkt, pagina-instellingen en menu's hebben ook een geschiedenis.

## Instellingen

`/nb-admin/settings` bewerkt de naam en beschrijving van de site, de talen, de tekstrichting en de kant van de Nimbly-balk. Naam, beschrijving en richting stel je per taal in. Gebruikers met `manage-system` zetten hier ook eigen pagina's en het bewerken van de navigatie aan of uit.

De instellingen van één pagina, zoals de titel, bewerk je vanaf de pagina zelf, via de pagina-acties.

## Gebruikers en rollen

`/nb-admin/users` en `/nb-admin/roles` beheren accounts en rechten. Het rollenscherm toont een rij per resource met een vinkje per handeling en een kolom om alles op die resource te beheren. Zie [Gebruikers en rechten](/nl/docs/guides/permissions/). Het actiepaneel van een gebruiker bevat de schakelaar **API access**, die bepaalt of die gebruiker API-tokens mag aanvragen.

## Mediabibliotheek

`/nb-admin/media` toont elke upload, laat zien waar die wordt gebruikt, en verwijdert bestanden die niet meer nodig zijn. Zie [Media en inline bewerken](/nl/docs/guides/media/).

## Jobs

`/nb-admin/jobs` toont de wachtrij: jobs in de wachtrij, lopende, afgeronde en mislukte jobs met hun laatste fout, en draait op verzoek jobs die aan de beurt zijn of ruimt oude op. Zie [Werk op de achtergrond](/nl/docs/guides/jobs/).

## Een adminscherm vervangen

De admin is een module in core, en de routes en templates ervan worden, zoals al het andere, eerst in `ext/` gezocht. Een project vervangt één scherm door een route of template met hetzelfde pad in `ext/` te zetten, en laat de rest aan core over.