=== Download Magnet ===
Contributors: peachysoftware
Donate link:
Requires at least: 5.0
Tags:email capture, lead capture, lead magnet, marketing, download
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 2.5.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

This plugin provides an easy-to-use way of capturing email addresses when the end user wishes to download a file.

== Description ==
This plugin provides an easy-to-use way of capturing email addresses when the end user wishes to download a file. Is used as a shortcode in your posts or pages.
= Features: =

* Is easy to use
* Can be used to capture email addresses inline or from a button.
* Can now use an existing button on the page to keep the styling intact.
* Multiple entries can be created.
* A block for the Block Editor (Gutenberg) is available.
* Allows capture of an email address when offering a download as a lead magnet.
* Contacts can be downloaded (CSV file) to import into your email marketing system.
* An ProPak Addon (paid) is available to directly send contacts to your email marketing provider. <a href="https://peachysoftware.com/downloadmagnet/addons">Download Magnet Addons</a>
    * Currently supports ActiveCampaign, Kit, MailerLite, MailPoet, MailChimp, SendFox, Sendy and Webhooks. More in development.
	* The Webhook connects to any system that supports webhooks such as Zapier, Make (Integromat) and Automate.io etc.
* Custom options include to request name and also GDPR consent.
* Utilizes the wp_footer action to ensure the dialog box is always on top. (Can be overriden).
* Please send me your feedback  <a href="http://peachysoftware.com/contact/">here</a> for any new features you want to see in next version of this plugin.I will be happy to receive feedback.


== Installation ==

To install Download Magnet , follow these steps:

1.  Download and unzip the plugin
2.  Upload the entire downloadmagnet/ directory to the /wp-content/plugins/ directory
3.  Activate the plugin through the Plugins menu in WordPress
4.  Download Magnet will appear in the sidebar. Click on it.
5.  To add a download magnet, click on Add New and enter/upload a file for download
6.  In any post or page enter the shortcode [downloadmagnet id=xxx]. xxx is the id number of the download and a button will appear.
7.  To add a download magnet to an existing button, add an id name to the button and then add the shortcode [downloadmagnet id=xxx button=yyy]. xxx is the id number of the download and yyy is the id of the button. <a href="https://peachysoftware.com/docs/add-to-an-existing-button/">Click here for help.</a>

= Have Feedback =
Please send me your feedback  <a href="https://peachysoftware.com/contact/">here</a> for any new features you want to see in next version of this plugin.I will be happy to receive feedback.

== Frequently Asked Questions ==
= How do I add a download magnet to a page or post? =
In any post or page enter the shortcode [downloadmagnet id=xxx]. xxx is the id number of the download and either a button (popup) or the form (inline) will appear.
To add a download magnet to an existing button, add an id name to the button and then add the shortcode [downloadmagnet id=xxx button=yyy]. xxx is the id number of the download and yyy is the id of the button. <a href="https://peachysoftware.com/docs/add-to-an-existing-button/">For more guidance.</a>

= Does this version capture email addresses? =
Yes, this version captures email addresses and allows you to download a CSV file of the contacts. If you want to automatically send the contacts to your email marketing system, you will need to purchase the appropriate addon.

= What email marketing systems are available as addons? =
Currently available are ActiveCampaign, Kit (formerly ConvertKit) , MailChimp, MailPoet, SendFox, Sendy and Webhooks. More in development, check the Addons page in the menu. If you do not see your email marketing system, please contact me <a href="https://peachysoftware.com/contact/">here</a> and we will see what we can do.

= How do I get the Email ProPak Addon =
Addons can be purchased and installed from the Addon menu in this plugin or are also available from <a href="https://peachysoftware.com/downloadmagnet/">here</a>

= How do I get support? =
Plugin support can be found here <a href="https://wordpress.org/support/plugin/download-magnet">here</a>. Addon customers will receive premium support. Details when purchased.

= Are you planning to add more features? =
Yes, I am planning to add more features. Please send me your feedback  <a href="https://peachysoftware.com/contact/">here</a> for any new features you want to see in next version of this plugin.I will be happy to receive feedback.
The ability to add to an existing button came from feature requests. Please keep them coming.

== Screenshots ==
1. Using an existing button on the page to trigger the popup.
2. The popup requesting name, email and actual consent.
3. The form displayed inline on the page.
4. The custom post type main entry form.
5. Options for each file to be made available.

== Changelog ==
= 2.5.3 =
Fixed a bug on selecting a file to download!
Realigned options on the correct page following user feedback.

= 2.5.2 =
Fixed html link on direct download.
Fixed wrong modal dialog being used.
Cleaned up visual on email tab when no service.

= 2.5.0 =
User interface improvements for adding files.
Improved onboarding and bug fixes.
Sent emails now HTML formatted.
Disposable email address list updated.

= 2.2.0 =
Native Block Editor support added. Now you can add a download magnet post directly from the block editor.

= 2.1.0 =
Download type can be overriden in the shortcode (type=inline or type=popup or type=button)

= 2.0.1 =
Fixed post validation bug.

= 2.0.0 =
Added ability to attach popup to existing buttons on page.
Dialog HTML code now added to the footer to avoid any theme z-index issues (Can be overriden)
Bug fixes.

= 1.5.0 =
Architectural changes, premium items now available as paid addons.

= 1.2.1 =
Bug fix on saving the post.

= 1.2.0 =
Added an Inline option for the name/email address capture form (as well as a popup dialog).
Added MailPoet support (now as premium addon).
Added ability to ignore IP address from user (for GDPR/CCPA compliance options)
Can now customize Download button text.

= 1.1.1 =
Bug fix on download count.
Freemius SDK Version updated.

= 1.1.0 =
First public release.

= 1.0.1 =
Bug fixes for customers.

= 1.0.0 =
Private release



== Upgrade Notice ==
= 2.5.3 =
Fixed a bug on selecting a file to download!
Realigned options on the correct page following user feedback.

= 2.5.2 =
Fixed html link on direct download.
Fixed wrong modal dialog being used.
Cleaned up visual on email tab when no provider installed.

= 2.5.0 =
User interface improvements for adding files.
Improved onboarding and bug fixes.
Sent emails now HTML formatted.
Disposable email address list updated.

= 2.2.0 =
Native Block Editor support added. Now you can add a download magnet post directly from the block editor.

= 2.1.0 =
Download type can be overriden in the shortcode (type=inline or type=popup or type=button)
V2 adds ability to attach to existing elements.

= 2.0.1 =
Fixed post validation bug.
V2 adds ability to attach to existing elements.

= 2.0.0 =
Added ability to attach popup to existing buttons on page.
Dialog HTML code now added to the footer to avoid any theme z-index issues (Can be overriden)
Bug fixes.

= 1.5.0 =
Architectural changes, premium items now available as paid addons

= 1.2.1 =
Bug fix on saving the post.

= 1.2.0 =
Added an Inline option for the name/email address capture form (as well as a popup dialog).
Added MailPoet support (now as premium addon).
Added ability to ignore IP address from user (for GDPR/CCPA compliance options)
Can now customize Download button text.

= 1.1.1 =
Bug fix on download count.

= 1.1.0 =
First public release.

= 1.0.1 =
* Change to the button code in the shortcode to allow positioning to be applied.
* Recommended, some CSS tweaks to better handle the dialog box
* Bug fixes
* Naming changes

= 1.0 =
* First stable version released.