Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
Last revisionBoth sides next revision
docs:chats [2020-11-12 15:59] – Tobiasdocs:chats [2022-06-25 06:58] – [IRC-Chat Addon] Tobias
Line 1: Line 1:
 ====== Chats ====== ====== Chats ======
- 
-* [Home](help) 
  
 There are two possibilities to use chat on your friendica site There are two possibilities to use chat on your friendica site
  
   * IRC Chat   * IRC Chat
-  * XMPP / Jabber+  * XMPP/Jabber
  
 ===== IRC-Chat Addon ===== ===== IRC-Chat Addon =====
  
-  * **Addon**: irc +After activating the addon, you can find the chat at ''example.com/irc'' (if your Friendica nodes domain name is ''example.com''). Note: you can use this chat without any login at your site so that everyone could use it.
- +
-This addon is used to provide a web chat interface on your Friendica node to the IRC server [[https://freenode.net/|freenode.net]]. After activating the addon, you can find the chat at [[/irc|example.com/irc]]. Note: you can use this chat without any login at your site so that everyone could use it. +
- +
-If you follow the link, you will see the login page of the IRC chat. Now choose a nickname and a chatroom. You can choose any name you like for the room, even something like //superchatwhosenameisonlyknownbyme//. Finally, solve the captchas and click the connect button. +
- +
-The following window shows some text while connecting. This text isn't important, just wait for the next window. The first line shows your name and your current IP address. The right part of the window shows all users. The lower part of the window contains an input field. +
- +
-===== XMPP / Jabber ===== +
- +
-==== XMPP Server authentificate against Friendica ==== +
- +
-=== ejabberd === +
- +
- -> see [[install-ejabberd|Install ejabberd]] +
- +
-=== Prosody === +
- +
-If you want to use your Friendica installation for authentication with the [[https://prosody.im/|prosody]] XMPP server, you have to do the following. +
- +
-  - Enable the ''auth_http_async'' module of prosody +
-  - Adopt the configuration file (''prosody.cfg.lua'') of your prosody server to use Friendica for authentication (use your Friendica nodes domain instead of example.com) +
- +
-<code> +
-authentication = "http_async"; +
-http_auth_url = "https://example.com/api/account/verify_credentials.json"; +
-</code> +
- +
-You can now use your Friendica account credentials to login to your prosody, there is no need to register a new account on the XMPP server. +
- +
-==== Addons ==== +
- +
-<callout type="info" icon="true"> +
-The two XMPP client addons in Friendica (JappixMini and XMPP) are outdated and may or may not work on your server. +
- +
-Currently we advise to use a dedicated client program to use the XMPP accounts linked to the Friendica accounts. +
-</callout> +
- +
-=== Jappix Mini — === +
- +
-  * **Addon**: jappixmini +
-The Jappix Mini Addon creates a chatbox for jabber- and XMPP-contacts. You should already have a jabber/XMPP-account before setting up the addon. You can find more information at [jabber.org]([[http://www.jabber.org/|http://www.jabber.org/]]). +
- +
-You can use several servers to create an account: +
- +
-  * [[https://jappix.com|https://jappix.com]] +
-  * [[http://xmpp.net|http://xmpp.net]] +
- +
-== 1. Basics == +
- +
-At first you have to get the current version. You can either pull it from [Github]([[https://github.com|https://github.com]]) like so: +
-<code> +
- +
-  $> cd /var/www/virtual/YOURSPACE/html/addon; git pull +
- +
-</code> +
- +
-Or you can download a tar archive here: [jappixmini.tgz]([[https://github.com/friendica/friendica-addons/blob/stable/jappixmini.tgz|https://github.com/friendica/friendica-addons/blob/stable/jappixmini.tgz]]) (click at „view raw“). +
- +
-Just unpack the file and rename the directory to „jappixmini“. Next, upload this directory and the .tgz-file into your addon directory of your friendica installation. +
- +
-Now you can activate the addon globally on the admin pages. In the addon sidebar, you will find an entry of jappix now (where you can also find twitter, GNU Social and others). The following page shows the settings of this addon. +
- +
-Activate the BOSH proxy. +
- +
-== 2. Settings == +
- +
-Go to your user account settings next and choose the addon page. Scroll down until you find the Jappix Mini addon settings.+
  
-At first you have to activate the addon.+If you follow the link, you will see the login page of the IRC chat. Now choose a nickname and a chatroom. You can choose any name you like for the room, even something like #superchatwhosenameisonlyknownbyme. Finally, solve the captchas and click the connect button.
  
-Now add your Jabber/XMPP name, the domain/server (without "http"; just "jappix.com"). For „Jabber BOSH Host“ you could use "https://bind.jappix.com/". Note that you need another BOSH server if you do not use jappix.com for your XMPP account. You can find further information in the „Configuration Help“-section below this fields. At last you have enter your password (there are some more optional options, you can choose). Finish these steps with "send" to save the entries. Now, you should find the chatbox at the lower right corner of your browser window. If you want to add contacts manually, you can click "add contact". //+The following window shows some text while connecting. This text isn’t important, just wait for the next window. The first line shows your name and your current IP address. The right part of the window shows all users. The lower part of the window contains an input field.
  
-=== xmpp / Converse ===+===== XMPP/Jabber =====
  
-  * **Addon**: xmpp+Server admins can configure their ejabberd or prosody XMPP/Jabber servers to authenticate against the Friendica user database. If configured this way, every Friendica account is also a XMPP/Jabber account and can be used with any XMPP/Jabber client.
  
-Alternative JavaScript web client that you can use instead of the JappixMini client.+You can find details about such a [[docs:install-ejabberd|setup with ejabberd or prosody]] here.
  
  • Last modified: 2022-06-25 06:59