Editing Eng:J2J

{{EnglishVersion|J2J}}'''<big>Transport J2J</big>'''

With this transport you can aggregate contacts from rosters of two (or more) Jabber accounts in single roster. E.g., you can communicate through your GTalk or LiveJournal account, using main account on Jabber.org. For your interlocutors it will be seen as you logged in on this three-accounts manually. Though actually Gtalk and LiveJournal will be connected through J2J transport.

== Features ==
* [[:w:en:Gtalk|Gtalk]] support;
* [[:w:en:LiveJournal|LiveJournal]] support;
* [[:w:en:Secure_Sockets_Layer|SSL]] is not supported; <!-- feature? -->
* [[:w:en:Transport_Layer_Security|StartTLS]] support.

== Usage ==

[[image:X2x-register.gif|frame|J2J registration form]]

To make explanations smplier we'll introduce two main concepts: ''master Account'' and ''guest account''. ''Master account'' is that which will be register this transport, ''guest account'' is that which will be used through J2J.

In the Username field you must enter username of guest account. Password is a password for guest account. In the Server field you must enter just a hostname of your guest Jabber server.

Value of Port field doesn't follow for change. It must be used when Jabber server uses non-standard port.
Because SSL doesn't supported, value 5223 is invalid.

You will receive a subscription request after registration, you must accept it and wait for connection with guest account. When connection is established, J2J will be online.

There are protection from ring registrations on transport, however, it isn't recommended to create such connections.

== Using with Google Talk ==

Just enter your JID. Your Gtalk account will be recognized automatically, and the additional functions will be accessible:

Discover j2j -> Register -> fill form:
* username: gmailuser
* password: pass
* sever: gmail.com
* domain or ip: <nothing>
* port: 5222
... registration successful.
... may j2j.... see your presence? y/n
... j2j... allows you to see its presence.

There will appear an extra option '''Light first mail-notify''' in transport options (they could be aceessed via ad-hoc commands). Setting this option on makes the first new mail notification message consistent of number of them only.

== Using with Facebook ==
From Febrary 2010, facebook let you use any xmpp client to use their chat system[http://www.facebook.com/sitetour/chat.php]. You need to edit your facebook account and click in settings and after that in username, you can choose a convenient and clean alias (without blanks and such) [https://register.facebook.com/editaccount.php?settings&alias].

Discover j2j -> Register -> fill form:
* username: username_you_have_just_set
* password: pass
* sever: chat.facebook.com
* domain or ip: <nothing>
* port: 5222
... registration successful.

... may j2j see your presence? y/n

... j2j allows you to see its presence.

Test it, it seems to work to some degree.

== Import your contacts from guest-account ==
If you want to import your contacts from guest-account's roster to your master-account's roster, you can open Discovery-dialog of your Jabber-client, enter JID of your J2J-transport, and add contacts from the "Guest Roster" item. You can use grag and drop technology or context-menu. (drag and drop available in Tkabber и JAJC).

==JID Escaping==
Because, node of JID cannot include "@" char, it needed to use JID-Escaping: all "@" chars is replacing to "%" and "%" replacing to "\%". For example, <tt>vasya%jabber.ru@xmpp.tushinec.ru</tt>.

If you want to add contact through your guest-account, you must use such format.

Some clients (Tkabber, JAJC) supports addition contacts through transports transparently. In this case, just select transport and enter JID in simple format <user@server>.

==Additional possibilities==
===Auto-answer service===
At requests of users, auto-answer service is implemented in J2J. Use this for inform your contacts about your new JID or something else.

You need use Jabber-client with ad-hoc commands support, for example, Bombus, JAJC, Tkabber, Gajim, Psi or Coccinella. Execute a Options command, check "Enable auto reply for all guest contacts" checkbox and enter text for auto-answer in text area "Text for auto reply". It limited to 1000 chars.

Additional checkbox "Always forward messages to me" means, that messages will be forwarded with enabled auto-answer service too.

===Receive message only from Guest roster===
You can deny messages from users not from guest-account's roster checking checkbox "Receive messages only from Guest roster".

==Where it's used==
For a moment, J2J is in use at this servers:
* ''jrudevels.org''
* ''udaff.com''
* ''jabbus.org''
* ''jabbe.net.ru''
* ''jabster.pl''
* ''chrome.pl''
* ''im.flosoft.biz''
* ''jabber.hot-chilli.net''
* ''draugr.de''
* ''jabber.apinc.org''

* [[jworld:Список публичных транспортов J2J|List of public and private J2J instances]] (in russian)

==For Jabber-servers admins==
[[Eng:J2J:AdminGuide|J2J Installation and operation guide]]


[[Category:Gateway]]