=== Zeffy Donate Button ===

Contributors: hectorzeffy
Plugin URI: https://support.zeffy.com/wordpress-donate-button-plugin
Author URI: https://www.zeffy.com/
Donate link: https://zeffy.com
Tags: donate button, donation, nonprofit, fundraising, donation form
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Embed Zeffy donation forms on your WordPress site with customizable popup buttons. Simple setup with no coding required.

== Description ==

Zeffy Donate Button is a WordPress plugin that allows nonprofits to embed Zeffy donation forms on their websites using simple shortcodes.

**Key Features:**

* Two shortcode options: embedded iframe or popup button
* Customizable button colors, text, and alignment
* Mobile-responsive design
* Easy donation form embedding
* Secure donation processing through Zeffy
* No transaction fees - 100% of donations go to your organization

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/zeffy_plugin_0.0/`
2. Activate through the 'Plugins' menu in WordPress
3. Go to Settings > Zeffy to configure
4. Sign up at zeffy.com and create your donation campaign
5. Copy your campaign URL to the settings
6. Add shortcodes to pages or posts

== Shortcodes ==

**Embedded Donation Form (iframe):**
`[zeffy-donate]`

**Donation Button (opens popup):**
`[zeffy-donate-button]`

**With Custom Campaign URL:**
`[zeffy-donate url="https://www.zeffy.com/en-US/donation-form/your-campaign-id"]`

== Shortcode Parameters ==

**[zeffy-donate] - Embedded Form:**
* `url` - Override default campaign URL (optional)
* `width` - Custom iframe width in pixels (default: 700)
* `height` - Custom iframe height in pixels (default: 1000)
* `fullwidth` - Set to "true" to make width 100% (default: false)
* `align` - Alignment: left, center, or right (default: center)

**Examples:**
`[zeffy-donate width=800 height=1200]`
`[zeffy-donate fullwidth=true align=left]`
`[zeffy-donate url="https://www.zeffy.com/en-US/donation-form/xyz789"]`

**[zeffy-donate-button] - Popup Button:**
* `text` - Button label (default: "Donate Now")
* `bg-color` - Button background color in hex (default: #007bff)
* `text-color` - Button text color in hex (default: #ffffff)
* `url` - Override default campaign URL (optional)

**Examples:**
`[zeffy-donate-button text="Support Us"]`
`[zeffy-donate-button bg-color="#28a745" text-color="#ffffff"]`
`[zeffy-donate-button url="https://www.zeffy.com/en-US/donation-form/xyz789"]`

== Settings ==

All configuration happens in **Settings > Zeffy:**

* **Campaign URL** - Enter your Zeffy campaign URL or campaign ID (required)
  - Full URL format: `https://www.zeffy.com/en-US/donation-form/campaign-id`
  - Or just the campaign ID

== External Services ==

This plugin connects to Zeffy.com to display donation forms and process donations. The service is required for the plugin to function properly.

**What data is sent and when:**
* Campaign information is sent when loading donation forms
* Donation data (amount, donor information, payment details) is sent when users make donations
* This data is transmitted securely over HTTPS to Zeffy's servers

**Third party service details:**
* **Service provider:** Zeffy (https://www.zeffy.com)
* **Purpose:** Processing donations and displaying donation forms
* **Data transmission:** Secure HTTPS connection
* **Terms of Service:** https://support.zeffy.com/terms-of-use-for-users 
* **Privacy Policy:** https://support.zeffy.com/data-privacy-policy

== Frequently Asked Questions ==

= How does Zeffy handle donation processing? =

Zeffy is completely free with no processing fees, platform fees, or hidden costs. 100% of donations go directly to your organization. Zeffy is funded by optional donor tips, never by taking from your donations.

= Is it secure? =

Yes. Zeffy uses PCI DSS compliant payment processing. All transactions are encrypted and secure.

= What payment methods are supported? =

Zeffy supports credit cards, debit cards, and bank transfers. Check zeffy.com for the complete list of supported payment methods.

= Are donation receipts provided? =

Yes. Zeffy sends automated tax receipts to donors. You can customize receipt templates in your Zeffy dashboard.

= Can I use multiple campaigns? =

Yes. You can override the default campaign URL using the `url` parameter in the shortcode.

= How do I change button appearance? =

Use the shortcode parameters to customize colors, text, and alignment. Example:
`[zeffy-donate-button bg-color="#FF5733" text="Give Now"]`

= Do I need a Zeffy account? =

Yes, you need a Zeffy account to create donation campaigns. Sign up at zeffy.com to get started.

== Changelog ==

= 1.0.0 =
* Initial release
* Two shortcode options: [zeffy-donate] for embedded forms, [zeffy-donate-button] for popup buttons
* Customizable button colors, text, and alignment
* Mobile-responsive design
* Secure donation processing through Zeffy
* Campaign URL configuration in settings

== Screenshots ==

1. Plugin settings page - Configure your Zeffy campaign URL and view shortcode instructions