| Plugin Name: WP-Donators(WP赞助商插件) Author: Eric Wang Stable Version: 1.1.1 Author URL: http://www.ericbess.com/ericblog/ Plugin URL: http://wordpress.org/extend/plugins/wp-donators/ Download:http://downloads.wordpress.org/plugin/wp-donators.zip |
== Description ==
Monetize your blog! A lot of features to monetize your blog! Including: Sponsors Box,Text Link ADs,My Target, etc. Supporting multi-Currency exchange. It’s will support most popular payment interface in future. ParPal Just the first one.
WORDPRESS赞助商插件WP-DONATORS。可以支持PAYPAL多币种捐赠、广告位售卖、个人目标赞助,并实现自动汇率换算。它有个后台与PAYPAL API实时沟通,返回付款数据,然后把捐赠人赞助商指定的广告与连接放在“捐赠人云广告位”中展示出来。
Multi-Currency Support and Exchange
U.S. Dollars,Australian Dollars,British Pounds,Canadian Dollars,Czech Koruna,Danish Kroner,Hong Kong Dollars,Hungarian Forint,
Japanese Yen,Mexican Peso,New Zealand Dollar’,Norwegian Kroner,Polish Zlotych,Singapore Dollars,Swedish Kronor,Swiss Franc,Chinese Yuan(RMB)
== Features ==
Sponsors Box: Sponsor donate and submit name/URL or TextLink ad. The information of the latest donors are displayed in the cloud. The more a person donations, the bigger their link will be.
Text Link ADs: After Sponsor buy the TextLink Advertising, s/he can leave a TextLink and description on the blog. The more a person payment, the longer their advertising will be.
My Target: It will show what your target is, how much it needs. What’s the progress so far, how much is outstanding. And if someone decide to sponsor money to support the Target, it will provide convenient means of payment.
== Depend On ==
- If your haven’t the paypal account so far.Please register paypal account:[PayPal Registration] first.

- PHP5, Openssl,fsock.
== Installation ==
1. Upload WP-Donators.zip to your Wordpress plugins directory, usually `wp-content/plugins/` and unzip the file. It will create a `wp-content/plugins/wp-donators/` directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Go to {wp-admin}->Sponsors set the default setting.
4. Go to the Widgets set the sidebar SponsorBox.
5. Edit the THEME, add the PHP function.
== Screenshots ==
- Sidebar(Global) SponsorBox: Left sidebar this page.
- PerPost/Page SponsorBox: under side this post.
- Sidebar(Global) TextLinkADs/My Target: Right sidebar this page.
- PerPost/Page TextLinkADs/My target: under side this post{This Page Text Link ADs}.
{Test the plugin :Try to make a small donation on the SponserBox, your name or inputer will been displayed in the sponsors cloud box immediately and automatically after donation.}

Option Setting Page
== HOW To Do ==
= Sponsors Box =
- Sidebar(Global) SponsorBox:Go to the Widgets set the sidebar SponsorBox or add the
"<?php if(function_exists('sidebar_sponsor_box')) { sidebar_sponsor_box(); } ?>"to `THEME->sidebar.php`. - PerPost/Page SponsorBox:Edit the `THEME->single.php/page.php` add the
"<?php if(function_exists('sponsor_box')) { sponsor_box(); }?>"to correct place, or embed shortcode
in post/page content.
Advanced Mode:Just display the simplye Donate Form/Sponsor Cloud, not any display style.
- Display Donate Form:
"<?php if(function_exists('donate_form')) { donate_form("Type",[size]); }?>" - Display Sponsor Cloud:
"<?php if(function_exists('show_sponsor')) { show_sponsor("Type"); }?>"
- `Type` “global” or “post” applications range. “globel” Play a role in the whole site; “post” Play in The current post.
- `size` The form input width size,default is “40″.
= Text Link Ads =
- Sidebar(Global) TextLinkADs: Edit the `THEME->sidebar.php`, add the
"<?php if(function_exists('sidebar_textads')) { sidebar_textads(); } ?>"to correct place. - PerPost/Page TextLinkADs: Edit the `THEME->single.php/page.php`, add the
"<?php if(function_exists('textads')) { textads(); }?>"to correct place, or embed shortcode
in post/page content. - Custom Fields in Post/Page:
- `textads_price`:(Text Link ADs price /unit for this page).
- `textads_unit`
The days of one unit).
=My Target=
- Sidebar(Global) My Target:Edit the `THEME->sidebar.php`, Add the “<?php if(function_exists(’sidebar_mytarget’)) { sidebar_mytarget(); }?>” to correct place.
- Per-Post/Page My Target:Edit the `THEME->single.php/page.php`, Add the “<?php if(function_exists(‘mytarget’)) { mytarget(); }?>” to correct place, or embed shortcode
in post/page content. - Custom Fields in Post/Page:
- `target_price`:(My Target price for this page).
- `target_initial_value`:(initial My Target paid amount ‘< target_price’ for this page)
== Frequently Asked Questions ==
How do I change the Original string text and tranlsate the plugin?
Open wp-donations.po file with poedit, create the wp-donators-{WPLANG}.mo file, you can define customization text or translate to your lang with poedit.
How to name wp-donators-{WPLANG}.mo what is {WPLANG} ?
config the wp-config.php->define (‘WPLANG’, ”);such as:
- wp-donators-en.mo -> define (‘WPLANG’, ‘en’); //custonization text
- wp-donators-zh_CN.mo -> define (‘WPLANG’, ‘zh_CN’); //S_chinese
How to ensure the authenticity of the payment transaction?
This plugin developed in strict accordance with the PAYPAL IPN.
After my payment, Why no my information/ad displayed on the blog, immediately?
WP-Doantors IPN RESPONSE PROCESS will wait the PAYPAL return a validation informaiton. PAYPAL delays some minutes to send the IPN informantin because of the server busy.
How do I customize the css style?
This plugin display style base on [Jquery UI], you can edit the css style on [UI THEME],download it, replace the css file.
== Release Notes ==
**1.0** : First internal release;
**1.0.7** : IPN response reinforcement, L10n support;
**1.0.8** : Support Multi-currency;
**1.1.0** : New jquery ui,css;add textlinkads feature;
**1.1.1**: Add new feature:My Target;
== Need Your Help ==
* Bugs Report
* Language package .mo .po
== This Page Text Link ADs ==

== Sponsor My Target (New Domain and Host service for this plugin) ==
I want to apply new independent Domain and Host service for this Plugin, it’s need 350$, could you support me.
Following is this targat progress bar, your can click the “Support my target” to make donate. Thanks!




(30 votes, average: 4.47 out of 5)

Eric, I’d like to report a little bug.
- The “Donate now” link at “The page SPONSORED by” tab, isn’t redirecting to the tab “Become SPONSOR now” when clicked. It seems that the code #sponsor_box is wrong.
- A little misspelling at the Help tab. The “ParPal” should be “PayPal” in the “ParPal Just the first one” text.
Cheers.
ReplyEric, I’ve tried your plug-in and by posting the [sponsorbox] into the article, it isn’t respecting my .mo file in Brazilian Portuguese. Just shows the English version. I’m missing some command or other? Any tip?
Thanks in advance.
ReplyHey Eric, great plug-in, thanks for sharing it!
I’m translating the .po to Brazilian Portuguese Language, and as soon as I get it done, I’ll send it to you by mail. Just let me know, what e-mail I can send the .po file to you.
Eric, just a suggestion to add in the back-end. There are the options to check to “Image Promotion” and “Text promotion”. Your plug-in would have an extra input field in the back end where we would add our PayPal affiliate ID and it would add it in the text link and image link to PayPal automatically without needing to edit PHP or other. ;0)
There are some misspellings at your po file such as “apprechiate” that should be “appreciate” at Google punishment line, and “Havn’t” that should be “haven’t” at CHINA ACCOUNT text line.
ReplyI want to be able to allow donations for individual members. I can put the form on each page, but how do I get it to hit the right member?
ReplyI love the idea of this plugin, however when a payment is accepted the TARGET never changes, nor do the ’sponsors’ names / links get passed to the page.
Thanks for pluginperfect.Regards
ReplyHi,
Great plugin, is exactly what our project is looking for!
The only problem is, as we are using WPMU to facilitate multiple blogs that donate to the same account – is it possible/how do I restrict access for my multiple sub-blog admins so that they cannot alter payment accounts etc? I’m housing one central blog and four subdomains off that…
ReplyHi, a sponsor donated but he made a mistake in spelling the link. How can I change it?
Thanks,
Reply88news.net
Hi, my affiliate donated but entered the wrong address. Where can I change the settings?????
ReplyHi,
I love the idea of this plugin, however when a payment is accepted the TARGET never changes, nor do the ’sponsors’ names/links get passed to the page.
Any suggestions?
WP2.8 & version 1.1.12
Replyhello, a super strong plugin I found here, I find great, thank you and greet
ReplyGreat to hear you are thinking about integrating paypal subscriptions!
Unfortunately I will not be able to use your plugin until I find a solution for this dreaded MooTools/jQuery problems… – looks like your plugin is one of those who cause a conflict with the “Featured Content Gallery” plugin, which is based on MooTools.
As soon as I activate your plugin, the slideshow on my front page is gone…
Not your fault, but unless there is a really good replacement for FCG I have to kick out any conflicting plugins…
All best!
ReplyMartin
Dear Eric (&) Bess
I have instaled Donators at two of my sites/blogs
hojelusofonia.com and multidesportos.com
Today I received a message from my email account stating as follows:
*********
Details:
[06/28/2009 1:55 PM] – FAIL: Hacking Attempt!
[From:ec2-67-202-54-191.compute-1.amazonaws.com|67.202.54.191]IPN POST Vars Received By Paypal_IPN Response API:
IPN Response from Paypal Server:
********
Could you please investigate this issue and revert some comments about??
Thank you for your help and support (and, of course, for your great plugin; I foresee to support you with some more bucks in the future, but firs I must receive some bucks too)
Carlos Pereira
Replygrupo.paralaxe@gmail.com
It’s normal, your plugin receive a error or fake transaction From:ec2-67-202-54-191.compute-1.amazonaws.com.
ReplyHi!
came here hunting for a suitable donations plugin for my mini non-profit organization.
Looks pretty cool what you have developed here!
Just one question: is it possible to offer donators the choice for a recurring donation via Paypal subscription? Or do you plan to integrate this feature?
this is the one and most crucial (because it creates much higher returns!) ability almost all donation plugins are missing…
Cheers, Martin
ReplyGood ideal, it will be inegrated in future.
ReplyHi there,
When I enable this plugin on the latest wordpress I get error:
Warning: Division by zero in /home/******/public_html/wp-content/plugins/wp-donators/sponsor.php on line 378
ReplyI have updated to wp 2.8. no found this issue.
ReplyCould you update the new verson and install again.
This rocks. You rock. Thank you for sharing and helping people out. I send you a virtual beer
ReplyHi, nice posts there
thank’s for the interesting information
ReplyGreat Idea you have.
ReplyHi Eric,
ReplyGood plugin. Could you add one possibility?
When sponsor pays and submit his name and link to his website, He also wants to submit Logo of his site. Add special field for uploading logo in any picture formats (jpg, gif, png, bmp), controling quantity and size of pics. Thanks
I apply this plugin on my blog using justintadlock themes. but the image was scratched. how to fix this ?
Here the screenshot
ReplyI keep getting this error [02/24/2009 4:30 PM] – FAIL: Your paypal validation engine expired. Please update on PayPal Class!
Reply[From:mail03.servicetoyou.info|205.209.142.109]IPN POST Vars Received By Paypal_IPN Response API:
IPN Response from Paypal Server:
Is this a hack attempt or do I have a problem?
update to version 1.0.15
ReplyHello Eric,i wanted to send you my new version, but i can’t find your email. So i put it on my webspace:http://www.parodyblog.net/wp-donators.zip This Version is optical fixed and you can use your own Design and Tabs or your green buttons
For Example:<?php if(function_exists(‘post_sponsor_box’)) { post_sponsor_box(“ui-tabs”); }?>ui-tabs is the class i want to use, so i put it in the Call and the Plugin will use it.And when i call it like befor, without the class, the plugin will use your green Tabs.Greetings,Mathias
ReplyI love the plugin and changed the look and some other things for my blog http://www.parodyblog.net
I will send the new version to you and hope you like it.
Greetings
ReplyI need to change the colors to blend with my site. Where do I find such to change them? THANKS
ReplyHi,How do I delete the paypal affiliate link in the the following text in the middle tab?” If your haven’t the paypal account so far.Please register paypal account:[PayPal Registration] first. ”Thanks!
ReplyHello, does anyone know how I can remove the Google adsense code in the “HELP” tab? Also, in the “Become Sponsor Now” tab, I’ve tried to change the affiliate link for Paypal and I cannot find it to change it to my affiliate link. Do you know how I can do that? The Paypal ID starts with BV4…
Replyfsockopen PayPal conection Error No. 127937072: Unable to find the socket transport “ssl” – did you forget to enable it when you configured PHP?
Replyyour Host not support the php socket or ssl.
ReplyMy colors are not coming up like yours – tried looking at the source, it is referencing styles that don’t appear to be in my flora.tabs.css and wp-donators.css.
ReplyI’m trying to change the green tabs to a color that matches my site… I cannot find the reference to these green tabs. Help please? The input areas seem to blend in and are hidden also, due to conflict with my site colors.
You can see the problem on my site, if you go to one of the single pages and look at the bottom under replies.
Thanks! Michael
suggest the Customization Mode in your sponsors tab, just like your {Recent Posts/Recent Comments/Popular Tags} tab.
Donate Form:
<?php if(function_exists('donate_form')) { donate_form("global"); }?>Sponsor Cloud:
<?php if(function_exists('show_sponsor')) { show_sponsor("global"); }?>Advanced Mode
<?php if(function_exists('donate_form')) { donate_form("Type",[size]); }?><?php if(function_exists('show_sponsor')) { show_sponsor("Type"); }?>
ReplyType“global” or “post” applications range. “globel” Play a role in the whole site; “post” Play in The current post.sizeThe form input width size,default is “40″.Hi Eric,
Replyi translated your plugin into german. I cant reach you by mail, so i will post the downloadlink for the de_DE.mo file here.
http://www.majeres.de/wp-donators-mit-deutschem-sprachfile
greetings Andreas
Hi Eric,
Replythanks for updating the plugin and adding the possibility to choose the currency.
However, i think you should make the list of possible currencies chooseable from it’s settings-page as it doesn’t make much sense for my site to have all of them available – Euros and USD are probably enough for me.
Also, the text-fields where one can input the TextAd and the URL are a bit too big, at least in Firefox.
Another thing i am going to offer my help is correcting the grammar and spelling mistakes – at least for the publicly viewable texts – if you want me to do that, drop me an email.
Keep up the good work!
ok now it work, i try to donate to myself, the problem was i use email other than main email account
Replyand it notice me like this “An instant payment notification was failed, the fail reson is Receiver Email Not MatchIPN POST Vars Received By WP-Donators Paypal_IPN Response API:”
i still recieve payment but it not show, who was donate, now i use my main email account and it work as well
and my IPN setting in my Paypal account still like this :
“ayPal’s Instant Payment Notification (IPN) allows you to integrate PayPal payments with your website back-end operations.
Instant Payment Notification (IPN)
Off
Instant Payment Notification (IPN) URL:
”
Replyhow could i set it to on ?
thank you very much, i suggest someone try to make donate to me but it’s got error
i got this error form admin email
Reply“An instant payment notification was failed, the fail reson is IPN Validation FailedIPN POST Vars Received By WP-Donators Paypal_IPN Response API:IPN Response From Paypal Server:HTTP/1.1 200 OKDate: Sat, 08 Nov 2008 02:22:33 GMTServer: Apache ”
what happen ? somebody try to donate to me and got error ?
and please help me how to fix them out
I was wondering if you could use this option inside a page and not with widgets? is there a code i can insert into my page instead?
ReplyAlso, the plugin seems to be missing a stylesheet file.. I got lots of 404’s in my webserver logs, trying to get the file “flora.css” whereas there is only a file named flora.tabs.css there….
ReplyMaybe you want to look into this
Hi,

Replythanks for the great plugin
Can you please provide instructions on how to set an other currency besides dollars?
I want it to display € euros everywhere where currently a $ is displayed and also want it to default to euros once somebody clicks on the link and gets redirected to Paypal – it’d be great if you could make that an option and / or provide me with instructions on how to change that myself.
Thanks!
on coding
ReplyHow do I change the button colors or more importantly the text in the button links?For some reason the text colors are not the same as what you have on your site and the Donation and Sponsored button text is very hard to read.
ReplyThanks
Bob
Good question,What you mentioned will been designed in next version configureation pages. now you can edit the css file for your display style.
Replyah it work now sorry for lasy comment, i forgot to enter paypal account, thank so much
Replystill got some problem i use my paypal premier account but still got this
We cannot process this transaction because there is a problem with the PayPal email address supplied by the seller. Please contact the seller to resolve the problem. If this payment is for an eBay listing, you can contact the seller via the “Ask Seller a Question” link on the listing page. When you have the correct email address, payment can be made at http://www.paypal.com.
Replyplease help
Great it idea thank
Replywhen i try to active IPN it ask me to enter Notification URL and i don’t know what i should enter and where could it find it.
please help
Sorry there is a mistake on the instruction, It don’t need set the IPN on your paypal account . because the plugin will auto return a ipn session to paypal IPN getway to make the prcess.
Replywhat is Notification URL in paypal ?
ReplyInstant Payment Notification integrates PayPal payment notification and authentication with your website’s back-end operations. Check this box to activate Instant Payment Notification, and enter the URL at which you will receive the payment notifications below.
i go to active IPN and it ask me for Notification URL and how i enter it
Sorry there is a mistake on the instruction, It don’t need set the IPN on your paypal account . because the plugin will auto return a ipn session to paypal IPN getway to make the prcess!
Replyhi. Thanks for pluginperfect.Regards
ReplyHi,I already downloaded and installed your plugin into my blog,but I can’t access the option area.It said only an User have level higher than 10 can access the option.I’m already the admin of the site,may I know how to solve this?
ReplyPlease update the plugin,new version will give you user level when you can’t access option page. if you couldn’t access yet, please give me your user level.
ReplySame challenge here. I’m the only user and admin and it says I’m not level 10 so I can’t configure the program. Looks good if we can get it working! Thanks
Replysame problem. I am an admin and it says my user level is 0!
Replywhat’s your WP version
Reply“You are LEVEL 0 USER, not a LEVEL 10 USER & hence you cannot configure WP-DONATORS. If you are a LEVEL 10 or above USER, then please Logout & Login again.”
Replysame problem, I am the admin … Using WP 2.6.2, Plugin Version 1.0.4
Thanks for your help
I change my code for you, download the newest version, and test again, thanks!
Reply