Drain Hole Plugin


Download: Drain Hole
Version: 2.2.8
Supports: WordPress 2.5-2.9
Other: This plugin is no longer actively maintained

Drain Hole is a centralized download manager, with full monitoring and statistics, versioning, SVN support, and SEO download URLs (no more nasty query strings!).

In addition to it’s monitoring abilities, Drain Hole has a run-time tag replacement feature that lets you embed special tags in your post which are replaced with information from Drain Hole. For example, you can embed download URLs, version information, last update times, and so on. Whenever you change a downloadable file it is automatically updated throughout your blog, without you needing to change anything else.

Features include:

  • SEO download URLs – a unique feature that allows files to look like real links
  • Local or remote file storage – keep your files on your own server or have them stored somewhere else such as Amazon S3 or wordpress.org
  • SVN support – attach a file directly to an SVN repository and have the contents automatically updated
  • Versioning – maintain multiple versions of a file, allowing users to download older files
  • Full download statistics, including number of downloads, access times, referrer, and download speed, available as CSV and Flash-based graphs
  • Download security – permissions can be assigned to downloads (including Flash files), restricting them to WordPress roles
  • Template tags – insert dynamic download data into posts, and into the sidebar as a Widget
  • Hot-link protection
  • Fully localized


Installation is like any WordPress plugin:

  • Download Drain Hole
  • Unzip
  • Upload drain-hole directory to /wp-content/plugins on your server
  • Activate the plugin
  • Use Drain Hole from the Manage/Drain Hole menu

You can find full details of installing a plugin on the plugin installation page. SVN access to the plugin is provided at the SVN repository.

General Concepts

The Drain Hole plugin makes use of two fundamental concepts:

  • Drain hole – a base URL and associated directory where files are stored and downloaded from
  • Files – a file belongs to a particular Drain hole

It is important to understand the mapping between a Drain Hole’s URL and its associated directory. To do this you need to know two pieces of information:

  1. Where files are to be downloaded from (i.e. http://urbangiraffe.com/download/)
  2. Where files are to be stored (i.e /users/john/download/)

This is a mapping from URL to directory:

http://urbangiraffe.com/download/ => /users/john/download/

All files inside the directory will be available at the Drain Hole URL. For example:

/users/john/download/myplugin.zip => http://urbangiraffe.com/download/myplugin.zip

It is preferable that your directory is not in a public location (i.e. in public_html) as Drain Hole may not then be able to function. Your URL must be part of your WordPress installation, but you should not create a directory for it.

Creating a Drain Hole

New Drain Holes require the following information:

New Drain Hole

The URL is the URL on your website at which to make the files available. The directory is the real directory in which the files exist. These two values do not have to match up and the files do not (and ideally should not) be publicly available.

Once a Drain Hole has been created you can then edit it from the list of Drain Holes:

Drain Holes

Editing a Drain Hole will allow you to set additional options:

Edit Hole

The Access Level is the minimum user level required to download files from the hole. This allows you to restrict download access to certain types of user. If a user does not meet the required access level then they will be returned a 404 error page or will be redirected to the configured URL.

The Stop Hot-links option allows you to stop external users from downloading files in the hole. This protection is achieved by analyzing the referring page for a given download – if the referrer is not from your site then the user is sent a 404 error page or redirect to the error URL.


A Drain Hole can contain any number of files and sub-directories.


As with the rest of the plugin, columns are sortable, and data can be searched.

Each file allows you to:

  • Edit the file configuration
  • Manage version history (by clicking on the version number)
  • View download statistics (by clicking on the number of hits or the charts link)
  • Create a new version or update from SVN (by clicking on the branch link)

When editing a file you will be shown additional configuration details:

Edit File

The filename is the actual name of the file and this may differ from the name, which is what will be shown in a download link. If no name is given then the filename will be used. As an extra function, you can insert $version$ into the name and it will be replaced with the file’s current version.

The description is a free-form field allowing you to enter further details about the download. This can be shown when the file is displayed.

The SVN field allows you to enter an SVN repository. See the SVN section later.

When displaying a file to download, an icon can be shown. You can change which icon is shown when editing a file.

The MIME type allows you to specify a custom MIME type for the file. This may be useful if you want a file to open inside the browser. If set to ‘automatic’ then Drain Hole will try and decide what the file is.

Forcing a download allows you to override default browser behaviour and force the file to always be downloaded. This is useful if you have a file that a browser usually tries to open (for example, a PDF), but you want it to always be downloaded.

Forcing the access level is an advanced option that is useful if you are trying to restrict files that are used inside Flash. For example, you may have a video tutorial that you want to restrict to registered users only. The flash video player requires your video file to be available, but may not provide any restriction options. Storing the video inside Drain Hole and then forcing the access level will ensure that only allowed users can access the file, even inside Flash.

Adding new files

New files can be added by any of these methods:

  • Uploading a file directly into the Drain Hole directory and ‘rescanning’
  • Uploading a file through the browser
  • Creating an empty file which can be uploaded later, or which requires an SVN repository

Add File


Drain Hole allows you to retain old versions of files, either for archiving purposes or for user downloads. To modify a file’s version you need to create a new branch:


You can enter details about the reason for the new version, and this will be presented to the end user. To retain an old version you must check ‘retain old version’. This old version can be downloaded as follows:



Drain Hole provides simple SVN functionality that allows you to associate a file with an SVN repository. A file that uses SVN can then be ‘refreshed’ directly from the SVN repository, rather than requiring you to manually update the file.

SVN functionality requires that you have SVN installed on your host. You must configure the Drain Hole options and provide the full path to the svn executable. If you are in doubt you should consult your host for details.

When an SVN-based file is refreshed, Drain Hole will use SVN to retrieve the latest copy of the files. If a repository contains multiple files they will be automatically zipped.

As additional functionality, Drain Hole will detect if the SVN repository is for a WordPress plugin, and will automatically set the version according to the version information inside the plugin.

Note that no direct capabilities are provided for username and passwords. However, you can pass a username and password to SVN by including it on the SVN field:

http://svn.mysite.com/plugin/trunk/ --username=john --password=thing

Download As – Remote File Storage

With version 2.2, Drain Hole now allows you to keep your files stored on a remote server. For example, you may want to have the files stored on Amazon’s S3. To achieve this you can enter the full URL of the remote file in the ‘download as’ field on a file.

Note that entering a filename in the ‘download as’ will allow you to have the file download with a name different to the original. Additionally, if you enter $version$ in this filename then Drain Hole will automatically replace it with the file’s current version. This will be useful if you want one download URL that when clicked will download a versioned file.

Download Tags

The following tags can be inserted inside posts and pages to embed Drain Hole information. This information is generated dynamically, and will change whenever the underlying information changes:

  • [drain hole ID hits] – Displays the total number of hits from the specified hole ID
  • [drain hole ID show] – Show a list of all files in the specified hole (change display code by copying view/drain-hole/show_hole.php from the Drain Hole plugin directory to the same directory path in your theme’s directory and editing the file)
  • [drain file ID show template] – Displays the download template for the specified file ID. ‘template‘ is optional and can be ignored (the default template will be used)
  • [drain file ID version] – Displays the version of the specified file
  • [drain file ID versions limit] – Displays the specified number of versions from the file’s history
  • [drain file ID hits] – Displays the total downloads for the specified file
  • [drain file ID url name] – Displays a URL allowing the specified file to be downloaded. ‘name‘ is optional and is the text that will appear inside the download link (if not specified then the filename is used)
  • [drain file ID updated] – Displays the update time of the specified file
  • [drain file ID size] – Displays the size of the specified file
  • [drain file ID icon] – Displays the download icon for the specified file
  • [drain file ID href] – Displays the URL of the file

Where ID refers to the ID of the file or hole, as shown in the Drain Hole administration pages.

Download Templates & File Icons

A download template is a section of HTML code that is used to display all the information for a file download. For example, on this page in the top right corner is the download for Drain Hole itself. The icon and file information are all part of a download template that is re-used on each of the other plugin pages available from this site.

A download template is a file that is stored in your theme directory and contains standard HTML as well as special Drain Hole template tags:

  • $icon$
  • $url$
  • $version$
  • $updated$
  • $size$
  • $href$

These template tags function similar to the post & page tags, but do not require an ID to be specified.

A default template is provided with Drain Hole. Custom templates are PHP files that are stored in view/drain-hole, inside your theme directory. For example, if you are using the default WordPress theme then:


To use this template in a post you would insert the tag:

[drain file 5 show mytemplate]

This tells Drain Hole to use ‘mytemplate.php‘ to display file 5.

Custom icons can be stored inside your theme:



Drain Hole provides full download statistics:


Support & Bugs

This plugin is no longer actively maintained.

438 thoughts on “Drain Hole Plugin”

  1. Hi, this is a really cool plugin!

    Is there by any chance a way to disable the parsing of the version in the title of the link drain hole generates when using the [drain file ID url name] tag to invoke the function?

    Also if there were ways to better manipulate the parsing of the url when using [drain hole ID show] tag that would be so cool! Like for example using the folder name only instead of the whole path (folder+filename).

    Flexibility would definitely make this to a very mighty downloadmanager…

  2. When I want to edit the title or description of a file, the grey Ajax pop-up window remains empty. I rum WP 2.9.2 and the latest version of drainhole.

  3. Hi! I am considering this plugin to replace wp-downloadmanager (no longer supported) on a massive site with many files. However, I am wondering if this plugin is compatible with WordPress 3.0 multisite? Since MU merged with WordPress, I’d like to begin rolling out multiple sites, but I need a compatible plugin first. It would be amazing if this plugin could share files across the WordPress network (and/or allow sharing within single site as well). Thank you!

  4. I just wanted to drop you a note saying how much I’ve loved Drain Hole. I taught an undergraduate course this summer, and used Drain Hole to manage access to lecture slides and protected course content, and it worked like a charm. Thanks again.

  5. I like Drainhole, but am struggling with it in several simple
    places. I added a code mod to file.php: Purpose: to check the role
    name of the user against the role name given to the specific drain
    hole. I needed this to check names of roles, not just capabilities.
    Here’s the new code: // CHECK ROLE NAME FIRST! // FIX: Dan
    Linstedt, December 16th, 2010 $match = 0; if
    $match = 1; if
    $match = 1; // Current User Role Name doesn’t match role needed for
    access! if ($match == 0) return false; // END FIX FUNCTION:
    have_access, right after the code: global $wp_roles; $caps =
    $wp_roles->get_role ($hole->role); Hope this helps, Dan L

  6. Great job for this plugin. I am using it instead of Download Manager. Your plugin is simple and easy to use. That’s what we are looking for. A simple thing.

    Thank you again for this plugin. Will tell you if there is a bug.

  7. Hi i already reported that large files didn’t download. For that issue our teamleader changed the code in plugin file. now its working fine. can you please add the code in drainhole/models/file.php

    1.comment/remove the function readfile ($this->file ($hole, $version))
    2.add the following code
    //code starts
    $file = @fopen($this->file ($hole, $version),”rb”);
    if ($file) {
    while(!feof($file)) {
    print(fread($file, 1024*8));
    if (connection_status()!=0) {
    //code ends

    I saw in forum many of them asking this question.who are all need this means use it.If any other solution means welcome.

  8. Hi, Just want to know if there a way to dynamically create drain holes for wordpress registered users.
    I plan to use it with clients, so they can upload artwork, and each client needs his own drain hole.

    Thanks for all

  9. I like your plugin very much.

    How would I be able to make it available to roles other than the Administrator?

    For a site I’m building, Editors and the Administrator will need to upload files and to refer to these files on their posts/pages.

    Can this be done or am I missing something?

    Thanks for your help

Comments are closed.