Created: 30/01/2013
By: Benoit Mercusot
Email: benoit@mbcreation.net
Thank you for purchasing WooCommerce Sponsor a Friend Plugin. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much! Online documentation and demo : http://wsafp.mbcreation.net/
WooCommerce Sponsor a Friend is a great marketing plugin that allow your customers to become your ambassadors.
Once the plugin is set up it gives the opportunity to your customers to sponsor (or refer) friends by filling a simple form with their friends data (First Name, Last Name, Email address) and an optionnal message. If the form is okay (email must not already be in your active customers database), it will send an email containing a unique Coupon for that person. You decide the coupon type, the amount and the duration of that coupon.
Then, if the person uses the coupon to buy stuff on your website, the process goes on and the sponsor will receive a “Reward Coupon”by email. The Reward Coupon is automatically created at “the order completed” event. Since 2.0 the reward coupon settings are independant and can be different. You can also choose to allow sponsors to keep their coupon and accumulate reward on it everytime they refer a friend.
Both email uses native woocommerce email header and footer and you can off course customize the inner content. See “aliases” section bellow.
WooCommerce Sponsor a Friend is translation ready with .po and .mo files.
Including french (fr_FR) and almost english (en_US) translations (the one used on that demo site)
If you are upgrading from a previous installation. Replace your folder with the files. Deactivate then reactivate the plugin to populate the new available options in the database. Previous settings won't be deleted.
At start there's a form in a page.
Then a request. (that can contain errors)
Or not
At this stage of the process, an email has been sent and a coupon created
Everything in the email can be modified.
So now the coupon can be used in checkout
To perform an order
The coupon has been used. Great news !
If everything is okay with the order. You complete it so a new coupon is created.
A special "Reward Coupon" to the sponsor that helped you gaining a new customer !
And here is the final step
{{placeholder}} will be replaced with actual data when sending emails.
Available aliases for email subjects & for email headings :
{{sponsor}} => name and first name of the sponsor
{{sitename}} => your sitename
Available aliases for email content :
{{sponsor}} => “User Billing Firstname User Billing LastName” (ie John Doe).
{{coupon}} => The coupon code (ie 15221313fdf).
{{amount}} => The amount of the coupon parsed by woocommerce_price() function.
{{sitename}} => bloginfo() (ie My Great Site).
{{message}} => The message left by the sponsor for his/her friend.
{{homeurl}} => Hyperlink to your home page with sitename as anchor (aka home_url())
{{email}} => The email used in form and used as the recipient. Match the coupon code (customer email)
{{validity}} => A well formated expiry date for coupon
Available aliases for email subjects :
{{friend}} => name and first name of the friend
{{sitename}} => your sitename
Available aliases for email headings :
{{friend}} => name and first name of the friend
{{sitename}} => your sitename
Available aliases for email content :
{{sponsor}} => Name and First name of the sponsor
{{friend}} => Name and first name of the friend
{{coupon}} => Coupon code
{{amount}} => Amount of the coupon code parsed by woocommerce_price()
{{sitename}} => Name of your site
{{homeurl}} => Hyperlink to your home page with sitename as anchor (aka home_url())
{{email}} => The email of the sponsor. Match the coupon code (customer email)
{{validity}} => A well formated expiry date for coupon
{{sponsor}} thinks you should be shopping with {{sitename}} !
Message from {{sponsor}} :
{{message}}
As welcome gift, here’s a {{amount}} voucher you can use to discover our great products.
Personnel gift code : {{coupon}}
Email address associated with it *: {{email}}
See you soon on {{homeurl}} !
* You will need to use this email as the billing email address on checkout.
Hi {{sponsor}},
{{friend}} just ordered on our site thanks to you !
As reward gift, here’s a {{amount}} voucher you can use to order great new products.
Personnel gift code : {{coupon}}
Email address associated with it *: {{email}}
See you soon on {{homeurl}} !
* You will need to use this email as the billing email address on checkout.
We spent a lot of time adding a lot of extra filters and action in the latest release of the plugin.
You should be able with them to change almost every message or variable used by the plugin to make the tool fits your exact needs. Just look in code and find the perfect spot the hook correcty.
Benoit Mercusot