=== Autodownload ===
Contributors: fbern
Donate link: http://www.fabiobernasconi.com/donatingdonating
Tags: download, post, page, common, plugin
Requires at least: 2.0.2
Tested up to: 2.7.1
Stable tag: 1.3

Autodownload enables you to link to files in your posts and pages without
interacting with Wordpress. 

== Description ==

Autodownload is a WordPress plugin that enables your blog to provide links 
to files either in your posts or pages. Emphasize has been put on ease of 
use and thus it does most of the things automagically. Autodownload is easy
to install. Installation lasts less than 5 minutes. Once a download folder
for a given post or blog was defined, adding links to files is as easy
as uploading them to a folder. Links are then automatically
generated and inserted in your post/page - everything without interacting 
with Wordpress

Features
* Works with posts and pages
* Almost no configuration (one configuration variable)
* Automatically generates links to files and wraps them in either html list items or table
* Multiple download sources within one post or page
* Files can be sorted either by name or by modification time
* Rplaces occurences of file names in a post or a page
* Support for link descriptions 

== Installation ==

This section describes how to install the plugin.
<br><br>For **complete instructions** on how to perform the installation, please see
[Autodownload homepage](http://www.fabiobernasconi.com/code/autodownload).

1. Download autodownload-1.1.zip
1. Unpack the archive and upload it to your WordPress plugins directory 
   (usually wp-content/plugins)
1. [optional] If you want to change the default download root directory 
   (it defaults to wp-content/) then go to the Autodownload options 
   page and change the root directory
1. In any post or page you want to provide downloadable files you must call 
   a `ad__*` function. See the table below for available functions and 
   their arguments. A function call is always enclosed in a HTML comment. 
   The first argument is always a path relative to the absolute path defined 
   in the Autodownload options page (or `wp-content` by default). The second argument 
   is always the sort order. A typical call would look like this
   `<!-- ad__filesListLI(path/to/dir, date, ol, , color:red) -->`
   **!!! Please make sure to preserve the space before and after the function call !!!**
   You may want to refer to the table below for an in-depth explanation of the arguments.
   For security reasons only functions with a *ad__* prefix will be called by the plugin. 
   Any other function name is ignored.
1. [optional] If you want to add a description too the link either add a file named 
   `ad_descritions.desc` (the first entry is for the first file, the second entry for 
   second file, etc.) in the directory where your files reside or, for each file in the 
   directory, create a text file with the equal name but with extension `.desc` 
   (i.e. `myFile.tar.gz` and `myFile.tar.gz.desc`). The file `ad_descriptions.desc` 
   has precedence over individual comment files. 
 
**API change in version 1.2.2 and above!** Calls to ad__filesListLI should not be 
wrapped in html list entities anymore! 

The function table can be found on the [Autodownload homepage](http://www.fabiobernasconi.com/code/autodownload/#table).

== Frequently Asked Questions ==

None at the moment :-(

== Screenshots ==

1. Screenshot showing the (only) configuration variable for the autodownload plugin
2. Backend. That's how a post/page source looks like
3. Result of what was defined in the post/page source.