=== Fee recovery for GiveWP ===
Contributors: linknacional
Donate link: https://www.linknacional.com/wordpress/
Tags: fee, donation, givewp, form, recover
Requires at least: 5.0
Requires PHP: 8.0
Tested up to: 6.8
Stable tag: 1.3.2
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Define a recovery fee for your donations forms, give the option to your donor cover you payment fees.

== Description ==

The [Fee recovery for GiveWP](https://www.linknacional.com/wordpress/) plugin provides donors with the choice to cover the payment fees associated with their donations made through a donation form on the website. By using this plugin, website owners or non-profit organizations can offer an additional option to donors, allowing them to assume the processing expenses of the transaction.

**Key Features**

1. Fee Cover Option: The plugin adds an optional field to the donation form, enabling donors to decide whether they want to cover the payment processing fees or not;

2. Transparent Fee Calculation: When donors choose to cover the fees, the plugin automatically calculates the exact amount required to cover the transaction costs, ensuring transparency and accurate calculations;

3. Customizable Messaging: Website owners can customize the messaging displayed to donors, explaining the purpose and benefits of the fee cover option;

4. Multiple Payment Gateways: The plugin is compatible with popular payment gateways, ensuring a seamless integration with the existing donation process.

By integrating the Fee recovery for GiveWP plugin into their WordPress site, organizations can empower donors with the choice to contribute more effectively, enabling them to support the cause with full transparency and control over the donation process.

**Dependencies**

This plugin needs the [GiveWP](https://wordpress.org/plugins/give/) plugin to work.

**User instructions**

1. Go to GiveWP settings menu;

2. Search for the tab 'fee recovery';

3. Define the fees and enable the plugin;

4. Save. And now the Fee recovery for GiveWP plugin is working in all donation forms.

== Installation ==

1. Upload `fee-recovery-for-givewp.zip` to the `/wp-content/plugins/` directory;
2. Activate the plugin through the 'Plugins' menu in WordPress.

== Frequently Asked Questions ==

= Can I require the donor to cover the fees on donation? =

The donor can choose if it will cover the payment fees for the donation or not, the option to cover the fees for the payment is not a requirement.

= Is there a option to have different fees for each payment gateway? =

Not in the free version. We have this option and more in our Fee recovery PRO plugin, you can aquire it [here](https://www.linknacional.com/contact/).

= Can I define the fee option for each donation form? =

Not in the free version.  We have this option and more in our Fee recovery PRO plugin, you can aquire it [here](https://www.linknacional.com/contact/).

== Screenshots ==

1. Configuration page
2. Legacy template form recovery fee option
3. Multi-step template form recovery fee option
4. New template form recovery fee option
5. Donation summary

== Changelog ==
= 1.3.2 =
**14/04/2026**
* Change banners.

= 1.3.1 =
**12/03/2026**
* Addition of icons and banners.

= 1.3.0 =
**23/05/2025**
* Fix lagacy form and new form.

= 1.2.1 = 
**27/02/2025**
* Fix fee value in legacy forms.

= 1.2.0 =
**14/12/2024**
* Compatibility with 3.0.0 forms.

= 1.1.2 =
**02/01/2024**
* Fix security issues with plugin;
* Fix internationalization.

= 1.1.1 =
**28/12/2023**
* Remove security vulnerabilities;
* Compatibility with WordPress 6.4;
* Update license with GPLv3.

= 1.1.0 =
**18/08/2023**
* Plugin percent fee option now accept float values;
* After the checkbox is marked the total amount is updated with fees;
* Dinamically change the currency symbol;
* Adds compatibility with any currency;
* Fixed a bug in fee calculation for numbers in the thousands.

= 1.0.0 =
**21/07/2023**
* Plugin Launch.

== Upgrade Notice ==

= 1.0.0 =
* Plugin stable version.
