InfraSWidgets

• 1. PRÉSENTATION GÉNÉRALE
• Présentation Générale
• 2. INSTALLATION ET ACTIVATION
• Installation et Activation
• 3. CONFIGURATION
• Configuration
• 4. WIDGETS DISPONIBLES
• Widgets Disponibles
• 5. PERMISSIONS ET DROITS D'ACCÈS
• Permissions
• 6. UTILISATION DES WIDGETS
• UTILISATION DES WIDGETS
• 7. SAUVEGARDE ET RESTAURATION
• Sauvegarde et Restauration
• 8. DÉPANNAGE
• Dépannage

1. PRÉSENTATION GÉNÉRALE

Présentation Générale

InfraSWidgets est un module optionnel pour Dolibarr ERP & CRM qui enrichit les widgets de base du tableau de bord par une série de widgets configurables et avancés.

Le module ajoute 4 widgets principaux :

• Un rapport de trésorerie (activité prévisionnelle)
• Un rapport de rentabilité (marges réalisées par mois)
• Un rapport de factures fournisseurs (montants et statistiques mensuelles)
• Un rapport de factures clients (montants et statistiques mensuelles)

Avantages :

• Visualisation graphique des données financières
• Widgets configurables selon vos besoins
• Filtres avancés par période et par utilisateur
• Compatible avec les modules natifs Dolibarr (factures, devis, marges)

Informations du module :

• Version : Compatible Dolibarr 3.5.0 et supérieur
• Développeur : Sylvain Legrand - InfraS
• Contact : support@infras.fr
• Site web : https://www.infras.fr

2. INSTALLATION ET ACTIVATION

Installation et Activation

1.INSTALLATION

Méthode recommandée :

1. Utilisez l'outil de déploiement des modules externes de Dolibarr
2. Accédez à : Accueil > Configuration > Modules/Applications
3. Recherchez "InfraSWidgets" dans la liste des modules
4. Cliquez sur "Activer"

Méthode manuelle :

1. Décompressez l'archive dans le dossier : htdocs/custom/infraswidgets/
2. Vérifiez que les permissions sont correctes (lecture/exécution)
3. Accédez à l'interface de gestion des modules
4. Activez le module InfraSWidgets

2.ACTIVATION OBLIGATOIRE

⚠ IMPORTANT : Après chaque mise à jour de Dolibarr ET/OU du module InfraSWidgets, vous DEVEZ : Désactiver le module InfraSWidgets. Réactiver immédiatement le module InfraSWidgets

Cette opération effectue les modifications nécessaires dans :

• La base de données
• Les fichiers de configuration

SANS CETTE OPÉRATION, les widgets ne fonctionneront pas correctement !

3.PRÉREQUIS TECHNIQUES

• Extension PHP XML activée (obligatoire pour le changelog)
• Modules Dolibarr requis selon les widgets :
  • Module "Factures clients" pour les widgets de factures clients
  • Module "Propositions commerciales" pour le widget de trésorerie
  • Module "Marges" pour le widget de rentabilité
  • Module "Factures fournisseurs" pour les widgets fournisseurs

3. CONFIGURATION

Configuration

1.ACCÈS À LA CONFIGURATION

Menu : Outils > InfraS > InfraSWidgets > Paramètres spécifiques InfraS

Droits nécessaires :

• Droit "Accès au menu InfraS" (paramMenu)
• Droit "Paramètres InfraSWidgets" (paramInfraSWidgets)

2.PARAMÈTRES GÉNÉRAUX [Ligne 5]

Nombre d'années dans les graphiques

Paramètre : INFRASWIDGETS_NB_OF_YEAR_IN_GRAPH

• Définit la profondeur historique des graphiques
• Par défaut : 1 an
• Recommandé : 1 à 3 ans selon vos besoins

3.ACTIVATION DES WIDGETS [Ligne 1 à 4]

Chaque widget peut être activé/désactivé individuellement via les paramètres :

• INFRASWIDGETS_TREASURY : Widget d'Activité prévisionnelle
• INFRASWIDGETS_MARGIN_GRAPH : Widget de marges
• INFRASWIDGETS_CUSTOMER_INVOICES : Widget factures clients
• INFRASWIDGETS_SUPPLIER_INVOICES : Widget factures fournisseurs

3.SAUVEGARDE/RESTAURATION DES PARAMÈTRES

Le module offre une fonctionnalité de sauvegarde/restauration :

SAUVEGARDE :

• Cliquez sur "Sauvegarder les paramètres"
• Tous les paramètres InfraSWidgets sont sauvegardés
• Utile avant une mise à jour majeure

RESTAURATION :

• Cliquez sur "Restaurer les paramètres"
• Restaure la dernière sauvegarde effectuée
• Permet de revenir à une configuration stable

4. WIDGETS DISPONIBLES

Widgets Disponibles

1.WIDGET DE TRÉSORERIE

Affiche un rapport d'activité prévisionnelle basé sur les devis signés et les factures sur une période donnée.

Données affichées :

• Devis signés (propositions commerciales acceptées)
• Factures validées
• Factures en cours de règlement
• Factures payées
• Total par période

Filtres disponibles :

• Date de début (jour/mois/année)
• Date de fin (jour/mois/année)
• Utilisateur (si droit "Voir tout" accordé)

Modules requis :

• Module "Factures clients" activé
• Module "Propositions commerciales" activé

2.WIDGET DE MARGES

Affiche un rapport graphique de rentabilité montrant les marges réalisées par mois sur une période.

Données affichées :

• Graphique des marges mensuelles
• Montants totaux (optionnel)
• Pourcentages de marge (optionnel)

Filtres disponibles :

• Année de référence
• Affichage des totaux (Oui/Non)
• Affichage des pourcentages (Oui/Non)

Modules requis :

• Module "Marges" activé
• Droit "Voir toutes les marges" (margins→liretous)

3.WIDGET FACTURES CLIENTS

Affiche un graphique des factures clients avec répartition par statut et par mois.

Données affichées :

• Factures brouillons par mois (montants)
• Factures validées par mois (montants)
• Factures en cours de règlement par mois
• Factures payées par mois
• Évolution sur plusieurs années

Filtres disponibles :

• Nombre d'années à afficher
• Affichage des totaux
• Affichage des pourcentages

Modules requis :

• Module "Factures clients" activé

4.WIDGET FACTURES FOURNISSEURS

Affiche un graphique des factures fournisseurs avec répartition par statut et par mois.

Données affichées :

• Brouillons de factures fournisseurs par mois (montants)
• Factures validées par mois (montants)
• Factures en cours de règlement par mois
• Factures payées par mois
• Évolution sur plusieurs années

Filtres disponibles :

• Nombre d'années à afficher
• Affichage des totaux
• Affichage des pourcentages

Modules requis :

• Module "Factures fournisseurs" activé

5. PERMISSIONS ET DROITS D'ACCÈS

Permissions

Le module InfraSWidgets définit 4 niveaux de permissions :

Permission	Code	Par défaut	Description
Accès au menu	paramMenu	OUI	Permet d'accéder au menu InfraS dans Outils
Paramètres	paramInfraSWidgets	NON	Permet d'accéder aux paramètres de configuration du module et de modifier les paramètres généraux
Voir tout	paramViewAll	NON	Permet de voir les données de tous les utilisateurs dans les widgets. Sans cette permission : l'utilisateur ne voit que ses propres données et celles de ses subordonnés (hiérarchie)
Sauvegarder / Restaurer	paramBkpRest	NON	Permet de sauvegarder et restaurer les paramètres du module

CONFIGURATION DES PERMISSIONS :

Menu : Accueil > Utilisateurs & Groupes > [Utilisateur] > Permissions

Rechercher : "InfraSWidgets"

• Cocher les permissions appropriées

6. UTILISATION DES WIDGETS

UTILISATION DES WIDGETS

1.AJOUT DE WIDGETS AU TABLEAU DE BORD

1. Accédez à votre tableau de bord (page d'accueil)
2. Cliquez sur l'icône "Modifier les widgets" (en haut à droite)
3. Sélectionnez "Ajouter un widget"
4. Recherchez les widgets InfraSWidgets :
   • Activité prévisionnelle
   • Évolution des marges
   • Montant des factures clients (HT par mois)
   • Montant des factures fournisseurs (HT par mois
5. Positionnez le widget selon vos préférences (glisser-déposer)
6. Cliquez sur "Enregistrer"

2.FILTRAGE DES DONNÉES

Chaque widget dispose de filtres accessibles via l'icône "Filtre" :

Widget de Trésorerie :

1. Cliquez sur l'icône de filtre du widget
2. Sélectionnez la date de début (jour/mois/année)
3. Sélectionnez la date de fin (jour/mois/année)
4. Si vous avez le droit "Voir tout" : sélectionnez un utilisateur
5. Cliquez sur "Actualiser"

Widgets Graphiques (Marges, Factures) :

1. Cliquez sur l'icône de filtre du widget
2. Sélectionnez l'année de référence
3. Cochez/décochez "Afficher les totaux"
4. Cochez/décochez "Afficher les pourcentages"
5. Cliquez sur "Actualiser"

3.LECTURE DES GRAPHIQUES

Les graphiques utilisent un code couleur standardisé :

Bleu : Données prévisionnelles ou brouillons

Vert : Données validées ou réalisées

Orange : Données en cours (ex: factures en attente de paiement)

Rouge : Alertes ou dépassements

Astuce : Les totaux sont affichés au survol de la souris sur les barres du graphique.

4.ACTUALISATION DES DONNÉES

Les widgets se rafraîchissent automatiquement :

• Au chargement de la page
• Après modification des filtres
• Manuellement via le bouton "Actualiser" de chaque widget

Les données sont en temps réel et reflètent l'état actuel de la base de données.

7. SAUVEGARDE ET RESTAURATION

Sauvegarde et Restauration

1.SAUVEGARDE AUTOMATIQUE

Le module sauvegarde automatiquement ses paramètres dans les cas suivants :

• Avant chaque désactivation du module
• Avant chaque mise à jour

Données sauvegardées :

• • • Tous les paramètres de configuration (INFRASWIDGETS_*)
    • Les widgets activés/désactivés
    • Les paramètres de filtrage par défaut

2.SAUVEGARDE MANUELLE

1. Menu : Outils > InfraS > InfraSWidgets > Paramètres
2. Section "Sauvegarde/Restauration"
3. Cliquez sur "Sauvegarder les paramètres"
4. Attendez le message de confirmation

Quand sauvegarder ?

• • • Avant une modification importante des paramètres
    • Avant une mise à jour de Dolibarr
    • Avant une mise à jour du module
    • Périodiquement (recommandé : une fois par mois)

3.RESTAURATION

1. Menu : Outils > InfraS > InfraSWidgets > Paramètres
2. Section "Sauvegarde/Restauration"
3. Cliquez sur "Restaurer les paramètres"
4. Attendez le message de confirmation
5. Actualisez la page (F5)

⚠ ATTENTION : La restauration écrase TOUS les paramètres actuels. Cette action est irréversible. Effectuez une sauvegarde avant de restaurer si nécessaire.

Droits requis : Pour accéder aux fonctions de sauvegarde/restauration, vous devez avoir le droit "Sauvegarde/Restauration"

8. DÉPANNAGE

Dépannage

1.LES WIDGETS NE S'AFFICHENT PAS

• Module non activé :

Solution : Menu > Configuration > Modules > Activer InfraSWidgets

• Widgets non activés dans les paramètres :

Solution : Menu > InfraSWidgets > Paramètres > Activer les widgets souhaités

• Droits utilisateur insuffisants :

Solution : Vérifier les permissions de l'utilisateur

• Modules requis non activés :

Solution : Activer les modules Factures, Devis, Marges selon les widgets

2.ERREUR "Extension XML manquante"

Cause : L'extension PHP XML n'est pas activée

Solution :

1. Contactez votre administrateur système
2. Activez l'extension PHP XML dans php.ini
3. Redémarrez le serveur web
4. Désactivez et réactivez le module InfraSWidgets

3.LES DONNÉES NE S'AFFICHENT PAS

• Aucune donnée dans la période sélectionnée :

Solution : Élargissez les dates de début et de fin

• Filtrage par utilisateur trop restrictif :

Solution : Sélectionnez "Tous les utilisateurs" ou vérifier les droits

• Cache non actualisé :

Solution : Videz le cache navigateur ( Ctrl+F5 ) et actualiser

4.SUPPORT TECHNIQUE

Si vous rencontrez un problème non résolu :

• Email : support@infras.fr

Informations à fournir :

• • • Version de Dolibarr
    • Version du module InfraSWidgets
    • Description détaillée du problème
    • Messages d'erreur (captures d'écran)
    • Étapes pour reproduire le problème