# Fileshelf

Download-Verwaltung für Joomla mit geschütztem Ablageordner, Zähler, Passwortschutz und Smart Search · Version 1.10.1 · Stand 12.11.2026

# Fileshelf im Überblick

Fileshelf verwaltet Downloads in Joomla 6 mit den Bordmitteln von Joomla: Kategorien, Schlagwörter, Zugriffsebenen, Felder und Versionen kommen aus dem Core, nicht aus einem eigenen System. Jeder Download hat genau eine Datei, eine Hauptkategorie und auf Wunsch weitere Kategorien, in denen er ebenfalls erscheint.

<figure id="bkmrk-die-liste-der-downlo"> ![Die Liste der Downloads im Backend mit Version, Zugriffsebene und Zähler](https://docs.graup-it.de/uploads/images/gallery/2026-11/8Kgdoku-02-downloads.png) <figcaption>Die Liste der Downloads: Titel, Kategorien, Version, Zugriffsebene und wie oft jede Datei heruntergeladen wurde.</figcaption></figure>## Was Fileshelf für Sie tut

- **Dateien geschützt ablegen.** Die Dateien liegen in einem eigenen Ablageordner, den Fileshelf gegen direkten Abruf sperrt und selbst prüft. Besucher erhalten eine Datei nur über Fileshelf – mit Zugriffsprüfung und Zähler.
- **Zugriff steuern.** Zugriffsebenen von Joomla, ein Passwort je Download oder je Kategorie, Veröffentlichungszeitraum.
- **Auf der Website zeigen.** Menüpunkte für Kategorien, einzelne Downloads und die neuesten Downloads, ein Modul, Shortcodes für Beiträge und eine Schaltfläche im Editor.
- **Finden lassen.** Die Suche der Website (Smart Search) findet Downloads nach Titel, Beschreibung, Dateiname und Schlagwort.
- **Pflegen.** Werkzeuge ordnen Dateien neu, übernehmen per FTP abgelegte Dateien und prüfen Dateiangaben.

## Die Bestandteile

Fileshelf wird als ein Paket installiert. Es enthält:

<table class="table" id="bkmrk-bestandteilaufgabe-k"> <thead> <tr><th scope="col">Bestandteil</th><th scope="col">Aufgabe</th></tr> </thead> <tbody> <tr><td>Komponente Fileshelf</td><td>Downloads, Ablage, Website-Ansichten, Werkzeuge</td></tr> <tr><td>System - Fileshelf</td><td>Kategoriepasswort, Schutz vor dem Löschen belegter Kategorien</td></tr> <tr><td>Inhalt - Fileshelf</td><td>Shortcodes in Beiträgen und Modulen</td></tr> <tr><td>Schaltfläche - Fileshelf</td><td>Schaltfläche „Download“ im Editor</td></tr> <tr><td>Suchindex - Fileshelf</td><td>Downloads in der Suche der Website</td></tr> <tr><td>Dateisystem - Fileshelf</td><td>Bereich „Downloads“ im Medienmanager</td></tr> <tr><td>Modul Fileshelf - Downloads</td><td>Neueste, beliebteste, hervorgehobene Downloads oder die einer Kategorie</td></tr> </tbody></table>

Die Plugins werden bei der ersten Installation eingeschaltet. Lassen Sie „System - Fileshelf“ immer eingeschaltet; die übrigen können Sie abschalten, wenn Sie die jeweilige Funktion nicht nutzen.

[English version](https://docs.graup-it.de/link/411)

# Voraussetzungen und Installation

## Voraussetzungen

- Joomla 6
- PHP 8.3 oder neuer
- MySQL 8.0.13 oder neuer bzw. MariaDB 10.4 oder neuer

## Installieren

1. Laden Sie das Paket `pkg_fileshelf-<version>.zip` herunter.
2. Öffnen Sie im Backend **System → Erweiterungen installieren** und ziehen Sie die ZIP-Datei in das Feld.
3. Nach der Installation zeigt Joomla eine Übersicht des Pakets mit Links zum Dashboard. In der Free-Version steht dort zusätzlich ein kurzer Hinweis auf die Pro-Version.

Fileshelf legt bei der Installation den Ablageordner `fileshelf/` im Joomla-Ordner an und schreibt Sperrdateien hinein. Öffnen Sie danach **Komponenten → Fileshelf → Dashboard**: Dort sehen Sie, ob der Ordner geschützt ist (siehe *Ablageordner und Selbsttest*).

<figure id="bkmrk-das-dashboard-der-fr"> ![Das Dashboard der Free-Version: Begrüßung, Hinweis auf die Pro-Version, Kennzahlen mit der Status-Karte, Schnellzugriff, zuletzt geänderte und beliebteste Downloads, die Plugins von Fileshelf](https://docs.graup-it.de/uploads/images/gallery/2026-11/kzmdoku-01-dashboard.png) <figcaption>Das Dashboard der Free-Version, wenn nichts zu tun ist: oben die Begrüßung, die Kennzahlen mit der Status-Karte, darunter Schnellzugriff, zuletzt geänderte und beliebteste Downloads und die Plugins.</figcaption></figure>## Das Dashboard

- **Braucht Ihre Aufmerksamkeit** – erscheint nur, wenn etwas zu tun ist, farbig hervorgehoben direkt unter der Werkzeugleiste, mit der Zahl der Punkte und je dem Weg, es zu beheben: etwa ein Download ohne Datei („Datei zuordnen“), ein Ablageordner, dessen Schutz nicht bestätigt ist, das ausgeschaltete Plugin „System – Fileshelf“ („Zum Plugin“) oder Pläne, die ohne Membership Pro gesperrt bleiben.
- **Begrüßung** – in zwei Sätzen, was Fileshelf ist und kann, dazu die installierte Version und dieses Handbuch.
- **Kennzahlen** – gleich hohe Karten mit Kopf: Downloads (veröffentlicht und unveröffentlicht), Kategorien, in der Pro-Version die Abrufe (heute, letzte 7 Tage, letzte 30 Tage und gesamt), und der Ablageordner. Unten in jeder Karte steht der Weg weiter, etwa „Alle Downloads“.
- **Ablageordner** – wo der Ordner liegt und wozu er da ist: Hier liegen die Dateien, und Besucher bekommen eine Datei nur über Fileshelf mit Prüfung von Zugriff, Passwort und Limits. Dazu „Jetzt prüfen“, die Einstellungen und diese Anleitung. Ist nichts zu tun, heißt die Karte **Status** und sagt „Nichts zu tun“.
- **Schnellzugriff** – die Seiten, die Sie am häufigsten brauchen, als Kacheln; am Ende Import (in der Pro-Version) und Werkzeuge. Die Optionen stehen oben rechts in der Werkzeugleiste.
- **Zuletzt geändert** und **Beliebteste Downloads** – die fünf zuletzt bearbeiteten Downloads und daneben die fünf veröffentlichten mit den meisten Abrufen insgesamt.
- **Plugins von Fileshelf** – unten über die ganze Breite und zweispaltig: jedes installierte Plugin des Pakets mit „an“ oder „aus“ und dem Link zu seinen Einstellungen, dazu die Zahl der Module auf der Website.
- In der **Free-Version** nennt ein Kasten oben die Pro-Version, und die Reihe „In der Pro-Version“ erklärt deren Funktionen je auf einer eigenen Seite.

Jede Seite von Fileshelf hat oben rechts den Knopf **Hilfe**: Er öffnet dieses Handbuch. Alle Seiten, auch die der Pro-Version, stehen außerdem im Menü unter **Komponenten → Fileshelf**.

## Updates

Neue Versionen erscheinen unter **System → Aktualisieren → Erweiterungen**. Ein Update behält Ihre Downloads, Dateien und Einstellungen; es funktioniert von jeder früheren Version aus.

## Deinstallieren

Wenn Sie das Paket deinstallieren, entfernt Joomla die Tabellen von Fileshelf. Der Ablageordner mit Ihren Dateien bleibt erhalten – löschen Sie ihn von Hand, wenn Sie ihn nicht mehr brauchen.

[English version](https://docs.graup-it.de/link/412)

# Ablageordner und Selbsttest

Alle Dateien liegen in einem Ablageordner. Kein Download wird über die Adresse der Datei ausgeliefert, sondern immer über Fileshelf: Erst prüft Fileshelf, ob der Besucher die Datei bekommen darf, dann zählt es den Download und sendet die Datei. Damit das nicht zu umgehen ist, muss der Ordner gegen direkten Abruf gesperrt sein.

## Der Selbsttest

Das Dashboard prüft den Ordner selbst: Fileshelf legt eine Testdatei ab und versucht, sie über ihre Adresse abzurufen. Er wiederholt den Test nach einem Tag oder wenn sich der Ordner ändert; ist „Software-Pakete erlauben“ an, holt jede Seite von Fileshelf im Backend einen fehlenden Test nach. Das Ergebnis erscheint in drei Farben:

<table class="table" id="bkmrk-ergebnisbedeutung-gr"> <thead> <tr><th scope="col">Ergebnis</th><th scope="col">Bedeutung</th></tr> </thead> <tbody> <tr><td>Grün</td><td>Geschützt: Die Dateien sind über ihre Adresse nicht erreichbar, oder der Ordner liegt außerhalb des Webverzeichnisses.</td></tr> <tr><td>Rot</td><td>Nicht geschützt: Dateien lassen sich an Schutz und Zähler vorbei herunterladen. Das Dashboard zeigt, wie Sie den Ordner schließen.</td></tr> <tr><td>Gelb</td><td>Nicht prüfbar: Die Website hat auf die Testanfrage nicht geantwortet. Prüfen Sie später erneut.</td></tr> </tbody></table>

Mit **Jetzt prüfen** wiederholen Sie den Test, etwa nachdem Sie die Serverkonfiguration geändert haben.

## Apache

Fileshelf legt eine `.htaccess`-Datei in den Ordner. Bleibt der Test trotzdem rot, lässt Ihr Server `.htaccess`-Dateien nicht zu. Bitten Sie Ihren Hoster, `AllowOverride`für diesen Ordner zu erlauben.

## nginx

nginx liest keine `.htaccess`-Dateien. Tragen Sie die Regel, die das Dashboard anzeigt, in die Serverkonfiguration ein (notfalls über den Hoster). Für den vorgegebenen Ordner lautet sie:

```
location ^~ /fileshelf/ { deny all; }
```

## Außerhalb des Webverzeichnisses

Am sichersten ist ein Ordner, der gar keine Adresse hat. Tragen Sie dazu unter **Optionen → Ablage → Ablageordner** einen absoluten Pfad außerhalb des Webverzeichnisses ein, zum Beispiel `/home/kunde/fileshelf`. Vorhandene Dateien werden bei einer Änderung nicht verschoben – kopieren Sie sie selbst in den neuen Ordner.

<div class="callout warning" id="bkmrk-ein-men%C3%BCpunkt-mit-de">Ein Menüpunkt mit demselben Alias wie der Ablageordner (etwa <code>fileshelf</code>) würde mit dem Ordner gesperrt. Das Dashboard warnt in diesem Fall; geben Sie dem Menüpunkt dann einen anderen Alias.

</div>## Auslieferung durch den Webserver

Unter **Optionen → Ablage → Auslieferung** können Sie statt PHP den Webserver die Datei senden lassen: *X-Sendfile* (Apache mit mod\_xsendfile) oder *X-Accel-Redirect* (nginx mit einer internen Adresse). Wählen Sie das nur, wenn Ihr Hoster es eingerichtet hat; im Zweifel bleiben Sie bei PHP. Schutz und Zähler gelten in allen drei Fällen.

[English version](https://docs.graup-it.de/link/413)

# Downloads anlegen und pflegen

Ein Download ist ein Eintrag mit genau einer Datei. Sie legen ihn unter **Komponenten → Fileshelf → Downloads → Neu** an.

<figure id="bkmrk-der-reiter-%E2%80%9Edatei-un"> ![Das Formular eines Downloads: oben die Datei, darunter die Beschreibung, rechts Status, Kategorie und Zusatzkategorien](https://docs.graup-it.de/uploads/images/gallery/2026-11/18Odoku-03-download.png) <figcaption>Der Reiter „Datei und Beschreibung“: oben die Datei, darunter die Beschreibung, rechts Status, Kategorie, Zusatzkategorien und Schlagwörter.</figcaption></figure>Das Formular hat höchstens sieben Reiter: **Datei und Beschreibung**, **Zugang**, in der Pro-Version **Weitergeben**, **Versionen** und **Statistik**, dazu **Veröffentlichung** und **Berechtigungen**. Eigene Felder bekommen wie bei Beiträgen ihren eigenen Reiter.

## Reiter „Datei und Beschreibung“

- **Kategorie** – die Hauptkategorie. Sie bestimmt die Adresse des Downloads, seine geerbten Rechte und den Ordner, in dem die Datei liegt.
- **Zusatzkategorien** – der Download erscheint auch in den Listen dieser Kategorien. Adresse und geerbte Einstellungen kommen weiterhin von der Hauptkategorie.
- **Beschreibung** – erscheint auf der Seite des Downloads. Sie wird mit demselben Editor bearbeitet wie ein Beitrag, samt Bildern, Medien und den Editor-Schaltflächen; Inhalts-Plugins wirken darin wie in Beiträgen. Zeigt das Feld nur einen leeren Rahmen, liegt es am Editor: Prüfen Sie unter Benutzer → Ihr Profil → „Basiseinstellungen“ den Editor und bei JCE, ob ein Editor-Profil veröffentlicht ist und für Ihre Benutzergruppe gilt.
- **Schlagwörter** und **Felder** wie bei Beiträgen.

### Die Datei

<figure id="bkmrk-hochladen-oder-eine-"> ![Der Bereich Datei mit der vorhandenen Datei, dem Feld zum Ersetzen und der Auswahl freier Dateien](https://docs.graup-it.de/uploads/images/gallery/2026-11/eyFdoku-04-download-datei.png) <figcaption>Hochladen oder eine vorhandene Datei aus dem Ablageordner wählen; darunter die Angaben zur Datei.</figcaption></figure>

- **Datei hochladen** – die Datei wird beim Speichern im Ordner der Hauptkategorie abgelegt.
- **Oder eine Datei aus dem Ablageordner wählen** – listet Dateien, die noch zu keinem Download gehören, etwa per FTP dorthin kopierte. Fileshelf liest den Ordner erst, wenn Sie auf *Freie Dateien im Ablageordner anzeigen* klicken; die Liste zeigt bis zu 200 Dateien.
- Liegt dieselbe Datei schon bei einem anderen Download, zeigt Fileshelf einen Hinweis.
- **Version** – unter „Angaben zur Datei“, frei wählbar, etwa `2.1`. Besucher sehen sie in den Listen. In der Pro-Version stehen die Angaben zur Datei oben im Reiter „Versionen“.
- **Lizenz** – erscheint dort, sobald ein Import aus einer anderen Download-Erweiterung das Feld angelegt hat (Pro-Version). Auf der Website steht sie mit der Beschriftung „Lizenz“ in der Sprache des Besuchers.

Erlaubt sind die Dateitypen aus **Optionen → Ablage → Erlaubte Dateitypen**. Programme und Webseiten (zum Beispiel `php`, `svg`, `html`) nimmt Fileshelf nie an, auch nicht in Namen wie `bericht.php.pdf`. Außerdem prüft Fileshelf, ob der Inhalt zur Endung passt, und Joomla prüft die Datei zusätzlich.

### Erweiterungen und andere Software-Pakete

Ein ZIP mit einer Erweiterung für Joomla, Shopware oder WordPress enthält PHP-Dateien. Joomla weist solche Archive beim Hochladen ab, und Fileshelf sagt dann, was zu tun ist. Wollen Sie Erweiterungen anbieten, schalten Sie **Optionen → Ablage → Software-Pakete erlauben** ein. Dann nimmt Fileshelf zip-, tar-, gz- und tgz-Archive mit Programmcode an:

- nur beim Hochladen im Backend (Formular, Mehrfachupload, Import), nie über die Website;
- nur, solange der Selbsttest den Ablageordner als geschützt meldet – sonst weist Fileshelf das Paket mit einem Hinweis auf den Selbsttest ab;
- nie mit einem verbotenen Teil im Namen wie `paket.php.zip`.

Für `tar.gz` und `tgz` tragen Sie zusätzlich `gz` und `tgz` bei den erlaubten Dateitypen ein. Programme wie `.exe` oder `.msi` bleiben gesperrt. Besucher bekommen ein Paket immer als Datei zum Speichern; die Prüfsumme auf der Seite des Downloads hilft ihnen, es zu prüfen.

## Reiter „Zugang“

Hier setzen Sie ein Passwort für diesen einen Download (siehe *Passwortschutz*). In der Pro-Version binden Sie den Download dort auch an Pläne von Membership Pro.

## Reiter „Weitergeben“ (Pro-Version)

Einmal-Links und befristete Links (siehe *Links*) und die Benachrichtigungen (siehe *Benachrichtigungen*).

## Reiter „Veröffentlichung“

Status, Zugriffsebene, Sprache, Beginn und Ende der Veröffentlichung, Autor und Zähler. Ein unveröffentlichter oder abgelaufener Download ist für Besucher nicht vorhanden – auch nicht über einen alten Link.

Beim Speichern prüft Fileshelf die Rechte, gleich auf welchem Weg der Download kommt (Formular, mehrere Dateien, Upload von der Website): Veröffentlichen darf nur, wer in der Kategorie den Status ändern darf – sonst bleibt ein neuer Download unveröffentlicht. Als Zugriffsebene sind nur die eigenen wählbar, und eine Zusatzkategorie nur dort, wo man Downloads anlegen darf.

## Die Liste

Die Liste zeigt zu jedem Download die Hauptkategorie, die Datei mit Typ und Größe, Version, Zugriffsebene und Zähler. Ein Download ohne Datei ist rot hervorgehoben. Über der Liste stehen Schnellfilter mit der jeweiligen Zahl: *Alle*, *Veröffentlicht*, *Unveröffentlicht* und – wenn es welche gibt – *Ohne Datei*. In den Filter-Optionen wird außerdem nach Status, Hervorhebung, Datei, Kategorie (Haupt- oder Zusatzkategorie) und Ebene, Zugriffsebene, Autor, Sprache und Schlagwort gefiltert.

- **Im Backend herunterladen** – der Dateiname in der Spalte „Datei“ lädt die Datei, ohne sie zu zählen. Dafür braucht der Benutzer das Recht „Im Backend herunterladen“.
- **Stapelverarbeitung** – Zugriffsebene, Sprache und Schlagwörter setzen, Zusatzkategorien hinzufügen oder entfernen, in eine andere Hauptkategorie verschieben. Kopieren ist nicht vorgesehen, weil eine Datei nur zu einem Download gehört.

[English version](https://docs.graup-it.de/link/414)

# Kategorien

Fileshelf nutzt die Kategorien von Joomla. Sie verwalten sie unter **Komponenten → Fileshelf → Kategorien** wie Beitragskategorien – mit Unterkategorien, Zugriffsebenen, Sprache und Rechten.

## Zusätzliche Reiter

Im Formular einer Kategorie ergänzt Fileshelf zwei Reiter:

- **Fileshelf** – ein Passwort für alle Downloads dieser Kategorie und ihrer Unterkategorien (siehe *Passwortschutz*).
- **Fileshelf: Darstellung** – wie die Kategorie ihre Downloads auf der Website zeigt: als Liste mit Kategoriebaum, Karten oder Tabelle.

<figure id="bkmrk-die-darstellung-gilt"> ![Der Reiter Fileshelf: Darstellung mit der Auswahl Liste, Tabelle oder Kacheln](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-07-kategorie-darstellung.png) <figcaption>Die Darstellung gilt, solange der Menüpunkt der Kategorie nichts anderes wählt.</figcaption></figure>Welche Darstellung gilt, entscheidet diese Reihenfolge: der Menüpunkt der Kategorie, dann die Kategorie, dann **Optionen → Anzeige → Darstellung**.

## Das Bild als Symbol

Das Bild der Kategorie (Reiter **Optionen → Bild** im Kategorieformular) erscheint auf der Website klein vor dem Namen der Kategorie und neben ihrer Überschrift.

## Zugriff über Zusatzkategorien

Unter **Optionen → Downloads → Zugriff über Zusatzkategorien** legen Sie fest, ob für einen Download nur seine Hauptkategorie zählt (Vorgabe) oder ob auch die Zugriffsebenen seiner Zusatzkategorien erfüllt sein müssen (*Strengste*).

## Löschen

Eine Kategorie, die noch Downloads enthält, lässt sich nicht löschen. Verschieben oder löschen Sie zuerst die Downloads. Wird eine Kategorie gelöscht, entfernt Fileshelf sie auch als Zusatzkategorie aus den Downloads.

[English version](https://docs.graup-it.de/link/415)

# Passwortschutz

Zusätzlich zu den Zugriffsebenen kann ein Passwort einen Download schützen. Der Besucher gibt es einmal ein und lädt danach herunter, ohne ein Benutzerkonto zu brauchen.

## Passwort für einen Download

<figure id="bkmrk-der-reiter-%E2%80%9Ezugang%E2%80%9C-"> ![Der Reiter Zugang eines Downloads mit Passwortfeld und Status](https://docs.graup-it.de/uploads/images/gallery/2026-11/KJydoku-05-download-schutz.png) <figcaption>Der Reiter „Zugang“ zeigt nur, ob ein Passwort gesetzt ist – nie das Passwort selbst.</figcaption></figure>

- Tragen Sie im Reiter **Zugang** ein Passwort ein und speichern Sie.
- Leer lassen behält das bisherige Passwort.
- **Passwort entfernen** hebt den Schutz auf.

## Passwort für eine Kategorie

<figure id="bkmrk-ein-kategoriepasswor"> ![Der Reiter Fileshelf im Kategorieformular mit dem Kategoriepasswort](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-06-kategorie-passwort.png) <figcaption>Ein Kategoriepasswort schützt jeden Download der Kategorie und ihrer Unterkategorien.</figcaption></figure>Ein Kategoriepasswort gilt für jeden Download der Kategorie und ihrer Unterkategorien, der kein eigenes Passwort hat. Wer es einmal eingegeben hat, kann alle diese Downloads laden.

## Was der Besucher sieht

<figure id="bkmrk-das-formular-erschei"> ![Das Formular zum Freischalten eines geschützten Downloads auf der Website](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-16-website-passwort.png) <figcaption>Das Formular erscheint, wenn ein Besucher einen geschützten Download öffnet.</figcaption></figure>

- In Listen steht statt der Schaltfläche ein Schloss mit dem Link **Passwort eingeben**.
- Nach dem richtigen Passwort startet der Download sofort.
- Für die Zeit aus **Optionen → Downloads → Passwort gilt für (Minuten)** fragt Fileshelf nicht erneut (Vorgabe 120 Minuten; 0 bis zum Ende der Browsersitzung).
- Nach fünf falschen Versuchen muss der Besucher kurz warten; die Wartezeit wächst mit jedem weiteren Fehlversuch bis auf eine Minute. Ist in Joomla eine Sicherheitsabfrage (Captcha) eingestellt, kommt sie ab dem zehnten Fehlversuch hinzu.
- Fileshelf zählt die Fehlversuche auf dem Server, je Passwort und Besucher. Ein neues Browserfenster oder gelöschte Cookies setzen den Zähler nicht zurück. Die Adresse des Besuchers wird dafür nur verschlüsselt gespeichert und nach einem Tag gelöscht.
- Kommen für ein Passwort innerhalb einer Stunde 100 Fehlversuche zusammen, gleich von wem, sperrt Fileshelf es für alle für 15 Minuten. Das bremst Angriffe aus vielen Adressen; danach geht es normal weiter.

<div class="callout info" id="bkmrk-fileshelf-speichert-">Fileshelf speichert Passwörter nur verschlüsselt (als Hash). Sie erscheinen weder im Formular noch im Versionsverlauf noch in einer Adresse. Ein vergessenes Passwort setzen Sie einfach neu.

</div>[English version](https://docs.graup-it.de/link/416)

# Downloads auf der Website

Auf der Website zeigen Menüpunkte Ihre Downloads. Legen Sie sie unter **Menüs → \[Ihr Menü\] → Neu → Menüeintragstyp → Fileshelf** an.

## Die Menüpunkttypen

<table class="table" id="bkmrk-typzeigtwichtige-ein"> <thead> <tr><th scope="col">Typ</th><th scope="col">Zeigt</th><th scope="col">Wichtige Einstellungen</th></tr> </thead> <tbody> <tr><td>Kategorien</td><td>Die Kategorien unter der gewählten Wurzel als Kacheln oder als kompakte Liste, mit Bild, Beschreibung, Anzahl der Downloads und Unterkategorien</td><td>Wurzelkategorie, Darstellung, Beschreibung der obersten Kategorie, Kategoriebild, Beschreibung, Anzahl anzeigen, Ebenen (1 = ohne Unterkategorien)</td></tr> <tr><td>Kategorie</td><td>Die Downloads einer Kategorie und ihre Unterkategorien</td><td>Darstellung, Reihenfolge, Anzahl je Seite, Kategoriebild und seine Darstellung, Angaben (Größe, Version, Datum, Zähler, Schlagwörter), gesperrte Downloads anzeigen</td></tr> <tr><td>Einzelner Download</td><td>Die Seite eines Downloads</td><td>Datei direkt ausliefern statt die Seite zu zeigen</td></tr> <tr><td>Neueste Downloads</td><td>Die zuletzt angelegten Downloads</td><td>Anzahl, Kategorien, Zeitraum in Tagen</td></tr> </tbody></table>

<figure id="bkmrk-men%C3%BCpunkt-%E2%80%9Ekategorie"> ![Die Kategorienübersicht auf der Website mit der Anzahl der Downloads je Kategorie](https://docs.graup-it.de/uploads/images/gallery/2026-11/Q7wdoku-12-website-uebersicht.png) <figcaption>Menüpunkt „Kategorien“ als Kacheln: je Kategorie Bild (aus dem Feld „Bild“ der Kategorie, sonst ein Ordnersymbol), Beschreibung, Zahl der Downloads mit allen Unterkategorien und die Unterkategorien zum Anklicken.</figcaption></figure>Über den Kacheln stehen Titel, Beschreibung und Bild der gewählten Wurzelkategorie (abschaltbar im Menüpunkt unter „Beschreibung der obersten Kategorie“ und „Kategoriebild“). Jede Kachel hat eine Bildfläche im Format 16 : 9; das Bild wird eingepasst, nie beschnitten, Logos bleiben also ganz.

## Kategoriebild und Beschreibung

Oben in jeder Kategorie stehen Titel, Beschreibung und das Bild aus dem Feld „Bild“ der Kategorie. Das Bild steht neben dem Text, höchstens 220 × 160 Pixel groß und nie beschnitten; auf schmalen Bildschirmen steht es darüber. Wahlweise erscheint es als **Banner** über die volle Breite im Format 3 : 1 – das passt zu Fotos, schneidet aber zu. Beides wählen Sie in den Optionen oder je Menüpunkt („Kategoriebild“, „Darstellung des Kategoriebilds“). Den Alternativtext nimmt Fileshelf aus dem Bildfeld der Kategorie; ist dort „Keine Beschreibung“ angehakt, gilt das Bild als Schmuck.

## Überschriften

Jede Seite hat genau eine Hauptüberschrift (h1). In einer Kategorie ist es ihr Titel – oder die Seitenüberschrift des Menüpunkts, wenn „Seitenüberschrift anzeigen“ an ist und der Menüpunkt genau diese Kategorie zeigt. Darunter gliedern die kleinen Abschnitte **Unterkategorien** und **Downloads** die Seite (h2), die Downloads darin sind h3. Seiten ohne eigenen Titel, etwa „Neueste Downloads“, behalten ihre Hauptüberschrift auch bei ausgeschalteter Seitenüberschrift – dann nur für Screenreader. So finden sich Screenreader und Suchmaschinen zurecht.

### Überschrift und Einleitung der Übersicht

Über den Kategorien der Download-Übersicht können eine eigene **Überschrift** und ein **Einleitungstext** stehen. Beides tragen Sie in den Optionen von Fileshelf (Reiter „Anzeige“) für alle Übersichten ein, oder im Menüpunkt der Übersicht nur für diesen; ein leeres Feld im Menüpunkt nimmt den Wert aus den Optionen. Eine eingetragene Überschrift ist die Hauptüberschrift der Seite und erscheint immer, auch wenn „Seitenüberschrift anzeigen“ aus ist. Ohne eigene Überschrift gilt das oben Beschriebene.

### Browser-Seitentitel

Der „Browser-Seitentitel“ eines Menüpunkts (Reiter „Seitenanzeige“) gilt für die Seite, die der Menüpunkt zeigt: die Übersicht, die Kategorie, den Download oder „Neueste Downloads“. Seiten darunter, etwa eine Unterkategorie, tragen ihren eigenen Titel. Der Name der Website kommt dazu, wenn das in der globalen Konfiguration von Joomla so eingestellt ist.

## Drei Darstellungen einer Kategorie

Jede Darstellung führt anders durch die Kategorien. Gewählt wird sie im Menüpunkt, in der Kategorie (Reiter „Fileshelf: Darstellung“) oder für alle in den Optionen.

- **Liste mit Kategoriebaum** (Vorgabe) – links der Baum der Kategorien unter dem Menüpunkt, mit der Zahl der Downloads; er öffnet sich nur entlang des Weges zur gezeigten Kategorie. Auf dem Handy steht er unter der Liste.
- **Karten** – über den Downloads der Weg zurück zur Elternkategorie und die Unterkategorien (ohne Unterkategorien die Kategorien derselben Ebene); die Downloads als Karten.
- **Tabelle** – „Kategorie wechseln“ als Auswahl, die Unterkategorien zum Anklicken, die Downloads als Tabelle, deren Spaltenköpfe sortieren. Auf schmalen Bildschirmen wird jede Zeile ein Block mit beschrifteten Angaben.

Der Dateityp steht in allen Darstellungen als farbiges Etikett („PDF“, „ZIP“ …); die Farbe hilft beim Überfliegen, das Wort nennt den Typ.

## Ohne eigene Seite je Download

Jeder Download hat eine eigene Seite mit Beschreibung und Details. Wer Downloads nur als Liste mit Direktlink führen will, stellt in den Optionen (Reiter „Anzeige“) oder im Menüpunkt **Eigene Seite je Download** auf „Nein“. Dann gilt:

- Der Titel führt direkt zur Datei, mit denselben Prüfungen wie die Schaltfläche „Herunterladen“, die stehen bleibt. Braucht ein Download ein Passwort oder eine Anmeldung, zeigt der Hinweis daneben den Weg.
- Alte Adressen der Seite leiten dauerhaft (301) auf die Datei um. Ein Menüpunkt „Einzelner Download“ für genau diesen Download zeigt seine Seite weiter.
- Auch das Modul, die Kürzel, YOOtheme, die Suche, die Mails der Benachrichtigungen und der Editor-Dialog verlinken dann die Datei.
- Was nur auf der Seite steht, fehlt auf der Website: „Benachrichtigen“ und die älteren Versionen (Pro-Version). Formular und Freischaltung eines Links (Pro-Version) erreicht der Besucher über den Hinweis.

Über der Liste können Besucher suchen (Titel und Dateiname), sortieren und – bei mehreren Dateitypen – nach Typ filtern. Die Auswahl steht in der Adresse, ein gefilterter Link lässt sich also weitergeben. Abschalten lässt sich das mit **Suche und Sortierung** im Menüpunkt oder in den Optionen. Die Breadcrumbs von Joomla zeigen den Weg vom Menüpunkt bis zur Kategorie bzw. zum Download.

Fileshelf übernimmt das Aussehen von Schaltflächen, Feldern und Tabellen aus dem Template: Jede Schaltfläche trägt die Klassen von Bootstrap (Cassiopeia und viele andere Templates) und von UIkit (YOOtheme Pro) zugleich. Wer mehr anpassen will, legt Overrides für `com_fileshelf/category` und das Layout `fileshelf/item` an.

<figure id="bkmrk-darstellung-%E2%80%9Eliste-m"> ![Eine Kategorie als Liste mit dem Kategoriebaum links, Suche und Sortierung über der Liste](https://docs.graup-it.de/uploads/images/gallery/2026-11/Ijedoku-42-website-liste.png) <figcaption>Darstellung „Liste mit Kategoriebaum“ (Vorgabe): links der Baum, über der Liste Suche und Sortierung.</figcaption></figure><figure id="bkmrk-darstellung-%E2%80%9Etabelle"> ![Eine Kategorie als Tabelle mit „Kategorie wechseln“ und sortierbaren Spalten](https://docs.graup-it.de/uploads/images/gallery/2026-11/3jqdoku-13-website-tabelle.png) <figcaption>Darstellung „Tabelle“: oben „Kategorie wechseln“, die Spaltenköpfe sortieren.</figcaption></figure><figure id="bkmrk-darstellung-%E2%80%9Ekarten%E2%80%9C"> ![Eine Kategorie in der Darstellung Karten](https://docs.graup-it.de/uploads/images/gallery/2026-11/yQ1doku-14-website-kacheln.png) <figcaption>Darstellung „Karten“: oben der Weg zurück und die Unterkategorien.</figcaption></figure>## Gesperrte Downloads

Downloads, deren Zugriffsebene der Besucher nicht hat, blendet Fileshelf aus. Mit **Gesperrte Downloads anzeigen** (Optionen oder Menüpunkt) erscheinen sie mit Schloss und einem Link zur Anmeldung. Passwortgeschützte Downloads stehen immer in der Liste, mit dem Link **Passwort eingeben**.

## Die Seite eines Downloads

<figure id="bkmrk-titel-und-kategorien"> ![Die Seite eines Downloads: Titel, Kategorien, Beschreibung und daneben der Kasten mit Datei, Schaltfläche und Angaben](https://docs.graup-it.de/uploads/images/gallery/2026-11/whvdoku-15-website-detail.png) <figcaption>Titel und Kategorien, die Beschreibung und daneben der Download-Kasten.</figcaption></figure>Der **Download-Kasten** nennt die Datei mit Typ und Größe, trägt die Schaltfläche **Herunterladen** (oder das Schloss mit dem Grund) und die Angaben Version, Datum und – wenn eingeschaltet – die Zahl der Downloads. Auf Wunsch zeigt er die **Prüfsumme** (SHA-256) zum Aufklappen, damit Besucher eine heruntergeladene Datei prüfen können; eingeschaltet wird sie in den Optionen oder im Menüpunkt „Einzelner Download“. Ist der Bereich schmal – auf dem Handy oder in einer schmalen Spalte –, steht der Kasten über der Beschreibung.

Erscheint ein Download in mehreren Kategorien, nennt seine Seite der Suchmaschine die Adresse unter der Hauptkategorie als die maßgebliche (Canonical). So zählt er nicht doppelt.

## Adressen

Mit eingeschalteten suchmaschinenfreundlichen URLs sehen die Adressen so aus:

- Seite eines Downloads: `…/preislisten/preisliste-2026`
- Datei: `…/preislisten/preisliste-2026/file`
- Passwortformular: `…/preislisten/preisliste-2026/unlock`

Die Option **IDs aus URLs entfernen** (Optionen → Integration) steuert, ob die Nummer des Downloads in der Adresse steht. Der Alias eines Downloads muss je Kategorie eindeutig sein.

[English version](https://docs.graup-it.de/link/417)

# An Ihr Template anpassen

Fileshelf richtet sich nach Ihrem Template, statt es zu übermalen. Ohne jede Einstellung übernehmen Listen, Kacheln, Tabellen und die Seite eines Downloads Schrift, Farben, Schaltflächen und Felder des Templates – geprüft mit Cassiopeia, YOOtheme Pro, Helix Ultimate und Astroid. Diese Seite zeigt, wie Sie darüber hinaus anpassen, vom Farbwähler bis zum eigenen Override.

## Ohne Code: die Optionen

Unter **Optionen → Darstellung** wählen Sie eine **Akzentfarbe** und die **Ecken**, oder Sie schalten das **Stylesheet** von Fileshelf ab (siehe *Optionen und Rechte*).

## Mit einer Zeile CSS: die Variablen

Farben, Linien und Ecken von Fileshelf hängen an Variablen. Setzen Sie sie in der `user.css` Ihres Templates (Cassiopeia: *System → Site Template Styles → Cassiopeia → Erweitert* bzw. die Datei `media/templates/site/cassiopeia/css/user.css`):

```
.com-fileshelf {
  --fsh-accent: #b8322b;   /* Schaltflächen und Kennzeichen */
  --fsh-on-accent: #fff;   /* Schrift auf der Akzentfarbe */
  --fsh-border: #d0d4da;   /* Linien und Rahmen */
  --fsh-radius: 0;         /* Ecken */
  --fsh-gap: 1.5rem;       /* Abstand zwischen Einträgen */
}
```

Ohne eigene Werte nimmt Fileshelf die Farben des Templates: bei Cassiopeia die Primärfarbe und die Rahmenfarbe, bei Bootstrap-Templates (Helix Ultimate, Astroid, T4) die Bootstrap-Variablen, sonst leitet es Linien aus der Textfarbe ab. Deshalb bleibt Fileshelf auch auf dunklen Abschnitten lesbar.

## Eigene Regeln gewinnen immer

Das Aussehen von Fileshelf (Farben, Rahmen, Schaltflächen, Felder) steht in einer eigenen CSS-Ebene (`@layer fileshelf`). Jede Regel Ihres Templates oder Ihrer `user.css` geht ihr vor – ohne `!important`. Nur die Anordnung (Raster, Abstände) und die Wahl unter „Darstellung“ stehen außerhalb.

## Schmale Spalten

Listen, Kacheln und die Seite eines Downloads richten sich nach der Breite des Bereichs, in dem sie stehen – nicht nach der Breite des Bildschirms. In einer Seitenleiste wird die Liste kompakt, und die Schaltfläche zeigt nur noch ein Symbol; ihren Namen lesen Screenreader weiter vor.

## Klassen der Schaltflächen und Felder

Schaltflächen, Felder und Tabellen tragen die Klassen von Bootstrap 5 und UIkit 3 zugleich – jedes Framework übernimmt seine. Nutzt Ihr Template ein anderes, legen Sie die Datei `templates/<ihr-template>/html/com_fileshelf/ui.json` an und nennen je Baustein die Klassen Ihres Frameworks:

```
{
  "button": "button is-primary",
  "button-secondary": "button",
  "input": "input",
  "select": "select",
  "table": "table is-striped"
}
```

Bausteine: `button`, `button-secondary`, `button-link`, `button-small`, `input`, `textarea`, `select`, `label`, `field`, `table`, `card`, `section` (die kleinen Abschnittsüberschriften). Die eigenen Klassen von Fileshelf (`com-fileshelf-…`) bleiben immer erhalten. Bei einem Child-Template gilt dessen Datei vor der des Eltern-Templates.

## Das Stylesheet ganz ersetzen

Ein Template kann das Stylesheet von Fileshelf durch ein eigenes ersetzen: in seiner `joomla.asset.json` ein Eintrag mit dem Namen `com_fileshelf.site`. Oder Sie schalten es unter **Optionen → Darstellung** ab.

## Overrides

Alle Ansichten und Bausteine lassen sich wie bei Joomla üblich überschreiben, unter **System → Site Template → Ihr Template → Overrides erstellen → Komponenten → com\_fileshelf**bzw. **Layouts → com\_fileshelf**. Die wichtigsten Layouts:

- `fileshelf/item` – ein Eintrag in Listen, Kacheln, Modul und Shortcodes;
- `fileshelf/file` – der Download-Kasten auf der Seite eines Downloads;
- `fileshelf/lock` – das Schloss mit dem Grund;
- `fileshelf/items` – die Liste um die Einträge;
- `fileshelf/categoryhead` – Titel, Bild und Beschreibung oben in Kategorie und Übersicht.

**Seit 1.9.0:** Die Kategorie hat die Abschnitte „Unterkategorien“ und „Downloads“, die Downloads darin sind h3, und der Kopf kommt aus dem Layout `fileshelf/categoryhead` (das frühere `fileshelf/categoryicon` entfällt). Haben Sie `category/default_head.php`, `category/default_filter.php`, `category/default_cards.php`, `category/default_table.php` oder `category/default_entries_*.php` überschrieben, übernehmen Sie diese Änderungen in Ihr Override, sonst fehlen dort Abschnitte oder Bild.

[English version](https://docs.graup-it.de/link/457)

# Shortcodes in Beiträgen

Mit Shortcodes setzen Sie Downloads in Beiträge, Module und alle anderen Texte, die durch die Inhalts-Plugins laufen. Am einfachsten fügen Sie sie über die Schaltfläche **Download** im Editor ein (siehe *Editor-Schaltfläche*); Sie können sie aber auch von Hand schreiben.

<figure id="bkmrk-ein-beitrag-mit-alle"> ![Ein Beitrag mit Link, Schaltfläche, Zähler und Liste aus Shortcodes sowie dem Modul](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-17-website-beitrag.png) <figcaption>Ein Beitrag mit allen Arten von Shortcodes und, darunter, dem Modul.</figcaption></figure>## Die Formen

<table class="table" id="bkmrk-shortcodeergebnis-%7Bf"> <thead> <tr><th scope="col">Shortcode</th><th scope="col">Ergebnis</th></tr> </thead> <tbody> <tr><td><code>&#123;fileshelf id&#61;12&#125;</code></td><td>Link mit dem Titel des Downloads</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 text&#61;&#34;Formular laden&#34;&#125;</code></td><td>Link mit eigenem Text</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 button&#125;</code></td><td>Schaltfläche</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 button class&#61;&#34;uk&#45;button uk&#45;button&#45;primary&#34;&#125;</code></td><td>Schaltfläche mit eigenen CSS-Klassen</td></tr> <tr><td><code>&#123;fileshelf id&#61;12 count&#125;</code></td><td>Nur die Zahl, wie oft der Download heruntergeladen wurde</td></tr> <tr><td><code>&#123;fileshelf cat&#61;3&#125;</code></td><td>Liste der Downloads einer Kategorie (Haupt- oder Zusatzkategorie)</td></tr> <tr><td><code>&#123;fileshelf cat&#61;3 layout&#61;cards limit&#61;5 order&#61;popular&#125;</code></td><td>Kacheln, höchstens 5, beliebteste zuerst</td></tr> </tbody></table>

`{fsh …}` ist die Kurzform von `{fileshelf …}`. Für `order` gibt es `title` (Vorgabe), `rtitle`, `newest`, `oldest`, `popular` und `ordering`; `limit` geht bis 100.

## Was Besucher sehen

- Darf der Besucher den Download laden, erscheint Link oder Schaltfläche.
- Ist er geschützt, erscheinen Titel und Schloss mit dem Link **Passwort eingeben** bzw. **Anmelden**.
- Ein unbekannter, unveröffentlichter oder abgelaufener Download erscheint gar nicht. Im Debug-Modus von Joomla steht an seiner Stelle ein HTML-Kommentar mit dem Grund.

<div class="callout info" id="bkmrk-steht-eine-liste-all">Steht eine Liste allein in einem Absatz, ersetzt sie den Absatz. Schreiben Sie <code>&#123;fileshelf cat&#61;…&#125;</code> deshalb in eine eigene Zeile.

</div>[English version](https://docs.graup-it.de/link/418)

# Editor-Schaltfläche

Unter dem Editor bzw. im Menü **CMS Inhalt** von TinyMCE finden Sie die Schaltfläche **Download**. Sie öffnet ein Auswahlfenster und fügt den passenden Shortcode ein.

<figure id="bkmrk-oben-w%C3%A4hlen-sie-die-"> ![Das Auswahlfenster der Schaltfläche Download mit der Wahl Link, Schaltfläche oder Anzahl](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-11-editor-auswahl.png) <figcaption>Oben wählen Sie die Form, darunter den Download. Im Reiter „Kategorien“ fügen Sie eine ganze Kategorie als Liste ein.</figcaption></figure>

1. Setzen Sie den Cursor an die gewünschte Stelle und klicken Sie auf **Download**.
2. Wählen Sie unter **Einfügen als**: Link, Schaltfläche oder Anzahl der Downloads.
3. Klicken Sie auf den Download. Suche, Filter und Sortierung funktionieren wie in der Liste.
4. Für eine Liste öffnen Sie den Reiter **Kategorien** und klicken auf die Kategorie.

## Link-Dialog von TinyMCE

Auch im Link-Dialog von TinyMCE stehen die Downloads als Quelle bereit. So verlinken Sie markierten Text direkt mit der Seite eines Downloads.

## Wer die Schaltfläche sieht

Die Schaltfläche erscheint im Backend für Benutzer mit dem Recht „Administrationszugriff“ auf Fileshelf. Im Frontend-Editor wird sie nicht angeboten.

[English version](https://docs.graup-it.de/link/419)

# Das Modul

Das Modul **Fileshelf - Downloads** zeigt Downloads auf einer Modulposition. Legen Sie es unter **Inhalt → Site Module → Neu → Fileshelf - Downloads** an.

## Einstellungen

<table class="table" id="bkmrk-einstellungbedeutung"> <thead> <tr><th scope="col">Einstellung</th><th scope="col">Bedeutung</th></tr> </thead> <tbody> <tr><td>Anzeigen</td><td>Neueste Downloads, Am häufigsten heruntergeladen, Downloads einer Kategorie oder Hervorgehobene Downloads</td></tr> <tr><td>Kategorien</td><td>Nur Downloads dieser Kategorien (Haupt- oder Zusatzkategorie). Für „Downloads einer Kategorie“ nötig, sonst wahlweise.</td></tr> <tr><td>Anzahl Downloads</td><td>Höchstens so viele Einträge (bis 100)</td></tr> <tr><td>Darstellung</td><td>Liste oder Kacheln</td></tr> <tr><td>Überschrift der Titel</td><td>Überschriftenebene der Download-Titel, eine unter dem Modultitel</td></tr> <tr><td>Dateityp und Größe, Datum, Anzahl Downloads je Datei</td><td>Einblenden, ausblenden oder wie in den Optionen von Fileshelf</td></tr> </tbody></table>

Das Modul nutzt dieselbe Zugriffsprüfung wie die Kategorieansicht: Gesperrte Downloads erscheinen mit Schloss. Es nutzt den Modul-Cache von Joomla; der Cache unterscheidet dabei nach Zugriffsebenen, Sprache und freigeschalteten Passwörtern, damit niemand die Ansicht eines anderen Besuchers bekommt.

[English version](https://docs.graup-it.de/link/420)

# Suche (Smart Search)

Das Plugin **Suchindex - Fileshelf** nimmt Downloads in die Suche der Website (Smart Search) auf. Gefunden werden Titel, Beschreibung, Dateiname – auch seine Teile, also `preisliste-2026.pdf` unter „preisliste“ –, Version und Schlagwörter.

<figure id="bkmrk-die-suche-findet-den"> ![Das Ergebnis der Suche nach Preisliste mit dem passenden Download](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-18-website-suche.png) <figcaption>Die Suche findet den Download über Titel, Dateiname oder Schlagwort.</figcaption></figure>## Einrichten

1. Prüfen Sie, dass die Plugins **Suchindex - Fileshelf** und **Inhalt - Smart Search** eingeschaltet sind.
2. Öffnen Sie **Komponenten → Smart Search** und klicken Sie einmal auf **Index**, damit vorhandene Downloads aufgenommen werden.

Danach hält Fileshelf den Index selbst aktuell: beim Speichern, Veröffentlichen, Zurückziehen und Löschen eines Downloads und wenn sich Zugriffsebene oder Status einer Kategorie ändern.

## Wer was findet

Die Suche zeigt einem Besucher nur Downloads, deren Zugriffsebene – und die der Hauptkategorie – er hat. Passwortgeschützte Downloads werden gefunden; die Datei gibt es trotzdem erst nach dem Passwort.

Als Filter der Suche stehen Typ, Kategorie (auch Zusatzkategorien), Autor, Schlagwort und Sprache bereit.

[English version](https://docs.graup-it.de/link/421)

# Medienmanager

Das Plugin **Dateisystem - Fileshelf** zeigt den Ablageordner im Medienmanager als Bereich **Downloads**. So sehen Sie die Ordner und Dateien, laden Dateien hoch und legen Ordner an, ohne FTP.

<figure id="bkmrk-der-bereich-%E2%80%9Edownloa"> ![Der Medienmanager mit dem Bereich Downloads und den Ordnern der Kategorien](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-09-medienmanager.png) <figcaption>Der Bereich „Downloads“ neben den lokalen Ordnern von Joomla.</figcaption></figure>## Was anders ist als bei normalen Ordnern

- **Adresse:** Eine Datei, die ein Download verwendet, hat als Adresse die des Downloads – nicht die der Datei. Wer sie einfügt, verlinkt also über Fileshelf, mit Schutz und Zähler. Dateien ohne Download haben keine Adresse.
- **Hochladen:** Für Uploads gelten dieselben Prüfungen wie im Download-Formular.
- **Schutz:** Eine Datei, die ein Download verwendet, lässt sich hier nicht löschen, verschieben oder überschreiben – ebenso ein Ordner mit solchen Dateien. Ändern oder löschen Sie zuerst den Download.
- **Sichtbar** ist der Bereich nur für Benutzer, die Fileshelf verwalten dürfen.
- **Inhalt und Adresse** einer Datei (Vorschau, Herunterladen im Medienmanager) gibt es nur mit dem Recht *Im Backend herunterladen* – wie bei der Schaltfläche im Download-Formular. Wer Fileshelf nur verwalten darf, sieht die Dateinamen, aber nicht ihren Inhalt.

## Grenze

Der Medienmanager zeigt nur Dateitypen, die in seinen eigenen Optionen erlaubt sind (**Medien → Optionen**). Fehlen dort Endungen wie `zip` oder `docx`, erscheinen solche Dateien im Bereich nicht, obwohl Fileshelf sie verwaltet. Ergänzen Sie die Endungen dort, wenn Sie sie im Medienmanager sehen wollen. Neue Downloads legen Sie am besten über das Download-Formular an; per Medienmanager hochgeladene Dateien wählen Sie dort unter **Oder eine Datei aus dem Ablageordner wählen** oder übernehmen sie mit den Werkzeugen.

[English version](https://docs.graup-it.de/link/422)

# Werkzeuge

Die Werkzeuge erreichen Sie über das Dashboard oder das Menü **Komponenten → Fileshelf → Werkzeuge**. Sie stehen nur Benutzern mit dem Recht „ACL &amp; Optionen konfigurieren“ auf Fileshelf zur Verfügung (Super User und Administratoren mit diesem Recht).

<figure id="bkmrk-die-werkzeuge-in-dre"> ![Die Werkzeuge von Fileshelf in drei Gruppen: Ablageordner und Dateien, Ausprobieren, Nicht umkehrbar](https://docs.graup-it.de/uploads/images/gallery/2026-11/tqWdoku-08-werkzeuge.png) <figcaption>Die Werkzeuge in drei Gruppen; was sich nicht rückgängig machen lässt, steht abgesetzt.</figcaption></figure>Die Seite hat drei Gruppen: **Ablageordner und Dateien**, **Ausprobieren** (die Demodaten) und **Nicht umkehrbar** (Zähler zurücksetzen, Demodaten löschen). Jedes Werkzeug zeigt vorher, was es tun würde. Ausgeführt wird erst, wenn Sie das Häkchen zur Bestätigung setzen und auf die Schaltfläche klicken; bei den Demodaten und den Zählern steht beides in einem Dialog, der die Folgen nennt.

Was im Ablageordner nicht stimmt (verschobene oder fremde Dateien), sucht Fileshelf erst, wenn Sie oben unter **Ablageordner prüfen** auf **Ablageordner jetzt prüfen** klicken – ein Durchlauf für beide Werkzeuge, bei vielen Dateien dauert das einen Moment. Verschoben werden je Lauf bis zu 300 Dateien; die Meldung sagt, wie viele noch übrig sind.

<table class="table" id="bkmrk-werkzeugwann-sie-es-"> <thead> <tr><th scope="col">Werkzeug</th><th scope="col">Wann Sie es brauchen</th></tr> </thead> <tbody> <tr><td>Demodaten</td><td>Sie wollen sehen, wie Fileshelf auf Ihrer Website aussieht, bevor Sie eigene Downloads anlegen. „Demodaten anlegen“ erzeugt sechs Kategorien (eine mit dem Passwort <code>demo</code>), zwölf Downloads mit kleinen Beispieldateien, zwei Schlagwörter und im Hauptmenü den Menüpunkt „Fileshelf-Demo“ mit je einem Unterpunkt für die Darstellungen Liste, Karten und Tabelle, einen einzelnen Download und die neuesten Downloads. „Demodaten löschen“ entfernt genau das wieder samt Dateien. Was Sie seither geändert haben oder eigene Downloads in einer Demo-Kategorie bleiben stehen; die Vorschau nennt sie. Das Passwort <code>demo</code> ist bekannt – löschen Sie die Demodaten, bevor die Website öffentlich wird.</td></tr> <tr><td>Dateien neu ordnen</td><td>Eine Datei bleibt in ihrem Ordner, wenn ihr Download eine andere Hauptkategorie bekommt. Das Werkzeug verschiebt sie in den Ordner der Hauptkategorie; die Links bleiben gleich.</td></tr> <tr><td>Dateien ohne Download übernehmen</td><td>Sie haben Dateien per FTP oder Medienmanager in den Ablageordner kopiert. Wählen Sie Dateien und Kategorie; jede Datei wird ein unveröffentlichter Download mit dem Dateinamen als Titel. Dateien, die die Upload-Prüfungen nicht bestehen, bleiben unberührt.</td></tr> <tr><td>Dateiangaben prüfen</td><td>Sie haben eine Datei per FTP ersetzt. Das Werkzeug liest jede Datei neu und speichert Größe, Typ und Prüfsumme; fehlende Dateien nennt es. Es arbeitet in Schritten zu 300 Dateien; nach jedem Schritt geht es mit *Weiter prüfen* weiter.</td></tr> <tr><td>Download-Zähler zurücksetzen</td><td>Setzt die Zähler aller Downloads oder der Downloads einer Hauptkategorie auf 0. Das lässt sich nicht rückgängig machen.</td></tr> </tbody></table>

[English version](https://docs.graup-it.de/link/423)

# Optionen und Rechte

Die Optionen erreichen Sie über die Schaltfläche **Optionen** im Dashboard und in der Liste der Downloads.

<figure id="bkmrk-die-optionen%2C-reiter"> ![Die Optionen von Fileshelf mit dem Reiter Ablage](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-10-optionen.png) <figcaption>Die Optionen, Reiter „Ablage“.</figcaption></figure>## Ablage

<table class="table" id="bkmrk-optionvorgabebedeutu"> <thead> <tr><th scope="col">Option</th><th scope="col">Vorgabe</th><th scope="col">Bedeutung</th></tr> </thead> <tbody> <tr><td>Ablageordner</td><td><code>fileshelf</code></td><td>Relativ zum Joomla-Ordner oder ein absoluter Pfad. Am sichersten außerhalb des Webverzeichnisses.</td></tr> <tr><td>Erlaubte Dateitypen</td><td>pdf, zip, docx, xlsx, pptx, jpg, jpeg, png, mp3, mp4</td><td>Endungen, durch Kommas getrennt. Programme und Webseiten werden nie angenommen.</td></tr> <tr><td>Software-Pakete erlauben</td><td>Nein</td><td>Nimmt Archive mit Programmcode an, etwa Erweiterungen für Joomla, Shopware oder WordPress (siehe *Downloads anlegen und pflegen*). Nur im Backend und nur bei geschütztem Ablageordner.</td></tr> <tr><td>Größte Datei (MB)</td><td>100</td><td>0: keine eigene Grenze. Die Grenze des Servers gilt immer.</td></tr> <tr><td>Auslieferung</td><td>PHP</td><td>PHP, X-Sendfile oder X-Accel-Redirect (siehe *Ablageordner und Selbsttest*)</td></tr> </tbody></table>

## Downloads

<table class="table" id="bkmrk-optionvorgabebedeutu-1"> <thead> <tr><th scope="col">Option</th><th scope="col">Vorgabe</th><th scope="col">Bedeutung</th></tr> </thead> <tbody> <tr><td>Zugriff über Zusatzkategorien</td><td>Nur Hauptkategorie</td><td>„Strengste“: Auch die Zugriffsebenen der Zusatzkategorien müssen es erlauben.</td></tr> <tr><td>Passwort gilt für (Minuten)</td><td>120</td><td>0: bis die Browsersitzung endet.</td></tr> <tr><td>Versionen</td><td>Ja, 10</td><td>Versionsverlauf der Downloads wie bei Beiträgen.</td></tr> </tbody></table>

## Anzeige

Darstellung (Liste mit Kategoriebaum, Karten, Tabelle), Suche und Sortierung sowie welche Angaben die Listen zeigen: Dateityp und Größe, Version, Datum, Anzahl Downloads, Schlagwörter – und ob gesperrte Downloads mit Schloss erscheinen. Menüpunkte und Modul können jede Angabe abweichend wählen. **Prüfsumme** zeigt auf der Seite eines Downloads die SHA-256-Prüfsumme der Datei (Vorgabe: aus). **Kategoriebild** zeigt das Bild der Kategorie oben in der Kategorie und in der Übersicht (Vorgabe: an); **Darstellung des Kategoriebilds** stellt es neben den Text (Vorgabe, nie beschnitten) oder als Banner über die volle Breite. **Überschrift der Übersicht** und **Einleitungstext der Übersicht** stehen über den Kategorien der Download-Übersicht; ein Menüpunkt kann beide überschreiben (siehe *Downloads auf der Website*).

## Darstellung

Wie Fileshelf sich in Ihr Template einfügt (siehe *An Ihr Template anpassen*). Leer gelassen gelten Farben und Ecken des Templates.

- **Stylesheet von Fileshelf laden** – „Nein“ für Templates, die Fileshelf selbst gestalten. Dann fehlt auch die Anordnung von Rastern und Abständen.
- **Akzentfarbe** – für Schaltflächen, Kennzeichen und, wenn sie auf Weiß gut lesbar ist, Links. Die Schrift auf Schaltflächen wählt Fileshelf selbst hell oder dunkel.
- **Ecken** – wie das Template, eckig oder abgerundet.

## Integration

**IDs aus URLs entfernen** (Vorgabe: Ja) und **Felder einschalten** wie bei Beiträgen.

## Rechte

Die Rechte folgen dem Muster von Beiträgen und vererben sich von der Komponente über die Kategorie auf den Download: Anlegen, Bearbeiten, Eigene bearbeiten, Status ändern, Löschen. Dazu kommt:

- **Im Backend herunterladen** – erlaubt, eine Datei im Backend zu laden, ohne dass sie gezählt wird.
- **Statistik ansehen** – zeigt die Download-Statistik der Pro-Version (Seite, Reiter, Kachel). In der Free-Version wirkt das Recht nicht; es steht da, damit die Einstellung einen Wechsel überlebt.
- **Auf der Website hochladen** – erlaubt, über die Seite „Datei hochladen“ der Pro-Version Dateien in die Kategorie hochzuladen; sie warten auf Freigabe. Auch dieses Recht steht in der Free-Version.

Wer auf der Website herunterladen darf, bestimmen die Zugriffsebenen (und gegebenenfalls ein Passwort), nicht die Rechte. Die Werkzeuge verlangen das Recht „ACL &amp; Optionen konfigurieren“.

[English version](https://docs.graup-it.de/link/424)

# Aktionsprotokoll

Fileshelf schreibt ins Aktionsprotokoll von Joomla. Unter **Benutzer → Benutzeraktionen** sehen Sie, wer wann welchen Download angelegt, geändert, veröffentlicht oder gelöscht hat und wer ein Passwort gesetzt oder entfernt hat. Mit dem Filter **Fileshelf** blenden Sie alles andere aus.

<figure id="bkmrk-eintr%C3%A4ge-von-fileshe"> ![Benutzeraktionen, gefiltert auf Fileshelf, mit Einträgen zu Downloads und einem Import](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-38-aktionsprotokoll.png) <figcaption>Einträge von Fileshelf in den Benutzeraktionen.</figcaption></figure>## Was protokolliert wird

- Downloads anlegen, ändern, veröffentlichen, zurückziehen, in den Papierkorb legen und löschen – jeweils mit Link auf den Download.
- Passwort an einem Download oder einer Download-Kategorie gesetzt oder entfernt. Das Passwort selbst steht nie im Protokoll.
- Kategorien von Fileshelf protokolliert Joomla selbst wie alle Kategorien.
- In der Pro-Version zusätzlich: Uploads von der Website freigegeben oder abgelehnt und jeder abgeschlossene Import.

## Ein- und ausschalten

Bei der ersten Installation nimmt Fileshelf sich unter **Benutzer → Benutzeraktionen → Optionen → Erweiterungen protokollieren** auf. Nehmen Sie Fileshelf dort heraus, schreibt es nichts mehr ins Protokoll; ein späteres Update ändert diese Einstellung nicht. Wie lange Einträge aufbewahrt werden, regelt das Plugin **System - Benutzeraktionen** von Joomla.

[English version](https://docs.graup-it.de/link/454)

# Free-Version und Pro-Version

Fileshelf gibt es als **Free-Version** und als **Pro-Version**. Die Free-Version ist ein vollständiges Produkt: alles, was dieses Handbuch ohne den Zusatz „(Pro)“ beschreibt, gehört dazu. Die Pro-Version enthält die Free-Version vollständig und bringt zusätzliche Plugins mit.

## Was die Pro-Version mitbringt

- **Download-Statistik** je Tag und je Download, ohne gespeicherte IP-Adressen, mit Export.
- **Versionen und Ablaufdatum:** frühere Dateien bleiben abrufbar, Downloads können ablaufen.
- **Links und Download gegen E-Mail:** Einmal- und befristete Links, Downloads nach bestätigter Adresse.
- **Download-Limits** je Benutzergruppe, Kategorie oder Download.
- **Benachrichtigungen:** Abo neuer Versionen, Meldungen über Downloads.
- **Datenschutz:** Auskunft und Löschung über die Datenschutzanfragen von Joomla, Löschfristen.
- **Mitgliedschaften mit Membership Pro:** Downloads und Kategorien an Pläne binden, „Meine Downloads“, Willkommensmail.
- **YOOtheme Pro:** dynamische Inhalte und ein Element für Download-Listen.
- **Editor JCE:** Downloads im Link-Dialog, Shortcodes per Reiter.
- **Alle herunterladen:** alle Downloads einer Kategorie als ZIP-Archiv.
- **Hochladen auf der Website:** Uploads von Besuchern mit Prüfung und Freigabe.
- **Import:** Umstieg von Phoca Download, jDownloads, Dropfiles und den Plan-Dokumenten von Membership Pro mit Vorschau, Bericht, Weiterleitungen und neuen Kürzeln.

Jede Funktion hat in diesem Handbuch eine eigene Seite mit „(Pro)“ im Titel. Die Pro-Version legt bei der Installation drei geplante Aufgaben an (Aufbewahrung, Benachrichtigungen, Löschfristen).

## Welche Version ist installiert?

Die Fußzeile jeder Seite von Fileshelf nennt sie mit der Versionsnummer: **Fileshelf** für die Free-Version, **Fileshelf Pro** für die Pro-Version.

## Von der Free- zur Pro-Version

1. Laden Sie das Paket der Pro-Version herunter.
2. Installieren Sie es über **System → Erweiterungen installieren** – einfach über die vorhandene Free-Version. Downloads, Dateien und Einstellungen bleiben erhalten.
3. Tragen Sie unter **System → Update-Sites** bzw. bei der Erweiterung Ihren Download-Schlüssel ein, damit Updates der Pro-Version ankommen.

Die Pro-Version enthält keinen Lizenzschalter: Was installiert ist, läuft – auch nach Ablauf der Mitgliedschaft. Der Download-Schlüssel steuert nur die Updates.

## Zurück zur Free-Version

Installieren Sie das Paket der Free-Version über die Pro-Version. Die Plugins der Pro-Version bleiben dabei installiert (Joomla entfernt bei einem Paket-Update keine Teile); deinstallieren Sie sie bei Bedarf unter **System → Erweiterungen verwalten**.

[English version](https://docs.graup-it.de/link/434)

# Download-Statistik (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Die Pro-Version zählt nicht nur, wie oft eine Datei geladen wurde, sondern hält jeden Download fest: wann, welche Datei, ob sie vollständig ankam. Daraus entsteht die Statistik – ohne dass eine IP-Adresse gespeichert wird.

## Die Seite „Statistik“

Sie öffnen sie im Menü unter **Komponenten → Fileshelf → Statistik**, im Dashboard über den Schnellzugriff oder über die Kennzahl **Abrufe**.

<figure id="bkmrk-downloads-je-tag%2C-du"> ![Die Statistikseite mit Zeitraum, Summen, Balkendiagramm je Tag und den meistgeladenen Downloads](https://docs.graup-it.de/uploads/images/gallery/2026-11/ePndoku-20-statistik.png) <figcaption>Downloads je Tag, dunkel die abgeschlossenen, hell die abgebrochenen.</figcaption></figure>

- **Zeitraum:** die letzten 30, 90 oder 365 Tage – ein Klick auf den Knopf zeigt ihn sofort.
- **Summen:** Downloads, davon abgeschlossen, und der Anteil, der nicht abgeschlossen wurde – etwa weil jemand den Download abgebrochen hat.
- **Diagramm:** ein Balken je Tag. Dieselben Zahlen stehen unter *Zahlen je Tag als Tabelle zeigen* – für Screenreader und zum Abschreiben.
- **Die 20 meistgeladenen Downloads** des Zeitraums, mit Link zum Download.
- **Export als CSV** für den gewählten Zeitraum: je Tag und Download die Zahl der Downloads und der abgeschlossenen. Der Export enthält keine Benutzer und keine Adressen.

## Im Download und im Dashboard

Jeder Download hat den Reiter **Statistik** mit seinen letzten 30 Tagen. Das Dashboard zeigt die Kennzahl **Abrufe** in vier Feldern: heute, letzte 7 Tage, letzte 30 Tage und gesamt. „Gesamt“ ist die Summe der Zähler aller Downloads, also dieselbe Zahl wie bei „Beliebteste Downloads“, auch mit Zahlen aus einem Import. Unten in der Karte führt „Statistik öffnen“ hierher.

<figure id="bkmrk-der-reiter-%E2%80%9Estatisti"> ![Der Reiter Statistik eines Downloads mit Summen und Diagramm der letzten 30 Tage](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-21-statistik-reiter.png) <figcaption>Der Reiter „Statistik“ im Download.</figcaption></figure>## Was gezählt wird

- Jeder Download über die Website, auch die Vorschau. Lädt ein Programm die Datei in Teilen – setzt ein Browser einen abgebrochenen Download fort oder holt ein Download-Manager mehrere Stücke gleichzeitig –, zählt das einmal, mit dem Teil, der das Ende der Datei enthält, oder sobald die Teile zusammen die ganze Datei ergeben.
- **Abgeschlossen** heißt: die ganze Datei ist angekommen.
- Downloads im Backend zählen nicht.

## Datenschutz und Aufbewahrung

Fileshelf speichert **keine IP-Adresse**. Statt ihrer steht ein Wert, der aus der Adresse und einem Schlüssel des Tages berechnet wird; der Schlüssel wird am nächsten Tag gelöscht. Damit lassen sich Downloads eines Tages einander zuordnen (für Limits), aber nie mehr einer Adresse. Bei angemeldeten Besuchern steht der Benutzer dabei.

Die geplante Aufgabe **Fileshelf - Aufbewahrung des Download-Protokolls** fasst jede Nacht die Downloads des Vortags je Tag und Download zusammen. Die Statistik liest diese Tageswerte und rechnet nur den heutigen Tag aus den einzelnen Einträgen – so bleibt sie auch bei Millionen Downloads schnell. Lief die Aufgabe einmal nicht, rechnet die Statistik die fehlenden Tage aus den Einträgen; sie ist dann nur langsamer.

Einzelne Downloads bewahrt Fileshelf **365 Tage** auf, danach löscht die Aufgabe die einzelnen Einträge in kleinen Stapeln; die Statistik zählt sie über die Tageswerte weiter. Die Frist ändern Sie in der Aufgabe unter **System → Geplante Aufgaben**. Wird ein Download gelöscht, gehen seine Einträge mit.

## Wer die Statistik sieht

Das Recht **Statistik ansehen** in den Optionen von Fileshelf (Reiter Berechtigungen). Super User haben es immer.

[English version](https://docs.graup-it.de/link/435)

# Versionen und Ablaufdatum (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Ersetzen Sie die Datei eines Downloads, bleibt die frühere Datei als **Version** erhalten. Besucher finden sie auf der Download-Seite, mit dem, was sich geändert hat. Außerdem kann ein Download ein Ablaufdatum bekommen.

## Eine neue Version anlegen

1. Öffnen Sie den Download und laden Sie im Reiter **Datei und Beschreibung** die neue Datei hoch (oder wählen Sie eine aus dem Ablageordner).
2. Tragen Sie im Reiter **Versionen** unter „Angaben zur Datei“ die neue Versionsbezeichnung ein, z. B. 2026.2.
3. Schreiben Sie im Reiter **Versionen** unter *Änderungen in dieser Version*, was neu ist.
4. Speichern Sie.

Die frühere Datei wandert in einen Unterordner `_versions` ihres Kategorieordners und behält ihre Bezeichnung und ihren Änderungstext. Werkzeuge und Medienmanager behandeln sie als in Gebrauch.

<figure id="bkmrk-der-reiter-%E2%80%9Eversione"> ![Der Reiter Versionen mit Änderungstext, Ablaufdatum und der Liste der früheren Versionen mit Status](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-22-versionen.png) <figcaption>Der Reiter „Versionen“: Änderungen, Ablaufdatum und frühere Versionen.</figcaption></figure>## Frühere Versionen verwalten

Jede frühere Version hat eine Bezeichnung, einen Änderungstext, einen eigenen Zähler und einen Status:

- **Aktiv:** auf der Download-Seite aufgeführt und herunterladbar.
- **Archiviert:** nicht mehr aufgeführt; vorhandene Links funktionieren weiter.
- **Gesperrt:** nicht herunterladbar.

Ob Besucher frühere Versionen überhaupt laden dürfen, stellen Sie im Plugin **Fileshelf - Versionen**ein (*Frühere Versionen öffentlich*, Vorgabe: ja).

## Auf der Website

<figure id="bkmrk-unter-der-datei%3A-was"> ![Download-Seite mit dem Abschnitt Versionen: Neues in dieser Version und eine frühere Version mit Link](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-28-website-versionen.png) <figcaption>Unter der Datei: was neu ist, und die früheren Versionen.</figcaption></figure>## Ablaufdatum

Unter *Läuft ab am* im Reiter **Versionen** geben Sie einen Zeitpunkt an. Danach bleibt der Download auf der Website sichtbar, zeigt aber ein Schloss mit dem Hinweis, dass er abgelaufen ist. Im Backend können Sie die Datei weiter herunterladen. Feld leeren – und der Download ist wieder verfügbar.

Anders als *Veröffentlichung beenden* (Reiter Veröffentlichung): Dort verschwindet der Download ganz von der Website.

[English version](https://docs.graup-it.de/link/436)

# Links und Download gegen E-Mail (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Zwei Wege, eine Datei gezielt weiterzugeben: **Links**, die ohne Anmeldung und Passwort funktionieren, und **Downloads gegen E-Mail-Adresse**, bei denen Besucher die Datei erst nach Bestätigung ihrer Adresse bekommen.

## Einen Link erzeugen

1. Öffnen Sie den Download, Reiter **Weitergeben**, Abschnitt **Links**.
2. Wählen Sie unter *Neuer Link*: **Einmal** (gilt für einen vollständigen Download) oder **Gültig bis zu einem Datum** (ohne Datum 7 Tage, optional mit einer Höchstzahl an Downloads).
3. Tragen Sie bei Bedarf eine Adresse unter *Senden an* ein – Fileshelf schickt den Link per Mail – und eine Notiz für sich.
4. Speichern Sie. Der Link erscheint **einmal** in der Meldung oben; kopieren Sie ihn.

<figure id="bkmrk-der-abschnitt-%E2%80%9Elinks"> ![Der Abschnitt Links im Reiter Weitergeben mit dem Schalter für Download gegen E-Mail-Adresse, den Feldern für einen neuen Link und der Liste der Links](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-23-links-reiter.png) <figcaption>Der Abschnitt „Links“ im Reiter „Weitergeben“.</figcaption></figure>Ein Link gilt auch für Downloads, die sonst nur Registrierte sehen oder die ein Passwort haben. Er gilt nur für diesen einen Download. Ein abgebrochener Download verbraucht ihn nicht. Lädt ein Programm die Datei in Teilen (fortgesetzter Download, Download-Manager), zählt das zusammen als ein Download, sobald die Datei vollständig übertragen ist. Fileshelf speichert nur einen Fingerabdruck des Links – deshalb lässt er sich später nicht noch einmal anzeigen.

**Widerrufen:** In der Liste *Links dieses Downloads* ankreuzen und speichern. Der Link gilt sofort nicht mehr.

## Download gegen E-Mail-Adresse

Schalten Sie im Reiter **Weitergeben** unter **Links** *Nur gegen E-Mail-Adresse* ein. Dann gilt:

1. Besucher sehen statt der Schaltfläche ein Formular: E-Mail-Adresse, Name (freiwillig) und die Einwilligung zur Speicherung.
2. Sie bekommen eine Mail mit einem Bestätigungslink; er gilt 48 Stunden.
3. Nach der Bestätigung erscheint die Schaltfläche zum Download. Sie funktioniert dreimal innerhalb von 48 Stunden und gilt nur für diese Adresse. Wer die Bestätigungsmail noch einmal öffnet, bekommt denselben Link mit den restlichen Downloads, keinen neuen.

Die E-Mail-Adresse ersetzt nur diese eine Hürde. Alles andere gilt weiter: Ein Download in einer Kategorie für Registrierte bleibt Registrierten vorbehalten, ein Passwort muss erst eingegeben werden, ein Mitgliedschaftsplan oder ein Download-Limit gelten auch mit dem Link. Das Formular erscheint nur, wenn der Besucher den Download ohne diese Hürde erreichen könnte.

<figure id="bkmrk-das-formular-auf-der"> ![Download-Seite mit dem Formular: E-Mail-Adresse, Name, Einwilligung und Schaltfläche Link anfordern](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-29-website-gate.png) <figcaption>Das Formular auf der Download-Seite.</figcaption></figure>Im Plugin **Fileshelf - Links** stellen Sie ein: die Gültigkeit in Stunden, die Zahl der Downloads je Bestätigung, die Adresse Ihrer Datenschutzerklärung (sie wird in der Einwilligung verlinkt) und das Captcha. Ohne eigene Wahl gilt das Captcha der globalen Konfiguration; ist dort keines eingestellt, wählt Fileshelf bei der ersten Installation ein eingeschaltetes Captcha-Plugin aus. Gegen automatische Anfragen hilft außerdem ein unsichtbares Feld, an dieselbe Adresse geht für denselben Download höchstens alle zehn Minuten eine Mail, und von einem Besucher nimmt das Formular höchstens fünf Anfragen pro Stunde an.

## Die Seite „Links“

Im Dashboard unter **Links**: alle Links, die noch gelten, und alle bestätigten Adressen, mit Export als CSV. Weil die Seite Adressen zeigt, sehen sie nur Super User und Administratoren mit dem Recht „ACL &amp; Optionen konfigurieren“.

<figure id="bkmrk-g%C3%BCltige-links-und-be"> ![Die Seite Links mit den gültigen Links und den bestätigten Adressen](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-24-links-seite.png) <figcaption>Gültige Links und bestätigte Adressen.</figcaption></figure>Die Texte der beiden Mails bearbeiten Sie unter **System → Mailvorlagen** (Erweiterung Fileshelf - Links). Wie lange Adressen gespeichert bleiben, steht unter *Datenschutz*.

[English version](https://docs.graup-it.de/link/437)

# Download-Limits (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Mit Limits legen Sie fest, wie oft Besucher herunterladen dürfen – etwa zehn Downloads am Tag für registrierte Benutzer oder drei im Monat für eine bestimmte Datei.

<figure id="bkmrk-die-seite-%E2%80%9Elimits%E2%80%9C."> ![Die Seite Limits mit zwei Limits und den Formularen für Benutzergruppe, Kategorie und einzelnen Download](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-25-limits.png) <figcaption>Die Seite „Limits“.</figcaption></figure>## Ein Limit anlegen

Im Dashboard unter **Limits** (nur Super User und Administratoren mit dem Recht „ACL &amp; Optionen konfigurieren“). Es gibt drei Arten:

- **Benutzergruppe:** zählt alle Downloads eines Benutzers dieser Gruppe.
- **Kategorie:** zählt die Downloads dieser Kategorie – als Haupt- oder Zusatzkategorie, ohne Unterkategorien.
- **Einzelner Download:** zählt nur diesen Download (die ID steht in der Download-Liste).

Zu jedem Limit gehören die erlaubte Zahl und der Zeitraum: pro Tag, pro Woche (ab Montag), pro Monat oder insgesamt. Zeiträume folgen dem Kalender in der Zeitzone der Website.

## Wie Limits zusammenwirken

- Gehört jemand zu mehreren Benutzergruppen, gilt je Zeitraum das **großzügigste** Gruppenlimit. So bekommt eine Gruppe „Premium“ mehr als „Registered“, obwohl ihre Mitglieder auch registriert sind.
- Limits einer Kategorie oder eines Downloads gelten zusätzlich; das **strengste** gewinnt.
- Ist ein Limit erreicht, zeigt die Liste ein Schloss mit dem Zeitpunkt, ab dem es weitergeht.
- **Nicht angemeldete Besucher** lassen sich nur je Tag zählen, weil Fileshelf keine Adressen speichert. Für sie gelten deshalb nur Limits *pro Tag*.
- **Insgesamt** reicht so weit, wie das Download-Protokoll einzelne Downloads aufbewahrt (Vorgabe 365 Tage).
- Links aus dem Reiter Weitergeben (Abschnitt Links) sind nicht begrenzt.

Im Plugin **Fileshelf - Limits** wählen Sie, was zählt: nur abgeschlossene Downloads (Vorgabe) oder jeder begonnene.

[English version](https://docs.graup-it.de/link/438)

# Benachrichtigungen (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Zwei Arten von Mails: Besucher erfahren von neuen Versionen, und Sie erfahren, wie oft ein Download geladen wurde. Fileshelf verschickt beides im Hintergrund – nie, während jemand auf eine Seite wartet.

## Neue Versionen abonnieren

Angemeldete Besucher sehen auf der Download-Seite **Neue Versionen abonnieren**. Bekommt der Download eine neue Datei, erhalten sie eine Mail mit der neuen Versionsbezeichnung und einem Link zur Seite. Jede Mail enthält einen Link zum Abmelden, der ohne Anmeldung funktioniert. Wer abonniert hat, sehen Sie als Zahl im Reiter **Weitergeben**, Abschnitt **Benachrichtigungen**.

## Download-Meldungen

Im Reiter **Weitergeben** eines Downloads, Abschnitt **Benachrichtigungen**, schalten Sie *Downloads per Mail melden* ein und tragen Empfänger ein (leer: der Autor des Downloads). Statt einer Mail je Download kommt eine Sammelmail, höchstens einmal in 24 Stunden.

<figure id="bkmrk-der-abschnitt-%E2%80%9Ebenac"> ![Der Abschnitt Benachrichtigungen im Reiter Weitergeben mit Schalter, Empfängern und der Zahl der Abonnenten](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-26-benachrichtigungen.png) <figcaption>Der Abschnitt „Benachrichtigungen“ im Reiter „Weitergeben“.</figcaption></figure>Im Plugin **Fileshelf - Benachrichtigungen** stellen Sie die Drosselung in Stunden ein und optional eine Adresse, die eine Meldung über *alle* Downloads bekommt.

## Der Versand

Die geplante Aufgabe **Fileshelf - Benachrichtigungen versenden** verschickt alle 15 Minuten, was ansteht. Fileshelf legt sie bei der Installation an; Sie finden sie unter **System → Geplante Aufgaben**. Die Links in den Mails nehmen nie die Adresse einer Anfrage auf der Website – ein Besucher könnte sie fälschen. Sie kommen aus der globalen Konfiguration (*Live-Site*) oder, wenn dort nichts steht, aus der Adresse, unter der Sie Fileshelf zuletzt im Backend geöffnet haben (Fileshelf merkt sie sich dabei, auch beim Installieren).

<figure id="bkmrk-die-drei-aufgaben-de"> ![Die geplanten Aufgaben von Fileshelf: Benachrichtigungen versenden, Aufbewahrung des Download-Protokolls, Adressen nach Frist löschen](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-27-aufgaben.png) <figcaption>Die drei Aufgaben der Pro-Version.</figcaption></figure>Die Texte der Mails bearbeiten Sie unter **System → Mailvorlagen** (Erweiterung Fileshelf - Benachrichtigungen).

[English version](https://docs.graup-it.de/link/439)

# Datenschutz (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Die Pro-Version speichert einige personenbezogene Daten. Diese Seite sagt, welche, wie lange, und wie Sie Auskunfts- und Löschanfragen beantworten.

## Was gespeichert wird

<table class="table" id="bkmrk-datenwof%C3%BCrwie-lange-"> <thead> <tr><th scope="col">Daten</th><th scope="col">Wofür</th><th scope="col">Wie lange</th></tr> </thead> <tbody> <tr><td>Download-Protokoll: Zeitpunkt, Download, abgeschlossen, bei angemeldeten Besuchern der Benutzer; statt der IP-Adresse ein Wert, der nur am selben Tag zuzuordnen ist</td><td>Statistik, Limits</td><td>365 Tage einzeln, danach nur noch Zahlen je Tag ohne Personenbezug</td></tr> <tr><td>E-Mail-Adresse, Name (freiwillig), Zeitpunkt der Einwilligung bei Downloads gegen E-Mail</td><td>Bestätigung und Zusendung des Downloads</td><td>365 Tage (einstellbar)</td></tr> <tr><td>Links mit einer Adresse</td><td>Zusendung, Gültigkeit</td><td>bis 365 Tage nach Ablauf</td></tr> <tr><td>Abos neuer Versionen (Benutzer)</td><td>Benachrichtigung</td><td>bis zur Abmeldung</td></tr> </tbody></table>

Die geplante Aufgabe **Fileshelf - Adressen nach Frist löschen** löscht täglich, was älter ist als die Frist, und alles, was zu gelöschten Benutzerkonten gehört. Die Frist stellen Sie in der Aufgabe ein.

## Auskunft und Löschung

Fileshelf hängt sich an die Datenschutzanfragen von Joomla (**Benutzer → Datenschutz → Anfragen**):

- **Auskunft** enthält Download-Protokoll und Abos des Benutzerkontos sowie Anfragen, Links und Meldungsempfänger mit der Adresse – nur die Daten dieser Person.
- **Löschung** entfernt den Benutzer aus dem Protokoll (die Statistik zählt weiter) und löscht Abos, Anfragen, Links mit der Adresse und die Adresse aus den Empfängerlisten.

Dafür muss das Plugin **Datenschutz - Fileshelf** eingeschaltet sein.

## Textbausteine für Ihre Datenschutzerklärung

Ein Vorschlag, den Sie an Ihre Website anpassen – keine Rechtsberatung:

> **Downloads.** Wenn Sie eine Datei herunterladen, speichern wir Zeitpunkt, Datei und – sofern Sie angemeldet sind – Ihr Benutzerkonto, um Downloads zu zählen und gegebenenfalls Download-Limits einzuhalten. Ihre IP-Adresse speichern wir nicht; wir bilden daraus einen Wert, der sich nach Ablauf des Tages keiner Adresse mehr zuordnen lässt. Einzelne Einträge löschen wir nach 365 Tagen.
> 
> **Downloads gegen E-Mail-Adresse.** Für einige Downloads bitten wir um Ihre E-Mail-Adresse und optional Ihren Namen. Wir senden Ihnen einen Bestätigungslink und speichern Adresse, Name und Zeitpunkt Ihrer Einwilligung für 365 Tage. Rechtsgrundlage ist Ihre Einwilligung, die Sie jederzeit widerrufen können.
> 
> **Benachrichtigungen.** Wenn Sie neue Versionen abonnieren, senden wir Ihnen eine Mail, sobald eine neue Version erscheint. Sie können sich über den Link in jeder Mail abmelden.

[English version](https://docs.graup-it.de/link/440)

# Mitgliedschaften mit Membership Pro (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Mit Membership Pro verkaufen Sie Mitgliedschaften; Fileshelf bindet Downloads und Kategorien an deren **Pläne**. Mitglieder mit einem passenden aktiven Plan laden herunter, alle anderen sehen den Weg dorthin: zur Anmeldung, zum Abschluss oder zur Verlängerung. Die Anbindung ist mit Membership Pro 4.7.1 geprüft.

## Pläne zuweisen

Im Download (Reiter **Zugang**, Abschnitt **Pläne**) und in der Kategorie (Reiter **Pläne**) wählen Sie die Pläne. Einer oder mehrere sind möglich. Welche Pläne gelten:

1. die Pläne des Downloads, wenn er eigene hat;
2. sonst die Pläne der Hauptkategorie – oder der nächsten darüber, denn eine Kategorie gilt auch für ihre Unterkategorien;
3. sonst die Pläne der ersten Zusatzkategorie, die welche hat.

Ohne Pläne braucht ein Download keine Mitgliedschaft. Bei mehreren Plänen genügt einer davon; im Plugin **Fileshelf - Membership Pro** stellen Sie um auf „Alle Pläne sind nötig“.

<figure id="bkmrk-die-pl%C3%A4ne-am-downloa"> ![Der Reiter Pläne eines Downloads mit dem gewählten Plan Premium](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-30-plaene.png) <figcaption>Die Pläne am Download.</figcaption></figure>## Was Besucher sehen

- **Gäste** sehen ein Schloss mit dem Namen des Plans und kommen zur Anmeldung.
- **Mitglieder ohne den Plan** kommen zum Abschluss des Plans in Membership Pro.
- **Mitglieder, deren Plan abgelaufen ist**, kommen zur Verlängerung.

Ein Link der Pro-Version (Einmal- oder befristeter Link) öffnet einen Download auch ohne Plan – wer den Link herausgibt, entscheidet.

## Meine Downloads

Legen Sie einen Menüpunkt vom Typ **Fileshelf → Erweiterungsseite** an und wählen Sie die Seite **Meine Downloads**. Angemeldete Mitglieder sehen dort alle Downloads, die ihre Mitgliedschaft freischaltet, nach Kategorien geordnet; Gäste kommen zur Anmeldung.

<figure id="bkmrk-%E2%80%9Emeine-downloads%E2%80%9C-au"> ![Die Seite Meine Downloads mit drei Anleitungen für Mitglieder mit dem Plan Basis](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-31-meine-downloads.png) <figcaption>„Meine Downloads“ auf der Website.</figcaption></figure>## Willkommensmail

Auf Wunsch bekommt ein Mitglied eine Mail, sobald seine Mitgliedschaft aktiv wird – mit den Downloads, die sie freischaltet, und einem Link auf „Meine Downloads“. Schalten Sie dazu im Plugin **Fileshelf - Membership Pro** die *Willkommensmail* ein. Die Mails verschickt die geplante Aufgabe **Fileshelf - Benachrichtigungen versenden**; den Text bearbeiten Sie unter **System → Mailvorlagen**.

## Wenn sich Membership Pro ändert

Ist Membership Pro installiert, zeigt das Dashboard von Fileshelf eine Kachel **Membership Pro**als letzte im Schnellzugriff, mit der Version und der Zahl der Downloads und Kategorien mit Plänen. Sehen seine Tabellen nach einem Update anders aus als erwartet, bleiben Downloads mit Plänen gesperrt – nie offen – und die Kachel nennt den Grund. Ist Membership Pro neuer als die geprüfte Version, weist die Kachel darauf hin; die Pläne funktionieren weiter.

Ist Membership Pro nicht installiert oder ausgeschaltet, gibt es keine Kachel. Haben Downloads oder Kategorien noch Pläne, bleiben sie gesperrt, und das Dashboard meldet es unter **Braucht Ihre Aufmerksamkeit** mit einem Link zu den Erweiterungen. Den Reiter **Pläne** zeigt das Formular dann nur bei Einträgen, die noch Pläne haben.

[English version](https://docs.graup-it.de/link/447)

# YOOtheme Pro (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Mit YOOtheme Pro gestalten Sie Download-Bereiche im Seitenbaukasten. Fileshelf bringt dafür **dynamische Inhalte** und ein eigenes Element mit. Ohne YOOtheme Pro tut das Plugin **System - Fileshelf für YOOtheme Pro** nichts.

## Dynamische Inhalte

Wählen Sie bei einem Element unter *Dynamic Content* eine der Quellen aus der Gruppe **Fileshelf**:

- **Fileshelf-Download** – ein Download, den Sie auswählen;
- **Fileshelf-Downloads** – die Downloads einer oder mehrerer Kategorien (auch als Zusatzkategorie), wahlweise nur hervorgehobene, mit Reihenfolge und Anzahl;
- **Fileshelf-Kategorien** – die Kategorien unter einer Kategorie, mit der Zahl ihrer Downloads.

Ein Download liefert unter anderem Titel, Beschreibung, Link zur Download-Seite, **Download-Link**, Dateityp und -größe, Version, Kategorie, frühere Versionen und – für gesperrte Downloads – **Sperrtext**und den **Weg am Schloss vorbei** (Passwort, Anmeldung, Mitgliedschaft). Der Download-Link ist leer, solange der Besucher die Datei nicht laden darf; binden Sie dann den Sperrtext an ein Feld daneben. Zugriff und Sperrgründe sind dieselben wie auf den Seiten von Fileshelf.

## Das Element „Fileshelf Downloads“

Für eine fertige Liste ziehen Sie das Element **Fileshelf Downloads** auf die Seite. Es zeigt die Downloads aus Kategorien, die hervorgehobenen, die neuesten oder die meistgeladenen – als Liste, als Karten oder als Tabelle, mit Schaltfläche oder Schloss wie auf den Seiten von Fileshelf.

<figure id="bkmrk-das-element-als-tabe"> ![Eine Seite mit dem Element Fileshelf Downloads als Tabelle mit Titel, Datei, Datum und Schaltfläche](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-32-yootheme.png) <figcaption>Das Element als Tabelle.</figcaption></figure>[English version](https://docs.graup-it.de/link/448)

# Editor JCE (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Arbeiten Sie mit dem Editor JCE (ab 2.9), wählen Sie Downloads direkt im Link-Dialog aus. Das Plugin **JCE - Fileshelf-Links** ergänzt den Dialog um Fileshelf; die Schaltfläche *Fileshelf* unter dem Editor (siehe *Editor-Schaltfläche*) funktioniert in JCE ebenso.

## Einen Link einfügen

Markieren Sie im Text die Stelle oder das Wort, öffnen Sie den Link-Dialog und klappen Sie im Baum **Fileshelf** auf. Unter den Kategorien stehen die Downloads; ein Klick übernimmt den Link. Er führt immer über Fileshelf – mit Zähler und Zugriffsprüfung –, nie direkt auf die Datei. Sie sehen nur Kategorien und Downloads, die Sie selbst sehen dürfen.

<figure id="bkmrk-der-fileshelf-baum-i"> ![Der Link-Dialog von JCE mit aufgeklapptem Fileshelf-Baum und der gewählten Preisliste](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-33-jce-link.png) <figcaption>Der Fileshelf-Baum im Link-Dialog.</figcaption></figure>## Als Shortcode einfügen

Statt eines einfachen Links fügt der Reiter **Fileshelf** einen Shortcode ein: Wählen Sie im Reiter *Link* einen Download oder eine Kategorie, wechseln Sie zum Reiter *Fileshelf* und wählen Sie die Form – für einen Download Link mit Dateiangaben, Schaltfläche oder Anzahl der Downloads, für eine Kategorie Liste oder Karten. **Einfügen** setzt den Shortcode in den Text; Fileshelf zeigt ihn mit aktueller Datei, Größe und Schloss (siehe *Shortcodes in Beiträgen*).

<figure id="bkmrk-der-reiter-%E2%80%9Efileshel"> ![Der Reiter Fileshelf im Link-Dialog mit der Auswahl Link mit Dateiangaben, Schaltfläche oder Anzahl](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-34-jce-reiter.png) <figcaption>Der Reiter „Fileshelf“.</figcaption></figure>[English version](https://docs.graup-it.de/link/449)

# Alle herunterladen (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Über der Liste einer Kategorie mit mindestens zwei Downloads steht die Schaltfläche **Alle herunterladen (ZIP)**. Besucher erhalten damit alle Downloads der Kategorie in einem ZIP-Archiv.

<figure id="bkmrk-die-schaltfl%C3%A4che-%C3%BCbe"> ![Die Kategorie Formulare mit der Schaltfläche Alle herunterladen (ZIP) über der Liste](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-35-alle-herunterladen.png) <figcaption>Die Schaltfläche über der Liste.</figcaption></figure>## Was ins Archiv kommt

Jede Datei wird geprüft wie ein einzelner Download: Zugriffsebene, Passwort, Mitgliedschaft, Limits. Sie wird gezählt und in der Statistik geführt. Was der Besucher nicht laden darf, fehlt im Archiv; die Datei **LIESMICH.txt** im Archiv nennt diese Downloads mit dem Grund. Gilt ein Limit, zählt jede Datei des Archivs mit – ein Archiv kann ein Limit also nicht umgehen.

## Grenzen

Im Plugin **Fileshelf - Alle herunterladen** stellen Sie ein, wie viele Dateien (Vorgabe 100) und wie viele Megabyte (Vorgabe 500) ein Archiv höchstens enthält; was nicht mehr passt, nennt die Liesmich-Datei. Dort blenden Sie die Schaltfläche auch aus. Das Archiv entsteht beim Senden und belegt keinen Platz auf dem Server.

[English version](https://docs.graup-it.de/link/450)

# Hochladen auf der Website (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Angemeldete Besucher laden Dateien auf der Website hoch, zum Beispiel Händler ihre Unterlagen. Jeder Upload wartet unveröffentlicht, bis Sie ihn geprüft und freigegeben haben.

## Einrichten

1. Geben Sie in der Kategorie (Reiter *Berechtigungen*) oder unter **Optionen → Berechtigungen** den passenden Benutzergruppen das Recht **Auf der Website hochladen**.
2. Legen Sie einen Menüpunkt vom Typ **Fileshelf → Erweiterungsseite** an und wählen Sie die Seite **Datei hochladen**.

Das Formular bietet nur Kategorien an, in die der Besucher hochladen darf. Wer das Recht nirgends hat, sieht einen Hinweis statt des Formulars; Gäste kommen zur Anmeldung.

<figure id="bkmrk-das-formular-auf-der"> ![Das Formular Datei hochladen mit Titel, Kategorie, Beschreibung und Datei](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-37-hochladen.png) <figcaption>Das Formular auf der Website.</figcaption></figure>## Was geprüft wird

Jede Datei durchläuft dieselben Prüfungen wie im Backend: erlaubte Dateitypen, keine ausführbaren Inhalte, die Prüfungen von Joomla. Bilder (JPG, PNG, GIF, WebP) speichert Fileshelf neu, damit nur das Bild selbst bleibt. Im Plugin **Fileshelf - Auf der Website hochladen** legen Sie die größte Datei (Vorgabe 20 MB) und die Zahl der Uploads je Benutzer und Stunde (Vorgabe 5) fest.

## Prüfen und freigeben

Bis zur Freigabe liegt die Datei im Ordner `_quarantine` des Ablageordners; Fileshelf liefert sie dort nie aus, auch nicht, wenn jemand den Download von Hand veröffentlicht. Die wartenden Uploads finden Sie im Dashboard unter **Uploads freigeben** (Recht „Status bearbeiten“). Wem dieses Recht in einer Kategorie verweigert ist, der sieht deren Uploads dort nicht und kann sie nicht freigeben. Die Seite nennt zu jeder Datei Typ, Größe und Ordner; Sie sehen die Datei an und entscheiden:

- **Freigeben** verschiebt die Datei in den Ordner ihrer Kategorie und veröffentlicht den Download.
- **Ablehnen** löscht Download und Datei – erst nach dem Häkchen *Löschen*.

Wartet nichts, sagt die Seite, ob das Hochladen überhaupt eingerichtet ist, und verlinkt, was fehlt: den Menüpunkt zur Seite „Datei hochladen“ oder eine Benutzergruppe mit dem Recht „Auf der Website hochladen“.

<figure id="bkmrk-die-seite-%E2%80%9Euploads-f"> ![Die Seite Uploads freigeben mit Herkunft und Ablageort der Dateien und dem Hinweis, was noch fehlt](https://docs.graup-it.de/uploads/images/gallery/2026-11/Zo2doku-36-uploads-pruefen.png) <figcaption>Die Seite „Uploads freigeben“: Wartet nichts, nennt sie, was zum Hochladen noch fehlt.</figcaption></figure>Tragen Sie im Plugin Adressen unter *Über neue Uploads informieren* ein, bekommen diese eine Mail zu jedem neuen Upload. Die Mails verschickt die geplante Aufgabe **Fileshelf - Benachrichtigungen versenden**.

## Mehrere Dateien auf einmal im Backend

Im Dashboard unter **Mehrere Dateien hochladen** (Recht „Erstellen“) wählen Sie viele Dateien auf einmal aus oder ziehen sie auf das Feld. Jede Datei wird ein eigener Download mit den gemeinsamen Einstellungen der Seite: Kategorie, Zusatzkategorien, Status, Zugriffsebene und Schlagwörter. Titel und Alias kommen aus dem Dateinamen („Preisliste\_2026.pdf“ wird „Preisliste 2026“); gibt es den Alias in der Kategorie schon, hängt Fileshelf eine Zahl an.

Die Dateien gehen nacheinander auf den Server, deshalb gilt die Größengrenze je Datei. Jede Datei wird geprüft wie beim einzelnen Hochladen. Am Ende steht zu jeder Datei, ob ihr Download angelegt wurde (mit Link) oder warum sie abgelehnt wurde; eine abgelehnte Datei hinterlässt nichts. Ohne JavaScript schickt die Seite alle Dateien auf einmal und meldet das Ergebnis gesammelt.

<figure id="bkmrk-%E2%80%9Emehrere-dateien-hoc"> ![Die Seite Mehrere Dateien hochladen mit den gemeinsamen Einstellungen und dem Ergebnis je Datei](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-41-mehrere-dateien.png) <figcaption>„Mehrere Dateien hochladen“: links die gemeinsamen Einstellungen, rechts das Ergebnis je Datei.</figcaption></figure>[English version](https://docs.graup-it.de/link/451)

# Umstieg von anderen Download-Erweiterungen (Pro)

<div class="callout info" id="bkmrk-pro-version.-diese-f">**Pro-Version.** Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter *Free-Version und Pro-Version*.

</div>Die Seite **Fileshelf → Import** übernimmt Kategorien, Downloads, Dateien und Download-Zähler aus einer anderen Download-Erweiterung derselben Website. Die alte Erweiterung bleibt unverändert und lauffähig: Fileshelf liest nur, Dateien werden kopiert. Die Seite sehen Super User.

<table class="table" id="bkmrk-quellewas-%C3%BCbernommen"> <thead><tr><th>Quelle</th><th>Was übernommen wird</th></tr></thead> <tbody> <tr><td>Phoca Download 6</td><td>Kategorien mit Bild, Downloads, Zähler, Version, Tags, Lizenz</td></tr> <tr><td>jDownloads 4</td><td>Kategorien, Downloads, Zähler, Version, Tags, Lizenz, Passwörter; auf Wunsch wird dieselbe Datei in mehreren Kategorien zu einem Download zusammengefasst</td></tr> <tr><td>Dropfiles 6</td><td>Kategorien mit Bild, Dateien, Zähler, Version, Tags, Mehrfachkategorien</td></tr> <tr><td>Membership Pro</td><td>Die Dokumente der Pläne, gebunden an ihre Pläne (siehe *Mitgliedschaften mit Membership Pro*)</td></tr> </tbody></table>

Ist eine Quelle nicht installiert oder weichen ihre Tabellen von der bekannten Version ab, nennt die Seite den Grund und importiert nichts.

## So läuft ein Import

1. Wählen Sie bei der Quelle **Vorschau und Import**. Die Vorschau zeigt den Kategoriebaum und die ersten Downloads mit dem, was mit ihnen geschehen wird – noch ist nichts geändert.
2. Wählen Sie, wohin die Kategorien kommen: 
    - **Neue Kategorie „Import aus …“** (Vorgabe): Sie hält den Import zusammen und bleibt unveröffentlicht, bis Sie ihn geprüft haben.
    - **Struktur 1:1 übernehmen (oberste Ebene):** Die obersten Kategorien der Quelle stehen in Fileshelf auf der obersten Ebene, der Baum bleibt wie in der Quelle. Sie entstehen unveröffentlicht. Gibt es dort schon eine Kategorie mit derselben Adresse, bekommt die neue ein „-2“ angehängt.
    - **Unter einer vorhandenen Kategorie:** Die obersten Kategorien der Quelle kommen unter die gewählte Kategorie.
3. Wählen Sie, was übernommen wird. Angehakt ist zunächst alles. Eine Kategorie nimmt ihre Unterkategorien und Downloads mit; unter **Downloads einzeln wählen** lassen sich einzelne Downloads abwählen. Ist nur eine Unterkategorie gewählt, kommt ihre Elternkategorie leer mit, damit der Baum stimmt. Ein späterer Import ergänzt, was noch fehlt, und legt nichts doppelt an.
4. Lassen Sie **Download-Zähler übernehmen** angehakt, wenn die Zahlen weiterlaufen sollen.
5. **Import starten.** Der Import läuft Schritt für Schritt; lassen Sie die Seite offen, bis der Bericht erscheint. Abbrechen ist jederzeit möglich, ein neuer Start setzt fort.

<figure id="bkmrk-die-vorschau-vor-dem"> ![Vorschau des Imports aus Phoca Download mit Kategoriebaum, ersten Downloads und Optionen](https://docs.graup-it.de/uploads/images/gallery/2026-11/5ysdoku-39-import-vorschau.png) <figcaption>Die Vorschau vor dem Import.</figcaption></figure>Ein Import lässt sich wiederholen: Was schon übernommen ist, wird übersprungen; wurde ein übernommener Download inzwischen gelöscht, kommt er wieder.

## Was nicht übernommen wird

- **Dateien, die Fileshelf nicht annimmt:** Jede Datei wird geprüft wie ein Upload (erlaubte Dateitypen, Größe, Inhalt). Abgelehnte Dateien stehen mit Grund im Bericht; passen Sie bei Bedarf die Optionen an und starten Sie den Import erneut.
- **Dateien außerhalb der Website:** Links, Dateien in einer Cloud (Google Drive, Dropbox, OneDrive). Fileshelf liefert nur eigene Dateien aus.
- **Passwörter, die nur verschlüsselt vorliegen:** Solche Downloads und Kategorien kommen unveröffentlicht an; setzen Sie ein neues Passwort und veröffentlichen Sie sie.
- **Einzelne Download-Protokolle:** Übernommen wird nur der Zähler.

Zugriffsebenen, die es auf dieser Website nicht gibt, werden zu „Spezial“. Lizenztexte stehen im Feld **Lizenz**, das der Import einmal anlegt.

## Der Bericht

Der Bericht nennt, was übernommen und was übersprungen wurde, und führt durch die nächsten Schritte.

<figure id="bkmrk-der-bericht-mit-nach"> ![Bericht des Imports mit Zahlen, Nachlauf und Checkliste](https://docs.graup-it.de/uploads/images/gallery/2026-11/doku-40-import-bericht.png) <figcaption>Der Bericht mit Nachlauf und Checkliste.</figcaption></figure>

- **Import veröffentlichen:** Die Schaltfläche veröffentlicht die Import-Kategorie und jede Kategorie, die in der Quelle veröffentlicht ist. Sie bleibt da, solange noch eine dieser Kategorien unveröffentlicht ist; so lässt sich ein unterbrochenes Veröffentlichen vollenden.
- **Kürzel ersetzen:** Beiträge und Module „Eigener Inhalt“ mit Kürzeln der alten Erweiterung bekommen die Kürzel von Fileshelf. Beiträge behalten die alte Fassung in ihren Versionen. Was sich nicht ersetzen lässt, steht in der Spalte „Von Hand“.
- **Weiterleitungen:** Alte Adressen von Downloads und Kategorien leiten auf die neuen um. Ein alter Download-Link führt direkt zur Datei, wie bei der alten Erweiterung; Zugriffsebene, Passwort und Limits gelten wie bei jedem Download. Das gilt auch für Menüpunkte, die Sie auf Fileshelf umgestellt haben, und nachdem die alte Erweiterung deinstalliert ist, solange das Plugin „Fileshelf - Import“ eingeschaltet bleibt. Zusätzlich legt **Import veröffentlichen** Weiterleitungen in Joomla an; dafür muss das Plugin „System – Weiterleitung“ eingeschaltet sein. Fehlen noch welche, zeigt die Übersicht des Imports **Offene Weiterleitungen** mit einer Schaltfläche zum Anlegen.
- **Menüpunkte umstellen:** Menüpunkte der alten Erweiterung zeigen danach die passende Seite von Fileshelf.

Deinstallieren Sie die alte Erweiterung erst, wenn Sie den Bericht geprüft haben.

Der Import und die Nachbereitung ändern auch Beiträge, Module und Menüpunkte. Fileshelf verlangt dafür das Recht, Fileshelf zu konfigurieren (Super User oder „ACL &amp; Optionen konfigurieren“), nicht die Rechte der Beiträge oder Menüs – geben Sie den Import deshalb nur Personen, die das Gesamtbild der Website kennen. Kategoriebilder übernimmt Fileshelf nur als Bilddatei (jpg, png, gif, webp).

[English version](https://docs.graup-it.de/link/455)

# Für Entwickler: Ereignisse

Fileshelf lässt sich mit eigenen Plugins erweitern – genau so, wie es die Pro-Version tut. Alle Plugins der Gruppe `fileshelf` lädt Fileshelf, bevor es seine Ereignisse feuert. Die Klassen liegen in `Graup\Component\Fileshelf\Administrator\Event`.

<div class="callout info" id="bkmrk-die-ereignisse-sind-">Die Ereignisse sind die öffentliche Schnittstelle von Fileshelf. Name, Argumente und öffentliche Methoden ändern sich nur mit einer neuen Hauptversion.

</div>## Die Ereignisse

<table class="table" id="bkmrk-ereignisklassewannwa"> <thead> <tr><th scope="col">Ereignis</th><th scope="col">Klasse</th><th scope="col">Wann</th><th scope="col">Was ein Plugin tun kann</th></tr> </thead> <tbody> <tr><td><code>onFileshelfResolveToken</code></td><td><code>ResolveTokenEvent</code></td><td>Die Anfrage trägt einen Token (<code>t</code>).</td><td><code>grant&#40;&#41;</code> überspringt Zugriffsebene und Passwort, <code>reject&#40;&#41;</code> sperrt mit Grund <code>token</code>.</td></tr> <tr><td><code>onFileshelfAccess</code></td><td><code>AccessEvent</code></td><td>Nach Status, Token, Zugriffsebene und Passwort; auch in Listen (Kontext <code>list</code>).</td><td><code>deny&#40;&#36;reason&#44; &#36;message&#44; &#36;redirect&#41;</code> sperrt. In Listen nichts zählen oder schreiben.</td></tr> <tr><td><code>onFileshelfBeforeSend</code></td><td><code>BeforeSendEvent</code></td><td>Zugriff erteilt, vor dem Zähler.</td><td><code>setFile&#40;&#41;</code> tauscht die Datei; Fileshelf prüft sie danach erneut gegen die Ablage.</td></tr> <tr><td><code>onFileshelfAfterCount</code></td><td><code>AfterCountEvent</code></td><td>Nach dem Hochzählen, vor dem ersten Byte.</td><td>Nur Meldung; <code>getRequestId&#40;&#41;</code> verbindet mit dem nächsten Ereignis.</td></tr> <tr><td><code>onFileshelfAfterSend</code></td><td><code>AfterSendEvent</code></td><td>Nach dem Senden, auch bei Abbruch.</td><td><code>isCompleted&#40;&#41;</code>, <code>getBytesSent&#40;&#41;</code>, <code>getMethod&#40;&#41;</code>.</td></tr> <tr><td><code>onFileshelfDownloadDisplay</code></td><td><code>DownloadDisplayEvent</code></td><td>Detailseite, je Position.</td><td><code>addHtml&#40;&#41;</code> mit fertig maskiertem HTML.</td></tr> <tr><td><code>onFileshelfDashboard</code></td><td><code>DashboardEvent</code></td><td>Dashboard im Backend.</td><td><code>addTile&#40;&#36;id&#44; &#36;title&#44; &#36;html&#44; &#36;order&#44; &#36;area&#41;</code> (<code>&#36;area</code>: <code>status</code>, <code>content</code>, <code>insight</code> oder <code>setup</code>); ab 1.8.0 <code>addAttention&#40;&#36;id&#44; &#36;text&#44; &#36;link&#44; &#36;count&#44; &#36;label&#41;</code> für „Braucht Ihre Aufmerksamkeit“, nur bei Handlungsbedarf mit Ausweg; eigenes Recht vorher prüfen.</td></tr> <tr><td><code>onFileshelfAdminPages</code></td><td><code>AdminPagesEvent</code></td><td>Dashboard und jede Plugin-Seite.</td><td><code>addPage&#40;&#36;name&#44; &#36;title&#44; &#36;right&#44; &#36;icon&#41;</code> meldet eine Seite <code>view&#61;page&#38;page&#61;…</code> an; Fileshelf prüft das Recht.</td></tr> <tr><td><code>onFileshelfAdminPage</code></td><td><code>AdminPageEvent</code></td><td>Die Plugin-Seite wird angezeigt.</td><td><code>addHtml&#40;&#41;</code>, <code>addAction&#40;&#36;action&#44; &#36;label&#44; &#36;icon&#44; &#36;confirm&#41;</code>.</td></tr> <tr><td><code>onFileshelfAdminAction</code></td><td><code>AdminActionEvent</code></td><td>Eine Aktion der Seite läuft; Token, Recht und Bestätigung sind geprüft.</td><td><code>handled&#40;&#36;message&#44; &#36;type&#41;</code>.</td></tr> <tr><td><code>onFileshelfFilesInUse</code></td><td><code>FilesInUseEvent</code></td><td>Werkzeuge, Download-Formular und Medienmanager fragen, welche Dateien der Ablage Plugins gehören.</td><td><code>claim&#40;&#36;path&#41;</code> für eigene Dateien (z. B. ältere Versionen); sie gelten nie als verwaist.</td></tr> <tr><td><code>onFileshelfSitePages</code></td><td><code>SitePagesEvent</code></td><td>Menüpunkt „Erweiterungsseite“ und jeder Aufruf einer solchen Seite.</td><td><code>addPage&#40;&#36;name&#44; &#36;title&#44; &#36;login&#41;</code> meldet eine Seite der Website an; mit <code>&#36;login</code> leitet Fileshelf Gäste zur Anmeldung.</td></tr> <tr><td><code>onFileshelfSitePage</code></td><td><code>SitePageEvent</code></td><td>Die Seite wird angezeigt.</td><td><code>addHtml&#40;&#41;</code> mit fertig maskiertem HTML, <code>setTitle&#40;&#41;</code>, <code>getOptions&#40;&#41;</code> (Menüpunkt).</td></tr> <tr><td><code>onFileshelfSiteAction</code></td><td><code>SiteActionEvent</code></td><td>Ein Formular der Seite wurde abgeschickt; Token, Seite und Anmeldung sind geprüft.</td><td><code>handled&#40;&#36;message&#44; &#36;type&#44; &#36;redirect&#41;</code>; Fileshelf maskiert die Meldung.</td></tr> <tr><td><code>onFileshelfCategoryDisplay</code></td><td><code>CategoryDisplayEvent</code></td><td>Kategorieseite, Positionen <code>beforeList</code> und <code>afterList</code>.</td><td><code>addHtml&#40;&#41;</code> mit fertig maskiertem HTML; <code>getTotal&#40;&#41;</code> nennt die Zahl der gelisteten Downloads.</td></tr> <tr><td><code>onFileshelfActionLog</code></td><td><code>ActionLogEvent</code></td><td>Seit 1.3.0: Fileshelf oder ein Plugin meldet eine Aktion fürs Aktionsprotokoll (Passwort, Freigabe, Import).</td><td>Reine Meldung: <code>getAction&#40;&#41;</code>, <code>getKind&#40;&#41;</code> (<code>download</code>, <code>category</code>, <code>import</code>), <code>getItemId&#40;&#41;</code>, <code>getTitle&#40;&#41;</code>, <code>getDetails&#40;&#41;</code>. Das Plugin „Aktionsprotokoll - Fileshelf“ schreibt sie.</td></tr> <tr><td><code>onFileshelfImportSources</code></td><td><code>ImportSourcesEvent</code> (Pro)</td><td>Seit 1.3.0: Die Seite „Import“ sammelt ihre Quellen.</td><td><code>addSource&#40;&#41;</code> mit einer Klasse, die <code>SourceInterface</code> des Import-Plugins erfüllt (Kategorien, Downloads, Prüfung der Tabellen).</td></tr> <tr><td><code>onFileshelfResolveScopes</code></td><td><code>ResolveScopesEvent</code></td><td>Von der Pro-Version (Limits) gefeuert, sobald ein Limit einen Scope-Typ eines anderen Plugins nutzt; die Free-Version feuert es nicht.</td><td><code>addScope&#40;&#36;type&#44; &#36;id&#41;</code>.</td></tr> </tbody></table>

Der Download kommt als schreibgeschütztes `DownloadRecord` (ohne Passwort-Hash), nie als Table-Objekt. Eigene Sperrgründe beginnen mit `x-<plugin>-`; die Website zeigt dann nur die Nachricht.

## Beispiel

```
final class Example extends CMSPlugin implements SubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return ['onFileshelfAccess' => 'onAccess'];
    }

    public function onAccess(AccessEvent $event): void
    {
        if ($event->getContext() !== 'list' && !$this->allowed($event->getUser())) {
            $event->deny('x-example-hours', 'Downloads sind nur werktags möglich.');
        }
    }
}
```

Formular-Reiter am Download fügen Plugins wie bei Beiträgen mit `onContentPrepareForm` (Formular `com_fileshelf.download`) ein und speichern sie in `onContentAfterSave` (Kontext `com_fileshelf.download`).

## Seiten auf der Website

Mit dem Menüpunkttyp **Fileshelf → Erweiterungsseite** bekommt ein Plugin eine eigene Seite auf der Website, ohne eigene Komponente. Formulare dieser Seite schicken `task=extension.action`, `page`, `action` und das Formular-Token an `Route::_('index.php?option=com_fileshelf')` – die Adresse immer über `Route::_()` bauen, eine relative Adresse stimmt unter suchmaschinenfreundlichen URLs nicht. Reiter am Kategorieformular hängen Plugins mit `onContentPrepareForm` an das Formular `com_categories.categorycom_fileshelf`; Fileshelf lädt die Gruppe `fileshelf` dafür.

[English version](https://docs.graup-it.de/link/441)

# Änderungsprotokoll

Dieses Änderungsprotokoll listet alle veröffentlichten Versionen von Fileshelf, die neueste zuerst.

<div class="callout info" id="bkmrk-diese-seite-wird-bei">Diese Seite wird beim Release automatisch aus der Änderungsdatei des Produkts erzeugt. Änderungen von Hand gehen beim nächsten Abgleich verloren.

</div>## Version 1.10.1 – 12.11.2026

### Geändert

- Die Karte „Membership Pro“ steht im Dashboard jetzt als letzte Kachel im Schnellzugriff.

### Behoben

- Mit „Software-Pakete erlauben“ werden Erweiterungen wieder angenommen, auch nachdem die Optionen gespeichert wurden.

## Version 1.10.0 – 12.11.2026

### Hinzugefügt

- Erweiterungen für Joomla, Shopware und Co. lassen sich als Download anbieten: Schalten Sie in den Optionen „Software-Pakete erlauben“ ein. Programme wie .exe bleiben gesperrt.
- Über den Kategorien der Download-Übersicht stehen auf Wunsch eine eigene Überschrift und ein Einleitungstext, einstellbar in den Optionen und je Menüpunkt.

### Geändert

- Das Dashboard ist aufgeräumter: Die Abrufe zeigen heute, 7 Tage, 30 Tage und gesamt, die Plugins stehen unten zweispaltig.

### Behoben

- Der Browser-Seitentitel eines Menüpunkts wird jetzt übernommen, und der Name der Website erscheint im Titel, wenn Joomla so eingestellt ist.

## Version 1.9.0 – 12.11.2026

### Hinzugefügt

- Das Dashboard zeigt „Braucht Ihre Aufmerksamkeit“ nur noch, wenn etwas zu tun ist, und hebt es hervor. Neu: eine Begrüßung, die beliebtesten Downloads und der Zustand der Plugins.
- Das Kategoriebild wird nicht mehr beschnitten: Es steht neben Titel und Beschreibung, wahlweise als Banner. Die Kategorienübersicht zeigt Beschreibung und Bild der gewählten Kategorie.

### Geändert

- Die Seiten der Website sind sauber gegliedert: eine Hauptüberschrift, darunter die Abschnitte „Unterkategorien“ und „Downloads“. Das hilft Screenreadern und Suchmaschinen.

### Behoben

- Das Dashboard öffnet auch mit MariaDB und vielen tausend Downloads schnell.

### Hinweise

- Haben Sie die Kategorieansicht im Template angepasst (Overrides), übernehmen Sie die neuen Abschnitte; das Handbuch nennt die Dateien unter „An Ihr Template anpassen“.

## Version 1.8.1 – 12.11.2026

### Behoben

- Die Listen „Neueste Downloads“ und „Am häufigsten heruntergeladen“ erscheinen auch bei vielen tausend Downloads ohne Verzögerung.

## Version 1.8.0 – 11.11.2026

### Hinzugefügt

- Der Import kann die Struktur 1:1 auf die oberste Ebene übernehmen, und vor dem Start lassen sich einzelne Kategorien und Downloads auswählen.
- Neue Kategorienübersicht als Kacheln oder kompakte Liste; die eigene Seite je Download lässt sich abschalten, dann führt der Titel direkt zur Datei.
- Übersichtlicheres Dashboard: Karten mit Kopf, die Karte „Ablageordner“ erklärt Ort und Zweck, und „Membership Pro“ erscheint nur, wenn es installiert ist.

### Behoben

- Der Import ist verlässlicher: „Import veröffentlichen“ bricht nicht mehr ab, und alte Download-Links aus Phoca Download und jDownloads führen danach direkt zur Datei.
- Im Backend steht „Optionen“ wieder neben „Hilfe“, Titel in der Download-Liste brechen nur zwischen Wörtern um, und unter PHP 8.5 erscheint keine Warnung mehr.

## Version 1.7.0 – 11.11.2026

### Hinzugefügt

- Neue Optionen unter „Darstellung“: Akzentfarbe, Ecken und ob Fileshelf sein eigenes Stylesheet lädt.

### Geändert

- Downloads passen sich besser an jedes Template an, auch an dunkle Bereiche und schmale Spalten wie Seitenleisten.
- Die Seite eines Downloads ist neu geordnet: Datei und Knopf in einem Kasten neben der Beschreibung.

## Version 1.6.0 – 11.11.2026

### Hinzugefügt

- Jede Seite im Backend hat einen Knopf „Hilfe“, der das Handbuch in Ihrer Sprache öffnet.

### Geändert

- Neues Dashboard: Kennzahlen auf einen Blick, was Ihre Aufmerksamkeit braucht, Schnellzugriff und die zuletzt geänderten Downloads.
- Die Downloads-Liste zeigt Dateityp und Größe, hebt Downloads ohne Datei hervor und hat Schnellfilter.
- Das Formular eines Downloads ist übersichtlicher: die Datei vorn, weniger Reiter.
- Die Werkzeuge sind nach Aufgaben geordnet; was sich nicht rückgängig machen lässt, fragt vorher in einem Dialog nach.

## Version 1.5.1 – 11.11.2026

### Behoben

- Pro-Version: Korrigiert: Ein Download ließ sich in seltenen Fällen nicht löschen, wenn die Statistik ihn schon zusammengefasst hatte.

## Version 1.5.0 – 11.11.2026

### Sicherheit

- Listen zeigen keine Downloads mehr aus Kategorien, deren übergeordnete Kategorie unveröffentlicht oder Besuchern verschlossen ist – auch nicht als Titel.
- Pro-Version: Einmal-Links und Download-Limits zählen Downloads in mehreren Teilen genau einmal; der Link gegen E-Mail-Adresse ersetzt nur noch diese eine Hürde.
- Falsche Passwörter werden auf dem Server gezählt: Ein neues Browserfenster umgeht die Wartezeit nicht mehr, viele Fehlversuche sperren das Passwort kurz für alle.
- Uploads und Formular prüfen jedes Recht; Mails verlinken immer die echte Adresse der Website, nie eine von einem Besucher gefälschte.

### Geändert

- Große Bestände bleiben schnell: Kategorieseiten, Listen, Statistik und das Download-Formular laden auch bei Zehntausenden Downloads zügig.

## Version 1.4.0 – 10.11.2026

### Hinzugefügt

- Pro-Version: viele Dateien auf einmal hochladen, je Datei ein Download; „Uploads prüfen“ heißt jetzt „Uploads freigeben“ und erklärt, woher die Dateien kommen.
- Kategorien auf der Website wahlweise mit Kategoriebaum, als Karten oder als sortierbare Tabelle, dazu Suche, Sortierung, Filter nach Dateityp und ein Pfad zurück.
- Unter Werkzeuge legen Sie mit einem Klick Demodaten samt Menüpunkten an, um Fileshelf auf Ihrer Website auszuprobieren, und löschen sie ebenso wieder.

### Geändert

- Neues Dashboard: oben Ablageordner und Bestand, darunter nach Aufgaben geordnet; jede Seite hat oben „Dashboard“ und „Optionen“ und unten die installierte Version.

### Behoben

- Korrigiert: „Herunterladen“ und das Entsperren mit Passwort funktionieren wieder auf Kategorienseiten; „Version“ und „Lizenz“ stehen bei den Dateiangaben, die Lizenz in Ihrer Sprache.

## Version 1.3.0 – 10.11.2026

### Hinzugefügt

- Fileshelf schreibt ins Aktionsprotokoll von Joomla: wer Downloads anlegt, ändert, veröffentlicht oder löscht und wer Passwörter setzt oder entfernt.
- Pro-Version: Neuer Import übernimmt Kategorien, Downloads, Dateien und Zähler aus Phoca Download, jDownloads und Dropfiles sowie Plan-Dokumente von Membership Pro.
- Pro-Version: Nach dem Import ersetzt Fileshelf auf Wunsch die alten Kürzel in Beiträgen, legt Weiterleitungen für alte Adressen an und stellt Menüpunkte um.

## Version 1.2.0 – 10.11.2026

### Hinzugefügt

- Neuer Menüpunkttyp „Erweiterungsseite“: Erweiterungen für Fileshelf können eigene Seiten auf der Website anbieten, auf Wunsch nur für angemeldete Besucher.
- Pro-Version: Downloads und Kategorien lassen sich an Pläne von Membership Pro binden. Mitglieder finden ihre Downloads unter „Meine Downloads“, auf Wunsch mit Willkommensmail.
- Pro-Version: Downloads im Seitenbaukasten von YOOtheme Pro (dynamische Inhalte, Element für Download-Listen) und im Link-Dialog des Editors JCE, dort auch als Shortcode.
- Pro-Version: „Alle herunterladen“ lädt alle Downloads einer Kategorie als ZIP-Archiv; was nicht erlaubt ist, nennt eine Liesmich-Datei im Archiv.
- Pro-Version: Berechtigte laden auf der Website Dateien hoch; sie erscheinen erst, wenn Sie sie unter „Uploads prüfen“ freigeben.

## Version 1.1.0 – 10.11.2026

### Hinzugefügt

- Neu: die Pro-Version. Sie zeigt eine Download-Statistik je Tag und je Download mit Export – ohne IP-Adressen zu speichern. Das Dashboard nennt die installierte Version.
- Pro-Version: Ersetzen Sie eine Datei, bleibt die frühere als Version mit Änderungstext abrufbar; Downloads können ein Ablaufdatum bekommen und bleiben danach mit Schloss sichtbar.
- Pro-Version: Download-Links, die einmal oder bis zu einem Datum gelten, und Downloads, die Besucher erst nach Bestätigung ihrer E-Mail-Adresse erhalten.
- Pro-Version: Download-Limits je Benutzergruppe, Kategorie oder Download – pro Tag, Woche, Monat oder insgesamt; die Liste nennt, ab wann es weitergeht.
- Pro-Version: Abo neuer Versionen und Meldungen über Downloads per Mail; Datenschutzanfragen in Joomla umfassen die Daten von Fileshelf, Adressen werden nach Frist gelöscht.

## Version 1.0.0 – 09.11.2026

### Hinzugefügt

- Initiales Release.

[English version](https://docs.graup-it.de/link/425)