sandfox-im/xmpp-enabled

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

XMPP Enabled

Contributors: sandfox
Tags: xmpp, jabber, library
Requires at least: 3.0
Tested up to: 4.9
Stable tag: trunk, _(*1)

XMPP Enabled provides a single-function API for other plugins that use Jabber/XMPP messaging protocol., _(*2)

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., _(*3)

• GitHub page: https://github.com/sandfoxme/xmpp-enabled

Installation

1. Upload xmpp-enabled folder to the /wp-content/plugins/ directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. 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, _(*4)

Can it send messages to multiple contacts?

It's safe to use xmpp_send() multiple times. All calls will use the same connection, _(*5)

Thanks to

• Mako N (Japanese translation and i18n support)

Changelog

1.0.2

• PHP 7 support
• Removed from packagist.org (You can use GitHub link in composer directly)

1.0.1

• [Bug] Password validation fix

1.0.0

• Japanese translation and internationalisation support from Mako N
• Russian translation
• Remove unnecessary part of XMPPHP
• Lang builder
• Consider plugin is stable :)
• Installation via composer

0.3.2.2

sand-fox.com to sandfox.org, _(*6)

0.3.2.1

• minor bugfixes

0.3.2

• Fixed array serialization in logs
• PHP5 is now required minimum

0.3.1

• Bugfix for disabling encryption

0.3.0

• Multiple calls to xmpp_send() now use single connection
• 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.3.2

Breaks old logs, _(*7)

0.3

Multiple calls to xmpp_send() now behave smarter, _(*8)

0.2.2

Update is strongly recommended for those who manually set server hostname, _(*9)

Plugin API

The Single Function

The single function for sending XMPP Messages is xmpp_enabled. It can be called directly from any WordPress plugin, _(*10)

xmpp_enabled($recipient, $message, $subject='', $type='normal');, _(*11)

• $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 for details

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

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', _(*13)

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

See Adding Administration Menus in WordPress Codex for further details, _(*15)