XMPP Enabled is a simple library plugin that provides a single-function interface for other plugins to send Jabber messages https://wordpress.org/plugins/xmpp-enabled/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
Anton Smirnov 1b7ae1e861 Remove from packagist 1 year ago
XMPPHP fixed XMPPHP for PHP7 1 year ago
bin Generate Markdown readme from WordPress readme 1 year ago
languages * composer 6 years ago
.gitignore Add some packages to ease development 1 year ago
LICENSE.md Explicit license file 1 year ago
README.md Remove from packagist 1 year ago
composer.json Add some packages to ease development 1 year ago
readme.txt Remove from packagist 1 year ago
todo.txt * composer 6 years ago
xmpp-enabled.php bump version as bugfix release 5 years ago

README.md

XMPP Enabled

Contributors: sandfox
Tags: xmpp, jabber, library
Requires at least: 3.0
Tested up to: 4.9
Stable tag: trunk

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
  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

Can it send messages to multiple contacts?

It’s safe to use xmpp_send() multiple times. All calls will use the same connection

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

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

0.3

Multiple calls to xmpp_send() now behave smarter

0.2.2

Update is strongly recommended for those who manually set server hostname

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 ‘[email protected]
  • $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('[email protected]',"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 in WordPress Codex for further details