| Downloads-Plugin | |
|---|---|
| Autor | GodMod |
| Aktuelle Version | 0.4.1 |
| Letzte Stabile Version | 0.4.1 |
Dieses Downloads-Plugin für EQdkp-plus gibt dem Administrator die Möglichkeit, seinen Usern Downloads zur Verfügung zu stellen. Einerseits können Dateien vom lokalen PC auf den Server übertragen werden, andererseits können Links zu Dateien/Internetseiten eingetragen werden, die allerdings aber nur verlinkt werden. Auch ein Vorschaubild kann hochgeladen werden. Mit dem Portalmodul "Last Uploads" werden die letzten neu hinzugefügten Downlaods angezeigt.
Keine Software ist jemals fehlerfrei... so auch mein Plugin nicht. Bisher ist kein Problem bekannt!
Kopiert den Inhalt des Archives in den plugins/-Ordner eures EQdkps. Dann das Plugin wie gewohnt über den Administrationsbereich installieren. Während dieser Installation versucht das Plugin, das Download-Verzeichnis zu sichern (siehe nächstes Kapitel). Mit dem Plugin wird auch ein Portalmodul („Last Uploads“) mit geliefert, welches ihr nach der Installation des Plugins bei den Portalmodulen aktivieren könnt.
Wichtig: vor einem Update immer ein Backup der Dateien per FTP und der Datenbank machen!!
Nach dem Backup einfach die neuen Dateien über die alten im Ordner ../plugins/downloads/ drüberkopieren und eine Administrationsseite des Plugins aufrufen. Sollte ein Datenbank-Update notwendig sein, weißt euch ein Hinweis darauf hin. Einfach den Anweisungen folgen. Spezifische Hinweise zu bestimmten Updates werden hier in der WIKI veröffentlicht. Siehe weiter unten.
Damit die von euch hochgeladenen Daten nicht unberechtigerweise heruntergeladen werden können, müsst ihr das Upload-Verzeichnis mit einer .htaccess-Datei sichern. Dies wird – sofern die nötigen CHMOD-Rechte gegeben sind – bei der Installation des Plugins automatisch erledigt. Sollte es allerdings nicht funktioniert haben, erstellt euch einfach selbst eine .htaccess-Datei. Diese öffnet ihr einfach in einem Editor, z.B. Notepad++, und kopiert folgendes in die Datei:
<Files *> Order Allow,Deny Deny from All </Files>
Ladet diese Datei anschließend in das Verzeichnis: data/../downloads/files/ Oder nehmt einfach die htaccess.txt im Doc-Ordner des Plugins, benennt sie in .htaccess um, und ladet sie in das oben angegebene Verzeichnis. Abschließend noch prüfen, ob die Dateien wirklich nicht aus dem Internet zu erreichen sind.
Aktuell verwendete IDs: 8000 - 8006
Mit diesem Rechte kann jemand alle Kategorien verwalten, d.h. sie bearbeiten, löschen und neue erstellen. Er kann auch die Berechtigung festlegen, d.h. ob die Kategorien öffentlich oder nur für registrierte Mitglieder sichtbar sind.
Dieses Recht gibt dem Admin die Möglichkeit, Downloads zu bearbeiten oder zu löschen. Es ist auch möglich, Vorschaubilder hochzuladen.
Mit diesem Recht kann ein Admin verschiedene Einstellungen des Plugins verändern.
Mit diesem Recht kann ein Admin die Download-Statistiken ansehen
Damit darf ein Administrator Downloads, die per FTP in den Upload-Ordner hochgeladen wurden, in das Downlaods-Plugin importieren
Haben Benutzer dieses Recht, können sie Downloads sehen und herunterladen.
Mit diesem Recht darf jemand lokale Dateien auf den Server hochladen oder externe Links eintragen, aber nichts daran ändern.
Hier findet die gesamte Kategorie-Verwaltung statt. Es können bestehende Kategorien bearbeitet oder gelöscht werden, sowie neue erstellt werden. Auch die Berechtigungen – ob die Kategorie öffentlich sichtbar ist oder nicht – können hier eingestellt werden.
Bei den Berechtigungen ist folgendes zu beachten: die Berechtigungseinstellung der Kategorie überwiegt die der einzelnen Downloads, wenn es darum geht, ob ein Download sichtbar ist oder nicht. Ist eine Kategorie nicht für unregistrierte Benutzer, dann sind automatisch alle Downloads in dieser Kategorie auch nicht sichtbar, auch wenn sie als öffentlich definiert sind.
Beim Löschen von Kategorien ist folgendes zu beachten: Wird eine Kategorie gelöscht, werden alle Downloads aus der Datenbank und vom Webspace gelöscht!! Also wenn ihr eine Kategorie löschen wollt, aber die Downloads behalten wollt, verschiebt diese einfach in eine andere Kategorie.
Damit Dateien hochgeladen werden können, muss mindestens 1 Kategorie vorhanden sein (nach der Installation als „Standard“ bezeichnet).
Hier werden alle Downloads in den entsprechenden Kategorien verwaltet, und können gelöscht, bearbeitet und neue Dateien hinzugefügt werden. Es können auch mehrere Downloads gleichzeitig gelöscht werden, indem die entsprechenden Checkboxen aktiviert werden und „markierte… Löschen“ ausgewählt wird. Mit den entsprechenden Links kann eine ganze Kategorie oder alle Downloads ausgewählt werden.
Hier bekommt ihr grafisch die Download-Statistiken zu sehen. Ihr könnt dabei Gesamt, Kategorien und einzelne Dateien auswählen. Für den zeitlichen Verlauf ist eine Jahresansicht, Monats- und Wochenansicht vorhanden.
Mit dem Importer können Dateien, die per FTP in den Ordner "data/.../downloads/files/" hochgeladen wurden, in das Downlaod-Plugin importiert werden. Aufgelistet werden nur jene Dateien, die noch nicht in der Datenbank als lokale Dateien eingetragen worden sind. Mit Hilfe der Checkboxen einfach die entsprechenden Dateien auswählen, dann den gewünschten Namen und die Beschreibung des Downloads eintragen, die Kategorie und Berechtigung auswählen und importieren.
Legt hier fest, welche Dateiendungen von hochgeladenen Dateien erlaubt sind. Trennt die einzelnen Endungen mit einem Komma voneinander ab. Als Dateiendung zählen nur die Buchstaben nach dem letzten Punkt, d.h. „gz“ ist richtig, im Gegensatz zu „tar.gz“. Auch wenn eine Dateiendung erlaubt ist, heißt es noch nicht, dass die Datei mit dieser Endung auch hochgeladen werden kann. Siehe dazu "Mime-Types".
Da die meisten Webspace-Angebote einen beschränkten monatlichen Traffic haben, kann nun auch für die Downloads ein bestimmtes Trafficbudget zugewiesen werden. Tragt einfach das Limit ein. Wenn das monatliche Limit überschritten ist, können nur noch externe Downloads oder Dateien über alternative Downloadserver heruntergeladen werden, jedoch keine lokalen Dateien mehr. Am Anfang des Monats wird der monatliche Traffic automatisch wieder auf 0 gesetzt. Lässt das Feld leer, wenn ihr kein Limit haben wollt. Tragt eine 0 ein, um sofort den Download von allen lokalen Dateien zu stoppen.
Damit Downloads hochverfügbar sind, kann man sog. Mirrors eintragen, d.h. Links zu Servern, die die gleiche Datei zum Download bereithalten. Dies ist auch praktisch, wenn z.B. die Traffic-Grenze erreicht ist, denn die User können sich die Datei von einer anderen Quelle herunterladen.
Um Rückmeldungen über die reingestellen Downloads zu bekommen gibt es neben dem Bewertungssystem auch das Kommentarsystem. Dies kann entweder aktiviert oder deaktiviert werden.
Mit dieser Funktion kann man bei einem Download IDs von anderen Downloads eintragen, die dann auf der Detail-Seite des Downloads als „Zugehörige Dateien“ erscheinen. Zugehörige Dateien müssen für jeden Download einzeln eingetragen werden, d.h. wenn A zu B gehört, dann gehört B nicht automatisch auch zu A. Dies muss per Hand nachgetragen werden.
Bevor unregistrierte User eine lokale Datei herunterladen können, müssen sie ein CAPTCHA lösen. Dies hilft v.a. Traffic sparen, denn nur Menschen können diese Datei herunterladen. Es wird ausdrücklich empfohlen, diese Funktion zu verwenden! Dafür ist ein kostenloser Account auf reCAPTCHA.net notwendig. Der Public- and Private-Key müsst ihr unter PLUS-Einstellungen-> Libraries eingeben!
Zeigt auf der Übersichtsseite Statistiken wie Top5-Downloads, letzter eingestellter Download, usw. an. Die Daten der Statistiken variieren je nach Berechtigung, d.h. unregistrierte User sehen andere Statistiken als registrierte Benutzer.
Die Downloads können in Kategorien verwaltet werden. Wenn Kategorien deaktiviert werden, werden alle Downloads in einer einzigen Liste angezeigt. Die bestehenden Kategorien und die entsprechenden Download-Zuordnungen bleiben weiterhin bestehen, d.h. wenn ihr Kategorien wieder aktiviert, sind die Downloads wieder in den ihnen früher zugewiesenen Kategorien. Wurden Dateien hochgeladen während Kategorien deaktiviert waren, wird beim Reaktivieren von Kategorien eine neue Kategorie mit den Namen „Unkategorisiert“ erstellt, in der sich dann diese Downloads befinden. Die „Unkategorisiert“-Kategorie könnt ihr wie eine normale Kategorie behandeln, d.h. löschen, verschieben, umbenennen, usw.
Mit dieser Funktion wird ein Link oben rechts im Reiter zum Download-Bereich angelegt. Dieser Link kann in den Plus-Einstellungen->Links angepasst werden.
Hier kann eingestellt werden, wieviele Download pro Seite erscheinen sollen, z.B. Bei der Suche oder in den Kategorien.
Bei jedem Aufruf des Administrationsbereiches wird geprüft, ob sich im .../data/.../downloads/files-Ordner die oben beschriebene .htaccess-Datei befindet. Wenn dem nicht der Fall sein sollte, wird versucht, eine neue Datei zu erstellen, ansonsten wird eine Warnung ausgegeben. DASS DEAKTIVIEREN DIESER FUNKTION IST NICHT EMPFOHLEN! NUR FÜR ERFAHRENE ADMINISTRATOREN!
Dies aktiviert die Statistiken, wo ihr die Anzahl der Downloads Gesamt/innerhalb der Kategorie/für eine einzelne Datei grafisch aufbereitet dargestellt bekommt.
Damit nicht zu viele Daten anfallen, können ältere Daten nach x Tagen automatisch gelöscht werden. Feld leer lassen, um Funktion nicht zu aktivieren.
Legt die max. Größe einer hochgeladenen Datei fest. Feld leer lassen, um kein Limit zu aktivieren (es wird dann die Server-Einstellung verwendet). Diese Funktion hat für Vorschaubilder keine Funktion!
Legt hier fest, wiegroß der Upload-Ordner max. werden darf. Lasst das Feld leer, um kein Limit zu aktivieren. Vorschaubilder werden nicht berücksichtigt!
Bei einer neuen Version des Downloads-Plugins wirst du benachrichtigt. Das Aktivieren dieser Funktion wird ausdrücklich empfohlen, da mit Updates nicht nur neue Features kommen und eventuelle Fehler beseitigt werden, aber auch der Sicherheit dienen!
Sollten Probleme beim Upload von Dateien auftreten, schallet zum Testen den Debug-Modus an, und ladet die Datei nochmal hoch. Dann sehr ihr gleich, woran es liegt. Diese Daten werden für eine Support-Anfrage benötigt.
Wenn ihr eine unfertige Version benutzt, müsst ihr ein Datenbank-Update manuell erzwingen.
Dies ist die Hauptseite von Downloads 4 EQdkp-plus. Auf diese Seite greifen die normalen User zu. Aber auch für den Admin ist diese Seite interessant, denn er kann auch hier – sofern er die entsprechenden Berechtigungen hat – Downloads bearbeiten, löschen und neue hinzufügen, ohne erst in den Administrationsbereich wechseln zu müssen. Auf der Startseite befinden sich die Statistiken und die Kategorien (falls deaktiviert: alle Downloads). Die Statistiken unterscheiden sich bei Gästen und Registrierten Usern, denn Gäste sehen nur Downloads, die für sie bestimmt sind. Klickt man auf eine Kategorie, werden alle Downloads in einer Kategorie angezeigt. Klickt man auf einen Download, konnt man zu seiner Detail-Seite, wo sind viele wissenswerte Information über einen Download befinden, z.B. Vorschaubild, alternative Downloadserver, zugehörige Dateien und Kommentare (falls aktiviert). Der Standort oben links ist immer verlinkt, d.h. man kommt schnell zur Übersichts-Seite bzw. Kategorie-Übersicht zurück.
Entweder hat der Download die Berechtigung „Registriert“ oder die Kategorie, in der sich der Download befindet, die Berechtigung „Registriert“ Nachprüfen, ob der Download sich in einer Kategorie mit der Berechtigung „Öffentlich“ befindet und selbst die Berechtigung „Öffentlich“ hat.
Beim Update von 0.1.2 auf 0.1.3 werden alle hochgeladenen Dateien vom Ordner ".../data/.../downloads" in den Ordner ".../data/.../downloads/files" verschoben. Es darf sich keine .htaccess mehr in dem Ordner ".../data/.../downloads" befinden, ansonsten können die Vorschaubilder nicht angezeigt werden. Löscht dann einfach die .htaccess aus dem vorher genannten Ordner. Und natürlich darauf achten, dass der neue Ordner ".../data/.../downloads/files" die oben beschriebene .htaccess enthält.
Beim Updatevorgang sollten die oben geannten Aktionen selbständig durchgeführt werden.
Supportanfragen bitte in diese Bereich im Forum stellen:
Bitte schreibt mir keine unaufgeforderten Privaten Nachrichten!!
Bei Gefallen könnt ihr hier Spenden: Amazon-Wishlist Paypal
Dieses Plugin ist unter der Creative Commons: Namensnennung-Keine kommerzielle Nutzung-Weitergabe unter gleichen Bedingungen 3.0 Unported veröffentlicht.