Using e107:Content:Downloads

From e107 Wiki
Jump to: navigation, search

e107 Wiki: English | Русский | Deutsch | Français | Magyar | Português | Български | Česky | Nederlands | Ελληνικά | Italiano | Norske | Polska | Slovenščina | Español | Svenska | Translate: Wiki | Page

logo_wiki.png

Current Release 1.0.4 | e107.org | Download | Changelog | Forum | Plugins | Themes | RSS Feed of Latest Changes | Atom Feed of Latest Changes


Third part of the e107 handbook
Main page > I : First Aid > II : Development > III : Administration > IV : How To's > V : Plugin Writing > VI : Theming & Shortcodes


Contents

Introduction

Using the integrated download system with e107 is very useful but can be a little tricky to get the files up there. So please look at uploading before you read on managing the downloads.

Uploading

There are 3 options essentialy with file uploading

Admin Uploading

Found in 'Admin > File Manager'

Simply select 'Files Directory' from the directory drop down. A list of files and folders will be presented. find the folder 'Downloads' and click the button to the far right of it labeled 'Upload file to this dir'

Note make sure file uploading is enabled (see HOWTO:Enable File Uploads)

Public Uploading

Configured in 'Admin > Public uploads'

Public users can then upload using the 'upload.php' file. found in the root of the site. an admin will then need to review and submit the download to the site via the admin area.

Note make sure file uploading is enabled (see HOWTO:Enable File Uploads)

FTP

Find an FTP program you are comfortable with and upload to the 'e107_files/downloads/' directory

Using Downloads

found in the admin area under Content > Downloads

Downloads Front Page

This page will display all your existing downloads. It displays the following columns:

  • ID

The unique number of download file. They will be sorted descending (new to old). Deleted downloads will create harmless 'gaps' in the numbering sequence.

  • Download

The name you gave to the download

  • Class

The class of users that is allowed to download.

  • Options

In the options column two icons should be visible: Edit and Delete. Clicking the Edit icon brings you to the maintenance function of the specific download. See for details Create Download. Clicking the Delete button will erase the download entry from the list. It will not physically delete the download file itself.

Create Download

This menu option gives an admin user the possibility to add a new download by defining the following fields:

  • Category

Drop down selection list of available categories. See Categories.

  • Name

Name of the plugin file to identify it.

  • File

Select local file will display a drop down selection list of all files available in the directory /e107_files/downloads/. When clicking on "Or click here to use an external file" the following choices are possible: URL and Enter filesize, to respectively fill in the URL where the download file resides and the file size in kB.

  • Mirrors

Typically, when no mirrors are defined the message "No mirrors defined in mirror section." will show up. See Mirrors

  • Author

Free text field to display name of the author. Field is optional.

  • Author Email

Free text field to display e-mail address of the author. Field is optional.

  • Author Website

Free text field to display website of the author. Field is optional.

  • Description

Free text field to enter a large description about the download file. Field is optional.

  • Main image

Drop down selection list of available image files in directory /e107_files/downloadimages/. Choice is optional.

  • Thumbnail image

Drop down selection list of available image files in directory /e107_files/downloadthumbs/. Choice is optional.

  • Date stamp

Possiblity to select a date with the calendar selection. For new entries the default is todays date. There is a check to update date stamp to current time; if selected date will be set automatically to todays date (especially handy when updating/editing existing download entries).

  • Status

Select one of the possible choices: Inactive | Active, file is subject to download limits | Active, file is NOT subject to download limits

  • Allow Comments?

Select one of possible choices: Yes or No

  • Download visible to

Shows the download to the selected user class. Typical choices available are: Everyone (public) | No one (inactive) | Members | Admin.

  • May be download by

File can be downloaded by selected user class. Typical choices available are: Everyone (public) | No one (inactive) | Members | Admin. In this way it is possible to display a download file to everybody, but make it available for download for site members.

Categories

The download category screen is divided in two parts. The top part shows all available categories. It displays the category icon, the category name and description, the number of download files in the category, an order number and the option to edit an existing category. With the 'order number' it is possible to arrange the categories in a different order. Press button 'Update' to submit your entered order preferences.

ATTENTION For the downloads to work correctly the categories must be two levels deep. So just creating a category and add downloads to them will not work.

For example...

   Software                      <- Main-Category
       Antivirus                 <- Sub-Category
           Antivir.zip           <- Download
   Utilities                     <- Main-Category
       Admin Tools               <- Sub-Category
           defraggler.zip        <- Download
           ccleaner.zip          <- Download


The bottom part shows a possibility to enter a new category.

  • Parent

It is possible to create sub-categories if there is at least one parent.

  • Name

The name of the download category.

  • Description

Description of the download category.

  • Icon

Name of the icon file in directory /e107_images/icons. When clicking on 'View Images' the icon list from directory /e107_images/icons is displayed to choose from, clicking an icon automatically fills in the name of the icon file.

  • Icon for empty category

Name of the icon file in directory /e107_images/icons. When clicking on 'View Images' the icon list from directory /e107_images/icons is displayed to choose from, clicking an icon automatically fills in the name of the icon file. This field is optional; when left empty the category icon file will be used.

  • Visible to

Select the category visible to only users in that class. Typical choices available are: Everyone (public) | No one (inactive) | Members.

Use button 'Create Category' to save the entered values.

Options

  • Downloads handled by PHP

Checking this will send all download requests through PHP.

  • Number of downloads to display per page

Choose between 5, 10, 15, 20 or 50.

  • Sort by

Select one of the possible values: Id No. | Date | Downloads | Filename | Author

  • Order

Select one of the possible values: Ascending | Descending

  • Broken-download reporting available to

Select the user class

  • Email admin when broken download reported

When checked an e-mail will be send to the head admin when a user reports a broken download.

  • Activate Download Agreement

When checked the Agreement Text will be displayed in a pop-up screen, before the actual download starts.

  • Agreement Text

Free text message that could be passed to the downloaders of your website.

  • Custom Download-denial message or URL

Free text message that will be passed to people that click to download the file, but are not authorized to download. In this way you could redirect visitors e.g. to the sign up page.

Limits

To restrict the use of bandwidth on your website, it is possible to set limits per user class. In the first field fill in the number of downloads per number of days. You can combine this with the number of kB's per number of days. This option could be used if your bandwidth is limited or if your download section is extremely popular.

Mirrors

On the Internet, a mirror site is an exact copy of another Internet site. Mirror sites are most commonly used to provide multiple sources of the same information, and are of particular value as a way of providing reliable access to large downloads. Mirroring is a type of file synchronization. In e107 the download mirrors can be used to spread the download capacity by dividing the downloads over multiple sites. The mirror screen is divided in two parts. The top part shows all available mirrors.

The bottom part shows a possibility to enter a new mirror. The admin user can define the following fields:

  • Name

Name of the mirror

  • Address

URL of the mirror

  • image

Name of the image file. Upload local images to directory /e107_files/downloadimages to show them here, or enter full address if image is remote.

  • Location

Free text field of where the mirror resides.

  • Description

Free text field for a description of the mirror.

In Video

{{#ev:youtube|FA4ilhuG_VM}} by spinningplanet

  • A brief overview of our Downloads Module

{{#ev:youtube|rK1oZjoFFMM}} by spinningplanet

  • Downloads Tutorial Module

{{#ev:youtube|S1lBk7uWJx0}} by BAW1994

  • E107 Tutorial - 4 - Downloads & Uploads