Personnaliser le comportement de Jorani

Pour modifier la configuration par défaut, ouvrez le fichier config/config.php et modifiez les variables en fonction du comportement souhaité.

Configuration générale

Ce fichier ne concerne ni la configuration d'envoi d'emails qui est contenue dans le fichier config/emails.php ni la configuration de la base de données (config/database.php); configurations décrites plus bas dans cet article.

. Certains serveurs de messagerie (Office 360, par exemple) nécessitent une adresse valide.

Variable	Description
`from_mail`	Adresse e-mail de l'émetteur des e-mails de notification, `do.not@reply.me` par défaut
`from_name`	Nom de l'émetteur des e-mails de notification, `Jorani` par défaut.
`subject_prefix`	Préfixe du sujet des e-mails de notification, `[Jorani]` par défaut.
`leave_status_requested`	Passez cette variable à `TRUE` si vous souhaitez créer des demandes de congé avec le statut demandée au lieu de planifiée.
`default_leave_type`	Identifiant par défaut du type d'une nouvelle demandes de congé. Le premier de la liste par défaut (soit compensation).
`languages`	Liste des langages disponibles (code ISO639-1 sur deux lettres). Pour n'activer que le français et faire disparaître la liste déroulante du choix de langage, il faut indiquer seulement fr dans cette liste.
`disable_overtime`	Passez cette variable à `TRUE` si vous souhaitez désactiver le module de gestion des heures supplémentaires dans le menu des utilisateurs. Cela ne fera toutefois pas disparaître le type de congé repos compensatoire qui est un type système.
`ga_code`	Renseignez votre code Google Analytics pour commencer à suivre le comportement de vos utilisateurs.
`ga_send_userid`	Suivre les utilisateurs individuellement en envoyant l'identifiant de session dans les statistiques de Google Analytics.
`ics_enabled`	Passez cette variable à `TRUE` si vous souhaitez afficher un lien pour le flux permettant d'afficher les absences et jours non travaillés dans une application de calendrier externe (flux ICS WebCAL iCal iCalendar). Pensez à renseigner également la variable `default_timezone`.
`default_timezone`	Timezone par défaut, Jorani ne se fie pas au paramètre défini dans PHP.ini.
`disable_edit_leave_duration`	Passez cette variable à `TRUE` si vous souhaitez basculer le champ durée de la demande de congé en lecture seule. Cela nécessite d'avoir défini correctement les jours fériés et non travaillés sur tous les contrats.
`requests_by_manager`	Passez cette variable à `TRUE` si vous souhaitez autoriser les managers à créer des demandes de congé pour leurs collaborateurs.
`delete_rejected_requests`	Passez cette variable à `TRUE` si vous souhaitez que les employés puissent supprimer les demandes refusées.
`edit_rejected_requests`	Passez cette variable à `TRUE` si vous souhaitez que les employés puissent modifier les demandes refusées.
`public_calendar`	Passez cette variable à `TRUE` si vous souhaitez rendre publiques les calendriers global et tabulaire. Une fois cette option activée, il ne sera pas nécessaire de s'authentifier pour les incorporer dans un autre site web.

Configuration LDAP

L'identifiant de connexion utilisé dans Jorani doit être identique à celui stocké dans LDAP. Il faut donc créer les utilisateurs dans Jorani (avec n'importe quel mot de passe, mais le même login), car Jorani ne faut pas de création automatique. Le mot de passe stocké dans la base de données n'a pas d'importance, puisque c'est celui stocké dans l'annuaire qui est vérifié.

Toujours dans le fichier config/config.php, modifiez les variables suivantes :

Variable	Description
`ldap_enabled`	Passez cette variable à `TRUE` si vous souhaitez activer l'authentification par LDAP.
`ldap_host`	Adresse IP ou nom du serveur LDAP.
`ldap_port`	Numéro de port du serveur LDAP.
`ldap_basedn`	Modèle d'authentification par LDAP, par exemple `uid=%s,ou=people,dc=company,dc=com`. Vous devez adapter ce modèle en fonction de la configuration de l'annuaire de votre entreprise (note pour AD: il faut activer le mode de compatibilité LDAP v3 d'Active Directory). Vous devez laisser le symbole `%s` quelque part dans cette chaîne. Ce symbole représentant l'identifiant de connexion. Cela suppose que tous les utilisateurs à authentifier soient stockés au même endroit dans l'annuaire. Dans le cas contraire, il faudra utiliser la variable `ldap_basedn_db`.
`ldap_basedn_db`	Passez cette variable à `TRUE` si vous souhaitez stocker un chemin d'authentification LDAP spécifique à chaque utilisateur dans la base de données de Jorani. Si cette configuration est activée, un champ supplémentaire apparaîtra dans le formulaire de création d'un nouvel utilisateur, vous permettant de saisir cette valeur.

Configuration de la base de données

Jorani ne supporte que les bases MySQL et MariaDB.

Localiser les lignes de code suivantes dans le fichier config/database.php et les adapter à votre configuration :

Variable	Description
`['default']['hostname']`	Adresse IP ou nom du serveur de base de données.
`['default']['username']`	Utilisateur habilité (permissions SELECT, INSERT, UPDATE, DELETE, EXECUTE) sur la base de données.
`['default']['password']`	Mot de passe de l'utilisateur.

Configuration email

Jorani utilise le composant PHPMailer pour envoyer des e-mails.

La configuration du serveur e-mail est contenue dans le fichier /config/emails.php. Par exemple, pour GMAIL :

$config['protocol'] = 'smtp';
$config['useragent'] = 'phpmailer';
$config['smtp_host'] = 'ssl://smtp.googlemail.com';
$config['smtp_user'] = 'my.account.@gmail.com';
$config['smtp_pass'] = 'my password';
$config['_smtp_auth'] = TRUE;
$config['smtp_port'] = '465';

Il existe un script qui permet de tester la configuration des e-mails. Ouvrez pour cela le fichier testmail.php à la racine de votre installation et modifiez l'adresse e-mail de test. Rendez-vous ensuite à l'adresse (changez localhost par l'adresse de votre installation) http://localhost/testmail.php. Des informations supplémentaires vous y seront données en cas d'échec.

Plusieurs facteurs indépendants de Jorani peuvent bloquer l'envoi des e-mails.

SELinux les bloque par défaut.
Certains programmes antivirus.
Un pare-feu pourrait bloquer le flux réseau.
Certains serveurs SMTP sont configurés pour n'accepter qu'un nombre limité de serveurs émetteur.
Les hébergeurs web (OVH, etc.) limitent le nombre d'e-mails envoyés par heure.
etc.