---
url: https://docs.ogmabox.com/nl/app/plugins.md
description: >-
  Installeer, beheer, update en ontwikkel Ogma-plugins vanuit lokale pakketten,
  mappen, ziparchieven en de marktplaats.
---

# Plug-ins {#plugins}

Plugins breiden Ogma uit met aangepaste interfacepagina’s, backendverwerking, eventhooks en instellingenpanelen, allemaal binnen de gedeclareerde machtigingen van de plugin.

## Wat plugins kunnen toevoegen {#what-plugins-can-add}

* Aangepaste interfacepagina’s die toegankelijk zijn via de linkernavigatie.
* Backendroutes die verzoeken of antwoorden verwerken.
* Eventhooks die door vastgelegd verkeer worden geactiveerd.
* Instellingenpagina’s voor pluginspecifieke configuratie.
* Opdrachten die in het opdrachtenpalet kunnen worden geregistreerd.

## Installeren vanuit een map {#install-from-folder}

1. Klik op **Installeren** in de pluginweergave.
2. Kies **Mappad**.
3. Selecteer de hoofdmap van de plugin. De map moet een geldig pluginmanifest en de daarin gedeclareerde bestanden bevatten.
4. Ogma valideert het pakket en registreert het.
5. Schakel de plugin in om deze te activeren.

## Installeren vanuit een ziparchief {#install-from-zip-archive}

1. Klik op **Installeren** in de pluginweergave.
2. Kies **ZIP-bestand**.
3. Selecteer het `.zip`-bestand van de plugin.
4. Controleer de herkende pluginnaam en -versie.
5. Klik op **Installeren uit ZIP** en schakel de plugin vervolgens in.

Zipinstallaties worden naar de beheerde pluginmap van Ogma gekopieerd. Het oorspronkelijke archief kan na installatie worden verwijderd.

## Compatibiliteitswaarschuwingen {#compatibility-warnings}

Na installatie kan Ogma waarschuwingen op de detailpagina van de plugin tonen. Deze zijn informatief en verhinderen de uitvoering van de plugin niet.

Veelvoorkomende waarschuwingen:

* **Bestanden zonder verwijzing** - bestanden in het pakket die niet in het manifest zijn gedeclareerd.
* **Ontbrekende runtimeshim** - de plugin gebruikt een API die een compatibiliteitsshim vereist die niet in deze Ogma-versie aanwezig is.

Controleer waarschuwingen voordat je een onbekende plugin inschakelt.

## In- en uitschakelen {#enable-and-disable}

Gebruik de schakelaar **Ingeschakeld** in de pluginrij om de plugin te activeren of deactiveren. Uitgeschakelde plugins blijven geïnstalleerd, maar draaien niet. Opnieuw inschakelen herstelt de plugin zonder herinstallatie.

## Tabbladen met plugindetails {#plugin-detail-tabs}

Selecteer een plugin om het detailpaneel te openen. Het paneel heeft de volgende tabbladen.

| Tabblad | Inhoud |
|-----|----------|
| Overzicht | Pluginnaam, versie, auteur, beschrijving en bron. |
| Waarschuwingen | Compatibiliteitsproblemen die bij installatie of inschakeling zijn ontdekt. |
| Rechten | Wat de plugin heeft aangevraagd en wat Ogma tijdens uitvoering heeft toegekend. |
| Bestanden | De lijst met bestanden in het pluginpakket. |
| Logboeken | Uitvoer van de plugin tijdens uitvoering, met syntaxisaccentuering voor gestructureerde logregels. |
| Interface | De aangepaste pagina van de plugin, rechtstreeks weergegeven. |

## Machtigingen {#permissions}

Het tabblad **Rechten** toont elke machtiging die de plugin in het manifest heeft gedeclareerd en de huidige toekenningsstatus. Machtigingen voor backendaanroepen worden aan de serverzijde afgedwongen. De interface toont de actuele status van elke machtiging.

Als een plugin niet werkt zoals verwacht, controleer dan op het tabblad **Rechten** of de vereiste machtigingen zijn toegekend.

## Ontwikkelmodus {#dev-mode}

Plugins die vanuit een map zijn geïnstalleerd, tonen een badge **Ontwikkeling** en een knop **Opnieuw laden**.

Klik op **Opnieuw laden** om codewijzigingen toe te passen zonder herinstallatie. De plugin wordt opnieuw gestart en registreert alle hooks en routes opnieuw. Dit is de gebruikelijke ontwikkelcyclus voor pluginauteurs.

Plugins in ontwikkelmodus blijven aan de bronmap gekoppeld. Bestandswijzigingen in die map worden bij de volgende herlading van kracht.

## Marktplaats {#marketplace}

Het tabblad **Marktplaats** toont communityplugins uit het Awesome Ogma Plugins-register.

1. Blader door de pluginlijst of doorzoek deze.
2. Klik op een plugin om de beschrijving, versie en compatibiliteitsmetadata te bekijken.
3. Klik op **Installeren** om deze rechtstreeks te installeren.
4. Als voor een geïnstalleerde marktplaatsplugin een nieuwere compatibele versie beschikbaar is, verandert de actie in **Bijwerken**.

Marktplaatsinstallaties vereisen een netwerkverbinding om het pakket op te halen.

## Gerelateerde pagina’s {#related-pages}

* [Snelstart voor plugins](/nl/plugins/quickstart)
* [Backend-SDK](/nl/plugins/backend-sdk)
* [Frontend-SDK](/nl/plugins/frontend-sdk)