-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathreadme.txt
173 lines (119 loc) · 10.4 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
=== Donation Form Block for Stripe ===
Contributors: givewp, dlocc, jasontheadams, webdevmattcrom
Tags: donation, donate, stripe, fundraise, block
Tested up to: 6.2
Stable tag: 1.3.1
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
A beautiful WordPress donation form block for Stripe by GiveWP. Accept Stripe donations in minutes with a simple online donation form.
== Description ==
Add a Stripe donation form to your website in a few seconds with the WordPress Donation Form Block for Stripe by GiveWP.
This "lite" version of GiveWP provides you with the style and functionality of a GiveWP form without all the setup. Start accepting Stripe donations immediately. [Learn more about how it works in our documentation](https://go.givewp.com/dfb-r-doc).
Want more? Use the full GiveWP donation plugin which includes full-featured fundraising reports, a donor database, and unlimited donation forms. [Download GiveWP for free from our website](https://go.givewp.com/dfb-r-free).
=== ✨ Block Features ===
This block provides Stripe donation forms that work great on any device, built for WordPress' block editor. Once installed, the block is easily inserted into your WordPress website and is designed to be easily customized to fit your needs.
Payments are facilitated using Stripe's new Payment Element – a simple, secure, and modern payment form. You can easily adjust the payment methods within your Stripe account's payment method settings.
=== 💳 Why Use Stripe for Donations? ===
* 18+ supported payment methods
* Supports all currencies that Stripe supports
* Accept credit and debit card donations on your website
* Supports payment wallets including Google Pay, and Apple Pay
* Bank redirects, like iDEAL, EPS, Giropay and more. This helps improve conversion rates and reduce fraud with non-US donors.
* Donate now, Pay Later - Reach customers who want to pay in installments with Klarna and Afterpay.
**Additional payment method features:**
* Automatically adjusts input fields to collect information based on the payment method and country.
* Dynamically sorts payment methods based on a customer’s locale and location to optimize for conversion.
* Reduces friction for card payments with input validation, masking, styling and error handling.
**Additional Features:**
The Donation Form Block for Stripe includes extensive customization options. You can easily change the donation amounts, colors, main image, headings, description text, and button text.
* Fully functional and responsive Stripe donation form that looks good on any device
* Native block controls for content, color, images, donation options
* Single Stripe account, so once it's configured it's connected for any and all blocks you add to your site
* Ultra light-weight; guaranteed to not slow down your site
* Zero database load on your site; adds no tables to your database
* Conditional script loading only adds the script to the page when the block is actually used
* Intuitive and simple settings allow for dynamic, visual editing in the block editor
* Donation receipts are emailed to the donor using Stripe's email receipt feature
== ⚙ Customization Options and Settings ==
This plugin does not add any unnecessary top-level menu items to the WordPress admin. Instead, it adds a block editor options that allow you to customize your donation forms to be unique to your cause.
**Appearance**
* Header Image - Upload a custom header image to be displayed above the donation form
* Primary Color - The main color of the donation form
* Donation Amounts - The donation amounts to be displayed on the form
**Donation Options**
* Donation Amounts - The donation amounts to be displayed on the form
* Default Currency - Adjust the currency to be used on the form, use any that Stripe supports
**Content**
* Main Heading - The main heading of the donation form
* Main Sub-heading
* Fields Heading
* Donation Button Text
**Stripe Connect**
* Connect to Stripe easily without any API key setup.
* Live/Test Mode toggle for easy testing before accepting live payments.
_In order to maintain and support this plugin, GiveWP collects a 2% fee on all transactions. You can upgrade to the full GiveWP plugin with the Stripe add-on to avoid this transaction fee. [Learn more here](https://go.givewp.com/dfb-r-stripe)_
= 💡 Use-Cases =
* Add a tip jar or buy me a coffee option to your blog
* Kickstart your business idea with a donation form
* Give family and friends a simple way to donate for an event
* Start fundraising for your nonprofit as quickly as possible
* Accept Stripe payments for any reason
= 👩💻 Development Notes =
Know some code? Great! We love open source contribution. Please visit this plugin's [GitHub repository](https://github.com/impress-org/donation-block-for-stripe) if you'd like to learn more about how to contribute to the development of this block.
= 💚 About the GiveWP Team =
[GiveWP](https://go.givewp.com/dfb-r-home) is part of StellarWP, a Liquid Web Family Brands. Our donation plugin is backed by a growing team of WordPress developers, support engineers, customer success managers, and marketing professionals who’ve worked with WordPress and nonprofits since 2009. This means GiveWP is made with best practices in mind; extremely extensible and customizable, stable, and reliable. We’ll be here in years to come for you and your nonprofit organization.
Stay in touch with us for important plugin news and updates:
* [Donation Form Block Documentation](https://go.givewp.com/dfb-r-doc)
* [GiveWP Website](https://go.givewp.com/dfb-r-home)
* [Download GiveWP Free](https://go.givewp.com/dfb-r-free)
* [GiveWP Newsletter](https://go.givewp.com/dfb-r-subscribe)
* [GiveWP Facebook](https://go.givewp.com/fb-group)
== Installation ==
Do you have a WordPress website? Great! You can use this block on your site to add a donation form in a few simple steps. Log into your WP-Admin and go to Plugins > Add New. Once there search "Donation Form Block for Stripe by GiveWP." Once you find the plugin, click "Install Now."
Alternatively, when in the block editor open up the block editor and click the "Add Block" button. Once there, type "Donation" and you should see the block display in the list of available blocks. Simply click to install and add the block to your page.
== Frequently Asked Questions ==
= How is the WordPress Donation Form Block for Stripe different from a GiveWP Donation Form block? =
This block contains a single form with a connection to Stripe. It does not have the additional access to PayPal and other payment gateway options, reporting, donor database, or campaign features that the free download of GiveWP provides. If you would like more information about GiveWP, please visit our website.
[Learn More](https://go.givewp.com/dfb-r-home)
= Is there a "Pro" version of this block with more features? =
Yes! GiveWP, is both the "Pro" version while also totally free! It provides a lot more to set up your fundraising website. When you use GiveWP, you also gain the ability to connect our add-ons, which provide features like Recurring Donations, Fee Recovery, Tributes, Gift Aid, and more. Our add-ons also include a more robust Stripe connection that includes options for Google Pay, Apple Pay, and disables the 2% transaction fee that the free Stripe donation form block requires.
[Learn About GiveWP](https://go.givewp.com/dfb-r-home) or [View Stipe Add-on](https://go.givewp.com/dfb-r-stripe)
= Does this donation form block support Stripe recurring donations? =
Not currently. For access to Stripe donation forms with support for recurring donations, please use GiveWP with our Stripe and Recurring Donations Add-ons. Both are included in a Plus plan and above.
[View Pricing](https://go.givewp.com/dfb-r-pricing)
== Screenshots ==
1. Customize your suggested donation amounts live in the block editor.
2. Powered by Stripe, your form supports multiple payment types, is highly secure, and leverage all the power of Stripe Payment Elements.
3. Sparks of JOY! Enthrall your donors with a confetti POP upon successful donation.
== Changelog ==
= 1.3.1 =
* Fix: Prevent JS error when using the ReCAPTCHA option for the first time. Also resolve PHP notice in PHP 8.0+ causing annoyances.
= 1.3.0 =
* New: 🤖❌ Added an integration with Google reCAPTCHA version 2 to help prevent spam donations.
* Fix: 🔗 Resolved an issue with Stripe's "Link" always being enabled regardless of the setting selected.
= 1.2.0 =
* New: 🔗 Added integration with [Stripe Link](https://support.stripe.com/questions/link-faq) for faster donations. You can enable this new feature under the block's "Donation Settings" settings panel.
* Tweak: 🎨 Adjusted CSS for better cross-theme compatibility.
= 1.1.1 =
* New: 🌈 Added pretty Stripe-style focus effects to the input fields for better UX.
* New: 🙋 There is now a new documentation/support element to Gutenberg sidebar for users who need assistance.
* Tweak: 🎨 Adjusted CSS for better cross-theme compatibility.
= 1.1.0 =
* ✨ New: You can now adjust the default donation amount using an intuitive radio selector on the donation amount repeater field.
* ✨ New: You can now switch the currency! Yippee. We added support for additional currencies with locale-based formatting.
* Updated the readme.txt with additional text and descriptions. Props to @taylorfromteamgive for the PR 🎉
* Fix: Prevent PHP notices on a fresh install related to Stripe keys with conditional.
* Fix: Allow multiple Stripe payment elements to mount on a single page. This is a rare edge case, but nonetheless it's possible and now working.
= 1.0.3 =
* 🙅 If you're are a GiveWP active license holder this plugin now will remove the 2% Stripe fee.
* 🎨 Improved the receipt step's user experience by preventing a flash of the default amount and step 1. Step 3 is now immediately displayed and the same confetti animation is used.
* 😎 Donor's can now edit their donation after moving on to the payment step. The UI also received an improvement.
* Added app identification for Stripe.
= 1.0.2 =
* Fixed zip issue preventing the rendering of the block.
= 1.0.1 =
* We removed the Stripe PHP SDK and now the plugin to reduce the overall plugin size and PHP footprint.
* Resolved an issue where an extra space was added before the currency symbol and amount.
* Fixed PHP 7.4+ syntax that wouldn't allow the block to run on earlier PHP versions.
= 1.0.0 =
* Initial Release. Yippee!