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.

Die Liste der Downloads im Backend mit Version, Zugriffsebene und Zähler
Die Liste der Downloads: Titel, Kategorien, Version, Zugriffsebene und wie oft jede Datei heruntergeladen wurde.

Was Fileshelf für Sie tut

Die Bestandteile

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

BestandteilAufgabe
Komponente FileshelfDownloads, Ablage, Website-Ansichten, Werkzeuge
System - FileshelfKategoriepasswort, Schutz vor dem Löschen belegter Kategorien
Inhalt - FileshelfShortcodes in Beiträgen und Modulen
Schaltfläche - FileshelfSchaltfläche „Download“ im Editor
Suchindex - FileshelfDownloads in der Suche der Website
Dateisystem - FileshelfBereich „Downloads“ im Medienmanager
Modul Fileshelf - DownloadsNeueste, beliebteste, hervorgehobene Downloads oder die einer Kategorie

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

Voraussetzungen und Installation

Voraussetzungen

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).

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
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.

Das Dashboard

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

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:

ErgebnisBedeutung
GrünGeschützt: Die Dateien sind über ihre Adresse nicht erreichbar, oder der Ordner liegt außerhalb des Webverzeichnisses.
RotNicht geschützt: Dateien lassen sich an Schutz und Zähler vorbei herunterladen. Das Dashboard zeigt, wie Sie den Ordner schließen.
GelbNicht prüfbar: Die Website hat auf die Testanfrage nicht geantwortet. Prüfen Sie später erneut.

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.

Ein Menüpunkt mit demselben Alias wie der Ablageordner (etwa fileshelf) würde mit dem Ordner gesperrt. Das Dashboard warnt in diesem Fall; geben Sie dem Menüpunkt dann einen anderen Alias.

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

Downloads anlegen und pflegen

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

Das Formular eines Downloads: oben die Datei, darunter die Beschreibung, rechts Status, Kategorie und Zusatzkategorien
Der Reiter „Datei und Beschreibung“: oben die Datei, darunter die Beschreibung, rechts Status, Kategorie, Zusatzkategorien und Schlagwörter.

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“

Die Datei

Der Bereich Datei mit der vorhandenen Datei, dem Feld zum Ersetzen und der Auswahl freier Dateien
Hochladen oder eine vorhandene Datei aus dem Ablageordner wählen; darunter die Angaben zur Datei.

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:

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)

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.

English version

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:

Der Reiter Fileshelf: Darstellung mit der Auswahl Liste, Tabelle oder Kacheln
Die Darstellung gilt, solange der Menüpunkt der Kategorie nichts anderes wählt.

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

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

Der Reiter Zugang eines Downloads mit Passwortfeld und Status
Der Reiter „Zugang“ zeigt nur, ob ein Passwort gesetzt ist – nie das Passwort selbst.

Passwort für eine Kategorie

Der Reiter Fileshelf im Kategorieformular mit dem Kategoriepasswort
Ein Kategoriepasswort schützt jeden Download der Kategorie und ihrer Unterkategorien.

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

Das Formular zum Freischalten eines geschützten Downloads auf der Website
Das Formular erscheint, wenn ein Besucher einen geschützten Download öffnet.

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.

English version

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

TypZeigtWichtige Einstellungen
KategorienDie Kategorien unter der gewählten Wurzel als Kacheln oder als kompakte Liste, mit Bild, Beschreibung, Anzahl der Downloads und UnterkategorienWurzelkategorie, Darstellung, Beschreibung der obersten Kategorie, Kategoriebild, Beschreibung, Anzahl anzeigen, Ebenen (1 = ohne Unterkategorien)
KategorieDie Downloads einer Kategorie und ihre UnterkategorienDarstellung, Reihenfolge, Anzahl je Seite, Kategoriebild und seine Darstellung, Angaben (Größe, Version, Datum, Zähler, Schlagwörter), gesperrte Downloads anzeigen
Einzelner DownloadDie Seite eines DownloadsDatei direkt ausliefern statt die Seite zu zeigen
Neueste DownloadsDie zuletzt angelegten DownloadsAnzahl, Kategorien, Zeitraum in Tagen
Die Kategorienübersicht auf der Website mit der Anzahl der Downloads je Kategorie
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.

Ü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.

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:

Ü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.

Eine Kategorie als Liste mit dem Kategoriebaum links, Suche und Sortierung über der Liste
Darstellung „Liste mit Kategoriebaum“ (Vorgabe): links der Baum, über der Liste Suche und Sortierung.
Eine Kategorie als Tabelle mit „Kategorie wechseln“ und sortierbaren Spalten
Darstellung „Tabelle“: oben „Kategorie wechseln“, die Spaltenköpfe sortieren.
Eine Kategorie in der Darstellung Karten
Darstellung „Karten“: oben der Weg zurück und die Unterkategorien.

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

Die Seite eines Downloads: Titel, Kategorien, Beschreibung und daneben der Kasten mit Datei, Schaltfläche und Angaben
Titel und Kategorien, die Beschreibung und daneben der Download-Kasten.

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:

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

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:

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

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.

Ein Beitrag mit Link, Schaltfläche, Zähler und Liste aus Shortcodes sowie dem Modul
Ein Beitrag mit allen Arten von Shortcodes und, darunter, dem Modul.

Die Formen

ShortcodeErgebnis
{fileshelf id=12}Link mit dem Titel des Downloads
{fileshelf id=12 text="Formular laden"}Link mit eigenem Text
{fileshelf id=12 button}Schaltfläche
{fileshelf id=12 button class="uk-button uk-button-primary"}Schaltfläche mit eigenen CSS-Klassen
{fileshelf id=12 count}Nur die Zahl, wie oft der Download heruntergeladen wurde
{fileshelf cat=3}Liste der Downloads einer Kategorie (Haupt- oder Zusatzkategorie)
{fileshelf cat=3 layout=cards limit=5 order=popular}Kacheln, höchstens 5, beliebteste zuerst

{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

Steht eine Liste allein in einem Absatz, ersetzt sie den Absatz. Schreiben Sie {fileshelf cat=…} deshalb in eine eigene Zeile.

English version

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.

Das Auswahlfenster der Schaltfläche Download mit der Wahl Link, Schaltfläche oder Anzahl
Oben wählen Sie die Form, darunter den Download. Im Reiter „Kategorien“ fügen Sie eine ganze Kategorie als Liste ein.
  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.

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

Das Modul

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

Einstellungen

EinstellungBedeutung
AnzeigenNeueste Downloads, Am häufigsten heruntergeladen, Downloads einer Kategorie oder Hervorgehobene Downloads
KategorienNur Downloads dieser Kategorien (Haupt- oder Zusatzkategorie). Für „Downloads einer Kategorie“ nötig, sonst wahlweise.
Anzahl DownloadsHöchstens so viele Einträge (bis 100)
DarstellungListe oder Kacheln
Überschrift der TitelÜberschriftenebene der Download-Titel, eine unter dem Modultitel
Dateityp und Größe, Datum, Anzahl Downloads je DateiEinblenden, ausblenden oder wie in den Optionen von Fileshelf

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

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.

Das Ergebnis der Suche nach Preisliste mit dem passenden Download
Die Suche findet den Download über Titel, Dateiname oder Schlagwort.

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

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.

Der Medienmanager mit dem Bereich Downloads und den Ordnern der Kategorien
Der Bereich „Downloads“ neben den lokalen Ordnern von Joomla.

Was anders ist als bei normalen Ordnern

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

Werkzeuge

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

Die Werkzeuge von Fileshelf in drei Gruppen: Ablageordner und Dateien, Ausprobieren, Nicht umkehrbar
Die Werkzeuge in drei Gruppen; was sich nicht rückgängig machen lässt, steht abgesetzt.

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.

WerkzeugWann Sie es brauchen
DemodatenSie wollen sehen, wie Fileshelf auf Ihrer Website aussieht, bevor Sie eigene Downloads anlegen. „Demodaten anlegen“ erzeugt sechs Kategorien (eine mit dem Passwort demo), 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 demo ist bekannt – löschen Sie die Demodaten, bevor die Website öffentlich wird.
Dateien neu ordnenEine 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.
Dateien ohne Download übernehmenSie 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.
Dateiangaben prüfenSie 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.
Download-Zähler zurücksetzenSetzt die Zähler aller Downloads oder der Downloads einer Hauptkategorie auf 0. Das lässt sich nicht rückgängig machen.

English version

Optionen und Rechte

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

Die Optionen von Fileshelf mit dem Reiter Ablage
Die Optionen, Reiter „Ablage“.

Ablage

OptionVorgabeBedeutung
AblageordnerfileshelfRelativ zum Joomla-Ordner oder ein absoluter Pfad. Am sichersten außerhalb des Webverzeichnisses.
Erlaubte Dateitypenpdf, zip, docx, xlsx, pptx, jpg, jpeg, png, mp3, mp4Endungen, durch Kommas getrennt. Programme und Webseiten werden nie angenommen.
Software-Pakete erlaubenNeinNimmt 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.
Größte Datei (MB)1000: keine eigene Grenze. Die Grenze des Servers gilt immer.
AuslieferungPHPPHP, X-Sendfile oder X-Accel-Redirect (siehe Ablageordner und Selbsttest)

Downloads

OptionVorgabeBedeutung
Zugriff über ZusatzkategorienNur Hauptkategorie„Strengste“: Auch die Zugriffsebenen der Zusatzkategorien müssen es erlauben.
Passwort gilt für (Minuten)1200: bis die Browsersitzung endet.
VersionenJa, 10Versionsverlauf der Downloads wie bei Beiträgen.

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.

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:

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

English version

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.

Benutzeraktionen, gefiltert auf Fileshelf, mit Einträgen zu Downloads und einem Import
Einträge von Fileshelf in den Benutzeraktionen.

Was protokolliert wird

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

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

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

Download-Statistik (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

Die Statistikseite mit Zeitraum, Summen, Balkendiagramm je Tag und den meistgeladenen Downloads
Downloads je Tag, dunkel die abgeschlossenen, hell die abgebrochenen.

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.

Der Reiter Statistik eines Downloads mit Summen und Diagramm der letzten 30 Tage
Der Reiter „Statistik“ im Download.

Was gezählt wird

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

Versionen und Ablaufdatum (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

Der Reiter Versionen mit Änderungstext, Ablaufdatum und der Liste der früheren Versionen mit Status
Der Reiter „Versionen“: Änderungen, Ablaufdatum und frühere Versionen.

Frühere Versionen verwalten

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

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

Download-Seite mit dem Abschnitt Versionen: Neues in dieser Version und eine frühere Version mit Link
Unter der Datei: was neu ist, und die früheren Versionen.

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

Links und Download gegen E-Mail (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

  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.

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.

Download-Seite mit dem Formular: E-Mail-Adresse, Name, Einwilligung und Schaltfläche Link anfordern
Das Formular auf der Download-Seite.

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 & Optionen konfigurieren“.

Die Texte der beiden Mails bearbeiten Sie unter System → Mailvorlagen (Erweiterung Fileshelf - Links). Wie lange Adressen gespeichert bleiben, steht unter Datenschutz.

English version

Download-Limits (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

Die Seite Limits mit zwei Limits und den Formularen für Benutzergruppe, Kategorie und einzelnen Download
Die Seite „Limits“.

Ein Limit anlegen

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

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

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

English version

Benachrichtigungen (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

Der Abschnitt Benachrichtigungen im Reiter Weitergeben mit Schalter, Empfängern und der Zahl der Abonnenten
Der Abschnitt „Benachrichtigungen“ im Reiter „Weitergeben“.

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).

Die geplanten Aufgaben von Fileshelf: Benachrichtigungen versenden, Aufbewahrung des Download-Protokolls, Adressen nach Frist löschen
Die drei Aufgaben der Pro-Version.

Die Texte der Mails bearbeiten Sie unter System → Mailvorlagen (Erweiterung Fileshelf - Benachrichtigungen).

English version

Datenschutz (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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

Was gespeichert wird

DatenWofürWie lange
Download-Protokoll: Zeitpunkt, Download, abgeschlossen, bei angemeldeten Besuchern der Benutzer; statt der IP-Adresse ein Wert, der nur am selben Tag zuzuordnen istStatistik, Limits365 Tage einzeln, danach nur noch Zahlen je Tag ohne Personenbezug
E-Mail-Adresse, Name (freiwillig), Zeitpunkt der Einwilligung bei Downloads gegen E-MailBestätigung und Zusendung des Downloads365 Tage (einstellbar)
Links mit einer AdresseZusendung, Gültigkeitbis 365 Tage nach Ablauf
Abos neuer Versionen (Benutzer)Benachrichtigungbis zur Abmeldung

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):

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

Mitgliedschaften mit Membership Pro (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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“.

Der Reiter Pläne eines Downloads mit dem gewählten Plan Premium
Die Pläne am Download.

Was Besucher sehen

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.

Die Seite Meine Downloads mit drei Anleitungen für Mitglieder mit dem Plan Basis
„Meine Downloads“ auf der Website.

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

YOOtheme Pro (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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:

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.

Eine Seite mit dem Element Fileshelf Downloads als Tabelle mit Titel, Datei, Datum und Schaltfläche
Das Element als Tabelle.

English version

Editor JCE (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

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.

Der Link-Dialog von JCE mit aufgeklapptem Fileshelf-Baum und der gewählten Preisliste
Der Fileshelf-Baum im Link-Dialog.

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).

Der Reiter Fileshelf im Link-Dialog mit der Auswahl Link mit Dateiangaben, Schaltfläche oder Anzahl
Der Reiter „Fileshelf“.

English version

Alle herunterladen (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

Ü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.

Die Kategorie Formulare mit der Schaltfläche Alle herunterladen (ZIP) über der Liste
Die Schaltfläche über der Liste.

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

Hochladen auf der Website (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

Das Formular Datei hochladen mit Titel, Kategorie, Beschreibung und Datei
Das Formular auf der Website.

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:

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“.

Die Seite Uploads freigeben mit Herkunft und Ablageort der Dateien und dem Hinweis, was noch fehlt
Die Seite „Uploads freigeben“: Wartet nichts, nennt sie, was zum Hochladen noch fehlt.

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.

Die Seite Mehrere Dateien hochladen mit den gemeinsamen Einstellungen und dem Ergebnis je Datei
„Mehrere Dateien hochladen“: links die gemeinsamen Einstellungen, rechts das Ergebnis je Datei.

English version

Umstieg von anderen Download-Erweiterungen (Pro)

Pro-Version. Diese Funktion gehört zur Pro-Version von Fileshelf. Was die Free-Version kann, steht unter Free-Version und Pro-Version.

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.

QuelleWas übernommen wird
Phoca Download 6Kategorien mit Bild, Downloads, Zähler, Version, Tags, Lizenz
jDownloads 4Kategorien, Downloads, Zähler, Version, Tags, Lizenz, Passwörter; auf Wunsch wird dieselbe Datei in mehreren Kategorien zu einem Download zusammengefasst
Dropfiles 6Kategorien mit Bild, Dateien, Zähler, Version, Tags, Mehrfachkategorien
Membership ProDie Dokumente der Pläne, gebunden an ihre Pläne (siehe Mitgliedschaften mit Membership Pro)

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.
Vorschau des Imports aus Phoca Download mit Kategoriebaum, ersten Downloads und Optionen
Die Vorschau vor dem Import.

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

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.

Bericht des Imports mit Zahlen, Nachlauf und Checkliste
Der Bericht mit Nachlauf und Checkliste.

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 & 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

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.

Die Ereignisse sind die öffentliche Schnittstelle von Fileshelf. Name, Argumente und öffentliche Methoden ändern sich nur mit einer neuen Hauptversion.

Die Ereignisse

EreignisKlasseWannWas ein Plugin tun kann
onFileshelfResolveTokenResolveTokenEventDie Anfrage trägt einen Token (t).grant() überspringt Zugriffsebene und Passwort, reject() sperrt mit Grund token.
onFileshelfAccessAccessEventNach Status, Token, Zugriffsebene und Passwort; auch in Listen (Kontext list).deny($reason, $message, $redirect) sperrt. In Listen nichts zählen oder schreiben.
onFileshelfBeforeSendBeforeSendEventZugriff erteilt, vor dem Zähler.setFile() tauscht die Datei; Fileshelf prüft sie danach erneut gegen die Ablage.
onFileshelfAfterCountAfterCountEventNach dem Hochzählen, vor dem ersten Byte.Nur Meldung; getRequestId() verbindet mit dem nächsten Ereignis.
onFileshelfAfterSendAfterSendEventNach dem Senden, auch bei Abbruch.isCompleted(), getBytesSent(), getMethod().
onFileshelfDownloadDisplayDownloadDisplayEventDetailseite, je Position.addHtml() mit fertig maskiertem HTML.
onFileshelfDashboardDashboardEventDashboard im Backend.addTile($id, $title, $html, $order, $area) ($area: status, content, insight oder setup); ab 1.8.0 addAttention($id, $text, $link, $count, $label) für „Braucht Ihre Aufmerksamkeit“, nur bei Handlungsbedarf mit Ausweg; eigenes Recht vorher prüfen.
onFileshelfAdminPagesAdminPagesEventDashboard und jede Plugin-Seite.addPage($name, $title, $right, $icon) meldet eine Seite view=page&page=… an; Fileshelf prüft das Recht.
onFileshelfAdminPageAdminPageEventDie Plugin-Seite wird angezeigt.addHtml(), addAction($action, $label, $icon, $confirm).
onFileshelfAdminActionAdminActionEventEine Aktion der Seite läuft; Token, Recht und Bestätigung sind geprüft.handled($message, $type).
onFileshelfFilesInUseFilesInUseEventWerkzeuge, Download-Formular und Medienmanager fragen, welche Dateien der Ablage Plugins gehören.claim($path) für eigene Dateien (z. B. ältere Versionen); sie gelten nie als verwaist.
onFileshelfSitePagesSitePagesEventMenüpunkt „Erweiterungsseite“ und jeder Aufruf einer solchen Seite.addPage($name, $title, $login) meldet eine Seite der Website an; mit $login leitet Fileshelf Gäste zur Anmeldung.
onFileshelfSitePageSitePageEventDie Seite wird angezeigt.addHtml() mit fertig maskiertem HTML, setTitle(), getOptions() (Menüpunkt).
onFileshelfSiteActionSiteActionEventEin Formular der Seite wurde abgeschickt; Token, Seite und Anmeldung sind geprüft.handled($message, $type, $redirect); Fileshelf maskiert die Meldung.
onFileshelfCategoryDisplayCategoryDisplayEventKategorieseite, Positionen beforeList und afterList.addHtml() mit fertig maskiertem HTML; getTotal() nennt die Zahl der gelisteten Downloads.
onFileshelfActionLogActionLogEventSeit 1.3.0: Fileshelf oder ein Plugin meldet eine Aktion fürs Aktionsprotokoll (Passwort, Freigabe, Import).Reine Meldung: getAction(), getKind() (download, category, import), getItemId(), getTitle(), getDetails(). Das Plugin „Aktionsprotokoll - Fileshelf“ schreibt sie.
onFileshelfImportSourcesImportSourcesEvent (Pro)Seit 1.3.0: Die Seite „Import“ sammelt ihre Quellen.addSource() mit einer Klasse, die SourceInterface des Import-Plugins erfüllt (Kategorien, Downloads, Prüfung der Tabellen).
onFileshelfResolveScopesResolveScopesEventVon der Pro-Version (Limits) gefeuert, sobald ein Limit einen Scope-Typ eines anderen Plugins nutzt; die Free-Version feuert es nicht.addScope($type, $id).

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

Änderungsprotokoll

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

Diese Seite wird beim Release automatisch aus der Änderungsdatei des Produkts erzeugt. Änderungen von Hand gehen beim nächsten Abgleich verloren.

Version 1.10.1 – 12.11.2026

Geändert

Behoben

Version 1.10.0 – 12.11.2026

Hinzugefügt

Geändert

Behoben

Version 1.9.0 – 12.11.2026

Hinzugefügt

Geändert

Behoben

Hinweise

Version 1.8.1 – 12.11.2026

Behoben

Version 1.8.0 – 11.11.2026

Hinzugefügt

Behoben

Version 1.7.0 – 11.11.2026

Hinzugefügt

Geändert

Version 1.6.0 – 11.11.2026

Hinzugefügt

Geändert

Version 1.5.1 – 11.11.2026

Behoben

Version 1.5.0 – 11.11.2026

Sicherheit

Geändert

Version 1.4.0 – 10.11.2026

Hinzugefügt

Geändert

Behoben

Version 1.3.0 – 10.11.2026

Hinzugefügt

Version 1.2.0 – 10.11.2026

Hinzugefügt

Version 1.1.0 – 10.11.2026

Hinzugefügt

Version 1.0.0 – 09.11.2026

Hinzugefügt

English version