====== Client XMPP ======

Au sein du service [[:services:xmpp.chapril.org|XMPP]] un client est mis à disposition des utilisateurs depuis leur navigateur Web.

Le client est une version personnalisée de [[https://conversejs.org/|ConverseJS]] pour le Chapril.

===== Installation =====

L’installation comprend le clonage d’un dépôt Git, le téléversement de fichiers vers la VM et la configuration du serveur Nginx.

==== Clonage du dépôt ====

Pour obtenir notre version de ConverseJS débute le clonage. Un animateur système est invité à exploiter sa clef SSH s’il est membre du dépôt.
<code bash>
git clone --branch=chapril "ssh://gitea@forge.april.org:222/fhenry2/xmpp.chapril.org-conversejs.git"
</code>

Au sein du dépôt le code final est construit dans le répertoire ''dist/''.
<code bash>
npm run build
</code>

==== Téléversement SSH ====

Le programme construit, la charge utile sera téléversée vers la VM via la commande ''scp''.
<code bash>
scp -r dist/ \
  fullscreen-chapril.html \
  init.js \
  local-chapril.html \
  local-chapril.js \
  manifest-chapril.json \
  "scp://xmpp.chapril.org///var/www/html/tests/conversejs-beta/"
</code>

==== Configuration Nginx ====

Pour terminer Nginx doit être adapté.
Depuis le fichier de configuration de XMPP, ''/etc/nginx/sites-available/xmpp.chapril.org'', deux blocs sont ajoutés.
<code nginx>
  ### Converse 14 ###
  location /beta/ {
    alias /var/www/html/tests/conversejs-beta/;
    index fullscreen-chapril.html;

    # CORS
    location ~ \.(ttf|ttc|otf|eot|woff|woff2|font\.css|css|js)$ {
      add_header Access-Control-Allow-Origin "*";
    }
  }
</code>

La configuration du //daemon// est rechargée.
<code bash>
nginx -t && nginx -s reload
</code>

<note tip>Il est toujours bon de vérifier la configuration de Nginx via la commande ''nginx -t''.</note>