Plugin "List Downloads" in Version 1.5 veröffentlicht
Posted: Sun May 30, 2010 6:26 pm
So, ich habe das Plugin/Tag "List Downloads" in Version 1.5 veröffentlicht.
Download gibts hier: http://dev.cmsmadesimple.org/project/files/728
Hinweis: In der SVN-Version fehlen die Appicons (gingen nicht einzuchecken), also am besten nur die ZIP-Version benutzen.
Installation:
In der ZIP-Datei gibt es 4 Ordner, die einfach alle ins Root Verzeichnis von CMSms zu kopieren sind.
Wenn die Ajax-Vergrößerung der Vorschaubilder verwendet werden soll, muss folgender Aufruf in den Head der HTML-Datei (z.B. im Template) eingefügt werden:
Was macht das Plugin eigentlich?
Dem Plugin ist ein Ordner (innerhalb des uploads-Verzeichnisses) zu übergeben. Wenn man nun das Plugin mittels Platzhalter in seinen Content einbindet, erzeugt es an dieser Stelle eine Tabelle, in welcher es die Dateien des übergebenen Ordners auflistet.
Die Ausgabe kann man mittels Parameter im Platzhalter steuern. So kann man u.a. die Reihenfolge der Dateien bestimmen, eine CSS-Klasse für die Tabelle, Zellen, etc. bestimmen, ein Passwort für das Verzeichnis festlegen, die Ausgabe von PDF Metadaten einschalten u.v.m.
Wie wird es benutzt?
Zur Benutzung reicht es prinzipiell, folgenden Platzhalter in die entsprechende Seite einzufügen:
Jedoch sollten einige der folgenden Parameter eingebunden werden:
* folder: Verzeichnis, dessen Dateien aufgelistet werden sollen (Standard ist "uploads/"). Dieser Parameter sollte immer angegeben werden. Beispiel:
* sort: Reihenfolge der Ausgabe
t - Sortieren nach Datum/Zeit aufsteigend
td - Sortieren nach Datum/Zeit absteigend
s - Sortieren nach Dateigröße aufsteigend
sd - Sortieren nach Dateigröße absteigend
f - Sortieren nach Dateiname aufsteigend
fd - Sortieren nach Dateiname absteigend
(Standard ist die Sortierung nach Dateiname)
Beispiel:
* lang: - Ausgabe Sprache (verfügbar sind en_US, en_GB und de_DE, Standard ist en_US). Beispiel:
* colheaders: - Tabellenbeschriftung anzeigen (Standard ist keine Tabellenbeschriftung). Beispiel:
* cssclass: - Definiere eine CSS Klassen-Prefix (Standard ist "downloads"). Beispiel:
* password: - Die Dateien dieses Verzeichnisses sollen durch dieses Passwort geschützt werden (leer lassen oder Parameter nicht benutzen, um kein Passwort zu benutzen). Beispiel:
* pdf: - Zeige Metadaten von PDF Dateien an (Standard ist false). Beispiel:
Um Metadaten zu bearbeiten, könnt Ihr z.B. das Programm BeCyPDFMetaEdit verwenden: http://www.becyhome.de/download_ger.htm#becypdfmetaedit
Beispiel CSS Regeln, um die Download Tabelle zu gestalten:
Download gibts hier: http://dev.cmsmadesimple.org/project/files/728
Hinweis: In der SVN-Version fehlen die Appicons (gingen nicht einzuchecken), also am besten nur die ZIP-Version benutzen.
Installation:
In der ZIP-Datei gibt es 4 Ordner, die einfach alle ins Root Verzeichnis von CMSms zu kopieren sind.
Wenn die Ajax-Vergrößerung der Vorschaubilder verwendet werden soll, muss folgender Aufruf in den Head der HTML-Datei (z.B. im Template) eingefügt werden:
Code: Select all
<__script__ type="text/javascript" src="js/jquery.imageplugins.js"></__script>Dem Plugin ist ein Ordner (innerhalb des uploads-Verzeichnisses) zu übergeben. Wenn man nun das Plugin mittels Platzhalter in seinen Content einbindet, erzeugt es an dieser Stelle eine Tabelle, in welcher es die Dateien des übergebenen Ordners auflistet.
Die Ausgabe kann man mittels Parameter im Platzhalter steuern. So kann man u.a. die Reihenfolge der Dateien bestimmen, eine CSS-Klasse für die Tabelle, Zellen, etc. bestimmen, ein Passwort für das Verzeichnis festlegen, die Ausgabe von PDF Metadaten einschalten u.v.m.
Wie wird es benutzt?
Zur Benutzung reicht es prinzipiell, folgenden Platzhalter in die entsprechende Seite einzufügen:
Code: Select all
{list_downloads}* folder: Verzeichnis, dessen Dateien aufgelistet werden sollen (Standard ist "uploads/"). Dieser Parameter sollte immer angegeben werden. Beispiel:
Code: Select all
{list_downloads folder="uploads/Downloads/"}t - Sortieren nach Datum/Zeit aufsteigend
td - Sortieren nach Datum/Zeit absteigend
s - Sortieren nach Dateigröße aufsteigend
sd - Sortieren nach Dateigröße absteigend
f - Sortieren nach Dateiname aufsteigend
fd - Sortieren nach Dateiname absteigend
(Standard ist die Sortierung nach Dateiname)
Beispiel:
Code: Select all
{list_downloads folder="uploads/Downloads/" sort="td"}Code: Select all
{list_downloads folder="uploads/Downloads/" lang="de_DE"}Code: Select all
{list_downloads folder="uploads/Downloads/" colheaders=true}Code: Select all
{list_downloads folder="uploads/Downloads/" cssclass="pdfs"}Code: Select all
{list_downloads folder="uploads/Downloads/" password="geheim"}Code: Select all
{list_downloads folder="uploads/Downloads/" pdf=true}Beispiel CSS Regeln, um die Download Tabelle zu gestalten:
Code: Select all
.downloads_table {
border-top: 1px solid #999;
border-left: 1px solid #999;
width:100%;
}
downloads_th {
border-bottom: 1px solid #999;
border-right: 1px solid #999;
padding: 1px 3px 1px 3px;
background-color:#999;
color:#fff;
}
downloads_td {
border-bottom: 1px solid #999;
border-right: 1px solid #999;
padding:3px;
background-color:#eee;
}
.downloads_description, .downloads_imagesize {
color:#666;
}