apostrophe-donate
v0.5.14
Published
Donate module for Apostrophe CMS
Downloads
29
Readme
#apostrophe-donate
apostrophe-donate
allows a developer to quickly add a donation form to a webpage on an apostrophe-sandbox-powered website.
It uses the paypal-api-sdk module to process payments and allows email configuration to the donor and recipient of the donation.
Installation
I assume you already have a nifty Apostrophe 2 project built with apostrophe-site. The easiest way is to start by cloning the apostrophe-sandbox project.
Add the module to your project:
npm install --save apostrophe-donate
Configuration
In app.js
, you'll need to configure the apostrophe-donate
module, just like the rest of your modules:
'apostrophe-donate': {
// production has this in local.js
payPal: {
mode: 'sandbox',
client_id: 'xxxxxx',
client_secret: 'xxxxxx'
},
description: 'Donation for P\'unk Ave', //description of transaction
// configure the email to send to the donor
from:{
email: '[email protected]',
name: 'First Last'
},
// configure the email to send to the recipient of the donation
recipient:{
email: '[email protected]',
name: 'Recipient'
},
thankYouSubject: 'Thanks!', // subject of the email to the donor
confirmationSubject: 'Yay!' // subject of the email to send to the recipient of the donation,
// Your recaptcha 2.0 key and secret. IF YOU LEAVE THIS OUT,
// YOU *WILL* GET OWNED BY CREDIT CARD FRAUD TESTERS. DON'T
// leave this out
recaptcha: {
key: 'xxx',
secret: 'yyy'
}
}
The client_id
and client_secret
are retrieved after setting up a pro account with PayPal and registering your application.
Registering an app with PayPal
- Login to PayPal and go to https://developer.paypal.com
- Click Applications, then click Create App.
- Give your app a name and leave the defaults in place for the sandbox developer account field.
- Click the Create App
- Under Test Credentials, note the Client ID and Secret. These are for your local
data/local.js
configuration so as to not be playing with real money in development. - Under Live Credentials, click Show to find the production Client ID and Secret
Registering your recaptcha 2.x key and secret
See the recaptcha documentation. You WILL regret skipping this step. Fraudsters routinely use legitimate sites to test stolen cards in bulk.
Inclusion
Add this line to the template of your choice where you want the form to appear
{{ aposDonationForm() }}
Assets
apostrophe-donate
comes with a lot of pre-baked things.
Templates
- form.html - donation form generated with
apostrophe-schemas
'sschemaMacros
. You can redefine the schema inindex.js
. - formWrapper.html - a wrapper for the form
- recipientEmail.html, recipientEmail.txt - email template sent to the recipient of the donation after successful form submission
- thankYou.html - thank you message displayed after successful form submission
- thankYouEmail.html, thankYouEmail.txt - email sent to the donor after successful form submission.
Extras
Pre-baked styles in content.less
and a spinner.gif
for backward compatible ui goodness