PHP Other
Latest commit 75a8400 Dec 8, 2016 @lesterchan Bump WordPress 4.7


Contributors: GamerZ
Donate link:
Tags: file, files, download, downloads, manager, downloadmanager, downloadsmanager, filemanager, filesmanager
Requires at least: 4.0
Tested up to: 4.7
Stable tag: 1.68.2
License: GPLv2

Adds a simple download manager to your WordPress blog.


Build Status

Build Status





  • I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.


Version 1.68.2

  • NEW: WordPress 4.7
  • FIXED: Pagination not working
  • FIXED: Remove eregi
  • FIXED: Remote file URL will get be broken, if the remote file URL gets really ugly

Version 1.68.1

  • NEW: Uses wp_kses_post() for better field sanitization

Version 1.68

  • NEW: Use to translate the plugin
  • FIXED: Some WP doesn't have wp_user_level because it has been deprecated

Version 1.67

  • FIXED: Notices

Version 1.66

  • FIXED: Notices in Widget Constructor for WordPress 4.3

Version 1.65

  • FIXED: Integration with WP-Stats

Version 1.64

  • NEW: Supports WordPress MultiSite Network Activate
  • NEW: Uses native WordPress uninstall.php
  • FIXED: Notices

Version 1.63

  • NEW: Added %FILE_EXT% template variable that output the file extension
  • FIXED: Editor button was outputting the wrong shortcode.
  • FIXED: ReferenceError: downloadssEdL10n is not defined if TinyMCE 4.0 is loaded outside the Add/Edit Posts/Pages.
  • FIXED: Added backward compatibility with [download=1] in order not to break older downloads.

Version 1.62

  • NEW: Uses Dash Icons
  • NEW: Supports TinyMCE 4.0 For WordPress 3.9
  • NEW: Added sorting to embedded downloads. Props ksze.
  • NEW: You can now choose to display file sizes in either binary base or decimal base (i.e. KiB vs KB), using either %FILE_SIZE or %FILE_SIZE_DEC; %CATEGORY_SIZE and %TOTAL_SIZE also have their _DEC counterparts.. Props ksze.

Version 1.61

  • FIXED: Added nonce to Options. Credits to Charlie Eriksen via Secunia SVCRP.

Version 1.60 (08-11-2010)

  • NEW: Display File ID In Message After Adding A File
  • FIXED: Bug In Remote File With Using Nice Permalink and File Name

Version 1.50 (01-06-2009)

  • NEW: Works For WordPress 2.8 Only
  • NEW: Add "Add File" To WordPress Favourite Actions
  • NEW: Minified editor_plugin.js And Added Non-Minified
  • NEW: Moved File Extension Icons To /images/ext/
  • NEW: Added %FILE_CATEGORY_ID% Template Variable To Download Listing, Download Embedded And Most Downloaded Templates
  • NEW: You Can Now Use File Name Instead Of File ID In The URL Via WP-Admin -> Downloads -> Download Options
  • NEW: Ability To Filter Downloads By Keyword In The Backend
  • NEW: Added Downloads RSS2 Feed
  • NEW: Finer Control Of File Download Permission (At Least Contributor, Author, Editor Or Administrator Role)
  • NEW: Use _n() Instead Of __ngettext() And _n_noop() Instead Of __ngettext_noop()
  • NEW: Uses New Widget Class From WordPress
  • NEW: Merge Widget Code To wp-downloadmanager.php And Remove wp-downloadmanager-widget.php
  • FIXED: Uses $SERVER['PHP_SELF'] With plugin_basename(__FILE_) Instead Of Just $_SERVER['REQUEST_URI']

Version 1.40 (12-12-2008)

  • NEW: Works For WordPress 2.7 Only
  • NEW: Load Admin JS And CSS Only In WP-DownloadManager Admin Pages
  • NEW: Added download-admin-css.css For WP-DownloadManager Admin CSS Styles
  • NEW: Uses wp_register_style(), wp_print_styles(), plugins_url() And site_url()
  • NEW: Download ShortCode Now Support Category by Kambiz R. Khojasteh
  • NEW: Right To Left Language Support by Kambiz R. Khojasteh
  • NEW: Output Of downloads_page() And download_embedded() Respectively Applied To "downloads_page" And "download_embedded" Filters by Kambiz R. Khojasteh
  • NEW: Call downloadmanager_textdomain() Inside create_download_table() by Kambiz R. Khojasteh
  • FIXED: SSL Support
  • FIXED: Removed Hard Coded "text-align" Styles And Align Attributes In Widget And Plugin Options by Kambiz R. Khojasteh

Version 1.31 (16-07-2008)

  • NEW: Works For WordPress 2.6
  • NEW: Better Translation Using __ngetext() by Anna Ozeritskaya
  • FIXED: MYSQL Charset Issue Should Be Solved
  • FIXED: Able To Search More Than 1 Word

Version 1.30 (01-06-2008)

  • NEW: Works For WordPress 2.5 Only
  • NEW: Added Search Feature
  • NEW: No Files Found Template
  • NEW: [page_download category="1"] Will Display Downloads In Category ID 1 Only
  • NEW: Use KiB/MiB/GiB/TiB Instead Of KB/MB/GB/TB
  • NEW: Added Paging Header And Footer Template For Downloads Page
  • NEW: Uses WP-PageNavi Style Paging For Downloads Page
  • NEW: Additional %CATEGORY_ID% Variable In Category Header And Footer Template
  • NEW: Updated WP-DownloadManager TinyMCE Plugin To Work With TinyMCE 3.0
  • NEW: Uses Shortcode API
  • NEW: Changed [page_downloads] to ### [page_download] ### For Consistency
  • NEW: You Can Now Embed Multiple File Download IDs By Doing This: [download id="1,2,3"], Where 1,2,3 Are Your File Download IDs
  • NEW: When Inserting File Download Into Post, It is Now [download id="1"], Where 1 Is Your File Download ID
  • NEW: Ability To Input File Size Manually Because Remote File Size Does Not Always Work
  • NEW: Added New File Permission, 'Hidden'
  • NEW: Uses /wp-downloadmanager/ Folder Instead Of /downloadmanager/
  • NEW: Uses wp-downloadmanager.php Instead Of downloadmanager.php
  • NEW: Uses wp-downloadmanager-widget.php Instead Of download-widget.php
  • NEW: Use number_format_i18n() Instead
  • NEW: Able To Choose Download Nice Permalink In 'WP-Admin -> Downloads -> Download Options'
  • NEW: Added File Extension Icons
  • NEW: Added File Last Downloaded Date Column
  • NEW: Added File Last Updated Date Column
  • NEW: Added %FILE_UPDATED_DATE% And %FILE_UPDATED_TIME% Template Variables
  • NEW: Added Download Page Link Template
  • NEW: Option To Display Download Page Link In Most Downloaded Widget And Recent Downloads Widget
  • FIXED: "Current File" Will Mess Up With The File Size
  • FIXED: If SubFolders Do Not Exists, It Will Display PHP Error Message
  • FIXED: Replaced get_newest_downloads() With get_recent_downloads()
  • FIXED: Recent Downloads Widget Not Working
  • FIXED: Conflict Permalink Structure With /%postname%/%post_id/
  • FIXED: TinyMCE Tool Tip For Insert File Download Is Not Translated
  • FIXED: Category Name Template Not Displaying Category Name

Version 1.00 (01-10-2007)

  • NEW: Initial Release


  1. Open wp-content/plugins Folder
  2. Put: Folder: wp-downloadmanager
  3. Activate WP-DownloadManager Plugin
  4. You Need To Re-Generate The Permalink WP-Admin -> Settings -> Permalinks -> Save Changes

General Usage

  1. To embed a specific file to be downloaded into a post/page, use [download id="2"] where 2 is your file id.
  2. To embed multiple files to be downloaded into a post/page, use [download id="1,2,3"] where 1,2,3 are your file ids.
  3. To limit the number of embedded downloads shown for each post in a post stream, use the stream_limit option.
    1. Example: [download id="2" stream_limit="4"]
    2. This will only display the first 4 downloads for the post when rendered in a post stream, and display the full list of downloads when viewing the single post.
  4. To sort embedded downloads, use the sort_by and sort_order options.
    1. Example: [download id="2" sort_by="file_id" sort_order="asc"]
    2. This will sort the embedded downloads by file ID in ascending order.
    3. Valid values for sort_by are: file_id, file, file_name, file_size, file_date, and file_hits
  5. To choose what to display within the embedded file, use [download id="1" display="both"] where 1 is your file id and both will display both the file name and file desccription, whereas name will only display the filename. Note that this will overwrite the "Download Embedded File" template you have in your Download Templates.
  6. To embed files as well as categories, use [download id="1,2,3" category="4,5,6"] where 1,2,3 are your file id and 4,5,6 are your category ids.
  7. If you are using Default Permalinks, the file direct download link will be If you are using Nice Permalinks, the file direct download link will be, where is your WordPress URL and 2 is your file id.
  8. The direct download category link will be, where is your WordPress URL, downloads is your Downloads Page name and 3 is your download category id.
  9. In order to upload the files straight to the downloads folder, the folder must be first CHMOD to 777. You can specify which folder to be the downloads folder in Download Options.
  10. You can configure the Download Options in WP-Admin -> Downloads -> Download Options
  11. You can configure the Download Templates in WP-Admin -> Downloads -> Download Templates

Downloads Page

  1. Go to WP-Admin -> Pages -> Add New
  2. Type any title you like in the post's title area
  3. If you ARE using nice permalinks, after typing the title, WordPress will generate the permalink to the page. You will see an 'Edit' link just beside the permalink.
  4. Click 'Edit' and type in downloads in the text field and click 'Save'.
  5. Type [page_download] in the post's content area.
  6. You can also use [page_download category="1"], this will display all downloads in Category ID 1.
  7. Click 'Publish'

Download Stats (With Widgets)

  1. Go to WP-Admin -> Appearance -> Widgets
  2. The widget name is Downloads.


  1. Deactivate WP-DownloadManager Plugin
  2. Open wp-content/plugins Folder
  3. Put/Overwrite: Folder: wp-downloadmanager
  4. Activate WP-DownloadManager Plugin
  5. Go to WP-Admin -> Downloads -> Downloads Templates and restore all the template variables to Default

Upgrade Notice



  1. Admin - Downloads Embedded
  2. Admin - Downloads Add
  3. Admin - Download Manage
  4. Admin - Download Options
  5. Admin - Download Stats
  6. Admin - Download Templates
  7. Admin - Download Templates
  8. Download Embedded
  9. Downloads Page

Frequently Asked Questions

To Display Most Downloaded

  • Use: <?php if (function_exists('get_most_downloaded')): ?> <?php get_most_downloaded(); ?> <?php endif; ?>
  • The first value you pass in is the maximum number of files you want to get.
  • Default: get_most_downloaded(10);

To Display Recent Downloads

  • Use: <?php if (function_exists('get_recent_downloads')): ?> <?php get_recent_downloads(); ?> <?php endif; ?>
  • The first value you pass in is the maximum number of files you want to get.
  • Default: get_recent_downloads(10);

To Display Downloads By Category

  • Use: <?php if (function_exists('get_downloads_category')): ?> <?php get_downloads_category(1); ?> <?php endif; ?>
  • The first value you pass in is the category id.
  • The second value you pass in is the maximum number of files you want to get.

Default: get_downloads_category(1, 10);