Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A WordPress plugin which provides an intuitive UI for uploading and managing downloadable files (including support for multiple versions), inserting download links into posts & logging downloads.


=== Download Monitor ===
Contributors: barrykooij, mikejolley
Donate link:
Tags: download, downloads, monitor, hits, download monitor, tracking, admin, count, counter, files, versions, download count, logging
Requires at least: 3.8
Tested up to: 4.1
Stable tag: 1.6.3
License: GPLv3

Download Monitor is a plugin for uploading and managing downloads, tracking downloads, and displaying links.

== Description ==

Download Monitor provides an interface for uploading and managing downloadable files (including support for multiple versions), inserting download links into posts, and logging downloads.

= Features =

* Add, edit and remove downloads from a familiar WP interface; just like posts.
* Quick-add panel for adding files whilst editing posts.
* Add multiple file versions to your downloads.
* Define alternative links (mirrors) per version.
* Categorise, tag, or add other meta to your downloads.
* Display download links on the frontend using shortcodes.
* Change the way download links get displayed via template files.
* Track downloads counts and log user download attempts.
* Member only downloads.
* Customisable endpoints for showing pretty download links.

[Read more about Download Monitor](

= Documentation =

Documentation will be maintained on the [GitHub Wiki here](

= Extensions =

Extensions, such as the __legacy importer__ and __page addon__ can be [found here]( Take a look!

= Contributing and reporting bugs =

You can contribute code to this plugin via GitHub: [](

You can contribute localizations via Transifex [](

= Support =

Use the forums for community support. If you spot a bug, you can of course log it on [Github]( instead where we can act upon it more efficiently.

If you want help with a customisation, hire a developer!

== Installation ==

= Automatic installation =

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New.

In the search field type "Download Monitor" and click Search Plugins. Once you've found the plugin you can view details about it such as the the point release, rating and description. Most importantly of course, you can install it by clicking _Install Now_.

= Manual installation =

The manual installation method involves downloading the plugin and uploading it to your webserver via your favourite FTP application.

* Download the plugin file to your computer and unzip it
* Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's `wp-content/plugins/` directory.
* Activate the plugin from the Plugins menu within the WordPress admin.

== Frequently Asked Questions ==

= I used this before, so why is this version 1? =

Version 1.0.0 is a fresh start/complete rewrite of the legacy 3.0 version using modern best-practices such as custom post types and endpoints. Because of this, data from the legacy plugin won't work without migration using [the legacy importer]( Since this upgrade process isn't straightforward nor automated I've reverted the version to 1.0.0 to prevent automatic updates.

Legacy versions can still be [found here](

= X feature/shortcode is missing from the legacy version; why? =

The rewrite has trimmed the fat and only kept the best, most useful features. If something is missing, you can always code it yourself - the new system is very flexible and its easy to query files using [get_posts](

If you are missing the "Page Addon", this is now a separate plugin found here: [Download Monitor Page Addon](

= Can I upload .xxx filetype using the uploader? =

Download Monitor uses the WordPress uploader for uploading files. By default these formats are supported:

* Images - .jpg, .jpeg, .png, .gif
* Documents - .pdf, .doc, .docx, .ppt, .pptx, .pps, .ppsx, .odt, .xls, .xlsx
* Music - .mp3, .m4a, .ogg, .wav
* Video - .mp4, .m4v, .mov, .wmv, .avi, .mpg, .ogv, .3gp, .3g2

To add more you can use a plugin, or filters. This post is a good resource for doing it with filters: [Change WordPress Upload Mime Types](

= Can I link to external downloads? =

Yes, you can use both local paths and external URLs.

= My Download links 404 =

Download links are powered by endpoints. If you find them 404'ing, go to Settings > Permalinks and save. This will flush the permalinks and allow our endpoints to be added.

= Download counts are not increasing when I download something =

Admin hits are not counted, log out and try!

== Screenshots ==

1. The main admin screen lists your downloads using familiar WordPress UI.
2. Easily add file information and multiple versions.
3. The quick add panel can be opened via a link about the post editor. This lets you quickly add a file and insert it into a post.
4. Display regular download links or fancy ones all using shortcodes and templates.

== Changelog ==

= 1.6.3 =
* Fixed an undefined method call 'get_filesize'.
* Allow third party extensions to hijack [downloads] shortcode with filter dlm_shortcode_download_content.
* Made 'wp_dlm_downloading' cookie only accessible through the HTTP protocol, props [Matt Mower](

= 1.6.2 =
* Fixed a bug that caused translations not to load.
* Fixed a bug that prevented download versions from being removed.
* Fixed a pagination in 'insert download' shortcode bug.
* Fixed a bug in the template loader when used with a custom directory, a slug and no custom template.
* Removed assigning by reference, fixed strict notice when deleting downloads.
* Tweaked template loader to accept arguments.
* Allow downloads shortcode WP_Query arguments to be filtered with 'dlm_shortcode_downloads_args'.

= 1.6.1 =
* Fixed an extension activation error.
* Fixed a bug that caused the featured image to disappear in some themes.
* Tweak: In multisite only users that are a member of the blog can download 'member only' downloads.

= 1.6.0 =
* Plugin is now initiated at plugins_loaded.
* Implemented auto loader.
* Classes are no longer initiated at bottom of class file but whenever an object is needed.
* Code standards corrections.
* Introduced Template_Handler. Loading of template parts should be done through this class.
* Removed $GLOBALS['dlm_logging'] global.
* Removed $GLOBALS['DLM_Download_Handler'] global.
* Removed internal use of $download_monitor global.
* Moved all inline JavaScript to separate JavaScript files.
* Moved all install related code to installer class.
* Moved main plugin class to it's own file.
* Deprecated 'dlm_create_log' function.
* Redone extensions page.
* Fixed a bug in shortcode download where orderby=download_count wasn't working.
* Fixed a bug where downloads didn't work with default WP permalink structure.
* Delete dlm_file_version_ids_ transient on save.
* Added dlm_download_headers filter.
* Added dlm_get_template_part filter.

= 1.5.1 =
* Fallback for JSON_UNESCAPED_UNICODE to fix accented characters on < PHP 5.4.
* Changed default orderby for downloads shortcode to date, desc.

= 1.5.0 =
* JSON_UNESCAPED_UNICODE for files to fix unicode chars when json encoded. Fix needs PHP 5.4+ to work, but won't break lower versions.
* Style filetype-docx
* Update get_version_id to work with non-numeric versions.
* Fix shortcode arg booleans.
* Add transient cache for get_file_version_ids.
* Moved all translations to Transifex -
* Changed text domain from download_monitor to download-monitor.
* Added Grunt.
* Added options to generate file hashes DISABLED BY DEFAULT as they can cause performance issues with large files.

= 1.4.4 =
* Use home_dir instead of site_dir - fixes hot-linking protections against own site (when not in root dir)
* Replace hardcoded WP_CONTENT_DIR and WP_CONTENT_URL with wp_upload_dir to work when UPLOADS and UPLOADS_URL constants are set.
* Added some filters for hotlink protection customisation.

= 1.4.3 =
* Add password form to download page when required
* Run shortcodes in excerpt/short desc
* Various hook additions
* pr_br and zh_cn translation
* Sort download count by meta_value_num
* Store URLs in JSON format to allow easier search/replace
* Fix dashboard sorting
* Option for basic referer checking to prevent hotlinking.
* Only get file hashes on save as they are resource heavy.
* Disable remote file hash generation, but can be enabled with filter dlm_allow_remote_hash_file
* Radio buttons instead of select (with pagination) in popup to improve performance.

= 1.4.2 =
* Fix for site_url -> abspath
* Check if hash functions are supported before use.

= 1.4.1 =
* Fix file_exists error in download handlers

= 1.4.0 =
* MP6/3.8 admin styling. Requires 3.8.
* Polish translation.
* Turkish translation.
* Change capability required to view dashboard widget.
* Don't show "insert download" when editing a download.
* Allow pagination for the [downloads] shortcode. Simply add paginate=true to the shortcode.
* Reverted flush change in download handler to reduce memory usage on some hosting envrionments
* changed download handlers and fixed corruption when resuming files
* Calculate md5/sha1/crc32 hashes for files. Obtainable via methods or download_data, e.g. [download_data id="86" data="md5"]
* Added file_date data

= 1.3.2 =
* Cleaned up log table queries
* Tweaked download handler headers
* Tweaked logging
* Limit UA to 200
* Setcookie to prevent double logging
* Addons page (disable using add_filter( 'dlm_show_addons_page', '__return_false' ); )

= 1.3.1 =
* Added some new hooks
* FR and SR_RS updates

= 1.3.0 =
* Fix 0kb downloads in some hosting enviroments
* Added button to delete logs
* Fixed log page when no logs are present
* FR and HU updates
* Added dropdown for the default template option to make available templates more obvious
* Added version-list and title templates

= 1.2.0 =
* Option to redirect to files only (do not force)
* Fixed textdomains
* HU translation by Győző Farkas
* Fix dlm_upload folder when not using month/day upload folders.
* Fix IP lookup
* Resumable download support
* Tweaked download handler

= 1.1.2 =
* HTTPS headers for IE fix
* Italian locale

= 1.1.1 =
* Specify error statuses on wp_die messages e.g. 404 for missing files.

= 1.1.0 =
* Fixed admin notices
* Added download link to admin 'file' column for copying and pasting
* Farsi localisation
* Wrapping content in a [download] shortcode will wrap it in a simple link.

= 1.0.6 =
* Hide taxonomies from nav menus
* Fix categories in download_data method.

= 1.0.5 =
* When do_not_force is enabled, still replace abspath with home_url
* Exclude dlm_download from search and disable query var
* Added category_include_children option for downloads shortcode
* Fixed logs time offset.

= 1.0.4 =
* Tweak admin page detection to work when no downloads exist.
* Fix dashboard widget warning.
* Add filters to logs and export csv function.
* Added extra columns to CSV.

= 1.0.3 =
* Fix config page to work with multibyte tab names.
* Japanese locale by hide92795
* Admin CSS/script conditonally loaded
* Versions are now strtolower to be compatible with version_compare and to standardise numbers.

= 1.0.2 =
* Only use wp_remote_head to get fielsize on remote files. Prevents timeouts when a file doesn't exist.
* If a filesize cannot be found, set to -1 to prevent re-tries.
* Insert button added to all CPT except downloads.
* French locale by Jean-Michel MEYER.

= 1.0.1 =
* Update blockui
* Workaround root relative URLS

= 1.0.0 =
* Complete rewrite of the plugin making use of custom post types and other best practices. Fresh start version '1' to prevent auto-updates (legacy importer needs to be used to migrate from old versions).

== Upgrade Notice ==

= 1.6.0 =
If you're using the Page Addon or Amazon S3 extension you must update these extensions too. Visit for more information.
Something went wrong with that request. Please try again.