Instructions for setting up the donation module

We too just downloaded it and added it to our site, but also do not know how to set it all up. There are no instructions in the ReadMe.txt file, that would have been helpful. Can anyone give us some instruction? I do have the simple paypal framework installed

Instructions missing...?

Tomas

Well after playing around I figured it out. So I will put down what I did here.

Step 1:
Open donation-5.x-1.x-dev/donation/donation.module
I personally used Crimson Editor for this which you can download for free at
http://www.crimsoneditor.com/

Here you will have to edit 3 areas.

The first is on line 480
'#value' => 'Change this here', This is what your site will send to paypal as the payment reason

The second is on line 495
'#description' => t('Change this here.'), This is what your site will say under the options to choose currency

The last is on line 500
'#description' => t('Change this here.'), This is the comment under where they type how much to donate

STEP 2:

Once you have the module installed, go to the admin section, and select Paypal under Site configuration. This should be set to https://www.paypal.com/cgi-bin/webscr by default. Just make sure thats what it says.

STEP 3:
Also under Site configuration, click on donations. This is what it will say at the top and bottom of your donation tracking page. It is also where you input your paypal email that you wish to receive donations at.

After that you should be all set up as far as working with paypal, now its just a matter of getting to the stuff.

You can do this in any number of ways, I chose to go 3 different routs, the first was placing a primary menu to the donation page, which the url should be /?q=donate. The second was placing a navigation link to both the donation tracker, and the donation page. The tracker page should be /donations.

Lastly, I went to paypal and and grabbed one of there donate graphics. Then I created a block, and have the image link to the donation page. I display that block on the footer section of each page.

If you do as I have said, then so long as people donate through your site, your tracker will track them (they have to be logged in to assign it to specific person)

I hoped this helped.

Is there a way to get rid of the Euro option or at least default to the US Dollar?

Hello,

Its not checking for Amount as the required field in client side. any changes for these?

Can we check it using sandbox account?

how to make sure only registered users can donate?

Any help please

Thanks in Advance

Thanks!

I have 4 small questions:

1) Can I make a Block out of this module? (so that people will be able to donate from withing a compact block) ... I think it should be pretty easy (I just know nothing about code)

2) How do I add a British Pound Sterling option? and will this module work with GBP?

3) How do I get it to display the donated ammounts on person's profile page? (from what I understand this module doesn't do it by default)

4) How can I add a radio button for "One-off" (default) and "Recurring" in the donation form.

thanks again.

Just wanted to say thanks for this documentation. It worked for me.

@Aldren

For the changes in code in your comment above, it is better if these are made configurable in the settings, so no one has to edit the module to change them.

@ezynetwork

For currency changes, please file a new feature request issue against simple paypal so it becomes configurable.

@drupalina

Please open a new feature request for a block for this module.

@Everyone else,

Please do not ask new questions in this issue. This is about instructions only, and it would be Can someone please write these steps in text format, so they are included in the README.txt file?

Aldren said:
"Lastly, I went to paypal and and grabbed one of there donate graphics. Then I created a block, and have the image link to the donation page. I display that block on the footer section of each page."

I know you posted this a long time ago but if you happen to come back here can you or someone else who knows tell me how exactly to do this? That is, add an image to a block and turn it into a link?

Thank you,
Tony

Any plans to upgrade this module for Drupal 6.x?

Please stick to the topic of the issue, not polluting it with extraneous questions.

Also, search the issues before you post for similar problems.

To answer the question, see here http://drupal.org/node/228214

I did the instructions below and it is not showing the completed Paypal donations on my site. Does the IPN settings have to be set in my Paypal account?

i installed on another site that I had access to the associated Paypal account and went and set the IPN in the Paypal settings and it does work (automated updating of donations)

There is no need to change the Paypal IPN in your Paypal account.

The donation module and simple_paypal send in the IPN in the transaction, regardless of what is set in your Paypal account.

Now, what we need is someone to summarize everything in this thread into a README.txt that I can commit with the module, and hence everyone has the documentation at their finger tips.

Patches welcome ...

any idea then on why the first site wouldn't update the donations?

The email address on the /admin/settings/donations page is the one used with Paypal...

You need to debug it. See if you get an IPN attempt or not, then see why it does not get acknowledged, ...etc.

Sorry...I don't know how to debug it. I know in the ecommerce module there is the option to turn on debugging on and it sends an email of all IPN transactions to the email address defined but I don't see that option in the simple_paypal module....

Do you have to debug it from the Paypal account side of things??

Hi Aldren and all,

Just got Paypal donations set up thanks to your help.

But I noticed that I seemed to have to search and replace the default Paypal email donations@drupal.org in 4-5 places with my organization's own Paypal email account in the donation.module file.

Just FYI ... you all might want to add that step to Aldren's instructions. I believe this solves the problem Metapsyche is having.

I'm using the Smultron code editor for Mac, incidentally. And no coder I. But if you muck about I'm sure you all will figure it out.

Cheers ...

There is no need to edit the code at all.

The email used is the one you configure in the settings page for this module, and you should set that to your own Paypal email.

Sure. I had already done that. But then why is Metapsyche getting the wrong Paypal page showing up?

Thank you very much. This was a great set of instructions that really ought to get put in a .TXT and sent out with the module.

What is the link for the donor list? I can't enable clean urls and site.com/donations does not work.

My Website: www.MegaAnimeOnline.com

This module comes with little to no documentation and is confusing to setup and use. I do not recommend it. If someone can take many hours to create a module, they can't take a few minutes to explain how it works?