=== Plugin Name ===
Contributors: Anton Smirnov
Tags: xmpp, jabber, library
Requires at least: 3.0
Tested up to: 3.0
Stable tag: 0.3.0

XMPP Enabled provides a single-function API for other plugins that use Jabber/XMPP messaging protocol.

== Description ==

XMPP Enabled provides a single function API for other plugins that use Jabber/XMPP messaging protocol.
See API section for details if you want to use XMPP protocol in your notifications.

== Installation ==

1. Upload `xmpp-enabled` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Set up default Jabber account in XMPP Enabled Settings page

== Frequently Asked Questions ==

= Why the distinct plugin? =

To provide a single XMPP account settings page for all Jabber notification plugins

= Can it send messages to multiple contacts? =

It's safe to use xmpp_send() multiple times. However in PHP older than 5.0 it will cause multiple connections to the XMPP server.

== Changelog ==

= 0.3.0 =
* Multiple calls to xmpp_send() now use single connection in PHP 5.0 and newer
* Now user can disable encryption
* Fixed menu creation priority

= 0.2.2 =
* Fixed wrong behaviour for custom hostnames.
* Improved logging

= 0.2.1 =
* A small usability change.

= 0.2.0 =
* A first public beta.

== Upgrade Notice ==

= 0.2.2 =
Update is strongly recommended for those who manually set server hostname

= 0.2.1 =
There's no real need to upgrade since 0.2.0. Just some cosmetic changes

== Plugin API ==

= The Single Function =

The single function for sending XMPP Messages is `xmpp_enabled`. It can be called directly from any WordPress plugin

`xmpp_enabled($recipient, $message, $subject='', $type='normal');`

* $recipient is a valid (bare or full) JID of the recipient like 'juliet@capulet.net'
* $message is a plain text message to be sent
* $subject is a title line for message. It is usually omitted for chat-type messages
* $type is a type of message. It can be 'chat', 'normal' or 'headline'. See [RFC 3921](http://www.ietf.org/rfc/rfc3921.txt) for details

*Example:* `xmpp_send('subscriber@something.com',"Read our new post:\nhttp://something.com/new-post",'New post is published','headline');`

= Create submenu in the XMPP Enabled section =

XMPP Enabled creates it's own section and you're free to use it for your plugins. The code is `'xmpp-enabled'`

*Example:* `add_submenu_page('xmpp-enabled', 'Jabber Comment Notifications', 'Comment Notifications', 'administrator', __FILE__, 'jcommnotify_settings');`

See [Adding Administration Menus](http://codex.wordpress.org/Adding_Administration_Menus) in WordPress Codex for further details