Donate module for Apostrophe CMS
npm install apostrophe-donate#apostrophe-donateapostrophe-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.
Add the module to your project:
npm install --save apostrophe-donate
In app.js, you'll need to configure the apostrophe-donate module, just like the rest of your modules:
``javascript`
'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@email.com',
name: 'First Last'
},
// configure the email to send to the recipient of the donation
recipient:{
email: 'email@gmail.com',
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.
* 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
See the recaptcha documentation. You WILL regret skipping this step. Fraudsters routinely use legitimate sites to test stolen cards in bulk.
{{ aposDonationForm() }}
`Assets
apostrophe-donate comes with a lot of pre-baked things.Templates
* form.html - donation form generated with apostrophe-schemas's schemaMacros. You can redefine the schema in index.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