
WICHTIG:
Für alle die eine Version vor 1.2.0 verwenden DRINGENST updaten! Das alte Plugin komplett deinstallieren und dann Version 1.2.0 komplett neu installieren!
Beschreibung:
Da in letzter Zeit immer mehr Probleme mit dem Download von PDF und Bildern hatten habe ich dieses Plugin erstellt.
Grundsätzlich wird ja jeder Link, der auf ein Bild (in manchen Browsern auch bei PDF) verweist, direkt im Browser selbst geöffnet. Will man das Bild (oder PDF) jedoch downloaden kann man dies nur per Rechtsklick > Datei/Ziel speichern unter...
Und genau hier greift "Whatever Download". Mit "Whatever Download" lässt sich jede Datei mit dem Standard Download-Dialog herunterladen ohne das diese im Browser geöffnet wird.
+++ UPDATE +++
Änderungen und neue Features in der Version 1.1.0:
- Neues Design des Download-Buttons
- Info-Hoverfeld neben dem Download-Button mit Informationen zur Datei (Dateiname, Dateigröße, Dateityp)
- Das Feld "name" wird nicht mehr für den Dateinamen verwendet, sondern für die Beschriftung des Download-Buttons!
Installationsanleitung:
1. Plugin über Joomla-Installer installieren
2. Plugin aktivieren
3. Im Joomla-Root einen Ordner namens "wdownloads" anlegen. In diesem Ordner werden alle Dateien gespeichert die man später herunterladen kann!
4. Plugin in Beiträgen aufrufen per
Code:
{wd file=PfadZurDatei name='ButtonBeschriftung'}
Beispielaufruf:
Code:
{wd file=wdownloads/test.zip name='Die Datei test.zip herunterladen'}
Hinweise:
- "file" darf keine Leerzeichen und/oder Sonderzeichen enthalten! Unterstriche (_) und Punkte (.) sind erlaubt.
- Bei "file" keinen führenden Slash (/), siehe "Beispielaufruf"
- Bei "name" sind alle gängigen (Sonder-)Zeichen bis auf einfache und doppelte Anführungszeichen erlaubt, sie dienen nur zur Button-Beschriftung
- Der Wert bei "name" muss unbedingt zwischen zwei einfachen Anführungszeichen (') stehen - keine doppelten (")
Getestete Browser:
- Firefox 3
- Internet Explorer 6
- Internet Explorer 7
- Internet Explorer 8
- Opera
- Safari for Windows
Known Bugs:
- Sicherheitslücke in 1.1.0 [fixed in 1.2.0] (Danke an CirTap für den Hinweis!)
FAQ:
- Der Text des Plugins wird im Frontend nicht ersetzt (Dort steht dann {wd ...} anstatt dem Download-Button)- Ist das Plugin installiert und aktiviert?
- Wird das Plugin in einem Beitrag aufgerufen? (in Modulen funktioniert dies nicht)
- Funktioniert der Beispielaufruf den man weiter oben finden kann wenn man ihn in einen Beitrag kopiert? (Stellen Sie vorher sicher das im Joomla-Root ein Ordner namens "wdownloads" exisitiert und sich eine Datei namens test.zip darin befindet!)
- Eine Meldung "Datei nicht gefunden" wird ausgegeben- Stimmt der Pfad zu der Datei? (Ohne führenden Slash (/))
- Die heruntergeladene Datei hat 0kb- Bisher keine Lösung bekannt - Liegt aber am Hoster
- "Don't try to cheat the System" wird ausgegeben- Die Angabe zum download-Ordner (wdownloads) stimmt nicht, geht wie folgt vor:
Die Meldung erscheint dann, wenn als Download-Ordner ein anderer ausgewählt ist als "wdownloads" im Joomla-Root. Der Fehler kann auch auftreten wenn Joomla in einem Unterordner läuft bzw auf dem localhost, auf jedenfall muss an der zweiten Stelle nach dem ersten Schrägstrich ("/") der Ordner "wdownloads" genannt sein.
Beispiel:
www.domain.de/wdownloads/test.zip < Funktioniert
www.domain.de/joomla/wdownloads/test.zip < Funktioniert NICHT
localhost/wdownloads/test.zip < Funktioniert
localhost/joomla/test.zip < Funktioniert NICHT
Falls Joomla also in einem Unterordner läuft muss man das im Plugin anpassen:
1. Öffnen Sie die Datei "wddownload.php" im Ordner plugins/content/wd/
2. Passt hier in Zeile 19 das Plugin nach euren Wünschen an:
Code:
if ($fileparts[3] != "wdownloads") echo "Don't try to cheat the System!";
| |
Position an der |
der Download- |
Ordner genannt |
sein muss* |
Name des Download-
Ordners
* Der Wert beginnt ab "0", d.h. Position 1 = "0", Position 2 = "1", usw. Ebenfalls muss beachtet werden das die Schrägstriche vom "http://" mitgerechnet werden, ein Beispiel:
http: / / www.domain.de / wdownloads
| | | |
0 1 2 3
Es wird quasi bei allen Schrägstrichen der Link getrennt.
Befindet sich Joomla nun in einem Unterordner verschiebt sich der Download-Ordner um eine Ebene nach hinten:
http: / / www.domain.de / unterordner / wdownloads
| | | | |
0 1 2 3 4
Das bedeutet die Code-Zeile müsste so aussehen:
if ($fileparts[4] != "wdownloads") echo "Don't try to cheat the System!";
In dieser Zeile ist es auch möglich den Namen des Download-Ordners zu ändern, einfach den Begriff zwischen den " austauschen!
Vielen Dank und Grüße,
infernalshade
Lesezeichen