▶ PPPTools Dokumentation
📚 Bibliothek
DE EN
Contents

Library Admin Guide

Created: 2026-05-30 · Updated: 2026-05-30

The Library Admin Guide describes how to manage the public PPPTools library. This document is intended for administrators with access to the admin panel.

Administrators only

The admin panel is only accessible with a valid API key. Unauthorized access is not possible.

Admin Panel

The admin panel is available at:

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

Access requires an Admin API key, which is entered at login.

Reviewing Drafts (Submissions)

When users submit snippets via 💾 Save → Upload as Draft, they appear in the admin panel under the Drafts tab.

Draft List

Column Description
Name Name of the submitted snippet
Category Category specified by the submitter
Date Submission date
Status Pending / Approved / Rejected

Reviewing a Draft

  1. Select a draft from the list
  2. Check the preview image and metadata
  3. View the code — the code scanner already checks for blocked patterns during upload
  4. Make a decision: Approve or Reject

Approving a Draft

  1. Select draft → click Approve
  2. Optionally: correct metadata (name, category, tags, description)
  3. Confirm → snippet appears immediately in the public gallery

What happens on approval?

  • Status changes from draft to published
  • The catalog cache is invalidated
  • The snippet is immediately visible to all PPPTools users in online mode

Rejecting a Draft

  1. Select draft → click Reject
  2. Optionally: enter a reason for the rejection
  3. The submitter receives no automatic notification (contact them manually)

Editing Items

Already published items can be edited in the admin panel:

Field Editable
Name ✅
Description ✅
Category ✅
Tags ✅
Tier (free / premium) ✅
Status (published / hidden) ✅
Code ❌ (submit a new snippet)
Preview image ❌ (submit a new snippet)

Setting Item Status

Status Meaning
published Publicly visible in the gallery
draft Submitted, not yet approved
hidden Disabled, not visible in the gallery

Setting the Tier

Tier Description
free Free of charge, no restrictions
premium (Phase 2) Reserved for premium content

In the current phase (Phase 1), all items are free. Premium items will be introduced in Phase 2.

Invalidating the Cache

When approving a draft, the cache is invalidated automatically. To do it manually:

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

Or in the admin panel: click Clear Cache.

Library Structure on the Server

All items are stored on the Synology NAS:

/volume3/docker/ppptools_library/library/
├── snippets/{guid}/
│   ├── snippet.xml    — Metadata
│   ├── code.cs        — Roslyn script
│   └── preview.png    — Preview image
├── slides/{guid}/
│   ├── slide.xml
│   ├── slide.pptx
│   └── preview.png
└── storylines/{guid}/
    ├── storyline.xml
    ├── preview.png
    └── slides/{guid}/...