▶ PPPTools Dokumentation
📚 Bibliothek
DE EN
Inhalt
Aktualisiert 2026-05-30

Library Admin Guide

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

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.

Drafts sichten (Einreichungen)

Wenn Nutzer Snippets über 💾 Speichern → Als Draft hochladen einreichen, erscheinen diese 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 / premium) ✅
Status (published / hidden) ✅
Code ❌ (neues Snippet einreichen)
Vorschaubild ❌ (neues Snippet einreichen)

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 Beschreibung
free Kostenlos, ohne Einschränkungen
premium (Phase 2) Reserviert für Premium-Inhalte

In der aktuellen Phase (Phase 1) sind alle Items free. Premium-Items werden in Phase 2 eingeführt.

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
    ├── preview.png
    └── slides/{guid}/...

Verwandte Seiten