PayPal Donations

Description | Installation | Usage | Download | Translations | Filters | Changelog


Adds a PayPal donation sidebar widget and shortcode to WordPress. The options menu lets you setup you PayPal ID and a few other optional settings. You can choose which donation button you want to use or if you want to use your own button. You can also set an optional default purpose and reference which can be overridden on each inserted instance with the widget and shortcode options. There is also settings for currency, custom payment page style and the return page.

This donation plugin generates valid XHTML code.



  1. Upload the ‘paypal-donations’ folder to the ‘/wp-content/plugins/’ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Go to Settings -> PayPal Donations and start entering your info.

Uninstall in WordPress 2.8 or newer

  1. Deactivate PayPal Donations in the ‘Plugins’ menu in WordPress.
  2. After Deactivation a ‘Delete’ link appears below the plugin name, follow the link and confim with ‘Yes, Delete these files’.
  3. This will delete all the plugin files from the server as well as erasing all options the plugin has stored in the database.

Uninstall in WordPress 2.7 / 2.7.1

  1. Deactivate PayPal Donations in the ‘Plugins’ menu in WordPress.
  2. Select PayPal Donations in the ‘Recently Active Plugins’ section and select ‘Delete’ from the ‘Bulk Actions’ drop down menu.
  3. This will delete all the plugin files from the server as well as erasing all options the plugin has stored in the database.


The Admin Page

The Admin Page

The Admin Page

PayPal Account

Your PayPal secure merchant account ID or an email address associated with your PayPal account.

As I loathe spam, I’d personally recommend to use your ID and not your email address. You will find your ID number in your PayPal profile page.

A secure merchant account ID is a number that only PayPal can match to your real email address in your profile. Your primary e-mail address is never displayed, so it cannot be used by spammers.

If you choose a plain text e-mail address, however, it will be displayed in the button code. Anyone, including spammers, can copy this address for their own use.


Select the currency the donations will be made in.

Page Style (optional)

The custom page style that associated with the donation button when arriving at the PayPal payment page.

Login to PayPal -> Profile -> Selling Preferences -> Custom Payment Pages, to design your own page style.

Note: Some PayPal accounts have this option located in this place instead:
My Account -> Profile -> My selling tools -> Selling online -> Custom payment pages.

Return Page (optional)

An URL where the user will be returned after completing the payment. For example, a URL on your site that hosts a “Thank you for your donation” page.

Amount (optional)

Set a default amount to be used by the plugin. Use numbers only, like 9.95 or 20 without any currency symbol.

Purpose (optional)

Here you can enter a default purpose for the donation. You can override this purpose when inserting a specific button by using the purpose=”” argument in the shortcode. If no purpose is defined, the user will get the possibility to enter a purpose on PayPal’s payment page.

Reference (optional)

Here you can enter a default reference for the donation. You can override this reference when inserting a specific button by using the reference=”” argument in the shortcode.

Select Button

Here you can select between PayPals three default buttons, or enter an URL to a custom button of your own to use instead.
The last option in this section is language and country. It let’s you localize the graphics of the button to use any of PayPal’s available buttons with translated button graphics. By selecting your intended country when using the button with credit card symbols, they will be adjusted to the ones appropriate for the selected country.


  • Disable PayPal Statistics Enable this to not load the hidden image PayPal uses for statistics. It’s recommended to load the statistics image, but for speed purposes it can be turned off with this option.
  • Theme CSS Override: Center Button If the theme you are using do not center form buttons, but you want the Donate button centered, enable this options to center it.
  • Set Checkout Language Enable this to override any potential PayPal language cookie the person to donate might have set in the browser, and control the language used for the first PayPal checkout page.

The Sidebar Widget

Widget Setup

Widget Setup

The Sidebar Widget is only available if you run WordPress 2.8 or newer.

In the Appearance -> Widgets in WordPress 2.8 or newer you’ll find the PayPal Donations widget in the selection of available Widgets.

After dragging it to your sidebar you can enter a few optional settings.

  • A title to appear on the Widget (defaults to Donate)
  • A descriptive text to appear above the button (it automatically adds <p></p> around it on display.
  • Purpose to override the default purpose.
  • Reference to override the default reference.

How to use the shortcode

Insert the button in your pages or posts with this shortcode


Which is the simplest option, and uses all default and optional settings. If you want to make a specific button for a specific purpose you can add these options as an example:

[paypal-donation purpose="Spline Importer" reference="LW3D Plugins"]

Styling the button

The button is wrapped in a paypal-donations class,

<div class="paypal-donations">Button HTML</div>

So by adding a

.paypal-donations {}

entry to your css stylesheet you can do some additional styling like alignment for instance.

Available arguments to use for the shortcode is: purpose, reference, amount, return_page and button_url.


The PayPal Donations install archive is available from the WordPress Plugin Directory. The download link below directs to the plugin page where the latest version as well as all older released versions of the plugin can be downloaded.


Other than the default English language, PayPal Donations has been translated to the following languages:


The following filters are available for hooking into the plugin:

  • paypal_donations_amount Filters the predefined amount before the button is generated.
  • paypal_donations_url Filters the URL the form points to. Useful to change to the PayPal sandbox URL for testing the button.
  • paypal_donations_purpose_html Filters the the default hidden form input element for the purpose.


function change_donation_amount( $amount ) {
  // Do something
  return $amount;
add_filter('paypal_donations_amount', 'change_donation_amount', 10, 1);

function change_paypal_url( $url ) {
  // Do something
  return $url;
add_filter('paypal_donations_url', 'change_paypal_url', 10, 1);

// Add a drop down menu for donation purposes
function paypal_purpose( $purpose ) {
  return '
    <select name="item_name">
      <option value="Donation Purpose 1">Donation Purpose 1</option>
      <option value="Donation Purpose 2">Donation Purpose 2</option>
add_filter( 'paypal_donations_purpose_html', 'paypal_purpose' );


See the plugin’s Changelog at WordPress Codex.

Liked this page?

Subscribe to the site feed with RSS or by email.


  1. FrederickMay 14, 2009


    how can I change the curreny from USD to EUR?


    1. JohanMay 14, 2009

      Currently you can’t.
      But that’s something that will be included in the next update, so you can select your default currency, together with a few other useful options. So stay tuned and I’ll soon have it released.

    2. JohanMay 23, 2009

      I just released version 1.1 which now supports selecting and changing between all PayPal supported currencies.


  2. InanMay 18, 2009

    I cant ablke to put this on the page can u pls help me about this., I want to put this n my page and posting

    1. JohanMay 20, 2009


      You have to type the short-code [paypal-donation] where you want the button to appear in your post or page.

      I will probably add a TinyMCE button to do this for you in coming version, so one doesn’t have to keep track of so many short-codes.

  3. JustinMay 24, 2009

    How would i put this into my template? like on the sidebar?

    1. JohanMay 25, 2009

      You can use shortcodes in your sidebar in WordPress by adding the following line of code to the functions.php file in your theme:

      add_filter(‘widget_text’, ‘do_shortcode’);

      Then you can enter the PayPal Donations shortcode in a text widget for instance.

      If you don’t want to edit your theme, I’ll soon release an update for this plugin with a built in sidebar widget. I am just waiting for WordPress 2.8 to be finalized (as I’ve used the new 2.8 widget API) and then I’ll release the next version of the plugin with a PayPal Donation Widget included.

      1. fetaMay 27, 2009

        Could you elaborate some more on the widget shorthand? I’m not sure where exactly to put the line of code you mentioned in the functions.php file.

        Basically I copied the line noted above into the functions.php file assuming it can go near the top of the file. Then follow the steps mentioned at the top of the page like usual. Is that the correct procedure?

        You did mention something about the theme, and am not sure why that is an issue.

      2. JohanMay 31, 2009

        Anywhere in the functions.php file is fine, so putting it near the top should be good, you could place it just below the register sidebar function for instance.

        After you have done that, you can use the standard text widget and use the paypal donations shortcode in that widget.

        It shouldn’t be any more you have to do than that, otherwise WP2.8 should be out really soon now, and then you’ll get a dedicated widget for the donations in my next plugin update.


  4. LibertyReduxJune 27, 2009

    Hi, I am not good with HTML and stuff like that. I can’t figure out how to make the button thinner. It stretches across my website. You can look and see what i’m talking about. Could you give me some in-depth instruction?

    1. JohanJune 27, 2009


      I checked your website, and noticed in your CSS file that all input entities are globally set to a defined width and height, and that’s why your input button for the PayPal donations get stretched.

      Go to the bottom of your CSS file for your theme and add these lines

      .paypal-donations input {
      	height: auto;
      	width: auto;

      and the button will appear as expected. (The above lines overrides the globally set width and height for inputs in your theme’s CSS back to normal for the PayPal button)

  5. LibertyReduxJune 27, 2009

    Worked perfectly! Thanks Johan. I like the plugin.

  6. JoeJuly 7, 2009

    I would like to make the donation a fixed amount such as 9.95 USD
    Is that possible

    1. JohanJuly 8, 2009

      Hey Joe,

      I just updated the plugin to version 1.3, where I’ve added an optional setting to set a default donation amount.


  7. Matthew TommasiJuly 9, 2009

    Great plugin.. I have just installed this.

    For the next release could you please include functionality whereby the PayPal page (or the option to) opens in a new page/tab?


    1. JohanJuly 10, 2009

      Hey Matthew,

      That shouldn’t be any problems to add, I’ve put down a note for it and will add some option for this in the next version. :)


  8. EricJuly 10, 2009

    Here is the php code to insert the donate button directly into your php file (like sidebar.php) without using the shortcode. This code has to go inside the php tags.

    $paypal = new paypal_donations();
    echo $paypal->paypal_shortcode($atts);
    1. DaroldJuly 10, 2009

      Hi there. Thanks for the code to insert this into the php directly. I get an error about an unexpected “&”. Wondering if you could help. Thanks!


    2. DaroldJuly 10, 2009

      Woo! That fixed it! Thanks!

    3. Gene SteinbergAugust 16, 2009

      Which PHP tags? Did this on a theme page and saw nothing but raw code.


      1. JohanAugust 16, 2009

        He refers to the PHP enclosing tags <?php and ?> which must start and end all snippets of PHP code on a web page.


              ...PHP Code goes here...


      2. Gene SteinbergAugust 16, 2009

        Anyone have an answer?


  9. Jonnie KingJuly 10, 2009

    Is there anyway to use this plugin with 2.7.1? I havent upgraded to 2.8.1 yet and wanted to wait a while because I heard there were still some bugs. I installed this on 2.7.1 but I see since i don’t have 2.8 that I cannot configure the “settings” tab and have no idea how to work around it.

    Help is much appreciated!

  10. Jonnie KingJuly 11, 2009

    Disregard my last comment, i got it working and found the settings, but now when i place the code in my sidebar i get a message saying “PayPal Donations requires WordPress version 2.7 or later!” actually posted on my site above the donate button. I am running 2.7.1 !! This shouldn’t be popping up.
    The button works fine, but it is just ridiculous to have that message above the button and i want to know how i can remove this message.
    Also, is there anyway to add a little spacing between this donate button and my next widget underneath? they are very much clustered right on top of each other.
    Thanks so much for your help!!

    1. JohanJuly 11, 2009

      About the version warning, I tried it on my 2.7.1 wp install and everything works fine without any warnings, but you mentioned that you used it on your sidebar. The plugin is not really designed to be used on the sidebar in WordPress versions before WP 2.8. In WP 2.8 or newer the plugin gives you a standard widget.

      Anyway, I guess you get the warning because when calling the plugin from the sidebar in WP2.7.1 it might not get provided with the WP version string and therefore believes it’s in an older environment. What you could do, is to make a small edit to the plugin file, track up a line that says

      } else {

      which is around line 71, and just comment it out so it doesn’t get used, like this:

      } else {
           // $this->version_warning();

      and you shouldn’t see any version warnings anymore even when using it in the sidebar. When you later on upgrade to a newer WP version everything will work smooth for you with the plugin as an ordinary widget for the sidebar.

      About getting more space below your button you can add these lines of code to your stylesheet:

      .paypal-donations {
      	margin-bottom: 40px;

      Or using a different px value that suits you. The same goes here, when you upgrade to WP 2.8 or newer you will get the default widget distance below the button.


      1. Jonnie KingJuly 11, 2009

        Thank you Johan! You are a Prince! Everything worked perfectly. Now you just need to make this great theme you have available :)

  11. AnthonyJuly 18, 2009


    How could I go about centering this button? I have it in my sidebar widget fine…but its left align

    1. JohanJuly 20, 2009


      The easiest way to center the button is to add these lines in your style.css file.

      .paypal-donations {
      	text-align: center;

      Just put them at the bottom of the style.css for instance and you should be ready to go.


      1. AshleyAugust 5, 2010

        Thanks for this. I was wondering as well.

  12. PhilAugust 8, 2009

    Thank you for this nice plug in!

  13. CraigAugust 20, 2009

    I’ve been researching donate plug-ins, and came upon this one. Reading through the comments above – I am extremely impressed – you know your stuff – and are extremely helpful in answering all sorts of questions (some that would test some people’s patience ;)).

    So I wanted to let you know that your communicative customer service attitude, detailed information and helpful replies, are what have helped me decide that yours is the way to go.

    It’s great to come across this. Many thanks and keep up the excellent work! :)

    1. JohanAugust 20, 2009

      Hi Craig,

      Thanks for your nice comment. It’s much appreciated! :)


  14. FeifeiAugust 20, 2009

    Hi, I like your plugin, simple and powerful. I’m just wondering if you can make some options in the donation button for people to make donations in your future versions. For example, some quick options like $1, $5, $10, if not then people can enter their own amount to donate.


    1. JohanAugust 25, 2009

      Hi Feifei,

      Thanks for your suggestion, it was a nice idea. I’ll add it to my list of things to do the next major update, I plan to set aside some time to do it quite soon. :)


  15. ICEAugust 21, 2009

    Hey, tank you very much for the very handy plugin.

    I installed it on m Arabic blog. I get this message whenever I am forwarded to paypal’s website after clicking the “donate” button:

    Data does not match input character set or default encoding. For more information, please contact the merchant.

    I get it in both cases when the button is added to the sidebar via the built in widget, or by manually adding the php code in the sidebar’s php file.

    Whaat solution can be to this ?

    Thanx !

    1. JohanAugust 25, 2009


      I guess it can be caused by the arabic character set on your site. I remember that character set can be defined through the PayPal button, I’ll look into adding such an option.


      1. MouadAugust 26, 2009

        Thanx, ill be waiting

  16. FrankAugust 25, 2009


    Thank you for this plug-in. So far it works pretty well. I need to change the color of the “text” from black to white. I am not sure where I do that. I could not find anything in the CSS file that I could change. Your help would be appreciated.


    1. JohanAugust 25, 2009

      Hi Frank,

      Do you have an URL where I can take a look of how it looks at the moment? Then I can see what you need to do change the text color.


  17. CarlSeptember 21, 2009

    I would like to create a donate text link instead of a button. Any suggestions? Great plugin!

  18. guntisSeptember 24, 2009

    is there any way of showing certain amount of money that have to be gathered and changes in that sum after donation, if not maybe it could be included in next versions

    1. JohanSeptember 24, 2009


      Well, no, there isn’t such a feature at the moment in the plugin. But thanks for the suggestion, I’ll look into if I could add something like that for a coming version.


  19. RomeoOctober 12, 2009


    Great plugin, i have translate it in the Albanian language. It will be nice from you to add this language too.

    Pls contact me in order to send you the .po and .mo files.


    1. JohanOctober 13, 2009

      Thanks for the translation files, much appreciated. :)
      I’ve updated the plugin to include your translation.


  20. GeorgWPOctober 14, 2009


    I have localized your plugin for the happy Danes: PayPal Donations

    Usually, I keep my translations updated, so you are welcome to check now and then, if I forget to notify you. :-)

    1. JohanOctober 14, 2009


      Awesome! I appreciate your work with this. :)
      I’ve added your translation to the plugin and to the credits.

      Thanks again.

  21. Matt MowerOctober 14, 2009

    In my last test of the plugin, the return page entry did not work. Can anyone else check this?

  22. Rich BrownOctober 16, 2009

    Excellent plug-in! One question: how can I include a small amount of text below the “donate” button? I was thinking something like, “If you have been blessed by the ministry and would like to participate, please consider a donation!”

    1. JohanOctober 19, 2009

      Currently the paypal widget only allows you to add text above the button. I could add an option to move it below the button though.

      Another way if you want this right away, you could add a text widget right below the paypal widget, and write your text there. If you leave the title field empty in the text widget, the text will appear close below the paypal button.

  23. SeanOctober 18, 2009

    Saw in an earlier response that you were going to add the ability for users to put in their own amount. I would just like to put in a second for this feature. Add this, and this plugin in perfect.

    1. JohanOctober 19, 2009

      By leaving the amount field empty in the admin for the plugin the user can put in their own amount in the current version. Or where you referring to having a set of predefined amounts to choose between for the user?

      1. SeanOctober 19, 2009

        Was thinking of letting the user put in their amount BEFORE they get to PayPal. So I would have an option to add an input field to the widget itself.

    2. JohanOctober 21, 2009

      Alright, now I’m with you. :)
      That’s a feature I’ve thought of myself, I’ll try to get it added into the next update.

  24. XHIBITOctober 19, 2009

    I love the plug in widget, however I use a custom donate button and cant get rid of the little bordering white lines.
    Any suggestions ?

    1. JohanOctober 21, 2009


      I should probably add a class selector when using custom images for easier styling. But you can fix that right now as well.

      Just add these lines in your CSS stylesheet and the border should be gone:

      .paypal-donations input[type="image"] {
      	border: none;


  25. gabsOctober 21, 2009

    how use the Page Style property ?

    1. JohanOctober 21, 2009


      When you have logged in to your PayPal account, go to:
      Profile -> Selling Preferences -> Custom Payment Pages

      And you can create your own custom pagestyle for the payment page and give it a name. Use that name in the Page Style property to use that design for the donation page.


      1. GabsOctober 22, 2009

        Hi Johan,

        Thanks for your answer. :-)
        But, what name should I give ? css style with absolute url ?

    2. JohanOctober 22, 2009

      You don’t use any CSS styles for the PayPal page style function.
      I made a couple of screenshots for you to see how to setup your own PayPal style.

      PayPal Custom Page Styles

      Screen 1: Goto your profile page and then to Custom Payment Pages.
      Screen 2: That brings you to screen 2, where you can Add a new Page Style.
      Screen 3: And here you can give your new Page Style a name, which is the name you tell the plugin that you want to use for a page style. Also here is the (somewhat limited) styling options PayPal allows you to set for your custom look of the payment page.

      Hope this helps. :)


  26. AlexGOctober 21, 2009

    Hey there, I’ve been attempting to install a Paypal donation plugin to my wordpress blog, but I’m not able to. I can’t find the Pluggin section. I’m thinking it may be because I’m using a free wordpress blog. Is that the problem? Here it is…. (I actually am running 3, 2 actively)

    1. JohanOctober 21, 2009

      Hi there,

      You are correct, I am pretty sure the hosted blogs doesn’t allow users to install plugins on their own. You need to run a self-hosted version of WordPress to do that.


  27. Olivier BruchezNovember 16, 2009


    I’m using WP 2.8.6. I’ve installed Paypal Donations 1.4.4, added the widget to the sidebar, filled in the fields, but nothing actually shows up in the sidebar of my blog.

    Is there a compatibility problem between Paypal Donations 1.4.4 and WP 2.8.6 or am I doing something wrong?


    1. JohanNovember 16, 2009

      It should work fine with 2.8.6 (and the 2.9 beta), so that seems strange. Have you also filled in the fields in the WordPress Dashboard -> Settings -> PayPal Donations?

      1. Olivier BruchezNovember 16, 2009

        I’ve filled in the 3 “defaults” fields (Amount, Purpose, and Reference) in the Settings page, but not the Page Style and Return Page optional settings. I’ve also filled in the 4 fields in the widget (Title, Text, Purpose, and Reference). I use Mandigo 1.38 as a theme. That’s the problem, I think. It seems to work with other themes…

    2. JohanNovember 16, 2009

      I just tried the Mandigo theme to see if I could find some problem with it, but it seemed to work fine. The version I found of the theme was v1.41, so perhaps updating the theme to the newest version will solve your problem?

      1. Olivier BruchezNovember 17, 2009

        I think I forgot about WP Super Cache. Again.

        Sorry about that… :-(

  28. Bob KingNovember 26, 2009

    Excellent plugin. Thank you very much for creating it.

    Since I have multiple donate page for different purpose, it’d be nice to provide different Thank-you page. The plugin currently only allow one default Return Page.

    I had a look at your code (brilliantly structure!) and added the ‘return_page” short code. However, I don’t quite know how I can test it without making a payment.

    If you could let me know to do the testing, please complete the patch and send it back to you. You can also see my patch at:

    Kind regards,

    1. JohanNovember 28, 2009

      Thanks for the patch, I’ll take a look at it and see if I can update the plugin with it. :)

      To test paypal without making a payment, you can use PayPal’s Sandbox feature, it’s available here where you can setup a test account and test users and make test payments without using any real money.

    2. JohanNovember 28, 2009

      Your addition for the return_page shortcode worked aces. I’ve included your code in the plugin and updated the version number to 1.4.5. I added your name and url to your site in the changelog here and at

      Thanks for the addition. :)

      1. Bob KingNovember 28, 2009

        Wonderful! thank you for your fast response.

        Kind regards,

      2. Bob KingJanuary 8, 2010

        Hi Johan,

        I installed version 1.4.5 with return_page shortcode. I now have 3 donations (after a month). With the return_page URL, the donor should be taken to the download page directly. However from the interactions, I realized they were not taken to the download page, instead to an old form page which was configured as default Return Page.

        It seems that the return_page value had no effect. The default always take over. Since I haven’t figured out how to test the plug in without keeping on contributing to Paypal, could you have a look?


        1. JohanJanuary 8, 2010

          Hi Bob,

          Thanks for your report.
          I made a test with the shortcode overriding the default return page value, and it seemed to work properly.
          Have you entered your shortcode like this?

          [paypal-donation return_page=""]

          If you have, do you have the url’s to your pages so I can take a look at it, what it looks like for you? (url for a page with a button using the default return page and url for page with button with new shortcode return page).


        2. Bob KingJanuary 9, 2010


          Thanks for you quick response. I realize that I can just look at the generated code to test. My problem was a mixed modified code. A clean re-install solved the problem.

          I own you a beer

  29. Bob KingNovember 27, 2009

    I’ve received a few donations. Paypal takes away 2.9% + $0.30 USD. For a $10 donation, this is $0.59. Pretty high. However, if this is a personal transfer, it’s free when the money comes from PayPal balance or bank account.

    Is there a way to set the donation to Personal Transfer?
    Thanks again

    1. JohanNovember 28, 2009

      I’m not sure if that’s possible, but I’ll take a look at the different options PayPal provides and see if there’s a setting for it. I don’t remember seeing it, but there’s plenty of options available so I might not have paid attention to it.

  30. DickNovember 30, 2009

    We had the issue that with a German PayPal account the checkout page was showing in German.

    I had to add the following to the plugin to get the cart page on PayPal to show in English for all users: $paypal_btn .= ”;

    Perhaps you can add this to be connected to the language setting variable so the checkout page in PayPal always has a preset language.

    Otherwise super cool plugin!

    1. JohanDecember 2, 2009

      Thanks for the information. :)

      I’ll take a look at this and add some option for it in the next update.


    2. smnJanuary 15, 2010


      I have the same problem.
      What is the code to put behind $paypal_btn .= ”; with $paypal_btn .= ”; it does not work

      1. JohanJanuary 15, 2010


        I think the html code got stripped from his comment.
        Anyway, PayPal allows you to set the localization of the checkout page with the lc variable.
        So to make sure the checkout page is in english you can add this row into the plugin:

        $paypal_btn .= '<input type="hidden" name="lc" value="US" />';

        That line shall go in the generate_html() function, just below the comment “// Optional Settings” (line 157 I think) would work fine.

        I’ll add this as an option in a coming update, but if you want this now, this works fine to do in the meantime.

        P.S. PayPal has a list of all available country codes, if you want to default it to something other than US English. D.S.


  31. RyanJanuary 2, 2010


    Thanks for the plugin, it was useful, but i’m having problems trying to add it into my sidebar as i’m not trained in playing around with the coding etc as you can see from my blog with the Meta, Blogroll, Archieves sidebarstill there

    When you mention php files to put in the paypal code add_filter(‘widget_text’, ‘do_shortcode’);

    does it mean that I have to go into my FTP account and retreive the files to insert the code into the php files and update the files from FTP?

    Is there any way whereby I can bypass the php files thingy?

    Btw: I come across a blog yesterday that has the same Paypal Donation button but his can allow the user to choose their preferred currency, is it possible with your plugin?
    his site is:

    Lastly, how do i create a thank you page with my wordpress blog? I’m still clueless on using the wordpress blog.

    1. JohanJanuary 2, 2010

      Hi Ryan,

      Okay, let’s see.

      No you shouldn’t have to edit or insert code into any php files to use the sidebar widget. In your WordPress Dashboard, if you go to Appearance -> Widgets, you’ll find all WordPress’ available widgets as well as the PayPal Donations widget which you then just have to drag into the sidebar there to activate it, and that should be all.

      About choosing the preferred currency, at the moment you can only do that in the admin, but it’s on my list to also expose that to the user if one wants to, in a coming version, so the user can select their preferred as well.

      To have a donation page, just create a simple page and call it thank-you, donated or something similar, and add the text and information you want to display to the donaters. And then in the PayPal Donations settings (Dashboard -> Settings -> PayPal Donations) add the complete URL to the thank you page in the return page field. For instance

      Hope this helps.

  32. qwizztestJanuary 11, 2010

    Hey Johan,

    I’m a web developer and I now use your Paypal donate plugin for any clients with donation needs.

    First I’d like to say thank you for developing such an easy to use plugin; I’ve had no problems at all with the installation and setup; and it has actually replaced a more complicated (though still very functional) event registration plugin I’ve used in the past.

    The best part of the plugin is the AMAZING support provided. Almost every single comment has been answered in a surprisingly detailed fashion (sometimes with screenshots!). Seriously, I’ve had paid for support that wasn’t as helpful.

    Finally, I do have an actual question. What does the “reference” argument do, exactly? After studying the examples, I’m guessing it’s used to group different types of donations… if so would I get those lists from paypal’s website?

    Thank you again.

    1. JohanJanuary 12, 2010


      I’m happy you find the plugin useful. :)

      Anyway, to answer your question.
      To quote PayPal about the reference argument: “Pass-through variable for you to track product or service purchased or the contribution made. The value you specify passed back to you upon payment completion.”

      In other words, PayPal themselves don’t use this argument for anything, so it’s solely for your own purpose if you find it useful. The text you enter there will be shown at the checkout page in smaller lighter text under the purpose which you can try by just enter some text in the reference field and press the donate button to get to PayPal’s checkout page.
      The text is also displayed in the subject of the email you receive from PayPal when you get a donation as well as in the donation details.

      So you can use it for your own personal grouping or when searching and perhaps other things I haven’t thought of. When using it with traditional products in a webshop it’s often used for the product ID. I have donation buttons for a few other things than my WordPress plugins so I personally use it to group different kind of donations together. So for all my WordPress plugins I just use “WordPress Plugin” as reference, so I easily can sort them from other donations in my mailbox later on.

      Hope this enlightens the reference variable a bit.


  33. jbJanuary 16, 2010

    thanks alot.

  34. nsaneJanuary 19, 2010

    My text and icon keeps alligning to the left of the widget box, and it even passes the border. I tried the code to center the button in this thread, but how do I also center the text?

  35. QuinJanuary 20, 2010

    Hi, I want to add the button to my footer (in the footer.php file). However, it doesn’t work. I tried it on my contact page, and it still doesn’t work.
    Any ideas? (hopefully for the footer)

    1. JohanJanuary 22, 2010


      To add the button in the footer, the user friendliest way would be to use fact that you can have multiple sidebars in WordPress, and have another sidebar registered for the footer, so you can drag sidebar widgets into the footer as well as the traditional sidebar. Then you can just add the paypal donations widget that way (and any other widgets you might want to use in the footer).

      The other option is to add a few lines of php code to the footer to add the button that way. You’d then just have to add these 3 lines posted in this comment above:


  36. KingWmFebruary 1, 2010

    Plugin appears to work well. I have a suggestion. I am not using the plugin for donations, but for payment for services. Your plugin does not have a feature to use the “saved buttons” feature from paypal. In other words, I created a personal button in PayPal for “Pay Now” with some specific options. They generated code for the button and provided me with a link URL to the code. The problem is, there is no where to enter the code or the link in your plugin. Apparently, the plugin is for Donations only, which is fine. However, if you could add the PayPal personal button feature to the plugin, it would be that much more wonderful.

    I hacked your code and it is working. First, I change the the icon to paynow:
    ‘cards’ => ‘’);

    Then, I change the following:
    $paypal_btn = ”;
    $paypal_btn .= ”;
    $paypal_btn .= ”;
    $paypal_btn .= ”;

    The x’s are my costum button ID.

    Making these changes allowed me to use your plugin for a “Pay Now” button that uses my custom payment screen in PayPal.

    Thanks for the plugin. It definitely works for me even though I had to hack it. I just wanted to suggest the feature for future upgrades. then, it would not be just a “Donations” plugin, but would also work for the other PayPal buttons.

    1. KingWmFebruary 1, 2010

      I just noticed the lines of code were removed from my comment.

      I made the following changes:
      $paypal_btn .= input type = hidden, name = cmd, value =_s-xclick
      $paypal_btn .= input type = hidden name = hosted_button_id, value = the ID of my button generated by PayPal

      In summary, I made 3 changes:
      1) changed icon for cards to _paynow instead of _donate
      2) changed the values for the two “$paypal_btn .=” to the valued provided by paypal.

      Sorry, I am not much of a coder, so I don’t understand the vernacular.

  37. Jan KlapisFebruary 18, 2010


    I am sorry if this sounds like a stupid question, but I just can´t seem to find my PayPal ID nor custom payment pages in my PayPal account. Regarding the first, the profile page displays only various links to my email, address etc but doesn´t contain my ID, and reg. the second, there is no such thing as Custom Payment Pages under Selling preferences… can you help?

    1. JohanFebruary 18, 2010

      Hey Jan,

      Check out this screenshot in the comment above

      At the top where the text is mosaiced, just under the Profile Summary heading, you’ll find your Secure Merchant Account ID. And then the link to custom payment pages is underlined in the same screenshot.

      Hope this helps.


      1. Jan KlapisFebruary 18, 2010

        Hmm, it´s clear that my PayPal shows me that page a little bit different…

        Please look at this:

        Why is it different from yours?

        1. JohanFebruary 18, 2010

          Ah, you probably have a personal PayPal account. To get all merchant services you need to change the account type.
          See this chart for available PayPal account types:

          You need to upgrade it to Premier account type at least to get all features. You should find the option to do that somewhere in the options after you’ve logged in to your account (I don’t remember exactly where the upgrade account link was).

  38. Jan KlapisFebruary 18, 2010

    Johan, you´re a great help. Thank you so much for investing your time in clearing my doubts.

    Best wishes,


  39. KlockarmanFebruary 19, 2010

    When I put it on my sidebar, there is a box around the “Donate” icon. Any way of getting rid of that?

    1. JohanFebruary 19, 2010


      Probably the CSS for your theme has set all form buttons to have a border around them. You need to make a small addition to your CSS stylesheet to make an exception for the PayPal button. See my reply to this comment of what you need to add.


      1. KlockarmanFebruary 19, 2010

        Me again. Where exactly on the CSS style sheet do I place that code? I tried pasting it to the very bottom of the style sheet but that didn’t work to solve the problem. Sorry, I’m just a blogger, not a techie.

        Also, I pasted my Pay Pal Secure ID into your Admin form as you suggest in the instructions, but when I press the Donate button on my blog’s Donate button the Pay Pal donation form window still shows my e-mail address rather than my Pay Pal secure ID.

        Can you help with that too?

        1. JohanFebruary 20, 2010

          Well, it could be a number of things then, if you have an url to your site where you have set it up, I could take a look at it.

          And your second question, you mean that the email is shown when you come to the checkout screen at PayPal?
          Well, the only way to completely hide it from there is to change your PayPal account type to business, then it won’t be shown.
          If you don’t want to change to business type account you could also make a custom checkout page with your own logo to hide the email, but I still think it’s shown somewhere in the body text (not sure though).

  40. michaelFebruary 20, 2010

    Hi. How might I use the reference (or purpose?) to dynamically add the name of a person being sponsored?

    1. JohanFebruary 20, 2010


      There is no such functionality built into the plugin. But with some PHP tweaking you can add such functionality pretty easy.
      You could use the paypal donations shortcode from your functions.php and make a small function that accepts a name as argument and passes it on to the plugin through the shortcode.

      Or another way is to call the generate_html() function directly in the paypal_donations class from your functions.php. The generate_html() function in the plugin accepts purpose and reference as arguments, and return the complete html code for the button. So that could be a quick and easy way to do what you want to do.


  41. BryanFebruary 21, 2010

    How do you customize the styling of the donation button in the widget window? I am using the .paypal-donations {} inside the stylesheet to no avail. I can change the CSS for all the widget classes and get the appropriate effect, but I only want to center the donation button in the individual window of the paypal widget. Hopefully I’m making sense.. I don’t speak good webmaster lingo.



  42. JakeMarch 3, 2010

    Hi, this plugin looks really great. I do have a suggestion though. Could you make a back end page to view donations received? or at the very least allow me to input an alternate email to be emailed whenever a donation is made? I use a separate email for paypal and I rarely check it, so it would be nice to know when I get a donation.


  43. David BurtonMarch 3, 2010

    Any chance we can pass the return page as a shortcode? Anything need to be modified to do that?


    1. JohanMarch 4, 2010


      Yes you can, the argument to pass on a return page in the shortcode is simply return_page.
      So using [paypal-donation return_page="your url" other_arguments...] should do the trick.


  44. Christine SiebelsMarch 9, 2010

    How can I output a list of people that have made donations. I was here the other day and there was a list of donors by your Pintware link. They are gone today. Are you dynamically outputting donors?

    1. JohanMarch 9, 2010

      The plugin doesn’t automatically build a list of donors at this time. I’ve got a few requests about that though, so I’m thinking of adding such a feature when I get some time to finish the next larger update of the plugin.


  45. achmatimMarch 11, 2010

    hi sir,

    thanks for this plugin. i use it at my site,


  46. JerryMarch 11, 2010

    I’m having trouble using this Plug-in. I installed and activated it, then placed it into the Sidebar. But instead of the instantly recognizable “PayPal Donate” button, it shows “PayPal, the safer, easier way to pay online” instead (just text). On top of that, when I click the link (to test it out), it says “We cannot process this transaction because there is a problem with the PayPal email address supplied by the seller.”

    I have a PayPal premiere account, and I’m using the latest version of the Lightword theme. Any idea what I’m doing wrong?

    1. JohanMarch 11, 2010


      I took a quick look at your site’s HTML, and indeed, both the URL to the PayPal button image and the PayPal account information was missing from the HTML for the donate button.

      Have you filled in all the required information in the Plugin’s settings? If so, what version of WordPress are you using?


  47. MarilynMarch 11, 2010


    I am new at this so please be patient. I have been trying to add a paypal donation button on my blog for days and cannot seem to get it to work. Your first instruction is to:

    1.Upload the ‘paypal-donations’ folder to the ‘/wp-content/plugins/’ directory

    What does this mean? Where is the directory and how do I upload to it?
    I have already downloaded the new version of wordpress then uploaded it to my site using ftp but nothing happened. So there seems to be a crucial piece of information that I am missing.

    Thanks in advance for your help.

    1. JohanMarch 11, 2010


      If you’ve trouble installing plugins via FTP, you can do it automatically from within WordPress now.
      Go to the WordPress Dashboard -> Plugins -> Add New -> Search for PayPal Donations in the search field, and you’ll find this plugin a little bit down from the top in that list, and select install from there.

      Then WordPress will download the archive, unpack it and install it for you in the proper folder automatically.

      Hope this helps.

  48. AgnesMarch 18, 2010

    This looks great !
    I dont get one thing:
    does it enable to get payment with paypal only, or through paypal with various methods (visa etc), as Paypal now also offers with “pauypal integral”?

    1. JohanMarch 18, 2010

      The user who wants to make a donation can choose to make the payment with a Visa, Mastercard etc when they arrive at the Paypal screen, and they don’t need to have a PayPal account of their own to make the donation.


  49. VincentMarch 20, 2010


    I’m using your great plugin, but whenever I click the Donation button I’m getting a Fatal Failure return from Paypal. If I’m logged in into Paypal and click on the Donation button from my website I don’t get this error and the donation is properly processed. Any thoughts on this?

    1. DFApril 3, 2010

      I’m having the exact same trouble as Vincent. Just started this week too.

      My Paypal donation button was working just fine until just a few days ago. Now when people click on it they get a “fatal failure” error.

      How on earth do I fix this???

      Thank you!!

      1. JohanApril 3, 2010

        If you have an URL where this problem occur, I can take a look at it.


  50. HassanMarch 23, 2010

    I am thinking of using this module on the website of an educational charity I volunteer for. They want to give user the option to go through ‘Direct Payment’ method where user stays on their page while payment processing happens in the background.

    Here is the paypal instruction page for this kind of donation

    Question is does this module support ‘Direct Payment’ where by module makes call to the DoDirectPayment API of the paypal webservice ?


    1. JohanMarch 23, 2010


      The plugin does not currently use the Direct Payment method for donations. Thanks for your link though, I’ll read up on how this option works.


  51. MattMarch 25, 2010

    Johan -

    Great plugin and great support. I am creating a site for a non-profit that has 2 different arms. I need to have the ability to donate to 2 different accounts completely. Is that possible?


    1. JohanMarch 25, 2010

      Hi Matt,

      Currently it only supports one account. I could add so one can change the account when using it as a shortcode, if that would work?

      / Johan

  52. SmalvoMarch 31, 2010

    Hi! I can’t solve this problem: clicking on the donate button I get a PayPal page saying “The seller accepts encrypted website payments only. You cannot pay the seller through un-encrypted buttons. Please contact your seller for more details”.

    What does it mean? Thanks for your help!

    1. JohanMarch 31, 2010


      When visiting your site, I can’t access it. My Kaspersky Antivirus 2010 blocks the site with the message that it is infected with the virus Trojan-Downloader.JS.Agent.fdl

      My guess is that the problems you have encountered are related to that virus infection, try to get rid of the virus infection, and see if it works like expected after that.


  53. StephenApril 6, 2010

    Hi Jonathan,
    Thanks for your previous help in changing the font size of the donation message in the sidebar. One additional request – how can I more center the text of the donation message – right now it is right up against the left margin.
    The text is: Help Support Children’s Rights to the best care
    Also could I change the color of that test as well?
    I imagine I have to go into the style sheet etc.
    Thanks so much,

    1. JohanApril 6, 2010


      Just keep adding styles to your .widget_paypal_donations p rule for further styling of the text.

      ie, to make it centered and have a white color other than just changing the font size, change it to something like this

      .widget_paypal_donations p {
      	color: #ffffff;


  54. BruceApril 7, 2010

    This looks like a great plugin and exactly what I was looking for.

    A couple of questions:

    1. Is it possible for the button to open a new window (or tab)?

    2. When I use the [paypal-donation] short code on a web page, text that follows the button seems to align around the button. I tried using around the text to no avail. Any suggestions?

  55. MikeApril 21, 2010

    Very nice-looking plug-in. A question and a comment:

    1. where's the CSS for this? The styling of the header doesn't match my other h2 usages, and I need to find out why.
    2. on line 226, DreamWeaver reports a line of invalid code. Just FYI…

    1. Johan SteenApril 21, 2010

      Hi Mike,

      1. The plugin doesn't use any specific CSS file. It's a standard widget using WordPress' built in widget hooks. Any default widget h2 styling will be applied to the paypal donations widget as well. Checking your site, the paypal widget seems to be the only widget you are using, and the only h2 with the widgettitle class applied to it.
      If you want to style all your widget h2's in a specific way, you can use the h2 .widgettitle selector in your stylesheet (assuming you use widgets for all your sidebars). I noticed you had a few different selectors for h2's and the sidebar in your stylesheet so that's probably why you see some different styles.

      2. Yes, Dreamweaver is not that good in parsing HTML code with lot's of PHP code nested with it, that why Dreamweaver thinks the div tag at line 226 isn't closed later. No invalid code, just a Dreamweaver limitation.


      1. MikeApril 21, 2010

        Thanks for the reply, Johan. I've fooled with it a bit, and I think it's OK now.

        BTW: I made a very simple mod to center the button image. I think it looks much better, at least on my site. If you would like to incorporate this, email me and I'll send you the code. It's just a few lines.

  56. QinApril 28, 2010

    Thank you very much for the plug-in. I would like to know if this image :

    img alt=”” src=”” width=”1″ height=”1″

    is necessary ? Because I would prefer to reduce the number of images.

    1. Johan SteenApril 28, 2010


      I'm pretty sure the use of pixel.gif is optional and that PayPal uses that line of code only to monitor traffic.


      1. QinApril 28, 2010

        Thank you for the fast answer !

  57. Laurie ONeilMay 1, 2010

    HI there,

    I have downloaded and installed the plug in and it shows just fine on my page here.. however when someone who doesn't have a paypal account used their credit card/debit card it gives them an error that says they can't use that card.. I have had two different people try this.. both with debit cards and they did put it in the info a few different times.. do you know why this won't work .

    Also I saw in a comment already about the high fees for donations unless it comes from a personal account which is where most of these donations will come from.. were you able to find a way to do this without the fees??

    Thank you so much.. and I have to say the plug in was very easy to install .. only a couple of minutes..


  58. LaurieMay 1, 2010

    I did try it with my credit card and that worked.. so is it just debit cards that it won't work for??

    1. Johan SteenMay 3, 2010

      Hi Laurie,

      Well, that depends on what debit card the person uses. PayPal only support a few debit cards. Some debit cards are national only for instance and don't work at all on site like PayPal, and some do work, like Visa's debit cards for instance.
      So if you had people not being able to use their debit cards, I bet they are using cards that are not possible to make PayPal transactions with.

      All the best,

  59. MarinalinMay 2, 2010

    Wp doesnt show me the Settings of this Widget!

    please help me

    1. Johan SteenMay 3, 2010


      Well, I'd need some more detailed information if I shall be able to give you some help. :)


  60. surf2surfMay 5, 2010

    hi Johan
    Like the plugin and it works fine from my site
    This is the place where my WP blog are stored.
    The thing is that I have another domain from where i redirect people to my site I set the domain name stay in the browser after the visitor are redirected.
    when the user hit the donation paypal link from this they got a fatal error ?

    The plugin is working fine from
    But not if I redirect the user from how can that happend ?

  61. PeterMay 8, 2010

    Hi there,

    thanks for you work. Does your plugin store the donated values anywhere, so that I could include a meter for example?

    Thanks in advance

    1. JohanMay 9, 2010


      No, currently the plugin doesn’t retrieve or store any donations being made for statistics or similar purposes. I’ve got a few requests about such a feature though, so it’s definitely something I’m having in mind for future versions.


  62. ScottMay 16, 2010

    I am trying to use the plugin based on feedback I have seen. After reading and trying all the above suggestions & tips I am still having problems.

    When I add the widget or put the php the code directly into sidebar the Donate images always shows as blended with a search bar. It appears to add another search bar for my blog and then tries to squeeze in the widget.

    You can see the example in this image,
    Any ideas?

    Thanks Scott

    1. JohanMay 17, 2010

      Hi Scott,

      Checking the CSS file for theme you’re using, I noted that it assumes that the search form in your sidebar is the only form element available on the page, so it’s not using a unique identifier but styling all other form elements added to the sidebar as well. That’s why also the PayPal form gets the search form’s style and image assigned to it.

      The easiest, and correct, way to fix this would be to change the CSS so the styling for the search form is unique for that form and not a global for all forms, or by making a unique form style for the PayPal button that resets the float and background image added by the search form.


      1. ScottMay 20, 2010

        Thanks so much for your response. While I have no problem playing with php on a basic level I have no skills with CSS. It is easy to edit existing css/php but creating is not my forte.

        I guess if I ever want to add form elements I better learn. If you have time do you have a code you can paste as an example? In the meantime I will try my hand at the css stylesheet.

        Thanks so much

  63. ScottMay 20, 2010

    “The easiest, and correct, way to fix this would be to change the CSS so the styling for the search form is unique for that form and not a global for all forms”

    This sounds good and is what I want to do. I reread your comment and will be trying to do just this.

    1. JohanMay 20, 2010


      Alright, if you haven’t done much CSS before, let’s see if I can help you a bit on the way to get you started. :)

      Checking your site, the code in the HTML for the search form looks like this:

      <!-- begin search -->
      <form action="">
      	<input type="text" name="s" value="" />
      	<button type="submit">Search</button>
      <!-- end search -->

      If you change that to:

      <!-- begin search -->
      <div id="searchform">
      	<form action="">
      		<input type="text" name="s" value="" />
      		<button type="submit">Search</button>
      <!-- end search -->

      ie, adding a div with a unique name to encapsulate the form with.

      By using this new ID in the CSS you can change the current lines looking like this in your CSS:

      #sidebar form {
      #sidebar form input {
      #sidebar form button {


      #sidebar #searchform form {
      #sidebar #searchform form input {
      #sidebar #searchform form button {

      And the current form styling should now be unique to the search form only and not affect the paypal button (or any other form fields either) anymore.

      Hope this helps.


      1. ScottMay 21, 2010

        Well that was information that was precise and correct. I learned a couple of lessons from how I implemented the changes. Thanks so much I will be doing a little thank you article in appreciation.

        Now on to try your Post Snippets plugin.


      2. ScottMay 23, 2010

        Thanks again. Wrote a little about my working with your plugin here


        1. JohanMay 23, 2010


          You’re a legend! Much appreciated indeed! :)


  64. PKMay 23, 2010

    Thank you very much for this widget! It was very easy to install. I would like to center my button though and can’t figure it out. I put .paypal-donations {text-align = center} at the very end of my css style sheet. It didn’t do anything though. Should I be doing something else?

    1. JohanMay 24, 2010


      If you change

      .paypal-donations {text-align = center}


      .paypal-donations {text-align: center;}

      instead, it should probably do the trick.


      1. PKMay 24, 2010

        thank you!!

  65. Greg BlencoeMay 27, 2010

    Hi Johan,

    I LOVE your WordPress plug-in, but I am having some problems.

    Yesterday I downloaded the plug-in for my Positive Waves Baby blog (

    However, when I dragged the widget to Sidebar 1 to be placed above the “Killer Recent Entries” widget, the “Killer Recent Entries” widget stopped working. It was like it got deleted.

    And now when I try to drag the “Killer Recent Entries” widget from the “Available Widgets” section, all I get is an error message where “Number of posts to show:” shows up just to the right of the first Available Widget which is the AddThis widget.

    Moreover, the more I try to drag the “Killer Recent Entries” widget to Sidebar 1, the more times “Number of posts to show:” is listed (one below another).

    This is VERY strange. I don’t think I’ve had any problems with Thesis until now.

    Can you help me solve this problem??? Any help would be MUCH appreciated!


  66. Greg QuinlivanJune 3, 2010

    Thanks for this plugin. I think I’ve installed it successfully. I wanted to know if I could hide my email address after people hit the PayPal donate button. I”ll also try checking this with PayPal. I’d rather they only saw my merchant ID. As you say, it might invite spammers otherwise. Greg.

    1. JohanJune 3, 2010


      I had the same concern myself at one time, and when I dug around I found that you had to change your account type to Business, and the e-mail address won’ be shown when people are taken to PayPal’s site anymore.


      1. Greg QuinlivanJune 3, 2010

        Thanks, Johan. I also found that out from PayPal. The only problem is I’m not a business. I’m just a teacher who has made up some resources to share, and I’d like to receive donations for their use particularly by any profit-making organisations.
        I don’t mind being considered a merchant, as I do sell the odd thing privately sometimes, but that’s personal and nothing to do with teaching.
        So, I guess I’ll just have to leave the email address on there. Hopefully no spammers will bother me.

  67. LucatoJune 12, 2010

    Hi there. I didn’t download/use your plug-in because it doesn’t really fit into my needs, but as I see you keep updating it here goes a suggestion to add in your plug-in or generate a other plug-in if you really enjoy developing stuffs. ;0).

    Here is a suggestion that you would add the following features into your plug-in and it is something that I’m looking for into a donation plug-in:
    - An option to show a sidebar widget as a cloud tag for donators showing them in different sizes depending in the amount they donated (Equally to Donations Cloud plug-in by Alex Günsche)
    - A widget sidebar with option to select to show the “Purpose” as in your plug-in or the “Donation form” (Equally to Donations Cloud plug-in), but in this form you would add the option with a dropdown list to select which donation/payment way you want to use to pay (PayPal, MoneyBreakers, PagSeguro, and many others that the user want to add ), but these “buttons” code for each payment method/company would be stored as a database like the plug-in (Datafeedr Random Ads by does for its ads where I have a admin contron of them crating/naming a groun for each one. So, when I select the payment method from the dropdown list in the widget, it will show the correct donation button for the picked option. So, the database would have a field name (for payment method name) and code (for pasting the button code). The dropdown list will show the “name” and the image button from the “Code” field. Well, something like that.

    Cheers and have a nice weekend.

  68. thebookmistressJune 18, 2010

    Is there a way to specify the image used for the button when you are inserting the button into a page or post? In other words, [paypal-donation purpose="purpose" image=""]? I want to change the button in one location, but keep the existing default button for other locations.

    1. JohanJune 21, 2010


      No, that’s currently not possible, but it’s pretty simple to add, so I can probably add it for the next update.


    2. JohanJune 29, 2010

      I’ve just updated the plugin to version 1.4.8 and included a new shortcode option for button_url.

      So no you can do
      [paypal-donation button_url="http://myimage.gif"]

      Enjoy. :)


  69. BPJune 25, 2010

    I’m stuck on a small aesthetic detail. Using the widget, the donate button populates in my sidebar looking and functioning as expected. However, when I enter the shortcode into a page, the button that shows up on the front end has a check-box looking square to the right of the button. (The button itself continues to function as expected, and the check-box thing is not doing anything, but then I’d rather the check-box thing not be there.)

  70. Daniel LucasJuly 18, 2010


    I’ve set up the framework of my blog myself. Your plugin works wonderfully in the sidebar. However I’ve tried using your shortcode in single.php and and all that is happening is that it shows [paypal-donation] in the page.

    Is there anything I need to add to functions.php to make shortcodes work or do you need to surround shortcodes with or something like that ?


    1. Daniel LucasJuly 18, 2010

      Right,it’s okay, I didn’t realise that shortcodes were to be put in the wordpress editor.
      Is there any way of making a donation button appear at the bottom of every post automatically using a cusomised image.
      For example:


  71. AndreasJuly 22, 2010

    Hello, I am at a loss here. Reading the comments really got me psyched about this app, but I just can’t seem to get it working? According to your guide after activating the plugin you should be able to see paypal settings in the Settings menu. But they never show up for me.

    I have tried deleting / doing it again, but it always ends up with no settings menu at all, after activating the plugin there’s just no trace of it. I am running the newest wordpress.

    Do you have any idea what could be causing this?

  72. Luis MaiaSeptember 26, 2010


    I’m having same problems with the button… I’ve created a button in PayPal page and I suppose that the URL what I have to copy to the “custom button” is:

    But don’t work… The preview in PayPal show me a correct button, but in the site I just see “PayPal – The safer, easier way to pay on-line”.

    What I am doing wrong?


  73. lauraOctober 9, 2010

    Hi love this widget. but i can’t get the button to center on my sidebar. it is left aligned. i read through the comments and i added the code you mentioned previously in the style sheet at the very end of the code, but nothing changed. any advice? you can check out my site at

    thanks so so much!

    1. JohanOctober 12, 2010

      Hi Laura,

      Sorry for the late reply, I just checked your site and the button was centered so it seems you got it sorted out anyway. :)


  74. MarkusNovember 2, 2010


    I would like to show on a page how my campaign is going. How much money that have been donated during the campaign. In a chart if possible.

    In the long prospective id like to show what the money is used for as well. But that can be solved later :-)

    Any ideas on hwo to slove the first question?


  75. Bob KingNovember 5, 2010

    Hi Johan,

    Here’s an idea to make your great plugin superb.
    I’ve using your plugin for over 18 month now. Every time someone donates, I’ll follow up with an email with links to useful resources. When I’m traveling, I feel sorry for my slow response to the donor.

    So I’m looking at an automated way to send the message to the donor. Paypal has this IPN Instant Payment Notification

    This is perfect to trigger your plugin to send an email or record the donor’s details (e.g. name, email) for later use.

    What do you think of this idea?

    Thanks again for the great plugin.

    1. Bob KingNovember 5, 2010

      BTW, I’ll donate again if you decide to implement the capability.

    2. johanNovember 17, 2010


      Thank you for the suggestion.
      IPN is actually something I have on my list of things I want to add to the plugin in a coming version.

      I’m a bit short on time at the moment because of involvement in some other projects, but as soon as I get some time to sit down with the next major update of the plugin IPN is high on the list.


  76. MattNovember 5, 2010


    Seeing a small problem that I cannot seem to resolve.

    The donate button does not appear in Firefox, but it shows in Chrome, IE and Safari.

    Firefox: Version 3.6.12
    Windows 7 All service packs applied

    Any ideas?


  77. BobDecember 4, 2010

    I installed your donate plugin on my localhost backup wordpress blog as a test. As per your instruction I used my paypal ID instead of my email , but when I click on donate my email address appears at the top. How do I change this to be either blank, a logo or something like yours.

    Thanks Bob

    Nice plugin once I figure how to set it up.

    1. JohanDecember 4, 2010


      To get rid of the email address from the PayPal checkout page, you can change your PayPal account type to business instead of personal, then the display of the email address will be replaced with your name.

      If you just want to cover up the address at the top with a logo, you can at your PayPal settings when you are logged in to your PayPal account, create a custom checkout page and add your own logo there to be used instead.


  78. GarryDecember 14, 2010

    Hi There… was wondering how to get the “payment option text” to get passed to paypal appended to the “reference”.
    This is so I know what option they chose when I process their payment in Paypal.

  79. HansDecember 21, 2010


    Thanks for the plugin.

    One problem: After pressing the “Spenden”-button on my German blog sometimes the symbols for credit cards or other payment-options besides Paypal do appear; and sometimes not (in this latter case only the option of Paypal appear, either opening new account or using an existing account). How can I make sure that the options for the other payment-options besides Paypal always appear?

    Best wishes, Hans

  80. Andrew ConstantinidisDecember 29, 2010

    On the customization page under “Country and Language” you include US-English and Canada-French, but not Canada-English. Does the location entered here carry over to Paypal? When I make a payment, Paypal defaults to the US as the country (even though I am registered with the Canadian Paypal, the country of the business is Canada and payment is Canadian dollars). If the Country is being carried over, could you add a Canada-English?


    1. JohanJanuary 7, 2011


      The location selected under Country and Language should not carry over to PayPal, the only thing affected by that setting is the language used on the PayPal button on your website. So I’ve added the different localized buttons PayPal had available. For Canada-English, PayPal displays the US English button, so that’s the one to use.


  81. adminFebruary 2, 2011

    I’m about to install paypal donation into my site.
    At this moment, I know very few about paypal needs and pp-plugins, but I do know I’m going to use yours.
    Looking at this comments page, you’ve one of the very best users service I’ve never seen for a freeware.

  82. EnnisPFebruary 6, 2011

    I downloaded and activated the plugin but I get no “settings” option. The only link is for editing which takes me to a page full of code which I wouldn’t try to manipulated without guidance.

    What must I do to get a “settings” option?

    1. JohanFebruary 7, 2011

      Could you post a screenshot somewhere or send to me, so I can see what you are experiencing?


      1. EnnisPFebruary 8, 2011

        I have a screen shot but have no idea how to get into a reply :(

        The plugin is listed in my plugins page in the admin panel but the only four clickable links are:

        Johan Steen
        Visit plugin site

        There is no link for settings.

        I did try deleting and reinstalling but that made no difference.

        If you send an email address or give me an idea where to post it I will do that.

        1. JohanFebruary 8, 2011

          Ah, okay, you don’t find the settings in the plugin admin panel. Go to WordPress Dashboard -> Settings Submenu -> PayPal Donations.


  83. WesFebruary 11, 2011

    So I installed using a full email address instead of my merchant account ID for PayPAl-not realizing the potential spam issues. Couldn’t get the thing to change when I redid the settings to reflect my number rather than email to identify my PayPal account. Deleted the whole plugin and started fresh with a “new” widget. Still the thing reflected the email addy rather than the numbers of my Merchant accounht ID…how can I get it to change?
    Thanks for the plugin – wish I hadn’t made this stupid mistake tho!!!

    1. JohanFebruary 12, 2011

      I guess you have a personal account, I believe PayPal requires you to change the account type to at least premier, to not display the email address on checkout.


  84. KlausFebruary 20, 2011

    Thanks for your great work. But it would be much better, if your plugin would support the possiblitiy to hide the email-address from everybody.

    Everybody can easily setup a button in his paypal account with only a code (like “ANCDRFPUR4EWQ”) and a hidden input filed called: “hosted_button_id”. Then you need only this code and nobody can see your email in your site.
    The button with all informations is hosted in your account. Check it out.
    That would be very useful and much more secure.

    Thanks in advance.


  85. JohanApril 2, 2011

    I have closed the comments as the page was growing too large.
    Use the support forum at for questions.

    Go to PayPal Donations Support Forum »

Trackbacks and Pingbacks

( Leave a Trackback )