-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathreadme.txt
121 lines (77 loc) · 6.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
=== Receipt Attachments for GiveWP ===
Contributors: webdevmattcrom, givewp
Donate link: https://givewp.com/free-addon-receipt-attachments-for-givewp
Tags: givewp, donation, donations, attachment, receipt
Requires at least: 4.0
Tested up to: 5.8
Stable tag: 1.1.3
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.en.html
A [GiveWP](https://givewp.com/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=Free_Addons&utm_content=ReceiptAttachments) add-on which allows you to upload a file to use as an attachment on your donation email receipts and donation confirmation page.
== Description ==
A [GiveWP](https://givewp.com/?utm_source=wordpress.org&utm_medium=referral&utm_campaign=Free_Addons&utm_content=ReceiptAttachments) add-on which allows you to add a file to any GiveWP donation form and have it appear for your donors to download via the donation confirmation page and email confirmation.
This has many potential use-cases. Here's a few ideas:
* Provide a PDF Gift Certificate to those who donate over a certian amount
* Give a MP3 song as thanks to your donors
* Give a ZIP file (like a free WordPress plugin) to your donors
**FEATURES**
* Choose custom title text for the confirmation page
* Choose custom link text for the download
* Upload your file via the Media Library Uploader
* Optionally set a minimum donation amount per form for the Gift to be available to the donor.
* Add the link to your Admin notification email and/or the Donor notification email via a custom Email tag.
* Forms that don't have uploads are not affected in any way.
**BASIC USAGE**
At the bottom of each GiveWP form edit screen you'll find the GiveWP Receipt Attachments settings area. You configure that per form. This includes the minimum donation amount necessary for the attachment to be available (optionally).
If you upload a file and configure the settings there, the attachment title and link will appear automatically before the Donation Receipt table on your Donation Confirmation page.
In order to have the attachment link appear in your donation receipt emails, go to "Donations > Settings" then the Emails tab. In the Donation Receipt email field add `{attachmenturl}` anywhere you like. Below that field you'll see a full list of all the available email tags.
**ABOUT MATT CROMWELL**
> I'm COO at [Impress.org](https://impress.org). Our most popular plugin is [GiveWP](https://go.givewp.com/download), the leading donation plugin for WordPress. I build custom WordPress plugins and themes and blog frequently at [mattcromwell.com](https://www.mattcromwell.com) on WordPress, Religion and Politics, and Family life.
== Installation ==
= Minimum Requirements =
* WordPress 4.0 or greater
* PHP version 5.3 or greater
* MySQL version 5.0.15 or greater
= 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 install Give Receipt Attachments, login to your WordPress dashboard, navigate to the Plugins menu and click "Add New".
In the search field type "Give Receipt Attachments" and click Search Plugins. Once you have found the plugin you can view details about it such as the the point release, ratings and description. Most importantly of course, you can install it by simply clicking "Install Now".
= Manual installation =
The manual installation method involves downloading the 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 before doing any plugin or theme updates just in case. If you have any trouble with an update, try out our [WP-Rollback plugin](https://wordpress.org/plugins/wp-rollback) which lets you revert to previous versions of WordPress plugins or themes with just a couple clicks.
== Frequently Asked Questions ==
= What file types are supported? =
Give Receipt Attachments uses the Media Library to upload your attachments. This means that you can use any file type that the Media Library supports. [See a full list here](https://codex.wordpress.org/Uploading_Files).
= Where can I submit Support Questions? =
I'll answer all inquiries [here](https://wordpress.org/support/plugin/give-receipt-attachments).
= I have a feature request, or would like to contribute to this plugin. Where can I do that? =
Give Receipt Attachments is hosted publicly on Github. I'd love your feedback and suggestions [there](https://github.com/mathetos/give-receipt-attachments/issues).
= I really love this add-on. Can I donate a bit to you for making it? =
I really appreciate that! [You can donate here](https://www.mattcromwell.com/products/give-receipt-attachments/).
Please know that all donations generated through my website go to support the work I do with local nonprofits in San Diego. [Read more about that here](https://www.mattcromwell.com/help-me-help-others/).
== Screenshots ==
1. The Attachment Title and Link displayed on the GiveWP Donation Confirmation page.
2. The Attachment link displayed inside the GiveWP Donation Receipt Email.
3. Adding the Attachment link to your donation receipt email requires adding the {attachmenturl} email tag.
4. The settings for GiveWP Receipt Attachments that are displayed at the bottom of each GiveWP form edit screen.
== Changelog ==
= 1.1.3 (Oct 2021) =
* Make sure the `{attachmenturl}` email tag always renders correctly.
= 1.1.2 (July 2020) =
* Hotfix to prevent the add-on from indicating it needs a license key.
= 1.1.1 (May 2020) =
* Improved Form Settings icon and general appearance
* Code clean-up of admin assets
* Removed deprecated core GiveWP functions from use
* Cleared out backwards compatibility files for VERY old versions of GiveWP
= 1.1 =
* Added compatibility with GiveWP 1.8's new Metabox UI
* Added a setting to toggle showing the download on the donation confirmation page or not.
* Added proper textdomain loader and POT, PO, and MO files.
= 1.0 =
* Initial release
== Upgrade Notice ==
= 1.1 =
NOTE: This update requires GiveWP version 1.8+
= 1.0 =
This is the initial release. Thanks for installing!