EQdkp Plus Navigation:   Home  |   Forum  |   Wiki  |   Translate  |   Bugtracker  |   WebSVN  |  USVN

Downloads

From EQdkp Plus Wiki

Downloads-Plugin
Logo dl-plugin.png
Author GodMod
Last Version 0.4.0
Last stable Version 0.4.0
Creating a new download

Contents

About this Plugin

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.

Installation

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.

Updates

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.

Securing your webspace

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.

Rights

Current used IDs: 8000 - 8006

Admin-Rights

Manage Categories

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.

Manage Downloads

This right gives the admin the possiblity to edit or delete Downloads, and to change the preview-image. D

Config Settings

The Admin can change the plugin-settings.

Statistics

You have access to the download-statistics.

Import

You can import through FTP uploaded files.

User-Rights

View

Users can see the downloads-area and the "Last-Uploads"-Portalmodul.

Upload

With this right you can upload files to the webspace or insert external URLs.

Administration-Pages

Categories

Category-Management

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.

Downloads

Manage Downloads

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.

Statistics

Download-Statistics

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.

Settings

Settings

Allowed file-extension

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.

Max. monthly traffic

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.

Enable entering Mirrors

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.

Enable Comments

Getting feedback is important - for that reason, user can add their comments for a downloads, if this feature is enabled.

Related Downloads

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.

CAPTCHA for unregistered Users

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!

Show statistics

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.

Enable categories

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.

Show Link to the downloads-page on tab-menu

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

Downloads per Page. Standard is 100 downloads per page.

Disable .htaccess-Check

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!

Activate Statistics

This activates collecting download-statistics and enabled the statistics-page.

Prune Statistic-Data older than xx days

To prevent a ton of data, data older xx days will be deleted automaticly. Leave field empty to disbable this function

Max. Filesize

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.

Max. Size of Upload-Folder

Set the max. Size of the upload-folder. Leave field empty to disable a limit. Preview-Images do not count!

Enable check for new Plugin Versions

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.

Debug-Mode

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.

Force Datebase-Update

While using an unstable or unreleased version of this plugin, a database-update has to be forced manually.


Import

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.

Overview-Page

Overviewpage with statistics
Detail-Page of a download

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.

FAQ

Why is my download not shown, when I'm not logged in

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".

Updates

0.1.2 to 0.1.3

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.

Support

Please ask for Support in following sections in our Forum:

English Plugin-Section

Deutscher Plugin-Bereich

Please do not write unprompted private messages to me!!

If you like this plugin, you can donate here: Amazon-Wishlist Paypal

Licence

This Plugin is available under the Creative Commons Licence: Attribution-Noncommercial-Share Alike 3.0 Unported.