Wdir_XH - ein CMSimple_XH Plugin

Dateilistenansicht

Wdir_XH ermöglicht die Anzeige von Verzeichnislistings auf Ihrer Website, so dass sie leicht eine Menge von Dateien zum Download anbieten können.

Wdir_XH ist als Nachfolger des beliebten Wdir gedacht, das seit langer Zeit nicht mehr weiter entwickelt wird. Leider erlaubt die Lizenz von Wdir keine Modifikationen, so dass Wdir_XH von Grund auf neu geschrieben wurde.

Bitte lesen Sie diese Dokumentation bevor Sie auf Probleme stoßen!

Wichtiger Hinweis

Wdir_XH konnte bisher noch nicht in diversen Umgebungen getestet werden. Es handelt sich um eine so genannte Beta Version. Vorsicht bei der Verwendung!

Voraussetzungen

Wdir_XH ist ein Plugin für CMSimple_XH. Es benötigt CMSimple_XH ≥ 1.6 und PHP ≥ 5.2.0.

Installation

Die Installation erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch. Im CMSimple_XH Wiki finden sie ausführliche Hinweise.

  1. Sichern Sie die Daten auf Ihrem Server.
  2. Entpacken Sie die ZIP-Datei auf Ihrem Computer.
  3. Laden Sie das gesamte Verzeichnis wdir/ auf Ihren Server in das plugins/ Verzeichnis von CMSimple_XH hoch.
  4. Vergeben Sie Schreibrechte für die Unterverzeichnisse css/, config/ und languages/.

Einstellungen

Die Konfiguration des Plugins erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch im Administrationsbereich der Homepage. Wählen Sie Plugins → Wdir.

Sie können die Original-Einstellungen von Wdir_XH unter "Konfiguration" ändern. Beim Überfahren der Hilfe-Icons mit der Maus werden Hinweise zu den Einstellungen angezeigt.

Die Lokalisierung wird unter "Sprache" vorgenommen. Sie können die Zeichenketten in Ihre eigene Sprache übersetzen (falls keine entsprechende Sprachdatei zur Verfügung steht), oder sie entsprechend Ihren Anforderungen anpassen.

Das Aussehen von Wdir_XH kann unter "Stylesheet" angepasst werden.

Verwendung

Wdir_XH ermöglicht die Anzeige von Dateien im Userfiles-Ordner (Standardwert ist userfiles/).

Um ein Verzeichnislisting auf einer Seite anzuzeigen, verwenden Sie:

{{{PLUGIN:wdir('PFAD');}}}

wobei PFAD ein Unterordner des Userfiles Ordners ist. Wenn Sie z.B. den Inhalt von userfiles/downloads/ anzeigen möchten, dann schreiben Sie:

{{{PLUGIN:wdir('downloads');}}}

Die Dateinamen in der Liste sind auf die Dateien verlinkt, so dass Besucher zu den Dateien surfen können; abhängig von den Server- und Browsereinstellungen können manche Dateien direkt im Browser angesehen werden, während andere zum Download angeboten werden.

Wdir_XH zeigt keine Unterordner des als Argument an die Funktion übergebenen Ordners an, so dass Besucher die Verzeichnisse nicht durchlaufen können. Wenn Sie Besuchern erlauben möchten, einige der Unterordner einzusehen, müssen Sie mehrere Aufrufe von wdir() auf einer Seite (oder verschiedenen Seiten) platzieren.

Filtern

Sie können wdir() ein zweites Argument übergeben, um die Dateien zu filter; d.h. nur die Dateinamen, die sich mit dem Filter decken, werden angezeigt.

Im Standard-Modus sind die Filterausdrücke einfache Platzhalter-Schablonen, wobei ein Asterisk (*) einen Platzhalter für eine beliebige Anzahl von Zeichen, und ein Fragezeichen (?) einen Platzhalter für ein einzelnes Zeichen darstellt.

Wenn Sie also nur PDF-Dateien im Userfiles Ordner anzeigen wollen, verwenden Sie:

{{{PLUGIN:wdir('', '*.pdf');}}}

Wenn Sie alle Dateien im Userfiles Ordner anzeigen möchten, die mit "Vertrag_" beginnen, schreiben Sie

{{{PLUGIN:wdir('', 'Vertrag_*');}}}

Eine sehr viel mächtigere Möglichkeit des Filterns kann durch Setzen der Konfigurationsoption Filter → Regexp aktiviert werden. Dann wird das zweite Argument für wdir() als PERL kompatibler regulärer Ausdruck interpretiert. Dieser Modus sollte nur von fortgeschrittenen Webmaster verwendet werden, die die Syntax im PHP-Handbuch nachschlagen können.

Beschränkungen

Wdir_XH verfügt derzeit noch nicht über alle Möglichkeiten von Wdir 03beta, und ein paar werden wahrscheinlich niemals implementiert werden (wie die Anzeige des Datei-Besitzers und der -Berechtigungen).

Auf manchen Systemen (z.B. Windows mit PHP < 5.3) könnten die einfachen Platzhalter-Schablonen zum Filtern nicht funktionieren. In diesem Fall müssen Sie die regulären Ausdrücke aktivieren, wenn Sie das Filtern benötigen (ziehen Sie als Alternative in Erwägung die Dateien auf unterschiedliche Ordner zu verteilen).

Lizenz

Wdir_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2012-2015 Christoph M. Becker

Slovakische Übersetzung © 2015 Dr. Martin Sereday
Russische Übersetzung © 2015 Васильев Леонид Валерьевич

Danksagung

Das Plugin-Icon wurde von Alexander Moore gestaltet. Vielen Dank für die Veröffentlichung des Icons unter GPL.

Die Datei-Icons wurden von 19eighty7 gestaltet. Vielen Dank für die Veröffentlichung unter einer liberalen Lizenz.

Die Sortier-Icons wurden MediaWiki entnommen. Vielen Dank für die Veröffentlichung.

Zu guter Letzt vielen Dank an Peter Harteg, den "Vater" von CMSimple, und allen Entwicklern von CMSimple_XH, ohne die dieses fantastische CMS nicht existieren würde.