Difference between revisions of "XMPP URIs"

From XMPP WIKI
Jump to navigation Jump to search
(Added how-to for MediaWiki)
(6 intermediate revisions by the same user not shown)
Line 3: Line 3:
= Formal Definition =
= Formal Definition =


For those interested in a formal definition of XMPP URIs, read RFC 4622 and [http://www.jabber.org/jeps/jep-0147.html JEP-0147].
For those interested in a formal definition of XMPP URIs, read RFC 4622, [http://www.jabber.org/jeps/jep-0147.html JEP-0147] and the [http://www.xmpp.org/registrar/querytypes.html querytypes registry].


= Web browsers =
= Web browsers =
Line 56: Line 56:
== jabber.el ==
== jabber.el ==


The CVS version of [http://emacs-jabber.sf.net jabber.el] supports XMPP URIs as of 2006-06-22.  How to set it up is described in the documentation.
[http://emacs-jabber.sf.net jabber.el] supports XMPP URIs from version 0.7.1.  How to set it up is described in the documentation.


== Gajim ==
== Gajim ==


Using Firefox, set the string for network.protocol-handler.app.xmpp to 'gajim-remote open_chat' in about:config. For Opera add 'xmpp=0,0,gajim-remote open_chat' under [Trusted Protocols] (I had to add Trusted Protocols at the bottom) in opera6.ini.
Using Firefox, set the string for network.protocol-handler.app.xmpp to 'gajim-remote handle_uri' in about:config. For Opera add 'xmpp=0,0,gajim-remote handle_uri' under [Trusted Protocols] (I had to add Trusted Protocols at the bottom) in opera6.ini.
 
== Coccinella ==
 
[http://Coccinella.im/ Coccinella] supports many of them but not all, see coccinella/components/ParseURI.tcl
And the Mac desktop bindings may be flaky.
 
== Miranda IM==
 
[http://miranda-im.org/ Miranda IM] supports handling of XMMP URIs since version 0.7.1.2 of jabber plugin. Implementation requires File Association Manager plugin which can be found at http://addons.miranda-im.
 
= MediaWiki =
 
If you run a MediaWiki you may also want it to support xmpp: URIs, which it doesn't by default. Thankfully the fix is easy. In your LocalSettings.php file, add the line:
 
$wgUrlProtocols[] = "xmpp:";
 
That's all you technically need to do. It can also make things prettier though if you add the Jabber icon next to all such links. To do this, locate the .css file for the skin you are using (e.g. skins/monobook/main.css) and append the following code:
 
#bodyContent a[href ^="xmpp:"],
.link-xmpp {
        background: url(xmpp_icon.gif) center right no-repeat;
        padding-right: 10px;
}
 
and in the same folder as the CSS file, download and place [http://wiki.jabber.org/skins/jabberorg/xmpp_icon.gif this icon file].

Revision as of 00:38, 17 August 2008

An XMPP URI is a Uniform Resource Identifier that makes a Jabber ID "clickable" in web browsers and such. Unfortunately, support for XMPP URIs is not (yet!) common in popular software applications, so you need to set it up manually. This page describes how...

Formal Definition

For those interested in a formal definition of XMPP URIs, read RFC 4622, JEP-0147 and the querytypes registry.

Web browsers

Firefox

To XMPP URIs clickable in the Firefox web browser, do this:

  1. Type "about:config" in the url bar
  2. Right-click and select New->String
  3. Enter "network.protocol-handler.app.xmpp" as the preference name
  4. Enter the application to run

Opera

To make XMPP URIs clickable in the Opera web browser, do this:

  1. Open your opera6.ini file
  2. find (or except add) "Trusted Protocols" section
  3. add "xmpp=0,0,<application to run>" to the "Trusted Protocols" section
  4. Note: on older versions it's "xmpp=<application to run>"

Operating systems

Linux

To follow.

Mac OS X

Install the XMPP-IRI helper application linked to from here.

Adium registered itself as a handler for XMPP URIs, "Just Works" with Camino.

Windows

Paste the following in Notepad and save to a file with an ".reg" extension. Then double-click on it and answer yes to the prompt to import the settings into your registry. Be sure to enter the path to your XMPP-URI capable Jabber client. See the Registering an Application to a URL Protocol article in MSDN for more details.

Windows Registry Editor Version 5.00
[HKEY_CLASSES_ROOT\xmpp]
@="URL:XMPP Protocol"
"EditFlags"=dword:00000002
"URL Protocol"=""
[HKEY_CLASSES_ROOT\xmpp\shell]
[HKEY_CLASSES_ROOT\xmpp\shell\open]
[HKEY_CLASSES_ROOT\xmpp\shell\open\command]
@="<application to execute> %l"

Jabber Clients

List clients supporting XMPP URIs here.

jabber.el

jabber.el supports XMPP URIs from version 0.7.1. How to set it up is described in the documentation.

Gajim

Using Firefox, set the string for network.protocol-handler.app.xmpp to 'gajim-remote handle_uri' in about:config. For Opera add 'xmpp=0,0,gajim-remote handle_uri' under [Trusted Protocols] (I had to add Trusted Protocols at the bottom) in opera6.ini.

Coccinella

Coccinella supports many of them but not all, see coccinella/components/ParseURI.tcl And the Mac desktop bindings may be flaky.

Miranda IM

Miranda IM supports handling of XMMP URIs since version 0.7.1.2 of jabber plugin. Implementation requires File Association Manager plugin which can be found at http://addons.miranda-im.

MediaWiki

If you run a MediaWiki you may also want it to support xmpp: URIs, which it doesn't by default. Thankfully the fix is easy. In your LocalSettings.php file, add the line:

$wgUrlProtocols[] = "xmpp:";

That's all you technically need to do. It can also make things prettier though if you add the Jabber icon next to all such links. To do this, locate the .css file for the skin you are using (e.g. skins/monobook/main.css) and append the following code:

#bodyContent a[href ^="xmpp:"],
.link-xmpp {
        background: url(xmpp_icon.gif) center right no-repeat;
        padding-right: 10px;
}

and in the same folder as the CSS file, download and place this icon file.