MoreHoliday

De Documentations Patas-monkey
Version datée du 10 septembre 2025 à 15:28 par Liam (discussion | contributions) (Page créée avec « |- | 400px | If you have permission to view all users, you don't have to select a user from the drop-down list. »)
Aller à la navigation Aller à la recherche
This module improves Dolibarr's native vacation management by adding:
  • a rolling week view of vacations
  • an advanced status of vacations by employee
  • an advanced vacation dashboard

Overview

The MoreHoliday module allows you to intuitively manage vacations in Dolibarr. It is based on native permissions, dictionaries, tables, and data without altering the structure.

The Moreholiday module is installed like any other module and adds additional menus to the Human Resources Management (HRM) area.

Settings

Access the module administration screen from the module list by clicking on the gear icon at the end of the line or the box associated with it. The administration screen is divided into three parts.

Setting colors according to holiday type and status

The first part of the screen allows you to define a color and abbreviation for each defined type and status.

These colors and abbreviations will be displayed on the rolling weeks page.

Leave types can be configured in Dolibarr's native dictionaries

It is possible to define the same color and abbreviation for different types and statuses; it is not mandatory to define an abbreviation or color.

Holiday Color Settings

The second part of the screen allows you to define a color for holidays.

These colors allow you to view active holidays on the rolling week page.

Additional Settings

The last part of the screen allows you to define additional parameters related to the ergonomics and use of the module.

An informational text is associated with each parameter to explain its use, which will also be detailed on the various pages of the documentation.

Application Menu

The module adds three menus to the HR section.

  • A statistics page, presenting dashboards and graphs related to leave management.
  • A user summary page, presenting users, company employees, and information related to their leave.
  • A sliding calendar page, displaying leave entered over a given period.

MoreHoliday Area

This page contains ten spaces, which can be grouped as follows:
  • Grouping lists and the most recently updated holidays
  • Graphs to visualize holiday activity
  • Action spaces to filter by period or filter the display of holidays in the native list


Filtering by period allows you to select vacations for a given period and refresh the data on the space page for that period.

  • P12: Displays vacation statistics for the previous year
  • P3: Displays vacation statistics for the previous quarter
  • P1: Displays vacation statistics for the previous month
  • All: Displays statistics for all vacations
  • 1: Displays vacation statistics for the current month
  • 3: Displays vacation statistics for the current quarter
  • 12: Displays vacation statistics for the current year

User Summary

To allow access to this page, users must have read permissions
The module displays the native Dolibarr user list with additional columns related to leave management.

The first group of columns corresponds to the list of leave types (default and those defined). The value in the column corresponds to the number of days remaining for each leave type.

The second group of columns corresponds to the user's monthly leave for the month. It is possible to configure the selectable months in the module configuration (you can define the number of months preceding the current month and the number of months following). The value in the column corresponds to the number of leaves taken by the employee.

Leave Taken Details

By clicking on the icon associated with the leave number, you can view the details of the leaves taken. The detail windows are not modal, so it is possible to open several at once.

Each window presents a table of leave taken by the employee for a given employee and month. The color corresponds to the type and status defined in the module settings.

Sliding Calendar

This is the main screen of the module, which allows you to view the status of employee leave over a given period.

The screen is divided into four parts:

  • Navigating the calendar and filtering the basic data
  • Filtering by selecting leave types and status
  • List of public holidays for the current year
  • Presentation of leave with employees listed in rows and weeks listed in columns

This last part allows you to view the details of the leave, to validate/approve/reject and cancel leave and naturally to create a leave request.

Moving and Filtering Basic Data

Moving and Organizing Weeks

This section allows you to navigate the calendar by specifying a starting week and the number of weeks you want to display.

The arrows allow you to move forward or backward by one week, as well as increase or decrease the number of weeks displayed. Clicking the calendar icon returns you to the current week. In the module settings, you can define:

  • the default week offset (e.g., to move to the previous or next week)
  • the number of weeks to display by default

It is now possible to show/hide the weekday weekends by clicking on the text at the bottom of the table.

Available Filters on Data

Depending on the permissions of the user accessing this page, it is possible to filter the users you wish to display.

If you have the right to view only your own data and that of your subordinates, you display a checkbox to view them both at the same time or only one person's account.

If you have permission to view all users, you don't have to select a user from the drop-down list.

In this case, it is also possible to filter by user category and/or user group.

Filtering by Type and Status Selection

This second table allows you to quickly filter holidays by type and status.

  • Clicking on the [Type] heading inverts the selection.
  • Clicking on the green check mark selects all checkboxes.
  • Clicking on the red cross unchecks all checkboxes.
  • The boxed row and column heading areas invert the selection of the associated checkboxes.

Visualisation et actions possibles sur L'agenda

Le format des tableaux par défaut de dolibarr ne présente pas de lignes pour séparer les colonnes, mais il est possible d'en ajouter en le définissant dans le paramétrage du module.

Les premières colonnes du tableau présente, l'identité du collaborateur, le nombre d'heure de travail par semaine défini et un accès au solde des congés du collaborateur par tooltip.

Les colonnes suivantes sont regroupées par semaine, la première semaine présente le mois de celle-ci. Les jours fériés sont colorées selon le paramétrage défini.

Quand un congé est présent sur une période, elle s'affiche avec la couleur (et/ou une abréviation) défini selon son type et le statut défini.

Si la période de congé ne débute pas un matin ou ne se termine pas un après-midi, la zone est partiellement colorée

Visualiser une demande de congé existante

Quand on clique sur une période de congé, un popup apparait présentant son détail.

Il est possible d'avoir plusieurs popup ouvertes à la fois (non modal) Selon l'habilitation de l'utilisateur et le statut de la demande de congé il est possible de réaliser diverses actions.

Réaliser une demande de congé

Il est possible de créer une demande de congé directement en cliquant sur l'icone en haut à gauche d'une cellule de tableau

à l'ouverture du popup, on présaisie l'utilisateur, la date de début et de fin selon la cellule où l'icone a été cliqué.