Admin Page

Für Backend-Benutzer können eigenständige Seiten innerhalb der Verwaltung zur Verfügung gestellt werden. Das entspricht den bisherigen "Plugin-Seiten" auf Projektebene, die allerdings direkt im Backend als normale Menüpunkte angelegt wurden.
Admin Pages stehen in allen Projekten zur Verfügung und beziehen ihren Inhalt aus der ZIP-Datei des Plugins, siehe zu dieser Funktionsweise auch die Static Content Extension.
fun registerAdminPage(info: AdminPageInfo)
AdminPageInfo besteht aus 
id, 
title, 
staticPath, 
handler und 
guard. 
id ist eine frei wählbare ID, die über alle Admin Pages eines Plugins hinweg eindeutig sein muss. Es ist kein Problem, wenn mehrere Plugins eine Admin Page mit derselben ID bereitstellen, da zum Ansprechen einer Admin Page auch die 
id des Plugins herangezogen wird.
title ist der Titel, wie er im Verwaltungsmenü auftaucht. 
staticPath ist der Unterordner im 
static Ordner des Plugin-ZIPs, aus dem die Dateien ausgeliefert werden.
Der optionale Wert 
handler ist ein 
RequestHandler, der aufgerufen wird, falls eine Datei angefordert wird, die nicht existiert. Hiermit können die Actions der bisherigen Plugin-Seiten nachgebildet werden.
Der optionale Wert 
guard ist ein 
StaticContentHandler.Guard, wie er auch bei Static Content verwendet wird. Falls definiert, wird die 
intercept Methode von 
guard in folgenden Fällen mit diesen Werten aufgerufen:
resource="" - um zu prüfen, ob die Admin Page dem Backend-Benutzer in der Navigation angezeigt werden soll oder nicht. Wird 
true zurückgegeben, taucht die Admin Page in der Navigation nicht auf.
resource="index.html", 
resource="assets/style.css", 
resource="dynamic/do-something-action" - um zu prüfen, ob der Request auf diese Ressource erlaubt werden soll oder nicht. Wird 
true zurückgegeben, erfolgt die Auslieferung der Ressource nicht, ebenfalls wird weder 
handler aufgerufen noch eine eigene Fehlermeldung generiert.
Beispiel​
In der Pluginhauptklasse wird die Admin Page registriert. In der Plugin-ZIP müssen die Dateien dementsprechend im Ordner static/import-ma/ liegen.
override fun load() {
  registerAdminPage(
    AdminPageInfo(
      "import-mitarbeiter", // id
      "Mitarbeiterimport", // title
      "import-ma", // staticPath
      null, // handler
      null // guard
    )
  )
}
Im Backend stellt sich die Admin Page im Menü wie folgt dar.