=== Plugin Name ===
Contributors: gvilabs
Donate link: http://www.grapevinedirect.co.za/
Tags: sms, text, smsing, texting
Requires at least: 2.x
Tested up to: 3.1
Stable tag: trunk

SMS-enable Wordpress. Makes a function available to allow sending of sms/text messages from within the code. Requires registration and payment.

== Description ==

This plugin makes a function available to allow Wordpress developers to send an sms/text message to whichever phone
number they want.

Usage of this plugin requires signing up and registering for a paid-for account with [Grapevine Interactive](http://www.grapevinedirect.co.za/).

This is a service plugin only, it does not do anything by itself, it just makes the smsing/texting functionality available
for developers to call at appropriate times.

== Installation ==

1. Sign up for a test account with Grapevine Interactive at [www.grapevinedirect.co.za](http://www.grapevinedirect.co.za/)
2. Upload `za.co.vine.wordpress.sms.php` to your `/wp-content/plugins` folder
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Enter the account details you would have received after signing up, on the Settings->Grapevine SMS page
	* Affiliate Code
	* Authentication Code
	* Post URL

== Frequently Asked Questions ==

= What does this plugin actually do? =

It makes a function called `za_co_vine_sms_sendSms` available to the whole of Wordpress, to allow plugin and theme developers
to use to send sms/text messages to whichever phone number they want.

= What is the cost? =

Usage of this plugin requires the user to sign up for an account with Grapevine Interactive, on either a pre- or post-paid
system.  Costs can be discussed with your sales person.

== Screenshots ==

Screenshot example of using this plugin to notify a number that a page was viewed:
[Usage example](http://skitch.com/aubrey/n4ffa/footer.php)


== Changelog ==

= 0.2 =
* Tested with Wordpress 3.1
* Wrapped message content in XML with CDATA to prevent XML errors

= 0.1 =
* Initial release
* Adds SMSApplink support to Wordpress

== Upgrade Notice ==

= 0.2 =
No extra information required.

= 0.1 =
No extra information required.

== Usage in code ==

As an example, use the following code wherever you want an sms/text message to be sent:

`<?php if (function_exists("za_co_vine_sms_sendSms")) {
        za_co_vine_sms_sendSms("0821234567","message content here");
} ?>`

Try to use this code close to the end of the Wordpress Loop execution, as the function will block while doing the HTTP post.