Building

Pre-requisite: Use Maven 2.2.1

1. Install maven-openfire-plugin from https://github.com/srt/maven-openfire-plugin
2. Obtain a copy of openfire.jar and install it into maven. There are serveral ways you can do it, here are two of them:

• Option 1. Download source code of the version of openfire you need at http://www.igniterealtime.org/downloads/source.jsp

  Then set $OPENFIRE_PATH and $OPENFIRE_VERSION environment variables according to source code path and version and run:

  cd $OPENFIRE_PATH/build
  ant
  mvn install:install-file -DgroupId=org.igniterealtime.openfire -DartifactId=openfire -Dversion=$OPENFIRE_VERSION -Dpackaging=jar -DgeneratePom=true -Dfile=$OPENFIRE_PATH/target/openfire/lib/openfire.jar

• Option 2. If you installed openfire using openfire*.deb package on ubuntu, you can find openfire.jar inside /usr/share/openfire/lib:

  Because this directory is read protected from regular users, you would first have to copy it to somewhere in your home directory and change it's read permissions using sudo, e.g by running:

  sudo cp /usr/share/openfire/lib/openfire.jar .
  sudo chmod a+r openfire.jar

  Now you can install it into maven by running:

  mvn install:install-file -DgroupId=org.igniterealtime.openfire -DartifactId=openfire -Dversion=$OPENFIRE_VERSION -Dpackaging=jar -DgeneratePom=true -Dfile=openfire.jar

3. Inside openfire-apns-plugin directory run: mvn clean install
4. If the build was successfull openfire-apns.jar should appear in target directory.

To use the plugin

Register device token

Send this IQ to XMPP server.

<iq type="set" to="OPENFIRE_SERVER" id="apns68057d6a">
	<query xmlns="urn:xmpp:apns">
	   <token>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</token>
	</query>
</iq>

Return value

<iq type="result" id="OPENFIRE_SERVER" from="210.205.58.23" to="user@OPENFIRE_SERVER/68057d6a">
	<query xmlns="urn:xmpp:apns">
	   <token>XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</token>
	</query>
</iq>

Known Issues

• Current the plugin only supports MySQL database.
• Push notifications with message "null" are sent along with notifications for actual messages.

Acknowledgements

XMPP2APNS