====== ELGG - Installation et administration ======

===== Installation =====

[[http://learn.elgg.org/en/stable/intro/install.html|Documentation d'installation]]

__Elgg incompatible avec Postgresql__
<code bash>
apt install mariadb-server php7.0 php7.0-gd php7.0-json php7.0-xml php7.0-mysql php7.0-mbstring apache2
cd /var/www/
wget https://elgg.org/about/getelgg?forward=elgg-2.3.8.zip
unzip getelgg\?forward\=elgg-2.3.8.zip
rm getelgg\?forward\=elgg-2.3.8.zip
rm -r html
mv elgg-2.3.8 html
mkdir /usr/share/elgg-data
chown www-data: /usr/share/elgg-data /var/www/html/elgg-config
chmod 750 /usr/share/elgg-data
</code>
==== Apache ====
<code bash>
a2enmod rewrite ssl
vim /etc/apache2/elgg.conf
</code>
<code apache>
<VirtualHost *:80>
  ServerName mon-url.com
  Redirect permanent / https://mon-url.com
</VirtualHost>
  
<IfModule mod_ssl.c>
  <VirtualHost *:443>
    ServerName mon-url.com
    DocumentRoot /var/www/html
    ErrorLog ${APACHE_LOG_DIR}/elgg-error.log
    CustomLog ${APACHE_LOG_DIR}/elgg-access.log combined
    SSLEngine on
  
    SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem
    SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key
  
    <Directory /var/www/html/>
      Options FollowSymLinks
      AllowedOverride All
    </Directory>
  </VirtualHost>
</IfModule>
</code>
<code bash>
a2dissite 000-default
a2ensite elgg
systemctl restart apache2
</code>
==== MariaDB ====
<code bash>
mariadb
CREATE USER elgg IDENTIFIED BY 'elgg';
CREATE DATABASE elgg;
GRANT ALL PRIVILEGES ON elgg.* TO elgg;
exit
</code>
==== post install ====

=== Longueur minimale de la phrase de passe ===
<code bash>
cd /var/www/html/elgg-config
vim settings.php
</code>

  $CONFIG->min_password_length = 8;

=== memcached ===
<code bash>
apt install memcached
vim /var/www/html/elgg-config/settings.php
</code>
  $CONFIG->memcache = true;
  $CONFIG->memcache_servers = array (
    array('localhost', 11211),
  );

=== Configuration depuis interface web ===

https://IP_SERVEUR/admin/settings/advanced

  - URL du site : https://mon_url.com
  - Utiliser un lien symbolique vers le répertoire du cache simple (recommandé) [__COCHER__]
  - Compresser le JavaScript (recommandé) [__COCHER__]
  - Compresser les CSS (recommandé) [__COCHER__]
  - Permettre à de nouveaux utilisateurs de s'enregistrer [__DÉCOCHER__]
  - Restreindre l'accès au site aux membres connectés [__COCHER__]

== Désactiver l'enregistrement automatique de nouveaux utilisateurs ==

Configurer -> Configuration -> Configuration avancée -> Accès au site -> décocher "Permettre à de nouveaux utilisateurs de s'enregistrer"

Pour enregistrer un nouvel utilisateur :
Administrer -> Utilisateurs -> Créer un utilisateur

== Restreindre création de groupes ==

Configurer -> Configuration -> Groups -> Qui peut créer un nouveau groupe ? -> "Administration"

=== Notes ===

Il semblerait qu'il soit possible de créer des utilisateurs en masse avec des requêtes SQL : https://stackoverflow.com/questions/18671499/how-can-i-add-new-user-in-elgg-using-sql-query

== Problèmes ==

  - Lorsqu'un rôle est créé graĉe au plugin "roles" via "roles_ui", la visilité des autres contacts devient impossible même sans règles renseignées dans le nouveau rôle. 
__EDIT:__ Après examen des logs (/var/log/apache2/elgg-error.log) il semblerait qu'il y ai une incompatibilité entre les rôles et le plugin "hype_inBox"

== Plugins ==

  - [[https://elgg.org/plugins/385077|Tidypics]] galerie photos,
  - [[https://elgg.org/plugins/2706200|JQuery Local Ads Rotator]] utile si l'on veux afficher des petites images type "communication",
  - [[https://elgg.org/plugins/2648103|CKEditor Addons]], édition de texte avancée,
  - [[https://elgg.org/plugins/2626274|hypeDropzone]] améliore l'upload des fichiers (drag&drop) __/!\__ N'as pas l'air de fonctionner,
  - [[https://elgg.org/plugins/2625041|hypeInbox]] améliore la messagerie (envoi à plusieurs utilisateurs, ...). Dépendance : [[https://github.com/hypeJunction/elgg_tokeninput/releases/tag/4.1.3|elgg_tokeninput]]. 
  - [[https://elgg.org/plugins/2659366|Roles UI]]. Dépendance : [[https://elgg.org/plugins/847275|Roles]].
  - [[https://elgg.org/plugins/1564847|newsletter]]. Dépendance : [[https://elgg.org/plugins/709492|HTML email handler]].
  - [[https://elgg.org/plugins/874513|File Tools]]
  - [[https://elgg.org/plugins/570566|Login As]]
  - [[https://elgg.org/plugins/2641523|hypeEmbed]] améliore l'intégration de médias dans les zones de texte.

== Thèmes ==

Je trouve que le thème pas défaut (sans Aalborg) est très bien mais il n'est pas "responsive".  
Le thème "Aalborg" peut être édité en allant fouiller dans les fichiers CSS "/mod/aalborg_theme/views/default/".

  - [[https://elgg.org/plugins/2667490|hypeUI]]" simple, clean.