This is our first free plugin release to the WordPress community: Super Refer a Friend. It’s a plugin which adds a new widget to your blog which allows readers to email the page they are on to a friend via a popup box. They can enter more than one email address and customise the message that is sent.
You can see an example of it in action on this blog, in the sidebar where it says “Send this Page to a Friend”.
You can download the plugin from WordPress.org
Installation Instructions
- Download the plugin
- Upload via ftp to domain.com/wp-content/plugins
- Or upload via WordPress admin Plugins >Add New > Upload
- Activate the plugin
- Visit Appearance > Widgets and you will see the “Super Refer a Friend” Widget, drag this to the desired location in your theme.
Configuration
Once the plugin is installed and the widget placed, you will see this configuration screen :

- Title: This is the title of the Widget
- Captcha Char Num: The amount of characters in the Captcha
- Max Friend Emails: How many email addresses can be sent at once
- Message Body: The actual message that is sent by the plugin
- Max Message Size: How many characters can be sent in the Message body
- Max Time to send another Email: How often someone can send a message using the plugin (to prevent spam)
- Attribution link: Includes a link back to WPLift (optional)
Customization
You can customize the CSS used to display the widget, the main CSS file is located in:
super-refer-a-friend/css/sraf.css


30 Comments
thanks your great article
Hi,
I’ve just placed this plugin on my wordpress website (www.buyingahousemadesimple.com.au). I’m testing it at the moment but I receive an error saying ‘Cannot send email. Security code did not match’ but the security code does match.
I’m testing this with WP 3.0.1 and Firefox browser 3.6.13.
I tried setting the captcha to 0 but that’s not allowed and I can’t see a way of turning it off.
I checked the requirements and it simply says WP 2.5 or higher and compatible up to 3.0.3.
I’ll remove it from my site until I receive an answer.
Any ideas what’s wrong with my set up?
Thanks,
Karen
It’s possible another plugin is clashing with ours, try deactivating all other plugins and see if Super refer a Friend works then.
Hi Oli
I tried to deactive all plugins and still the Captcha doesn’t display captcha image/code but only the captcha field. Could you please help. Cheers,
Hi Mali,
I have exactly the same problem where it tells me that the Captcha doesn’t match the one entered but it does.
Have you received any feedback yet ?
Hi again Oli
I tried to install and load Super Refer a friend plugin on the new installation and all works perfect but I’m getting error on my existing site: http://www.elginlearning.org.za/wp-content/plugins/super-refer-a-friend/sraf-captcha.php?width=200&height=30&characters=10&rand=768583.
As mentioned above I tried to dectivate all plugin and I’m not quite sure what I might doing wrong, or is possible to remove the captcha section on the form?
Thanking you in advance.
Cheers,
Mali
I use this on http://www.tomsshop.com and just wanted to say thank you very much for a great plugin and support! You all rock!
No probs, nice site Tom :)
This is a very nice plugin, but I am unable to use it on my website as I have a number of YouTube videos on my site which seem to take preference to your plugin. When the input screen loads, it loads behind the YouTube video.
Yes, thats a feature of Flash Im afraid – html cant overlay on the top of it.
I’m having the same problem as Buyingahousemade simple. It installs fine, but doesn’t show the captcha box so can’t complete the submission. I deactivated other plugins and it didn’t make any difference.
Hi Lisa
Did finally manage to see the captcha for Super Refer a friend form?
I’m also struggling with that.
Cheers,
Mali
This is exactly what I’m looking for, except that I’d like it to display inline on the page, rather than as a popup. Even better is if I could just paste in the php code in the page itself, rather than have it over in the sidebar. Possible?
Hi DeAnna
Did you perhaps get any response re adding the plugin with theme page or header?
No DeAnna
I manage to solve the issue above, but now I’m struggling with showing the plugin form captcha.
Thanking you in advance.
Cheers,
Mali
Hi,
I have installed plugin but why i am not getting link in to post loop.
Please reply.
This is really nice plugin for widgets. But how can i do in php code.
Please reply.
Nice simple plugin, thank you. Two questions:
1. Is there a way to change the subject line in the email that the recipient receives?
2. Is it possible to change the link in the subject of the email so that it automatically puts in just the home page of the site you’re recommending i.e http://www.homepage.com ?
Thanks.
I am using a theme that has narrow columns. Is there a simple way to either
a) move the friend’s email to a second line
or
b) limit the space between the label and input field in the widget
example:
http://www.theleftlane.com/ad/help-me/
anyone?
One more question, my theme has multiple widget areas, some for posts, some for front page. Currently this widget can only be used once. Please advise how to use it in more than one area?
@Mali -same problem – Captcha does not show up in the popup box. Pity this plugin doesn’t work properly, as it’s simple and otherwise does everything that’s needed.
To fix the captcha issue, I modified line 6 of sraf-captcha.php to read “var $font = ‘./monofont.ttf’;” – by adding the ./ ahead of the font name it just tells the script to look in the same directory for the font. For some reason PHP doesn’t know to do that by default.
Thanks Chris, I’ll get that added to the plugin and update it :)
FWIW, I’m also noticing problems with sending emails out. It’s unpredictable and I can’t seem to peg down what’s going on. I’m working on this site: http://www.amandasachse.com/
Obviously I’ve made a few modifications, and that could be the issue, but it seems that the plugin just does not want to send emails out to a few of my accounts. It spits an error, then directs me to the form processing file, which says it was successful (even though the emails don’t go out). I’m baffled.
Any ideas?
Also out of curiosity (and maybe it’s tied in to my other problem?) why create a table to store IPs but then not actually store IPs in it? I have a table full of IDs and dates, presumably tracking when the form was submitted, but none of the IPs are in there.
another freebie… great job:)
I’m planning to offer current subscribers some sort of a reward, if they refer new subscribers to my website.
Is there a way with this plugin, which would tell me where the new subscribers came from (who referred them)?
Thanks, a nice WP-Plugin …
Leave a Reply