Ninja Forms

Please note that this page contains functionality which is only available in version 1.4.0+ of the Ninja Forms extension combined with version 3.0+ of Ninja Forms.

The Ninja Forms extension for Download Monitor allows you to require users to fill in a Ninja Forms form before they gain access to a download.

Installation

  • Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory
  • Activate the extension through the ‘Plugins’ menu in WordPress

For more information on installing and managing plugins see here

Usage

After installing the extension head over to the download you wish to lock with a Ninja Forms form.

Lock the download

Edit the download you wish to lock with a form. If you scroll down the page you'll find a new meta box on the right side called "Ninja Forms Form". Select the form you want users to fill in prior download and save/update the download.

Insert the unlock download form shortcode

The Ninja Forms extension comes with a new shortcode that will display the Ninja Forms form and will display a download link to the file after the form has been successfully. You need to pass your download ID to this shortcode, we used download ID 5 in our example.

Example: [dlm_nf_form download_id=5]

Unlocking via the No Access page

Instead of displaying the unlock form on your page you can also display the default download link by using the shortcode. When the visitor clicks the link, Download Monitor will check if the user has already unlocked the download. If they didn't yet, a No Access page will be displayed. The Ninja Forms extension automatically appends the correct Ninja Forms form to the No Access page so your visitor can unlock the download there.

Example: [Download not found]

Because you use the default [download] shortcode, you can use all of the shortcode's attributes like output templates!

Unlock Types

Since version 1.1.0 you can set the type of unlocking that will be done once a form is completed. The default type is unlocking the requested download (the download the form was attached to) but you can also choose to:

  • Unlock all downloads locked with the same form
  • Unlock all Ninja Forms locked downloads

You can find the unlock type setting at the Ninja Forms tab in your Download Monitor settings page.

Select the unlocking option after a form is completed
Select the unlocking option after a form is completed

Offer the Download after form completion

After your visitors completed your form, you most likely want to offer them the locked download instantly. There are two main ways of doing so.

Add a Download Link to your Success Message

Adding a Download Link to your success message allows you to thank you visitor for completing the form while offering an instant way to download to unlocked file. The Download Link is a Ninja Forms Action which can be added in the Emails & Actions tab.

Add the 'DLM Link' action to automatically add a Download Link to your success message.
Add the 'DLM Link' action to automatically add a Download Link to your success message.

The Download Link will automatically link to the download the visitor just unlocked. This way you can reuse the same form for multiple downloads.

Redirect to Download

By redirecting the visitor to the download after form completion, you're instantly offering your file to your visitor. The Download Redirect is a Ninja Forms Action which can be added in the Emails & Actions tab.

Add the 'DLM Redirect' action to automatically redirect to your download URL
Add the 'DLM Redirect' action to automatically redirect to your download URL

The visitor will automatically be redirected to the download they just unlocked. This way you can reuse the same form for multiple downloads.

Customer Usage

If you've followed above steps in the Usage section your download is ready to go. Visitors will be have to complete the selected Ninja Forms form prior be granted access to the download.

Example display of your form
Example display of your form

After the visitor completed the form, the Ninja Forms extension will append a download link to your confirmation message. This URL will be automatically generated based on the download shortcode you've used.

FAQ

Can I use both the Download Link and Download Redirect action?

You can! When both Download Monitor actions are added to a form, the redirect will be fired with the download button (and other success messages) displayed in the background.

Can I change the download link/button HTML that is used in the Download Link Action?

You can! The Ninja Forms extension comes with an overridable template file nf-download-link.php. Copy this file to your the download-monitor directory in your theme (create the directory if it doesn't exist) and modify the file you just copied to your theme any way you want. This way you can still safely update the extension without losing these customizations!

Was this article helpful? Yes · No