forked from impress-org/givewp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
265 lines (188 loc) · 23.2 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
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
=== Give - WordPress Donation Plugin ===
Contributors: wordimpress, dlocc, webdevmattcrom
Donate link: http://givewp.com/
Tags: donation, donations, donation plugin, wordpress donation plugin, wp donation, ecommerce, e-commerce, fundraising, fundraiser, crowdfunding, wordpress donations, commerce, wordpress ecommerce, giving, charity, donate, gifts, non-profit, paypal, stripe, churches, nonprofit, paypal donations, paypal donate, stripe donations, stripe donate, authorize.net, authorize.net donations
Requires at least: 4.0
Tested up to: 4.5.3
Stable tag: 1.5.2
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Democratizing Generosity - Empower your cause: start accepting donations on WordPress with Give.
== Description ==
**[Give's](https://givewp.com "Visit the the Give website")** goal is to "Democratize Generosity". Give is the most robust WordPress plugin available for accepting donations. Upon activation, Give provides you with powerful features towards helping your raise more funds for your cause.
[youtube https://www.youtube.com/watch?v=gNdEelhjoKE]
= Features Include: =
* Goal tracking per donation form
* Single-page, simple, and hassle-free donor giving
* Zero commission charges
* Own all your donation data
* Accept Single, Custom, and Multi-level donations
* Easy to customize and enhance
* Looks great with nearly all WordPress themes
* Robust reporting features
* Customizable emails
* PayPal Standard and Offline Payments included for free
* Custom user roles for administration
* Flexible public API for developers
* Dedicated US-based support
* Continually developed an improved
* Updated and thorough **[documentation](https://givewp.com/documentation "Visit the Give documentation")**
Find out more on the **[Give website](https://givewp.com "Visit the Give website")**.
= Why Use Give for Donations? =
Prior to Give there was no single goto solution for accepting donations on WordPress. *Sure*, Gravity Forms and WooCommerce are great plugins... but they're not developed to work specifically for accepting donations. This can often lead to your users being confused by unnecessary cart systems, incorrect terminology, and clunky user experiences. As an admin, you may have experience wrestling with the various other WordPress donation plugins. Dealing with the lack of features, documentation, and support can be a real pain. There's a better way. Now you have Give and the entire team on *your* side.
= Simple and Pain Free Giving =
Give works great right in WordPress in a way that you're already familiar in working. Simply install and activate the plugin to get started. The backbone of Give lies within its forms. Forms are what allow you to accept donations anywhere on your website. When creating a form you may specify whether the form is a single or multi-level amount. As well, forms can accept a user provided donation amount.
= First Time Users =
For new users, we suggest reviewing our [documentation](https://givewp.com/documentation "Visit the Give docs") to get an understanding of how the plugin works prior to using it. If you run into any trouble, we offer [free support](https://wordpress.org/support/plugin/give "Visit the Give support page on WordPress.org") to help you with your issues, questions, and concerns.
= Zero Commission Charges =
We earn money by selling [premium add-ons](https://givewp.com/addons/ "View all of Give's Premium Add-ons"). The money you raise using Give is yours to support your cause. Period. Add-ons are premium features that enable you to extend the functionality of Give. For example, you can use one of our add-ons to accept funds through your favorite payment gateway or send new donor emails to MailChimp. [View all of Give's Add-ons](https://givewp.com/addons "View all Give add-ons") to discover all the ways you can extend Give.
= Easy to Customize and Enhance =
Give is built by [WordImpress](http://wordimpress.com "Visit the the developers of Give - WordImpress"), our plugins are built from the ground up to be intuitive and easy to use. By following along with our [Getting Stated Guide](https://givewp.com/documentation/core/give-101/ "Give 101 - Getting started using Give to accept donations on WordPress"), setting up Give to accept donations on WordPress is simple and easy.
Do you have some development experience? We've built in an advanced templating system similar to the ones found in many of WordPress' top plugins that makes customizing many of Give's frontend elements upgrade proof and extremely flexible. Run into some trouble? We're here to help! Along with the plugin is a support team that is dedicated, fast to respond, and always willing to squash bugs and help troubleshoot.
Here's some great developer-oriented tutorials and docs to help you customize Give to your liking:
* [Create Dramatic Donation Email Receipts](https://givewp.com/create-dramatic-donation-email-receipts/)
* [Load a Whole Donation Form in a Popup](https://givewp.com/load-donation-form-popup-give/)
* [Useing the Give API to Create Charts with ChartJS](https://givewp.com/using-give-api-create-charts-chartjs/)
* [Themeing with Give](https://givewp.com/documentation/developers/themeing-with-give/)
* [How to Create Custom Form Fields](https://givewp.com/documentation/developers/how-to-create-custom-form-fields/)
= Connect with Give =
Stay in touch with us for important plugin news and updates:
* **[Give Website](https://givewp.com "Visit the the Give website")**
* **[Give Add-ons](https://givewp.com/addons "View all Give Add-ons")**
* **[Newsletter](http://eepurl.com/bggG99 "Subscribe to Give via MailChimp")**
* **[Facebook](http://facebook.com/wpgive "Visit the Give on Facebook")**
* **[GitHub](https://github.com/WordImpress/Give "Visit the the developers of Give - WordImpress")**
* **[WordImpress](http://wordimpress.com "Visit the the developers of Give - WordImpress")**
= Contribute to Give =
This plugin is open source and we're always looking for more contributors. Whether you know another language, can code like no ones business, or just have an idea, we would love your help and input. To contribute to Give please head over to [our website](https://givewp.com "Visit the the Give website") or view/fork/watch the [GitHub repository](https://github.com/WordImpress/Give "Visit the the Give GitHub Repo") to learn more about what issues we're tackling and the project is developing.
= A Tribute to Open Source =
*"Open source software is software that can be freely used, changed, and shared (in modified or unmodified form) by anyone. Open source software is made by many people, and distributed under licenses that comply with the open source Definition."*
**~ The Open Source Initiative**
Give is a tribute to the spirit and philosophy of open source. We at WordImpress gladly embrace the open source philosophy both in how Give itself was developed, and how we hope to see others build more from our code base.
== Installation ==
= Minimum Requirements =
* WordPress 4.0 or greater
* PHP version 5.3 or greater
* MySQL version 5.0.15 or greater
* Some payment gateways require fsockopen support (for IPN access)
= Automatic installation =
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't need to leave your web browser. To do an automatic install of Give, log in to your WordPress dashboard, navigate to the Plugins menu and click "Add New".
In the search field type "Give" and click Search Plugins. Once you have found the plugin you can view details about it such as the the point release, rating and description. Most importantly of course, you can install it by simply clicking "Install Now".
= Manual installation =
The manual installation method involves downloading our donation plugin and uploading it to your server via your favorite FTP application. The WordPress codex contains [instructions on how to do this here](http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).
= Updating =
Automatic updates should work like a charm; as always though, ensure you backup your site just in case.
== Frequently Asked Questions ==
= Where can I learn more about how to use Give? =
We have extensive documentation on installing and configuring Give [on our website](https://givewp.com/documentation/). We suggest starting with the [Give 101 article](https://givewp.com/documentation/core/give-101/).
= How can I get support for Give? =
We work hard to the best support possible for Give. The [WordPress.org Support Forum](https://wordpress.org/support/plugin/give) is used for free community based support. We continually monitor the forum and do our best to provide ensure everyone gets an answer. [Priority support](https://givewp.com/support/) is given to users who have an active license for one of Give's [Add-ons](https://givewp.com/addons/) or [Bundles](https://givewp.com/addon-bundles/). This is email based support
= Do you have any demos? =
Yes! We have several live examples of Give displaying usage with many [popular WordPress Themes here](https://givewp.com/demos/).
= Do you have Case Studies of Nonprofits using Give? =
Yes! We call them "Give Stories". [You can read them all here](https://givewp.com/give-stories/).
= How is Give better than *Gravity Forms* for accepting donations through WordPress? =
First off, we love Gravity Forms. It's a great plugin and has a lot of good features for accepting donations. That being said, it lacks substantial donation reporting features and requires a developer license ($199/yr) to accept credit card payments on site.
= How is Give better than *WooCommerce* for accepting donations on WordPress? =
We also really like WooCommerce. It's hands-down the most robust eCommerce platform for WordPress. But that's also the issue. Typically you don't need a cart system, shipping, or tax calculations to accept donations. On top of that, customizing the plugin's terminology is a daunting task. You never want your users to receive an "invoice" for the donation "product" they "purchased". Rather, you'd like for them to receive a receipt for the donation they gave. WooCommerce can do donations, but that's not what it was designed for.
== Screenshots ==
1. Creating powerful donation forms is easy with Give. Simply install the plugin, create a new donation form, set the desired giving options, and publish!
2. Donation form fields can appear within a modal window (as shown here), be revealed with a nice sliding animation, or display entirely on the page (default).
3. Give makes the donation process simple and easy for your donors. This helps maximize conversion rates and further empower your cause.
4. The multi-level donation amount functionality allows you to set different giving levels for your donors to choose from. In addition, you can allow donors to specify custom donation amounts and even set donation goals.
5. The admin view of a donation form with multi-level amounts configured. Give's flexible options allow you to control whether the amounts output as radio buttons, a select field, or input buttons.
6. Don't need donation levels? No problem. You can set a default amount and allow your donor's to configure a custom donation amount to create a simple, yet powerful, donation form.
7. In-depth donation reports allow you to track just how much your cause has raised over time. You can even export the data to CSV or PDF formats.
8. Extend Give with a robust suite of powerful [Add-ons](https://givewp.com/addons "View all Give Add-ons"). Accept recurring donations, credit cards, add custom form fields, and more!
9. Give is thoroughly [documented](https://givewp.com/documentation "Visit the Give documentation") to help you get started quickly and learn basic to advanced features and functionalities.
10. Give has a dedicated support team to help answer any questions you may have and help you through stumbling blocks.
11. We are proud to build Give in collaboration with many of the WordPress communities' top developers.
== Changelog ==
= 1.5.2: June 31, 2016 =
* New: Added an addition "status" column for donation logs - https://github.com/WordImpress/Give/issues/684
* Tweak: Hide the submit button for the API Tab in Settings & improved the field description - https://github.com/WordImpress/Give/issues/681
* Fix: Deleted unnecessary user capabilities and resolved ones with typos causing issues with viewing and publishing donation forms for admins on new installs - https://github.com/WordImpress/Give/issues/671 and https://github.com/WordImpress/Give/issues/662
* Fix: Donation amount and count get reduced when delete pending donation - thanks @farookibrahim - https://github.com/WordImpress/Give/issues/677
* Fix: Broken link when clicking on donors name from transactions list in wp-admin - https://github.com/WordImpress/Give/issues/680
= 1.5.1: June 30, 2016 =
* Fix: The give_forms post type doesn't register correctly on new installs therefore users weren't seeing the "Add Form" or "Edit Form" options within WP-Admin - https://github.com/WordImpress/Give/issues/671 and https://wordpress.org/support/topic/the-add-forum-tab-not-showing?replies=4#post-8587308
= 1.5: June 29, 2016 =
* New: Easily reorder payment gateways with the new drag-and-drop gateway reorder capability within settings - https://github.com/WordImpress/Give/issues/391
* New: Implement honeypot hidden field to help prevent spam donation form submissions - https://github.com/WordImpress/Give/issues/424
* New: Export donation history based on a date range exports in "Reports > Export > Export Donation History"- https://github.com/WordImpress/Give/issues/414
* New: Automatically close a form when it reaches its Goal - https://github.com/WordImpress/Give/issues/168
* New: Added the ability to delete all test transactions under "Donations > Reports > Tools" - https://github.com/WordImpress/Give/issues/263
* New: Recalculate stats tool now available to recount individual donor statistics, delete test transactions, or reset all your statistics entirely - https://github.com/WordImpress/Give/issues/441
* New: New Give_Payments class added which allows easier development for donation payments - https://github.com/WordImpress/Give/issues/504
* New: Added "Test Mode" labels to more easily identify donations made while Give is in Test Mode - https://github.com/WordImpress/Give/issues/188
* New: Template wrapper support for the "Catch Evolution" theme added - https://github.com/WordImpress/Give/issues/632
* New: Export additional data and control the export columns for donors under Reports > Export > Export Donors in CSV - https://github.com/WordImpress/Give/issues/630
* New: South Korean Won added to list of currencies - https://github.com/WordImpress/Give/issues/624
* New: Moroccan Dirham added to list of currencies - https://github.com/WordImpress/Give/issues/381
* New: South African Rand added to list of currencies - https://github.com/WordImpress/Give/issues/624
* Tweak: Now when a multi-level donation is made the multi-level labels will display on the confirmation page, within the transactions listing page, and also attached to the {donation} email tag which outputs the email receipts - https://github.com/WordImpress/Give/issues/175
* Tweak: Added donor name to the donation receipt and reordered the rows for a more logical flow - https://github.com/WordImpress/Give/issues/645
* Tweak: Removed the French translation files included because, thanks to all French polyglots, we have been translated in full - https://translate.wordpress.org/locale/fr/default/wp-plugins/give
* Tweak: Removed Grunt in favor of Gulp for compiling pot files - https://github.com/WordImpress/Give/issues/666
* Tweak: Removed hosted translations in favor of public GlotPress translations
* Tweak: Rewrite of give_get_current_page_url to fix issues with domain mapped server with $_SERVER['SERVER_PORT'] - https://github.com/WordImpress/Give/issues/622
* Fix: Transactions Status Changes Causes Donation Form Income Amounts + Goals to Not Calculate Correctly - https://github.com/WordImpress/Give/issues/188
* Fix: Per form Offline donations gateway's "Request Billing Information" checkbox doesn't properly override the global setting - https://github.com/WordImpress/Give/issues/649
* Fix: Reports filter custom date range option when selected causes the refresh reports button to overlap - https://github.com/WordImpress/Give/issues/626
* Fix: Reports graph tooltips not displaying currency properly formatted - https://github.com/WordImpress/Give/issues/620
* Fix: Attaching a new user to a donor isn't updating - https://github.com/WordImpress/Give/issues/644
* Fix: Remove shortcode generator button when visual editor disabled - https://github.com/WordImpress/Give/issues/638
* Fix: Bug with shortcode & show_content argument when two of the same forms on a page displaying the content incorrectly when set to none - https://github.com/WordImpress/Give/issues/634
= 1.4.5: May 12, 2016 =
* Hotfix: Fixed a bug introduced which causes the custom amount minimum to be improperly calculated - https://github.com/WordImpress/Give/issues/616
= 1.4.4: May 12, 2016 =
* Hotfix: Version 1.4.3 breaks modal popup display method - https://github.com/WordImpress/Give/issues/615
= 1.4.3: May 12, 2016 =
* Fix: Update the email address of a customer record when the email of a user is updated via the WordPress profile updater - https://github.com/WordImpress/Give/issues/607
* Fix: Bug if the donation form's custom amount minimum is set to 0.00 the warning message would still display - https://github.com/WordImpress/Give/issues/604
* Fix: Bug with email access and the Donation History shortcode pagination not counting properly - https://github.com/WordImpress/Give/issues/600
* Fix: Fixed incorrect meta_key usage within is_single_price_mode() method which was returning false positives - https://github.com/WordImpress/Give/issues/602
* Update: Updated install process to account for WP multisite creation and deletion - https://github.com/WordImpress/Give/issues/609
= 1.4.2: April 26, 2016 =
* Fix: Bug with Custom Amount minimum and currencies with "," for decimal separator miscalculating the amounts - https://github.com/WordImpress/Give/issues/591
* Fix: Tooltips weren't loading properly when clicking the "Cancel" button after opting to create an account - https://github.com/WordImpress/Give/issues/500
* Fix: Closing Give Donation Modal Displays "give-hidden" elements in form incorrectly - https://github.com/WordImpress/Give/issues/582
* Fix: Ensure email is set in PHP session to view donation history after donating properly without having to preform additional email access request - https://github.com/WordImpress/Give/issues/587
* Tweak: Removing the top loading animation when changing donation amounts to reduce theme compatibility issues with it - https://github.com/WordImpress/Give/issues/556
* Tweak: Replaced JS get query parameter function with better function that doesn't throw unreachable code warning in console and works similarly - https://github.com/WordImpress/Give/issues/586
* Tweak: New changelog.txt file to offload older version changelogs; also added release dates to versions for better tracking - https://github.com/WordImpress/Give/issues/596
* Tweak: Hid the "ID" column from the multi-level repeater table because it served no real purpose for admins - https://github.com/WordImpress/Give/issues/554
= 1.4.1: April 12, 2016 =
* Fix: Member-only donation forms don't display member-only validation responses properly - https://github.com/WordImpress/Give/issues/551
* Fix: Email access cookie path set incorrectly breaks viewing details - https://github.com/WordImpress/Give/issues/570
* Fix: Validation conflicts with MemberPress - thanks @jimwebb - https://github.com/WordImpress/Give/issues/568
* Fix: If no Give logs under Settings > Reports > Logs then the log navigation does not display - https://github.com/WordImpress/Give/issues/564
* Fix: Login/Cancel/Register within donation form don't trigger float-labels - https://github.com/WordImpress/Give/issues/574
* Fix: Login/Cancel/Register within donation form has problems maintaining gateway-specific fields when changing gateways - https://github.com/WordImpress/Give/issues/574
* Tweak: Deprecated give_no_guest_checkout() in favor of give_logged_in_only() - https://github.com/WordImpress/Give/issues/551
* Tweak: Clean up '&' encoded ampersands for PayPal standard - https://github.com/WordImpress/Give/issues/562
* Tweak: Added a check for DOM and MBString PHP extensions in System Info tab - https://github.com/WordImpress/Give/issues/560
= 1.4: April 5, 2016 =
* New: Donors now have the ability to view their donation history using only the email they donated with via the new "Email Access" functionality that can be enabled under Settings > Advanced - https://github.com/WordImpress/Give/pull/496
* New: Unit tests added for Give_Donate_Form class - thanks @cklosowski - https://github.com/WordImpress/Give/pull/517
* New: Added new "Goal Format" option which will allow totals to be output based on a percentage rather than amount; also added more filters for better control over goal output - https://github.com/WordImpress/Give/issues/387
* New: Added links to plugin settings page and documentation on the WordPress plugin listing page - https://github.com/WordImpress/Give/issues/531
* New: Featured image size option for single donation forms found under Settings > Display Options - https://github.com/WordImpress/Give/issues/535
* Tweak: Sessions are only created when a donor performs an action. This will help Varnish caching on some Managed WordPress hosts and increase performance of the plugin - https://github.com/WordImpress/Give/issues/521
* Tweak: Removed usage of the image size "give_form_thumbnail" in favor of "give_form_single" - https://github.com/WordImpress/Give/issues/412
* Tweak: Increased modal windows z-index value - https://github.com/WordImpress/Give/issues/524
* Tweak: Added additional checks to the "System Info" settings tab - https://github.com/WordImpress/Give/issues/506
* Tweak: Removed Give's custom thumbnail size in favor for using WordPress' large media size to prevent image quality issues and excess image creation - https://github.com/WordImpress/Give/issues/535
* Tweak: Use $_SERVER['HTTP_HOST'] rather than $_SERVER['SERVER_NAME'] in give_get_current_page_url() - https://github.com/WordImpress/Give/issues/530
* Fix: Email compatibility with Mandrill WP plugin - https://github.com/WordImpress/Give/issues/548
* Fix: Add trailing slash to home_url() to prevent homepage redirect - https://github.com/WordImpress/Give/issues/545
* Fix: Problem give_format_amount_decimals return always 2 decimals - https://github.com/WordImpress/Give/issues/467
* Fix: "Custom Amount Text" should not show if the field is left blank for set donation forms - https://github.com/WordImpress/Give/issues/522
* Fix: Theme compatibility with Zerif and Customizr for single give donation forms - https://github.com/WordImpress/Give/issues/537
* Fix: Allow for $0 set donations to be saved properly - https://github.com/WordImpress/Give/issues/529
* Fix: Transactions with a "cancelled" status are not shown in the wp-admin Transactions table - thanks @pryley - https://github.com/WordImpress/Give/issues/514
* Fix: Alternative to fopen provided for PDF exports - https://github.com/WordImpress/Give/issues/511
[See full changelog here](https://plugins.svn.wordpress.org/give/trunk/changelog.txt)
== Upgrade Notice ==
= 1.4.3 =
Fixes for user profile emails, custom minimum amounts, donation history pagination, and multi-site install process.