▶ PPPTools Dokumentation
📚 Bibliothek
DE EN
Inhalt
Aktualisiert 2026-06-13

Library Admin Guide

Erstellt: 2026-05-30 · Aktualisiert: 2026-06-13

Der Library Admin Guide beschreibt die Verwaltung der öffentlichen PPPTools-Bibliothek. Dieses Dokument richtet sich an Administratoren mit Zugriff auf das Admin-Panel.

Nur für Administratoren

Das Admin-Panel ist nur mit gültigem API-Key zugänglich. Unbefugter Zugriff ist nicht möglich.

Admin-Panel

Das Admin-Panel ist unter folgender URL erreichbar:

https://ppptools.library.happy-pc.ch/admin

Der Zugang erfordert einen Admin API-Key, der beim Login eingegeben wird.

Entwürfe aus PowerPoint hochladen

Inhalte werden nicht von normalen Nutzern in die Online-Bibliothek hochgeladen — dieser Weg ist durch einen Upload-API-Key geschützt und damit nur Administratoren vorbehalten. (Der normale Freigabe-Workflow über den Netzwerkpfad ist davon unabhängig → Publish-Flow.)

1. Upload-API-Key eintragen

Den Key trägst du einmalig im Add-in ein:

Admin → Settings → Library Upload

  • Server URL — Adresse des Library-Servers (https://ppptools.library.happy-pc.ch)
  • API-Key — der Upload-Schlüssel (maskiert; mit „anzeigen" sichtbar machen)

Ohne gültigen Key ist die Upload-Option nicht verfügbar.

2. Inhalt als Entwurf hochladen

Sobald ein Key konfiguriert ist, erscheint im Verwalten-Bereich beim Speichern-Button ein Dropdown:

Verwalten → Speichern ▾ → In Online-Bibliothek hochladen

  • Verfügbar für Snippets, Slides und Storylines — einzeln und im Bulk (Sammel-Upload mit Ergebnisübersicht).
  • Vor dem Upload werden Pflichtfelder geprüft und Code-Snippets durch den Code-Scanner geleitet.
  • Der Inhalt wird als ZIP an den Server gesendet (POST /api/v1/drafts); der Server erkennt den Typ an der enthaltenen XML.
  • Anschliessend erscheint der Inhalt im Admin-Panel unter Drafts und durchläuft den normalen Freigabe-Prozess (siehe unten).

Hinweis

Der Inhalt muss vor dem Hochladen gespeichert sein. Bei ungültigem oder abgelaufenem Key meldet der Server „Ungültiger oder abgelaufener API-Key".

Drafts sichten (Einreichungen)

Hochgeladene Entwürfe (Snippets, Slides, Storylines und Actions) erscheinen im Admin-Panel unter dem Tab Drafts.

Draft-Liste

Spalte Beschreibung
Name Name des eingereichten Snippets
Kategorie Vom Einreicher angegebene Kategorie
Datum Datum der Einreichung
Status Pending / Approved / Rejected

Draft prüfen

  1. Draft in der Liste auswählen
  2. Vorschaubild und Metadaten prüfen
  3. Code ansehen — der Code-Scanner zeigt bereits beim Upload an, ob blockierte Muster vorhanden sind
  4. Entscheidung treffen: Freigeben oder Ablehnen

Draft freigeben

  1. Draft auswählen → Freigeben klicken
  2. Optional: Metadaten korrigieren (Name, Kategorie, Tags, Beschreibung)
  3. Bestätigen → Snippet erscheint sofort in der öffentlichen Galerie

Was passiert beim Freigeben?

  • Der Status wechselt von draft zu published
  • Das Snippet wird im Katalog-Cache invalidiert
  • Ab sofort für alle PPPTools-Nutzer im Online-Modus sichtbar

Draft ablehnen

  1. Draft auswählen → Ablehnen klicken
  2. Optional: Grund für die Ablehnung eingeben
  3. Der Einreicher erhält keine automatische Benachrichtigung (manuell kontaktieren)

Items bearbeiten

Bereits veröffentlichte Items können im Admin-Panel bearbeitet werden:

Feld Editierbar
Name ✅
Beschreibung ✅
Kategorie ✅
Tags ✅
Tier (Free / Standard / Pro) ✅
Status (published / hidden) ✅
Typ (Snippet ↔ Action …) ✅ (verschiebt Ordner + benennt XML um, ID bleibt)
Parameter-Beschreibung (nur Actions) ✅
Code ❌ (neues Snippet einreichen)
Vorschaubild ❌ (neues Snippet einreichen)

Typ wechseln

Über das Typ-Dropdown lässt sich der Objekttyp ändern — z. B. ein versehentlich als Snippet hochgeladenes Skript nachträglich zu einer Action machen. Der Server verschiebt den Item-Ordner in den Ziel-Typ-Ordner und benennt die XML um (snippet.xml ↔ action.xml); die ID bleibt erhalten.

Item-Status setzen

Status Bedeutung
published Öffentlich sichtbar in der Galerie
draft Eingereicht, noch nicht freigegeben
hidden Deaktiviert, nicht sichtbar in der Galerie

Tier setzen

Tier Anzeige Beschreibung
free 🟢 Free Kostenlos, ohne Einschränkungen
licensed 🔵 Standard Inhalte für lizenzierte Nutzer
premium 🟠 Pro Erweiterte Premium-Inhalte

In der aktuellen Phase (Phase 1) sind alle Items free. Die Stufen Standard und Pro werden mit dem Lizenzmodell aktiviert.

Cache invalidieren

Beim Freigeben eines Drafts wird der Cache automatisch invalidiert. Manuell:

POST https://ppptools.library.happy-pc.ch/api/v1/admin/invalidate-cache
Header: X-Admin-Key: <API-KEY>

Oder im Admin-Panel: Cache leeren klicken.

Library-Struktur auf dem Server

Alle Items liegen auf der Synology NAS:

/volume3/docker/ppptools_library/library/
├── snippets/{guid}/
│   ├── snippet.xml    — Metadaten
│   ├── code.cs        — Roslyn-Script
│   └── preview.png    — Vorschaubild
├── slides/{guid}/
│   ├── slide.xml
│   ├── slide.pptx
│   └── preview.png
└── storylines/{guid}/
    ├── storyline.xml
    ├── storyline.pptx   — self-contained (alle Folien zusammengeführt)
    ├── preview.png      — erste Folie
    └── slide_NN.png     — Vorschau je Folie

Verwandte Seiten