{{:logo-notifications-internes.png?200 |}} ====== Guide d'utilisation du Module Dolibarr "Notifications Internes" ======


===== Présentation =====


Le module Notifications Internes permet l'envoi automatique de notifications d'information par courriel lorsqu'un utilisateur fait des actions de base sur les Tiers, les Contacts et les Événements.

==== Informations ====


  * Module version : 2.2.0
  * Editeur/Licence : Artaban / GPL
  * Langage interface : Français
  * Information & Assistance : Nous contacter [[http://artaban.fr/spip.php?page=contact]]

==== Prérequis ====


  * Dolibarr min version : 14.0.*
  * Dolibarr max version : 16.0.*

==== Installation====

  - Télécharger le fichier archive du module (.zip) depuis le site web [[https://www.dolistore.com/fr/modules/532-Notifications-internes.html|www.dolistore.com]]
  - Placer le fichier dans le répertoire racine de dolibarr.
  - Décompressez le fichier zip, par exemple par la commande "unzip nomfichiermodule.zip"
  - A lire : [[http://wiki.dolibarr.org/index.php/FAQ_Repertoire_Custom_Module_Externe|FAQ Répertoire Custom Module Externe]]

Le module est alors disponible et activable.

**Remarque : ** Vous pouvez également installer le module via FTP. Pour ce faire, dézipper en local l'archive du module. Puis mettez le contenu ( le répertoire htdocs et tout son contenu ) à la racine du site....
Si le module n'apparaît pas, lisez : [[http://wiki.dolibarr.org/index.php/FAQ_Repertoire_Custom_Module_Externe|FAQ Répertoire Custom Module Externe]] 


==== Modifications Dolibarr ====

A l'installation, le module "Notifications Internes" ajoute une table **llx_internal_notification** à la base de données.
===== Fonctionnement =====

D'une manière générale, il est possible, dans un modèle de notification, de récupérer certaines informations via des tags. Ces informations concernent l'objet de la notification ainsi que le prénom et le nom de l'utilisateur ayant fait l'action déclenchant l'envoi de la notification...

Les notifications seront envoyées aux courriels spécifiés dans le champs prévu à cet effet pour chaque type de notification.

===== Les actions de base prises en compte =====

==== Tiers ====

  * Création
  * Modification
  * Suppression

==== Contact ====

  * Création
  * Modification
  * Activation / Désactivation
  * Suppression

Notez que pour Activation / Désactivation, il s'agit de la même notification. Elle permet juste de savoir que l'état activé ou non activé du contact a changé.

==== Evénement ====

  * Création
  * Modification
  * Suppression

===== Paramétrages des notifications =====


==== Accès au paramétrage des notifications ====

Depuis l'accueil, Configuration > Modules. Dans le premier onglet de la page des modules, chercher la partie 'Outils multi-modules', puis le module  'Notifications Internes'. L'activer si ce n'est pas déjà fait... Puis cliquer sur les outils à droite pour accéder à la page de paramétrage des notifications...

{{:module-notification-interne.png|}}

Pour information l'url de la page de paramétrage des notifications internes doit ressembler à : mondolibarr.com/htdocs/internalnotification/admin/internalnotification.php

==== Généralités sur le paramétrage des notifications ====

Il y a 3 onglets sur la page de paramétrage des notifications internes ( Tiers, Contacts et Evénements / Tâches ).

Chacun des 3 onglets présente des formulaires permettant de paramétrer les notifications de chacun de ses éléments.

Les formulaires comportent 3 champs obligatoires 
  * le/les courriel(s) des destinataire(s) séparés par une virgule
  * le sujet de la notification
  * le texte de la notification 

Des tags peuvent être insérés dans les champs pour récupérer automatiquement les informations utiles.

{{:parametrage-notifications-internes.png|}}

//Crédits illustration logo : Nicholas Menghini - TheNounProject//

===== Demandes de correction de bugs et d'ajout de fonctionnalités =====

Nous avons à coeur de livrer un produit répondant à vos attentes. Vous pouvez nous aider en ce sens en nous rapportant des bugs ou en nous suggérant de nouvelles fonctionnalités. Vous pouvez faire cela depuis cette page : https://bitbucket.org/artabanteam/notifications-internes-dolibarr/issues