Medien
Bilder und Dateien deines Teams speichern, in Ordnern und mit Tags organisieren, öffentlich per CDN teilen und über die API hochladen.
Medien
Unter Medien speicherst du Bilder und andere Dateien deines Teams an einem Ort – zum Beispiel Screenshots vom Gameserver, Beweisbilder für Support-Fälle oder Grafiken für Ankündigungen. Öffentliche Dateien bekommen einen Link über unser CDN, private Dateien sind nur für dein Team sichtbar.
Dateien kommen auf zwei Wegen hinein:
- Dashboard – Upload direkt in der Web-App (Bilder und Videos)
- API – Gameserver, Bots, Launcher oder eigene Skripte laden mit einem Team-API-Schlüssel hoch (Bilder, Videos, Audio, Dokumente). Siehe Medien-API und FiveM-Screenshots.
Modul öffnen
Du findest das Modul in der Sidebar unter Medien (Route /media). Der Menüpunkt erscheint, wenn du das Recht Medien einsehen (team.media.view) hast.
Zu den Medien
Die Seite hat zwei Tabs:
| Tab | Inhalt |
|---|---|
| Übersicht | Dateien, Ordner, Suche, Filter, Mehrfachauswahl, Dateien aus anderen Modulen sowie die Nutzungs-Zeile |
| API & Integrationen | Team-ID, Upload-URL, Upload-Parameter und Beispiele (curl, FiveM, JavaScript) |
Dateien hochladen
- Klicke auf Hochladen.
- Optional einen Zielordner wählen und Tags für alle Dateien eingeben.
- Dateien auswählen oder hineinziehen und hochladen.
Neue Dateien übernehmen die Standard-Sichtbarkeit des Zielordners (siehe Ordner-Regeln). Ohne Regel sind Uploads im Dashboard privat, Uploads über die API (Multipart) öffentlich.
Erlaubte Dateitypen
| Weg | Erlaubt |
|---|---|
| Dashboard | Bilder (JPEG, PNG, GIF, WebP, AVIF, BMP, HEIC) und Videos (MP4, WebM, MOV) |
| API | Bilder, Videos, Audio und Dokumente (z. B. PDF) |
Gesperrte Dateitypen
HTML, JavaScript, ausführbare Dateien, Shell-Skripte und SVG werden immer abgelehnt – im Dashboard
und über die API (HTTP 415).
Übersicht, Suche & Filter
- Ansicht: Kachelansicht oder Listenansicht (mit Ordner, Tags und Uploader)
- Einträge pro Seite: 24, 48 oder 96 – darunter die Seitennavigation
- Suche: nach Dateiname
- Dateityp: Alle Typen, Bilder, Videos, Audio, Dokumente
- Tags: einen oder mehrere Tags wählen. Bei mehreren Tags werden nur Dateien angezeigt, die alle gewählten Tags haben (UND-Verknüpfung). Ein Klick auf einen Tag an einer Datei filtert direkt danach.
Dateien aus anderen Modulen
In der Übersicht wechselst du über den Umschalter Quelle zwischen deinen eigenen Medien und Dateien aus anderen Modulen. Diese Quellen sind schreibgeschützt – du siehst sie hier nur gesammelt an einem Ort:
| Quelle | Inhalt | Voraussetzung | Zur Quelle führt zu |
|---|---|---|---|
| Mitglieder-Dateien | Dateien, die an Mitgliedern hochgeladen wurden | Recht Mitgliederdateien einsehen (team.member.file.view) | dem Mitglied |
| ToDo-Anhänge | Anhänge von Aufgaben – nur aus Boards, auf die du Zugriff hast | Recht Todo-Dateien einsehen (module.todo.file.view) | der Aufgabe im Board |
| Logo & Website | Team-Logo und Bilder des Website-Builders | – | dem Team-Logo in der Administration |
Quellen, für die dir das Recht fehlt, werden nicht angezeigt.
Bei Dateien aus anderen Modulen kannst du eine Vorschau ansehen, die Datei öffnen und über Zur Quelle direkt zum Ursprung springen. Bearbeiten und Löschen bleiben im jeweiligen Modul – Ordner, Tags, Sichtbarkeit und Mehrfachaktionen gibt es nur für deine eigenen Medien. Die Suche filtert bei diesen Quellen nur die aktuelle Seite.
Gemeinsamer Speicher
Alle Quellen belegen denselben Team-Speicher. Wie er sich aufteilt, siehst du im Speicher-Badge.
Ordner
Ordner helfen dir, Dateien zu trennen – z. B. screenshots, evidence oder branding.
- Alle zeigt alle Dateien, Ohne Ordner nur Dateien ohne Ordner
- Unterordner sind bis zu 5 Ebenen tief möglich; über die Breadcrumb-Navigation springst du zurück zu übergeordneten Ordnern
- Über das Menü am Ordner: Umbenennen, Verschieben, Regeln und Löschen (Recht Medien bearbeiten)
- Ordnernamen sind 1–100 Zeichen lang, enthalten kein
/und dürfen im selben Ordner nicht doppelt vorkommen
Ordner löschen
Beim Löschen eines Ordners bleiben die Dateien erhalten: Dateien und Unterordner wandern in den übergeordneten Ordner – bzw. nach Ohne Ordner, wenn es keinen gibt.
Ordner-Regeln
Über Regeln im Menü eines Ordners legst du fest, was automatisch passiert. Die Regeln gelten nur für Dateien, die direkt in diesem Ordner liegen (nicht für Unterordner). Ordner mit Regeln erkennst du an einem kleinen Symbol.
| Regel | Wirkung |
|---|---|
| Automatisch löschen nach (Tagen) | Dateien, die älter als N Tage sind, werden gelöscht (retentionDays). Leer = aus. |
| Nur die neuesten Dateien behalten | Nur die neuesten N Dateien bleiben erhalten, ältere werden gelöscht (maxFiles) |
| Standard-Sichtbarkeit für Uploads | Standard, Öffentlich oder Privat für Uploads ohne eigene Angabe (defaultPublic) |
Die Lösch-Regeln werden stündlich angewendet, Nur die neuesten Dateien behalten zusätzlich direkt nach jedem Upload. Wenn du eine Lösch-Regel neu setzt oder verschärfst, fragt TeamPanel vor dem Speichern nach. Ideal z. B. für einen Ordner screenshots, der nur die letzten 30 Tage behalten soll.
Endgültig
Von Ordner-Regeln gelöschte Dateien lassen sich nicht wiederherstellen. Prüfe die Werte, bevor du eine Regel auf einen bestehenden Ordner anwendest.
Tags
Tags verknüpfen Dateien mit Spielern, Quellen oder Kategorien. Wir empfehlen die Schreibweise key:value:
| Beispiel | Bedeutung |
|---|---|
license:abc123 | FiveM-/Rockstar-License |
steam:110000100000000 | Steam-ID (hex) |
discord:123456789 | Discord-ID |
type:screenshot | Art der Datei |
Regeln:
- 1–64 Zeichen, erlaubt sind
a-z,0-9und_ . : @ -(beginnt mit Buchstabe oder Ziffer) - Großbuchstaben werden automatisch kleingeschrieben
- Maximal 20 Tags pro Datei
Details, Teilen & Löschen
Über das Aktionsmenü einer Datei:
- Details – Dateiname, Größe, Typ, Upload-Datum, Uploader und Sichtbarkeit. Hier änderst du Ordner und Tags. Videos spielst du direkt im Dialog ab; im Raster zeigt ein Vorschaubild mit Play-Symbol das erste Bild des Videos.
- Teilen – zwischen öffentlich und privat umschalten und den Link kopieren.
- Öffnen – Datei in einem neuen Tab anzeigen.
- Löschen – Datei endgültig entfernen.
Öffentlich vs. privat
| Sichtbarkeit | Zugriff |
|---|---|
| Öffentlich | Fester Link über unser CDN: https://cdn.team-panel.com/media/team/<teamId>/<datei> |
| Privat | Nur für Teammitglieder – über kurzlebige, signierte Links (1 Stunde gültig) |
Beim Umschalten wird die Datei verschoben. Wird eine Datei privat gemacht oder gelöscht, entfernen wir sie auch aus dem CDN-Cache – der alte öffentliche Link funktioniert danach nicht mehr.
Mehrfachauswahl
Wähle mehrere Dateien über die Checkboxen (oder Alle auf der Seite) aus. Für bis zu 100 Dateien auf einmal stehen zur Verfügung:
| Aktion | Benötigtes Recht |
|---|---|
| Verschieben (in einen Ordner) | Medien bearbeiten |
| Öffentlich / privat machen | Medien bearbeiten |
| Tag hinzufügen / entfernen | Medien bearbeiten |
| Löschen | Medien löschen |
Speicher & Nutzung
Neben dem Titel Medien zeigt ein Badge den belegten Team-Speicher im Verhältnis zum Plan-Limit (z. B. 25.69 MB / 50.00 GB) – im selben Format wie bei den Backups. Fährst du mit der Maus darüber, siehst du, wie sich der gemeinsame Team-Speicher aufteilt: Medien, Mitglieder-Dateien, ToDo-Anhänge und Backups.
In der Übersicht zeigt eine Zeile darunter:
- Anzahl und Größe deiner eigenen Dateien in den Medien
- die max. Dateigröße pro Datei in deinem Plan
- Uploads der letzten 30 Tage, davon über die API
- CDN-Traffic der letzten 30 Tage (Datenmenge und Anfragen), sofern aktiviert
Speicherlimit nach einem Downgrade
Bei überschrittenem Team-Speicher gilt eine 30-tägige Schonfrist mit mehreren E-Mail-Warnungen an den Owner. Danach kann eine endgültige Bereinigung Dateien aus allen speicherpflichtigen Modulen entfernen, bis das aktuelle Limit eingehalten wird. Eine bestehende Datei oberhalb des kleineren Upload-Dateigrößen-Limits ist allein deshalb kein Löschgrund.
Unter Speicher verwalten sehen Owner und Superadmins die Aufteilung, den aktuellen Termin und die voraussichtlichen Löschungen. Du kannst jederzeit deinen Plan wieder erweitern oder selbst Dateien entfernen. Sobald genug Speicher frei ist, erfolgen keine weiteren Löschungen wegen der Überschreitung. Im angezeigten Simulationsmodus führt diese Bereinigung keine Löschungen aus; Ordner-Regeln bleiben davon unabhängig.
Die genaue Reihenfolge, die Warnungen und die Schutzfristen stehen unter Speicher nach einem Downgrade.
Protokoll
Aktionen in den Medien erscheinen in den Team-Logs: Hochladen, Bearbeiten, Sichtbarkeit ändern und Löschen von Dateien, Anlegen, Bearbeiten und Löschen von Ordnern, Mehrfachaktionen sowie Löschungen durch Ordner-Regeln (mit Anzahl der gelöschten Dateien).
Team-Berechtigungen
Unter Gruppen:
| Recht | Key | Bedeutung |
|---|---|---|
| Medien einsehen | team.media.view | Medien öffnen, Dateien ansehen und öffnen |
| Medien hochladen | team.media.upload | Dateien hochladen (Dashboard und API) |
| Medien bearbeiten | team.media.edit | Ordner, Ordner-Regeln, Tags, Sichtbarkeit, Mehrfachaktionen (außer Löschen) |
| Medien löschen | team.media.delete | Dateien löschen – einzeln und per Mehrfachauswahl |
Plan-Limits
Medien zählen zum gemeinsamen Team-Speicher deines Plans – demselben Speicher, den auch Mitglieder-Dateien, ToDo-Anhänge und Backups nutzen. Eine eigene Grenze für die Anzahl der Dateien gibt es nicht.
Die maximale Dateigröße pro Datei steigt mit dem Plan:
| Plan | Max. Dateigröße |
|---|---|
| Free | 10 MB |
| Starter | 25 MB |
| Pro | 50 MB |
| Expert | 100 MB |
| Enterprise | 250 MB |
Die aktuellen Werte deines Plans siehst du im Speicher-Badge und in der Nutzungs-Zeile unter Medien sowie auf der Preisseite.
Limit erreicht?
Ist ein Limit erreicht, schlägt der Upload fehl (über die API mit HTTP 402). Lösche nicht mehr
benötigte Dateien – z. B. automatisch per Ordner-Regel – oder upgrade deinen
Plan.
Automatisierung
Bei jedem Upload (Dashboard und API) wird das Event Medien hochgeladen ausgelöst. Damit kannst du z. B. neue Screenshots automatisch in einen Discord-Kanal posten. Details: Automatisierung.
Siehe auch
- Medien-API – Uploads und Verwaltung per API
- FiveM-Screenshots – Screenshots vom Gameserver hochladen
- API-Schlüssel – Schlüssel mit Scope
media:uploadanlegen