Contao (Teil 24): Einen Downloadbereich einrichten

Ein Downloadbereich lässt sich in Contao vergleichsweise einfach umsetzen. Ich gehe an dieser Stelle davon aus, dass ihr den Mitgliedern der Gruppe Registriert verschiedene Dokumente zum Download anbieten wollt. Voraussetzung dafür sind natürlich zwei Dinge:

• Ihr habt die Mitgliedergruppe Registriert angelegt.
• Dieser Gruppe wurde mindestens ein Mitglied zugeordnet und ihr kennt dessen Benutzernamen und Passwort.

Der erste Aspekt ist entscheidend, um die gewünschte Anwendung mit dem Downloadbereich überhaupt umsetzen zu können. Tatsächlich muss nämlich jedes Mitglied mindestens einer Mitgliedergruppe zugeordnet werden. Anforderung Nummer zwei muss erfüllt sein, damit ihr später den Downloadbereich testen könnt. Denn eines ist natürlich klar: Wenn ihr einen solchen Bereich auf eurer Webseite anbietet, solltet ihr unbedingt vorher testen, ob das Ganze tatsächlich funktioniert, bevor ihr damit online geht. Haltet dafür einen zweiten Browser bereit, mit dem ihr nicht im Backend angemeldet seid.

Legt für eine solche Anwendung über Layout>Seitenstruktur>Neue Seite eine neue Seite an. (Wenn ihr die Seite Downloads bereits erstellt habt, müsst ihr das natürlich nicht noch einmal machen. Verwendet in diesem Fall einfach die bereits vorhandene Seite). Die neue Seite befindet sich auf derselben Ebene wie Startseite, Kontakt, Impressum usw.




Entscheidend ist bei dieser Seite der Bereich Zugriffsschutz. Aktiviert das Kontrollkästchen Seite schützen.




Daraufhin wird der Punkt Erlaubte Mitgliedergruppen eingeblendet.




Hier aktiviert man das Kontrollkästchen vor Registriert. Mit Speichern und schließen werden die Einstellungen übernommen. Wenn ihr jetzt das Frontend der Seite aufruft, ist der Menüeintrag Downloads nicht mehr zu sehen.

Loggt sich allerdings ein Mitglied der Gruppe Registriert ins Frontend ein, sieht er den Downloads-Eintrag.

Ein Verzeichnis angeben

Legt nun das Verzeichnis an, das den Mitgliedern der Gruppe vorbehalten bleiben soll. Das geschieht unter System>Dateiverwaltung. Folgt im oberen Fensterbereich dem Link Neuer Ordner. Nachdem die Position des Verzeichnisses festgelegt wurde – am besten platziert ihr das Verzeichnis auf der obersten Ebene –, weist ihm den Namen downloads zu. Aktiviert außerdem das Kontrollkästchen Geschützt.




Dadurch kann auf das Verzeichnis und dessen Inhalt später nicht direkt per HTTP zugegriffen werden. Der Zugriff über den Downloads-Inhaltstyp funktioniert aber natürlich trotzdem.

Legt das Verzeichnis mit Speichern und schließen an. Daraufhin landet ihr wieder in der Verzeichnisübersicht der Dateiverwaltung. Ihr könnt nun bei Bedarf weitere Verzeichnisse anlegen, die nur für bestimmte Mitgliedergruppen verfügbar sind.

Um die Download-Funktion später tatsächlich testen zu können, solltet ihr in das Verzeichnis einige Dateien laden. Klickt dazu in der Dateiverwaltung auf Datei-Upload und wählt downloads als Zielverzeichnis. Über Datei auswählen könnt ihr die gewünschten Dateien auswählen und hochladen.

Den Download-Bereich einrichten

Damit der eigentliche Downloadbereich eingerichtet werden kann, bietet Contao zwei verschiedene Inhaltselemente. Welches davon ihr verwendet, hängt im Endeffekt davon ab, wie viele Dateien ihr zum Download anbieten wollt. Ruft die Übersicht Inhalte>Artikel auf. Klickt in der Artikelübersicht bei Downloads [Hauptspalte] auf das Stiftsymbol. Im oberen Fensterbereich folgt man dem Link Neues Element.




Nachdem ihr die Position des neuen Elements festgelegt habt, kommt dem Feld Elementtyp entscheidende Bedeutung zu. Darin findet ihr den Bereich Datei-Elemente, unter dem zwei Einträge zu sehen sind.

• Download – Hierüber kann man eine einzige Datei zum Download anbieten.
• Downloads – Dieser Inhaltstyp ermöglicht das Anbieten mehrerer Dateien zum Herunterladen.

Im aktuellen Fall wird der Inhalt von Elementtyp auf Downloads gestellt, um so gleichzeitig mehrere Dateien zum Download anbieten zu können. Daraufhin wird der Bereich Dateien und Ordner eingeblendet.




Klickt man dort auf Auswahl ändern, zeigt Contao den Inhalt der Dateiverwaltung an. Ihr habt nun die Möglichkeit, ganze Verzeichnisse oder einzelne Dateien auszuwählen. Im aktuellen Beispiel wird das Kontrollkästchen aktiviert, das vor downloads steht. Dadurch wird der gesamte Verzeichnisinhalt für die entsprechende Gruppe freigegeben. Mit Anwenden übernimmt man die Einstellungen.

Über das Sortieren-Feld könnt ihr explizit festlegen, in welcher Reihenfolge die Elemente angezeigt werden, die ihr zum Download bereitstellt. So könnt ihr beispielsweise eine alphabetische Sortierung, aber auch eine Sortierung nach Datum bestimmen.

Weiter geht es mit dem Bereich Zugriffsschutz. Aktiviert dort das Kontrollkästchen Element schützen.




Daraufhin werden die vorhandenen Mitgliedergruppen angezeigt. Aktiviert hier die Mitgliedergruppen, die auf die von euch bestimmten Dateien zugreifen können. Im aktuellen Beispiel wird die Gruppe Registriert ausgewählt.

Bestätigt die Einstellungen mit Speichern und schließen.

Testen des Downloadbereichs

Bevor ihr mit dem Downloadbereich an die Öffentlichkeit geht, solltet ihr diesen natürlich testen. Ich empfehle euch für solche Tests, ein Test-Mitglied in der betreffenden Gruppe anzulegen. Ferner solltet ihr die Tests immer in einem anderen Browser als in dem durchführen, mit dem ihr momentan am Backend angemeldet seid.

Der korrekte Testablauf sieht folgendermaßen aus: Ruft zunächst einmal die Startseite von Contao in einem anderen Browser auf. Ihr solltet die altbekannte Seite mit dem Menü zu sehen bekommen.

Nicht enthalten sein darf in diesem Menü der Eintrag Downloads. Loggt euch nun mit den Zugangsdaten eines Mitglieds der Gruppe Registriert ein. Im Menü solltet ihr den Eintrag Downloads sehen. Klickt diesen Eintrag an.

Contao zeigt daraufhin eine Liste der zum Download angebotenen Dateien. Diese können, wenn die Berechtigungen stimmen, heruntergeladen werden.

Der direkte Zugriff auf die Datei downloads.html funktioniert übrigens nicht, wenn man ein nicht angemeldetes Mitglied ist. Versucht doch jemand auf diese Seite zuzugreifen, wird eine entsprechende Fehlermeldung angezeigt.




Auf diese Weise könnt ihr also einen Downloadbereich für eure Webseite aufbauen.