-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
315 lines (219 loc) · 20 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
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
=== Toolbar Extras for Give Donations - Manage GiveWP Donation Campaigns Even Faster ===
Contributors: daveshine, deckerweb, wpautobahn, toolbarextras
Donate link: https://www.paypal.me/deckerweb
Tags: toolbar, adminbar, admin bar, givewp, donations, fundraising, donate, donation, campagin, manage, deckerweb, ddwtoolbar
Requires at least: 4.7
Tested up to: 5.2
Requires PHP: 5.6
Stable tag: 1.0.1
License: GPL-2.0-or-later
License URI: https://opensource.org/licenses/GPL-2.0
Managing Donations with GiveWP? Here's to easier & faster fundraising with this Toolbar Extras Add-On. Extension support baked right in.
== Description ==
🚀 Quick Access to Your Donation Campaigns with Give directly from your Toolbar. View and edit your donation transactions, donors and form campaigns. Access reports and typical filter views directly from the Admin Bar - within the Admin or from the frontend of your site.
https://www.youtube.com/watch?v=al56-yuHBfc
[Video direct link](https://www.youtube.com/watch?v=al56-yuHBfc) | [Long version video (full walkthrough)](https://www.youtube.com/watch?v=swA4yJURxvs) | [Install & setup video](https://www.youtube.com/watch?v=eUdrpwdfCi8)
Perfect for non-profit organisations and private donation fundraising campaigns: This smart WordPress plugin just adds missed and **very useful admin links** for Give Donations to your Toolbar / Admin Bar. Save mouse travel and scrolling time. Get more productive - and focus on your campaigns instead of searching for settings ... 😉
ℹ️ **Essential:** Toolbar Extras for Give Donations is an **Add-On** plugin, it **requires** the base plugin "Toolbar Extras".
ℹ️ **Important:** "Give Donations" (GiveWP) is a **free** plugin for WordPress by GiveWP/ Impress.org, LLC.
ℹ️ **Disclaimer:** Toolbar Extras for Give Donations is an **independent** free plugin by David Decker from DECKERWEB. It does **not** represent GiveWP/ Impress.org, LLC.
= ♥️ Features - What the Plugin Does =
* Set a **Featured Form Campaign** as top-level item: See earnings (income) at first sight - plus: deep links to payments, settings etc.
* Bring all GiveWP Components into your Toolbar: Donation Payments, Donors, Reports, Form Campaigns, Settings, Add-Ons
* Quick access to Reports, including typical filter views (sub views, tabs, sections)
* All special GiveWP pages (Give Shortcodes) at your fingertips for live preview and editing
* Quick jump links for all Settings, Tools, even from Give Add-Ons
* Up to 30 Toolbar Add-On settings for customizing the experience (components, features, icon, position, label, etc.)
* Give Add-On (Extensions) directly integrated where possible and useful (only when Extension is active, of course) - *for Add-On listings see below*
* Resources - deep links to GiveWP documentation (knowledge base); also for Add-Ons
* Additional Give Toolbar settings submenu item - for WordPress Admin Menu
* Integration in WordPress *Site Health* feature (WP 5.2+), on the *Info* screen
= 👍 More Benefits =
* Non-bloated, already familiar interface (the WP Toolbar)
* Customizeable: make it pretty with your favorite icons and use custom titles and URLs for the top-level items
* Get more focused on your mission, save mouse travel and scrolling time, be more productive with donation management!
* Perfect for non-profit organisations and private donation campaigns - let the Toolbar work for you!
* Any items are only loaded when needed
* Fully internationalized and translatable (but can be disabled if ever needed)
* Use **all the other awesome features** of Toolbar Extras base plugin - to speed up your *non-donation work* as well! 😉
* Even a developer-friendly plugin with lots of filters and hooks
= 🔌 Supported/ Integrated Offical (Premium) GiveWP Add-Ons/ Extensions =
* *All below are paid premium extensions made by GiveWP/ Impress.org, LLC!*
* **Recurring Donations** - Allows for Subscriptions
* **PDF Receipts**
* **Annual Receipts**
* **Form Field Manager**
* **Manual Donations**
* **Currency Switcher**
* **Stripe** - Payment Gateway
* **PayPal Pro** - Payment Gateway
* **Sofort (Klarna)** - Payment Gateway
* **Paymill** - Payment Gateway
* **Google Analytics** - Donation Tracking
* **Tributes**
* **Fee Recovery** - Recover payment gateway fees
* **Gift Aid** - for this specific program of the UK Government
* **Zapier** - dozens of third-party integrations/ connections possible
* **Mailchimp**
* **ConvertKit**
* **AWeber**
* **Constant Contact**
* ***Note:** Support for more premium Add-Ons by GiveWP will be integrated/ added over time*
= 🔌 Supported/ Integrated Third-party GiveWP Add-Ons/ Extensions =
* [**Mailchimp for WP**](https://wordpress.org/plugins/mailchimp-for-wp/) (free, by ibericode) - *with dedicated, built-in extension for GiveWP!*
* [**WP HTML Mail**](https://wordpress.org/plugins/wp-html-mail/) (free, by Hannes Etzelstorfer/ codemiq KG) - *with dedicated (free) extension for GiveWP called [**Give Donation - Email Template**](https://wordpress.org/plugins/wp-html-mail-give/)*
* [**Builder Template Categories**](https://wordpress.org/plugins/builder-template-categories/) (free, by David Decker - DECKERWEB) - *categorize Give donation forms - use categories as "global" categories also with other integrations of this plugin*
* [**Members**](https://wordpress.org/plugins/members/) (free, by Justin Tadlock) - *manage user roles and capabilities (permissions), including for all dedicated GiveWP roles!*
* [**Members - GiveWP Integration**](https://themehybrid.com/plugins/members-givewp-integration) (Premium, by Justin Tadlock) - *even better special GiveWP integration for the awesome Members plugin!*
* [**Simple Social Shout for GiveWP**](https://github.com/impress-org/give-simple-social-shout) (free, by Matt Cromwell) - *adds simple social sharing buttons above your Donation Confirmation table*
* [**User Role Editor**](https://wordpress.org/plugins/user-role-editor/) (free, by Vladimir Garagulya) - *another popular role editor/ permissions plugin*
* ***Note:** Support for more free third-party Add-Ons will be added if more get released by the community*
= ℹ️ Important: Required/ Recommended for plugin usage =
* Required: User has role `Administrator` (needed capabilities `manage_options` and `manage_give_settings`) OR has a GiveWP-specific user role with appropriate capabilities (permissions)
* Required: Toolbar/ Admin Bar is enabled (user profile settings in WordPress)
* Required: User is logged in (of course)
* Recommended: Plugin's settings are enabled to show the wanted links (or any filter/ constant in code)
= 🌎 Translations =
* 🇺🇸 English (United States) - `en_US` = default, always included
* 🇩🇪 [German (informal, default)](https://translate.wordpress.org/locale/de/default/wp-plugins/toolbar-extras-givewp) - `de_DE`
* 🇩🇪 [German (formal)](https://translate.wordpress.org/locale/de/formal/wp-plugins/toolbar-extras-givewp) - `de_DE_formal`
* `.pot` file (`toolbar-extras-givewp.pot`) for translators is always included in the plugin's 'languages' folder :)
= 😎 Be a Contributor =
If you want to translate, [go to the Translation Portal at translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/toolbar-extras-givewp).
You can also contribute code-wise via our [Toolbar Extras for Give Donations GitHub Repository](https://github.com/deckerweb/toolbar-extras-givewp) - and see where you can help.
= 📝 Documentation and Support =
* For more information about features, FAQs and documentation, check out our website at [Toolbar Extras for GiveWP Plugin](https://toolbarextras.com/).
* If you have any more questions, visit our support on the [Plugin's Forum](https://wordpress.org/support/plugin/toolbar-extras-givewp).
* An overview about the ongoing development you'll find on our [Trello Board for the Plugin's Roadmap](https://trello.com/b/JrpjwlX4/toolbar-extras-public-roadmap)
= ⚡ Liked Toolbar Extras for Give Donations Add-On Plugin? =
* Join our [Facebook Community Group 💬](https://www.facebook.com/groups/ToolbarExtras/)
* **Rate us 5 ⭐ stars** on [WordPress.org](https://wordpress.org/support/plugin/toolbar-extras-givewp/reviews/?filter=5/#new-post) :)
* [**Subscribe to my Newsletter for insider info on this plugin** 💯](https://eepurl.com/gbAUUn), plus tutorials and more stuff on deckerweb WordPress plugins - join a thriving community of site builders!
* [**Become a Patron** 💜](https://www.patreon.com/deckerweb) and support ongoing development, maintenance and support of this plugin
* [**Follow us on Instagram** 📷](https://www.instagram.com/toolbarextras) and like our content
* Follow us on Twitter 🐦: [@ToolbarExtras](https://twitter.com/toolbarextras) and [@deckerweb](https://twitter.com/deckerweb)
= ☕ This Plugin ... =
* ... scratches my own itch!
* ... is *Quality Made in Germany*
* ... was created with love (plus some coffee) :-) - [if you like it consider donating](https://www.paypal.me/deckerweb)
== Installation ==
= Minimum Requirements =
* **Base plugin:** [Toolbar Extras](https://wordpress.org/plugins/toolbar-extras/), version 1.4.6 or higher
* WordPress version 4.7 or higher
* PHP version 5.6 or higher
* MySQL version 5.0 or higher
* Logged-in user that at least has the capability of `edit_give_forms`, and for whom the Toolbar (Admin Bar) is enabled (user profile)
* Recommended: Administrator user with capabilities `manage_options` and `manage_give_settings` plus the other GiveWP-specific capabilities, and, who is logged-in and has the Toolbar (Admin Bar) enabled (user profile)
= We Recommend Your Host Supports at least: =
* PHP version 7.2 or higher
* MySQL version 5.6 or higher / OR MariaDB 10.1 or higher
* HTTPS support
= Installation =
https://www.youtube.com/watch?v=eUdrpwdfCi8
1. Install using the WordPress built-in Plugin installer (via **Plugins > Add New** - search for `toolbar extras givewp`), or extract the ZIP file and drop the contents in the `wp-content/plugins/` directory of your WordPress installation.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings > Toolbar Extras** to adjust any options for this plugin ("GiveWP" settings tab)
4. Now enjoy managing your donation campaigns even faster with GiveWP - and let the Toolbar work for you ;-)
For documentation and tutorials visit our [Knowledge Base](https://toolbarextras.com/docs-category/givewp-addon/).
== Frequently Asked Questions ==
= What are typical use cases of this plugin? =
In general it will make your donation management with Give Donations easier and faster.
**1st Example: Non-profit Organisation**
* You have a team, including 5 Donation Managers (User role: give_manager)
* You have lots of donation form campaigns, for example 20 different active campaigns (forms)
* Set your most important/current campaign as a featured top-level item in the Toolbar -- logged in Admins & Give Managers see the current income and can access all stuff related to this specific form with 1 (ONE!) mouse click!
* From the top-level "Donations" item: access all Donation related payments, donors, reports (filters etc.), settings, tools and Add-Ons directly from the Toolbar
* This helps your team get more focussed, save time (less mouse travel and searching for settings...) -- you gain more time for the things that really matter!
* Focus on more on your campaigns, reports, income/earnings, payment history - because the Toolbar presents these things front and center for you
**2nd Example: Private Donation Campaign**
* Landing Page, only 1 Form Campaign
* You are the only user of this site/install, of course you are the Administrator (has all permissions anyway)
* Set your 1 campaign as featured in the Toolbar, so you can watch your earnings each time you are logged in into your site
* Focus on your campaign because all important info, views, reports, settings etc. are only 1 (ONE!) click away
* Save time, get more focussed and more productive -- gain more time to market your campaign for personal fundraising
= Why is Toolbar Extras plugin required? =
Toolbar Extras is the "base" or "main" plugin. It provides a lot of functionality under the hood, like the settings page, and lots of helper functions. This plugin here, "Toolbar Extras for GiveWP" is just an Add-On for it, adding features on top. It extends the functionality, that means, adding more specific items to the Toolbar. In this case specifically for the Give Donations plugin.
= Why is Give Donation (GiveWP) plugin required? =
While technically the GiveWP Donations plugin is not "required", this Add-On here makes absolutely no sense without it.
= Why has the base plugin "Toolbar Extras" the word "Elementor" in its title? =
That is only in the plugin's readme and therefore appears on the plugin page on wordpress.org. The reason is simple: the "Elementor Add-On" is de-facto built-in in the base plugin and not an extra Add-On (like this one here for GiveWP). **But don't worry:** you won't see any Elementor stuff ever. Those integrations are **only** ever loaded at all if Elementor is installed and active.
So don't get confused :-) On your "Plugins" page in your WordPress install the base plugin is listed normally as just "Toolbar Extras" and that is also the official name and it is referenced everywhere as that only.
For more background info on this topic have look on our website:
* *Blog post:* [Can Toolbar Extras be Used Without Elementor? (or Plugin/ Theme Xyz?)](https://toolbarextras.com/use-toolbar-extras-without-elementor/)
* *Documentation article:* [Why is Toolbar Extras required and why no standalone plugin?](https://toolbarextras.com/docs/addons-why-toolbar-extras-required/)
= Will this Plugin slow down my site? =
Absolutely not. The plugin will only do its stuff for logged-in Administrator, and optionally a few things for other Give-specific user roles who have certain permissions. The regular visitors will not see, or "feel" this plugin! Even a registered "Donor" basic user account won't see or "feel" this plugin at all -- it won't even load in these scenarios.
= Does the Plugin work with Multisite? =
Yes, technically it works fine in Multisite, you could even activate it Network-wide if you want. However, that will only make sense, if you also have the base plugins - Toolbar Extras, plus Give Donations - also installed and both were also activated Network-wide.
The normal use case is a single WordPress install with Toolbar Extras, plus Give Donations and this Add-On here.
= More info on Translations? =
* English - default, always included
* German (de_DE): Deutsch - immer dabei! :-)
* For custom and update-safe language files please upload them to `/wp-content/languages/toolbar-extras-givewp/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that as well, just use a language file like `toolbar-extras-givewp-en_US.mo/.po` to achieve that (for creating one see the following tools).
**Easy WordPress.org plugin translation platform with GlotPress platform:** [**Translate "Toolbar Extras for Give Donations"...**](https://translate.wordpress.org/projects/wp-plugins/toolbar-extras-givewp)
*Note:* All my plugins are internationalized/ translatable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating and validating I recommend the awesome ["Poedit Editor"](https://www.poedit.net/), which works fine on Windows, macOS and Linux.
== Screenshots ==
1. Donations item - the main Toolbar item for your donation management
2. Focus on Donation Transactions (Payments)
3. Focus on Donors - also per Form
4. Focus on Reports and Analysis - Income and more
5. Focus on Your Campaigns (Give Forms) - Preview and Edit
6. Focus on all GiveWP-specific Pages
7. Additional View for all GiveWP Pages, plus Optional Post State for Shortcode Pages
8. Focus on GiveWP Settings items
9. Focus on GiveWP Tools items
10. Focus on Updates (from Add-Ons), Licenses etc.
11. Focus on active Add-Ons - only if any supported Add-On is installed & activated
12. Optional: Support for "Members" plugin baked right in, including its additional GiveWP Integration Add-On
13. Useful external Resources for GiveWP
14. Community-oriented Resources, plus tips for Donation management and missions
15. Also, integration in Toolbar Extras "Users" Group for GiveWP Roles
16. Optional: Totally awesome "Featured Form" Campaign as extra top-level Toolbar item
17. Plugin settings for the optional "Featured Form" item
18. Up to 3 Frontend Items (top-level) for the Toolbar: Donations (Main item, on the left), Featured Form (in the middle, violett background), and GiveWP Test Mode (on the right, orange background)
19. This Add-On plugin with its GiveWP-specific Settings page for the Toolbar
20. Help tab for this Add-On plugin
21. Integration in Site Health Debug Info screen - for WP 5.2 or higher -- very useful for Support ;-)
== Changelog ==
([For the full changelog of this plugin visit its website at ToolbarExtras.com](https://toolbarextras.com/changelog/))
= ⚡ 1.0.1 - 2019-08-13 =
* New: [Video of plugin feature walkthrough and live demo](https://www.youtube.com/watch?v=al56-yuHBfc)
* New: [Video of Add-On installation & setup](https://www.youtube.com/watch?v=eUdrpwdfCi8)
* Tweak: Updated `.pot` file plus all German translations (formal, informal) and language packs
* Tweak: Enhanced, improved and corrected Readme.txt file here
* Fix: Fixed fatal error on activation (sorry!)
= 🎉 1.0.0 - 2019-08-12 =
* *Plugin launch. Everything's new!*
* New: 8 Free GiveWP extensions supported/ integrated
* New: 19 Premium GiveWP extensions supported/ integrated
* New: 30 Settings - Toolbar-related, unique for this Add-On
= ⚡ 0.9.0 - 2019-08-06 =
* New: Private beta release on GitHub
([For the full changelog of this plugin visit its website at ToolbarExtras.com](https://toolbarextras.com/changelog/))
== Upgrade Notice =
= 1.0.1 =
Plugin launch. Everything's new! First tweaks and improvements. - **Update highly recommended.**
= 1.0.0 =
Plugin launch. Everything's new!
== Donate ==
Enjoy using the Add-On *Toolbar Extras for Give Donations*? **[Please consider making a donation](https://www.paypal.me/deckerweb)** - every donation helps to support the project's continued development, maintenance and support.
**Thank you very much in advance for your support!**
== Additional Info ==
**Idea Behind / Philosophy:** Just a little lightweight plugin for all the non-profit and private donation campaign runners - making their daily work and life just a little easier.
== Last but not least ==
**Special Thanks go out to my family for allowing me to do such spare time projects (aka free plugins) and supporting me in every possible way!**
== My Other Plugins ==
* [**Toolbar Extras for Elementor - WordPress Admin Bar Enhanced**](https://wordpress.org/plugins/toolbar-extras/)
* [**Toolbar Extras for Oxygen Builder - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-oxygen/)
* [**Toolbar Extras for MainWP Dashboard - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-mainwp/)
* [**Builder Template Categories - for WordPress Page Builders**](https://wordpress.org/plugins/builder-template-categories/)
* [**Polylang Connect for Elementor – Language Switcher & Template Tweaks**](https://wordpress.org/plugins/connect-polylang-elementor/)
* [**Simple Download Manager for WP Document Revisions**](https://wordpress.org/plugins/wpdr-simple-downloads/)
* [Genesis What's New Info](https://wordpress.org/plugins/genesis-whats-new-info/)
* [Genesis Layout Extras](https://wordpress.org/plugins/genesis-layout-extras/)
* [Genesis Widgetized Not Found & 404](https://wordpress.org/plugins/genesis-widgetized-notfound/)
* [Genesis Widgetized Footer](https://wordpress.org/plugins/genesis-widgetized-footer/)
* [Genesis Widgetized Archive](https://wordpress.org/plugins/genesis-widgetized-archive/)
* [Multisite Toolbar Additions](https://wordpress.org/plugins/multisite-toolbar-additions/)
* [Cleaner Plugin Installer](https://wordpress.org/plugins/cleaner-plugin-installer/)
* [*My plugins newsletter*](https://eepurl.com/gbAUUn)