From 96b19b4f10f1071a9f017cd605155fea93a6b2fe Mon Sep 17 00:00:00 2001 From: larm-odoo Date: Wed, 27 May 2026 20:01:01 +0000 Subject: [PATCH] [ADD] Time Off - Public Holidays X-original-commit: a2d03637bdc9bdda1d64b85c59e8f47ab6c2cd42 --- content/applications/hr/time_off.rst | 75 +----------------- content/applications/hr/time_off/holidays.png | Bin 19614 -> 0 bytes .../hr/time_off/public_holidays.rst | 58 ++++++++++++++ .../hr/time_off/public_holidays/holidays.png | Bin 0 -> 27471 bytes 4 files changed, 61 insertions(+), 72 deletions(-) delete mode 100644 content/applications/hr/time_off/holidays.png create mode 100644 content/applications/hr/time_off/public_holidays.rst create mode 100644 content/applications/hr/time_off/public_holidays/holidays.png diff --git a/content/applications/hr/time_off.rst b/content/applications/hr/time_off.rst index d165b444a7d..be6183b28a7 100644 --- a/content/applications/hr/time_off.rst +++ b/content/applications/hr/time_off.rst @@ -14,7 +14,7 @@ individuals, teams, or the whole company, and :ref:`approve time off requests Detailed :doc:`reports ` can be run to see how much time off (and what kinds of time off) are being used, :doc:`accrual plans ` can be created, and -:ref:`public holidays ` can be set. +:doc:`public holidays ` can be set. .. note:: Be advised, only users with specific access rights can see all aspects of the **Time Off** app. @@ -36,77 +36,6 @@ In order to allocate time off to employees, and for employees to request and use various :doc:`time off types must be configured ` first, then :doc:`allocated ` to employees (if allocation is required). -.. _time_off/public-holidays: - -Public holidays ---------------- - -Since holidays vary from country to country, or even city to city, there are no public holidays -preconfigured in Odoo. To observe public or national holidays, and provide extra days off as -holidays to employees, configure the observed public holidays in Odoo. - -It is important to configure public holidays in Odoo, so employees are aware of the days they have -off, and do not request time off on days that are already set as a public holiday (non-working -days). - -Additionally, all public holidays configured in the **Time Off** app are also reflected in any app -that uses working schedules, such as **Calendar**, **Planning**, **Manufacturing**, and more. - -Due to Odoo's integration with other apps that use working schedules, it is considered best practice -to ensure *all* public holidays are configured. - -Create public holidays -~~~~~~~~~~~~~~~~~~~~~~ - -To create a public holiday, navigate to :menuselection:`Time Off app --> Configuration --> Public -Holidays`. All currently configured public holidays appear in a default list view. - -Click the :guilabel:`New` button, and a new line appears at the bottom of the list. - -Enter the following information on that new line: - -- :guilabel:`Name`: Enter the name of the holiday. -- :guilabel:`Company`: If in a multi-company database, the current company populates this field by - default. It is **not** possible to edit this field. - - .. note:: - The :guilabel:`Company` field is hidden, by default. To view this field, click the - :icon:`oi-settings-adjust` :guilabel:`(settings adjusts)` icon in the top-right corner of the - list, to the far-right of the column titles, and activate the :guilabel:`Company` selection - from the drop-down menu that appears. - -- :guilabel:`Start Date`: Using the date and time picker, select the date and time the holiday - starts, then click :icon:`fa-check` :guilabel:`Apply`. By default, this field is configured for - the current date. The start time is set according to the start time for the company (according to - the :doc:`working schedules `). If the user's computer is set to a - different time zone, the start time is adjusted accordingly, compared to the company's time zone. -- :guilabel:`End Date`: Using the date and time picker, select the date and time the holiday ends, - then click :icon:`fa-check` :guilabel:`Apply`. By default, this field is configured for the - current date, and the time is set to the end time for the company (according to the :doc:`working - schedules `). If the user's computer is set to a different time zone, - the start time is adjusted accordingly, compared to the company's time zone. - - .. example:: - A company located in San Francisco operates from 9:00 AM - 6:00 PM, with an eight hour work day - and one hour lunch break. - - For a user in New York, with a computer time zone set to Eastern Standard Time, a created - public holiday displays a start time of 12:00 PM - 9:00 PM, accounting for the three hour time - zone difference. - - Similarly, a user located in Los Angeles, with a computer time zone set to Pacific Standard - Time, sees a public holiday time as 9:00 AM - 6:00 PM. - -- :guilabel:`Working Hours`: If the holiday should only apply to employees who have a specific set - of working hours, select the working hours from the drop-down menu. If left blank, the holiday - applies to all employees. -- :guilabel:`Work Entry Type`: If using the **Payroll** app, this field defines how the :doc:`work - entries ` for the holiday appear. Select the work entry type from the - drop-down menu. - -.. image:: time_off/holidays.png - :alt: The list of public holidays in the configuration menu. - Mandatory days -------------- @@ -195,6 +124,7 @@ the time off request in a modal, click the :guilabel:`View` button. .. seealso:: - :doc:`time_off/time_off_types` + - :doc:`time_off/public_holidays` - :doc:`time_off/allocations` - :doc:`time_off/accrual_plans` - :doc:`time_off/request_time_off` @@ -206,6 +136,7 @@ the time off request in a modal, click the :guilabel:`View` button. :titlesonly: time_off/time_off_types + time_off/public_holidays time_off/allocations time_off/accrual_plans time_off/request_time_off diff --git a/content/applications/hr/time_off/holidays.png b/content/applications/hr/time_off/holidays.png deleted file mode 100644 index e10ffe4e64b55366f9be22ee7321137f070a56fe..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19614 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 EFZfxnQ2+n{ diff --git a/content/applications/hr/time_off/public_holidays.rst b/content/applications/hr/time_off/public_holidays.rst new file mode 100644 index 00000000000..74a2de974cd --- /dev/null +++ b/content/applications/hr/time_off/public_holidays.rst @@ -0,0 +1,58 @@ +=============== +Public holidays +=============== + +Since holidays vary by country, region, and even city, Odoo's **Time Off** app does *not* include +any public holidays by default. To account for public or national holidays, configure the observed +holidays in Odoo so employees can receive the appropriate days off. + +Configuring public holidays helps employees clearly see their non-working days and prevents +unnecessary time off requests for dates already designated as holidays. + +Public holidays configured in the **Time Off** app are also reflected across other Odoo apps that +use :doc:`working schedules <../payroll/working_schedules>`, including **Calendar**, **Planning**, +**Manufacturing**, and more. + +Because of Odoo's integration across these apps, configuring all public holidays is considered best +practice. + +Create public holidays +====================== + +To create a public holiday, navigate to :menuselection:`Time Off app --> Configuration --> Public +Holidays`. All currently configured public holidays appear in a default list view. + +Click the :guilabel:`New` button and a new line appears at the bottom of the list. + +Enter the following information on that new line: + +- :guilabel:`Name`: Enter the name of the holiday. +- :guilabel:`Company`: If in a multi-company database, the current company populates this field by + default. It is **not** possible to edit this field. + + .. note:: + The :guilabel:`Company` field is hidden, by default. To view this field, click the + :icon:`oi-settings-adjust` :guilabel:`(settings adjusts)` icon in the top-right corner of the + list, to the far-right of the column titles, and activate the :guilabel:`Company` selection + from the drop-down menu that appears. + +- :guilabel:`Start Date`: Using the date and time picker, select the date and time the holiday + starts, then click :guilabel:`Apply`. By default, this field is configured for the current date, + with a start time of `12:00 AM`. +- :guilabel:`End Date`: Using the date and time picker, select the date and time the holiday ends, + then click :guilabel:`Apply`. By default, this field is configured for the current date, with an + end time of `11:59 PM`. + + .. note:: + It is **not** recommended to change the public holiday hours of `12:00 AM` to `11:59 PM`. This + ensures all employees working all shifts receive the public holiday. + +- :guilabel:`Working Hours`: If the holiday should only apply to employees who have a specific set + of working hours, select the working hours using the drop-down menu. If left blank, the holiday + applies to all employees. +- :guilabel:`Work Entry Type`: If using the **Payroll** app, this field defines how the :doc:`work + entries <../payroll/work_entries>` for the holiday appear. Select the work entry type using the + drop-down menu. + +.. image:: public_holidays/holidays.png + :alt: The list of public holidays in the configuration menu. diff --git a/content/applications/hr/time_off/public_holidays/holidays.png b/content/applications/hr/time_off/public_holidays/holidays.png new file mode 100644 index 0000000000000000000000000000000000000000..e6b39497deb07ae1d4a4a437b893fb26179d417d GIT binary patch literal 27471 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 VjHotCbIm_4P#Hz(5=p}^{|oC-HlY9j literal 0 HcmV?d00001