WordPress Download Manager User Guide

Rashty David,

<< Back to CM Download Manager || << Back to WordPress plugin site>       CM Downloads Manager Pro – Buy Now

For the new and updated version of the WordPress Download Manager User Guide please visit http://downloadsmanager.cminds.com/cm-downloads-manager-user-guide/


Initial Installation

Installing CM Download Manager plugin should be as easy to install as any other WP plugin. If you are unfamiliar with plugin installation, you can use this step-by-step guide.


How it Works

CM Download Manager provides a powerful but yet simple Download Manager forum. CM Download Manager enables you to make a directory where users can upload and manage Files / Downloads / Apps / Add-on / Packages / Plugins / Archives each containing detailed description. It contains download counter and support forum per each download page. For more information on additional features read this user guide.


Updating a Version or Upgrading to the Pro Version

If you are reinstalling the CM Download Manager plugin, don’t worry about the plugin writing over your previous data (previous downloads & Answers Posted), they will not be erased and you can safely update the plugin version or upgrade to the Pro version without losing any of your existing Data.

When upgrading to Pro, please remember to first deactivate the regular version before activating the Pro version, since they overlap each other and can not work together. simultaneously.


Setting up Permalinks

Before using CM Download Manager, make sure your WP Permalinks settings are set correctly to “Post Name” or to a “Custom Structure”


Your CM Download Manager Page (All Download List)

Your CM Download Manager page will be ready to use once plugin is installed successfully on http://your-site-domain/cmdownloads page. In some cases, for example, when your permalinks are setup according to a custom structure configuration, the CM Download Manager path may be different and require further customization. Find the correct path in the plugin settings.


Downloads Types

Download Manager plugin can support several types of downloads. Files by types defined by admin, Shortcodes which produce download or purchase/ add to cart buttons coming from other plugins installed on your system (for example EDD shortcodes), URL to external sites


Downloads Types Settings

Admin can define in settings what type of downloads are allowed and what files extensions are supported


URL as Download   (Pro Version Only)

Once URL is selected as download user can specify a URL. Once download button will be clicked user will be redirect to defined URL


Shortcode as Download   (Pro Version Only)

Once Shortcode is selected for download user can specify the shortcode which needs to be executed once download page is displayed. Download button will not appear in this case and only button produced by shortcode will appear


Adding screenshots to Download

User can add up to 4 screenshots Size: H: 220px W: 720px in PNG / JPEG format to each download. In case screenshots are not uploaded default screenshot set by admin will be displayed

WordPress Download Manager User Guide- screenshots from the plugin settings


Protecting Downloads by Password   (Pro Version Only)

Any download can be protected by a unique password set by user submitting the download. Password will appear above download button in download page

WordPress Download Manager User Guide- how to password protect files WordPress Download Manager User Guide


User Dashboard

CM Download Manager user dashboard can be found in the following URL http://your-wp-address/cmdownload/dashboard. The dashboard is displayed in the default theme but this can be changed by editing the CMDM files


Adding a Download

In case user is allowed to add downloads he can click on the Add New button and will be directed to the add new download form.


Controlling the Download

Users can control download directly from their dashbaord. They can Delete / Edit and Unpublish download


Changing User Submission & Access Permission by Admin   (Pro Version Only)

Once installed, CM Download Manager allows Admin to change the access permission. Admin can specify who can submit a Download or view download. For example to allow only users who are editors to submit downloads or to limit viewing the download page only for logged in users


Changing Access Permission by User   (Pro Version Only)

Admin can grant users the ability to define who can view download. Once Admin grant this option is settings, user can define per each download separately the access permissions


User Profile Page   (Pro Version Only)

In Pro version, clicking on the user who submitted a download will open a new page on a new tab that will contain additional information of a given user’s profile. Profile information includes all download submitted by user and shows their Gravatar icon linked to their Gravatar profile (if one exists). If a user is registered using his social profile, a link to his social profile will also appear.


User Gravatar   (Pro Version Only)

The Pro plugin supports Gravatar icons which shows beside a poster’s name. To enable this feature, define them in the plug-in settings.

When user had no image defined in Gravatar the mystery man icon will appear


How to Change your CM Download Manager Theme

CM Download Manager allows you to change your theme while continuing to upgrade versions of the plugin. To do this you need to have some basic HTML/PHP knowledge in manipulating template files. First, create a sub-directory named “CMDM” in your current template directory. Inside this sub-folder you can place your file structure similar to the one that is inside “cm-download-manager/views/frontend/”.

Once CM Download Manager finds your CMDM sub-directory inside your template directory, it will be given priority over other files stored in the plugin directory under “cm-download-manager/views/frontend/”.

If you would like to change the look & feel of the plugin or want to incorporate it into your custom theme, start by editing one of the following files: index.phtml (for an Index of all downloads) or single.phtml (for download page). Both files can be found inside the “CMDM/cmdownload” folder.


Setting Notifications for CM Download Manager

Inside the plugin settings, there is a section that deals exclusively with handling notifications. CM Download Manager allows to receive a notification every time a new question or comment to a question is posted in the download page support area.

This setting allows you to define the title of the Email sent, and the structure of the email. Inside the structure of the email you can use several shortcodes that can be applied only within the content of the email.


Setting Notifications for Users

Users that submit downloads to CM Download Manager can receive notifications in the following cases

    • If they are the creator of the downloads and have checked the “Notify me on new support topic” when submitting the download

    • If they are someone who has submitted a support question and have checked the “Notify me of follow” once submitting their question.

If you would like to control the structure and the kinds of notification messages that users receive, CM Download Manager enables admins to change these features in the following section that is found in the plugin settings. Here are several examples of shortcodes that can occur within an email message’s content

Download name: [addon_title]

Support topic title: [thread_title]

Link to support topic: [comment_link]


Controlling the Types of Users who use CM Download Manager

For more information about how to define which users can use the CM Download Manager, please refer to the user section of the guide.


Auto Approve Questions

In the plugin settings you will find a check-box feature that allow the admin to define whether or not all support questions are to be auto-approved or whether they will require admin approval before showing up in the download page support area.

If support Questions / Comments are not auto-approved by default, the Admin / Editor can moderate them by going into the WordPress Comments area found in the admin control panel.

Questions that are waiting for admin moderation will appear with a pending background color.

Admin can edit any question and either approve or delete them.


Auto-Approve Questions and Answers from Specific Users   (Pro Version Only)

In the CM Download Manager Pro version, you can define which users are allowed to automatically post support questions and answers to CM Download Manager without moderation, even when the moderation option is turned on. This feature also works with users that login with social media, once authenticated they are defined as WP users.


Top Downloads   (Pro Version Only)

Using shortcode CMDM-top-downloads will display list of most popular downloads. Only parameter with shortcode is number of downloads listed using count=number. A widget with this shortcode is also available in the widget area


Frequent Contributors   (Pro Version Only)

Using shortcode CMDM-frequent-contributors will display list of most popular users posting downloads. Only parameter with shortcode is number of users listed using count=number. A widget with this shortcode is also available in the widget area


Recent Added Downloads   (Pro Version Only)

Using shortcode CMDM-recent-updates will display list of new downloads recently added. Only parameter with shortcode is number of downloads listed using count=number. A widget with this shortcode is also available in the widget area


Related Downloads   (Pro Version Only)

Using shortcode CMDM-related-downloads will display list of related downloads to the current download displayed in the download page. Related downloads are chosen randomly from same category where download is defined in. Only parameter with shortcode is number of downloads listed using count=number. A widget with this shortcode is also available in the widget area


Social Media Login   (Pro Version Only)

The Pro version supports social media logins from Facebook, LinkedIn and Google+. Here is an example of what the login looks like:


Facebook   (Pro Version Only)

Once you allow Facebook users to authenticate their login with the CM Download Manager plugin they will be able to submit Questions or Answers to the CM Download Manager. This setting can be customized to specifically allow FaceBook authentication within the plugin settings panel. If left this option is left empty, the FB option will not appear.

To register your site with FaceBook, the admin must do the following steps:

    • Create Facebook application at https://developers.facebook.com/apps/
    • Remember to enter App Domains (your-domain)
    • “Website with Facebook Login” must be checked, but for “Site URL”, you can enter any landing URL

In the plugin settings panel, add these values in the following fields:


Google   (Pro Version Only)

Once Google users are allowed to authenticate the credentials with CM Download Manager, they will be able to submit Questions and Answers to the CM Download Manager. This setting specifically allows Google users authentication within the plugin settings panel. If the field is left empty, G+ option will not appear.

To register your site with Google and allow for G+ authentication with the plugin, do the following steps:

      • Create a Google APIs project at https://code.google.com/apis/console/
      • You do not have to enable any services from the Services tab.
      • Make sure to go to “API Access” tab and Create an OAuth 2.0 client ID.
      • Choose a Product name and home page URL (ex http://your-domain.com)

      • Choose a Web application for your Application type

      • Make sure that the redirect URL is set to actual OAuth 2.0 callback URL: http://your-domain.com/auth/google/oauth2callback

In the plugin settings, add these values in the following fields:


LinkedIn   (Pro Version Only)

Once you allow LinkedIn users to authenticate their credentials with CM Download Manager, they will be able to submit Questions and Answers to the CM Download Manager. Setting to specifically allow LinkedIn user authentication can be found in the plugin settings panel. If this option is left empty, the Ln option will not appear.

To register your site with LinkedIn and allow LinkedIn user authentication, do the following steps:

In the plugin settings, add these values in the following fields:



The CM Download Manager plugin supports localization preferences and currently comes with several language files as described in the plugin WP page (this is updated from time to time so please check the WP site). It is easy to add another localization file to support any additional desired language. Simply take one of the already existing language files from plugins/cm-download-manager/lang and use it to convert to your language. Use POedit to do the actual processing. Once translated, place the two files (PO and MO) inside the lang directory and WP will detect it. More information about localization preferences can be found here.

Please remember that in order for the localization version to work, you will need a WP version installation in same language as your localization file.

Another option for editing the localization files can be found by using this plugin.


Widgets Container

CM Download Manager has two defined defined widget container area which appears when displaying the download index page (this widget container is called CM Download Manager Sidebar) and for each download page (this widget container is called CM Download Manager Page Sidebar) on the right side of the screen. You can place widgets inside this container by selecting them from the admin menu Appearance -> Widgets panel.


Multisite Support   (Pro Version Only)

The Plugin Pro version Support WP Multisite. Using the plugin in a Multisite environment means that downloads database table is different for each site within separate installation folders.


Show the Number of Views   (Pro Version Only)

In the Pro plugin the number of views will be shown on download page. You can also define how views are counted


Define the Sorting of Support Questions   (Pro Version Only)

In the Pro plugin, you can choose whether or not support questions can be sorted in ascending or descending order.


PHP Version

If you receive the error message “We are sorry, but you need to have at least PHP 5.3 to run this plugin (currently installed version: 5.2.17) – please upgrade or contact your system administrator.” this means that you are running a version of PHP which is lower than 5.3 and need to upgrade.

The PHP version number is returned by phpversion() native function (http://php.net/manual/en/function.phpversion.php). Make sure you have the right version enabled on your server. Also make sure that you don’t have two different versions or that you forgot to restart your server after upgrading.


FB Connection return Error

Could be several reasons.