| Downloads-Plugin | |
|---|---|
| Author | GodMod |
| Last Version | 0.4.0 |
| Last stable Version | 0.4.0 |
This Plugin offers the administrator a possibility to provide his users files to download. One the one hand, local files can be uploaded to the webspace, on the other hand links to Files/URLs can be inserted, but will only be linked. Also a preview-image can be uploaded. The Portal-Module "Last Uploads" will show the newest Downloads.
Just copy the content of the archive into the "plugins"-folder of you EQdkp. Installt the plugin via the administration-panel as usual. During the installation, the plugin tries to secure your files in order to prevent unauthorized downloads (see next chapter). The Plugin contains also the Portal-Module "Last Uploads" which has to be activated after the installation of the plugin.
Important: please make a Backup of your files on your Webspace and of your Database before updating a plugin or the EQdkp-Version.
After the backup just copy the new files over the old ones in the folder "../plugins/downloads". Then go to an administration-page of this plugin. If a database-backup is neccessary, there will be a hint. Simply follow the instructions. Information about specific updates will be published here in the WIKI.
To prevent the unauthorized download of your uploaded files, it is neccessay to secure to Upload-folder with an .htaccess-File. This will be done automaticly during the installation - if the folder hat the right CHMOD-rights. If it doesn't work, you have to create an one .htaccess-file with the following content:
<Files *> Order Allow,Deny Deny from All </Files>
Just put the file into the folder "../data/../downloads/files/". Or take the htaccess.txt from the folder "../plugins/downloads/Doc/", rename it in ".htaccess" und put it into the directory named above. Oder nehmt einfach die htaccess.txt im Doc-Ordner des Plugins, benennt sie in .htaccess um, und ladet sie in das oben angegebene Verzeichnis. Finally, check whether your really cannot reach the files from the interneth.
Current used IDs: 8000 - 8006
With this right, you can manage categories, that means you can edit, delete them or create new ones. Also you can set the permission of a categorie, if it's visible for unregistered users or not.
This right gives the admin the possiblity to edit or delete Downloads, and to change the preview-image. D
The Admin can change the plugin-settings.
You have access to the download-statistics.
You can import through FTP uploaded files.
Users can see the downloads-area and the "Last-Uploads"-Portalmodul.
With this right you can upload files to the webspace or insert external URLs.
Here you can manage all categories. They can be edited or deleted, or a new one can be created. Also the permissions can be set - if the category is visible to unregistered users or not.
Information: the permissions of a category overwrite the permission of local file: If a category is only visible for registered users, all Downloads in a Category are visible for registered users only. If the category is public, the permission a the download counts.
If you delete a category, all Downloads in the category will be deleted from the database and the webspace!! If you want to delete a categorie but keep the file on your webspace, move it before deleting the category to another category.
In Order to create a new download, at leaste one categorie is required.
On this page you'll find all downloads in their categories. Here they can be deleted, edited or new ones created. Multiple Downloads can be deleted, when you checked the related checkboxes an select "all marked... delete". Withe the checkbox on top of every categorie you can select a whole categorie.
On this page, the download-statistics are shown in a graph. You can select total, a category or a file. Also you can select year-, month- or week-view.
Insert here all allowed file-extensions. Seperate the extension with a comma. As an extension only the letters after the last point count. That means: "gz" is right than "tar.gz". But if a file-extension is allowed, this does not mean, that you can upload a file... Please see the chapter "Mime-Types" for this topic.
Most of webspace-offers have limited traffic. For this reason, you can set a maximum monthly traffic for the downloads. If the monthly traffix is reached, only external links or Mirrors can be reached, but no local files anymore. Leave this field empty, if you don't want a limit; insert "0" if you want to stop all local downloads.
In order to offer a continous availbility of your downlaods, you can enter mirrors when uploding. Mirrors are server that contain the exact same file. It helps you to save your traffic.
Getting feedback is important - for that reason, user can add their comments for a downloads, if this feature is enabled.
With this feature, you can enter for each download IDs of other downloads. These related downlaods are shown on the detail-page of a download. Related downloads have to be inserted for each downloads, that means if A belongs to B, then B does not automaticly belongs to A.
Before downloading a local file, unregistered user have to solve a CAPTCHA. This helps you saving your Traffic, because you can be shure, that only humans are downloading your local file. Enabling this feature is recommended! For this, you need a free account on reCAPTCHA.net. Put the private- and private-key to at PLUS-Settings-> Libraries!
This shows Statistics like the TOP5-Downloads, last uploaded file, and much more... unregistered users get other statistics as registered users, due to different permissions.
The Downloads can be managed in categories. If categories are disbled, all downloads are shown in only one list. If you activate this feature again, all existing categories will show up - nothing will be deleted... If files have been uploaded during deactivated categories, they will be moved into the categorie "Uncategorized" if you reactivate categories.
Shows an link to the download-area at the top of your page, right nead the raidplan- or portal-link. The Link can be changed in PLUS-Settings -> Links.
Downloads per Page. Standard is 100 downloads per page.
An automatic function checks, if there's an .htaccess-File in the .../data/.../downloads/files-Folder. If this is negative, the function tries to create one, else there will be an warning. As described above, the file is important and helps you to protect your webspace. DISABLING THIS FUNCTION IS NOT RECOMMENDED! Only for experienced Admins!
This activates collecting download-statistics and enabled the statistics-page.
To prevent a ton of data, data older xx days will be deleted automaticly. Leave field empty to disbable this function
Set the max. Size of an uploaded file. Leave field empty to disable a limit (the server-limit will be used, now). This function doesn't work with preview-images.
Set the max. Size of the upload-folder. Leave field empty to disable a limit. Preview-Images do not count!
When a new version of this plugin is realeased, you'll get an message. Enabling this function is recommended, because Update can bring new features, bug- and security-fixes.
If there's a problem while uploading a file, you can switch on the debug-mode. After that, try to upload the file again. Now you can an output with the extesion and the mime-type. If you make a Support-Call, these information are required, if your Question has to do with problems while uploading files.
While using an unstable or unreleased version of this plugin, a database-update has to be forced manually.
Because uploading a lot of files or big files is annoying trough a web-interface, you can upload files through FTP into the folder "data/.../downloads/files/". When opening the importer, you'll see all files in the upload-folder that are now stored in the database. Just select the files you want to import, change the Name and Description, Select the category and permission and import it. That's all.
This is the main-page of Downloads 4 EQdkp-plus. Normal users can here download files. But this page is also interestring for admins, because here they can edit und delete downloads also as upload ned ones, without going to the admin-area. On the overview-page, you can see all statistics (if enabled) and categories (if enabled; if disabled: all downloads). By clicking on a categories you'll see all downloads in a categorie. When you open a download, you'll get detailed information about the download, for example a preview image, Mirrors, related downloads, comments, and much more.
Either the download has the permission "registered" or the categorie in which the download is, has the permission "registered". Check, if the download has the permission "Public" and if it is in a category with the permission "Public".
The Update of 0.1.2 to 0.1.3 all uploaded files are moved from the folder ".../data/.../downloads" to the folder ".../data/.../downloads/files". No .htaccess-file may return in the folder ".../data/.../downloads", otherwise the preview-image are not shown up. Just delete the .htaccess from the folder named above. And pay attention, that the new folder ".../data/.../downloads/files" contains the .htaccess from chapter "Securing your webspace".
All of this actions should be done automaticly during the update-process.
Please ask for Support in following sections in our Forum:
Please do not write unprompted private messages to me!!
If you like this plugin, you can donate here: Amazon-Wishlist Paypal
This Plugin is available under the Creative Commons Licence: Attribution-Noncommercial-Share Alike 3.0 Unported.