Search 1.9 billion lines of Odoo code on GitHub
hr_holidays_public
<h1 class="title">HR Holidays Public</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/hr-holidays/tree/15.0/hr_holidays_public"><img alt="OCA/hr-holidays" src="https://img.shields.io/badge/github-OCA%2Fhr--holidays-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/hr-holidays-15-0/hr-holidays-15-0-hr_holidays_public"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/290/15.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module handles public holidays.</p>
<p>The calculation of each leave can exclude rest public holiday, depending on
the leave type configuration.</p>
<p>In HR holiday app, public holiday will be displayed as unusual days (grey like weekends).</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li>
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id6">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id8">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<p>Go to <em>Time Off -> Configuration -> Time Off Types</em> and open a Leave Type</p>
<ul class="simple">
<li>Check "Exclude Public Holidays" to exclude public holidays.</li>
</ul>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<p>For adding public holidays:</p>
<ol class="arabic simple">
<li>Go to the menu <em>Leaves > Public Holidays > Public Holidays</em>.</li>
<li>Create your public holidays.</li>
</ol>
<p>For using public holidays on leaves:</p>
<ol class="arabic simple">
<li>Go to <em>Time Off > Dashboard</em>.</li>
<li>Select dragging on the calendar the days you want to be on leave, or go
to the form view for selecting start and end dates.</li>
<li>Select the proper "Leave Type" that has "Exclude Public Holidays" checked.</li>
<li>If no leave type is yet specified, then default configuration is to exclude
public holidays.</li>
<li>The number of days will be computed excluding public holidays that match the
selected employee, including global, country and state holidays.</li>
<li>If no employee is yet selected, only global holidays will be taken into
account.</li>
</ol>
<p>In calendar views in HR holiday app public will be display
(likes other unusual days) according the current user employee country/state. If not set
the there is a fallback to the current company country/state to filter public holidays.</p>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2>
<p>In Odoo 12.0, <cite>_leave_intervals()</cite> returns <cite>Intervals</cite> which is a list of
tuples (start_timestamp, end_timestamp, <cite>resource.calendar.leaves</cite> record).
Since this module does not operate with <cite>resource.calendar.leaves</cite>, it's
setting third component of a tuple to a <cite>hr.holidays.public.line</cite> record.
This may or may not be a problem, yet since this component is also being set to
<cite>resource.calendar.attendance</cite> records in <cite>_attendance_intervals()</cite>, seems it
should be ok.</p>
<p>There are no restrictions to block users from modifying or removing calendar
events linked to public holidays. There's a suggestion to overload <cite>write</cite> and
<cite>unlink</cite> methods of <cite>calendar.event</cite>, but it might have other impacts like
users not being able to edit event tags, or even custom fields.</p>
<p>Regional public holidays are shown in the public calendar. The regions will be
noted in the description of the event, but it'll be shown to all users. It'd
be good to have it show only for users in these regions.</p>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/hr-holidays/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/hr-holidays/issues/new?body=module:%20hr_holidays_public%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id5">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id6">Authors</a></h3>
<ul class="simple">
<li>Michael Telahun Makonnen</li>
<li>Tecnativa</li>
<li>Fekete Mihai (Forest and Biomass Services Romania)</li>
<li>Druidoo</li>
<li></li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id7">Contributors</a></h3>
<ul class="simple">
<li>Michael Telahun Makonnen <<a class="reference external" href="mailto:mmakonnen@gmail.com">mmakonnen@gmail.com</a>></li>
<li>Fekete Mihai <<a class="reference external" href="mailto:feketemihai@gmail.com">feketemihai@gmail.com</a>></li>
<li>Nikolina Todorova <<a class="reference external" href="mailto:nikolina.todorova@initos.com">nikolina.todorova@initos.com</a>></li>
<li>Alexis de Lattre <<a class="reference external" href="mailto:alexis.delattre@akretion.com">alexis.delattre@akretion.com</a>></li>
<li>Salton Massally (iDT Labs) <<a class="reference external" href="mailto:smassally@idtlabs.sl">smassally@idtlabs.sl</a>></li>
<li>Ivan Yelizariev <<a class="reference external" href="mailto:yelizariev@it-projects.info">yelizariev@it-projects.info</a>></li>
<li>Bassirou Ndaw <<a class="reference external" href="mailto:b.ndaw@ergobit.org">b.ndaw@ergobit.org</a>></li>
<li>Dhara Solanki <<a class="reference external" href="mailto:dhara.solanki@initos.com">dhara.solanki@initos.com</a>></li>
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul>
<li>Pedro M. Baeza</li>
</ul>
</li>
<li><a class="reference external" href="https://corporatehub.eu/">CorporateHub</a><ul>
<li>Alexey Pelykh <<a class="reference external" href="mailto:alexey.pelykh@corphub.eu">alexey.pelykh@corphub.eu</a>></li>
</ul>
</li>
<li><a class="reference external" href="https://www.camptocamp.com">Camptocamp</a>:<ul>
<li>Damien Crier <<a class="reference external" href="mailto:damien.crier@camptocamp.com">damien.crier@camptocamp.com</a>></li>
</ul>
</li>
<li><a class="reference external" href="https://www.druidoo.io">Druidoo</a>:<ul>
<li>Iván Todorovich <<a class="reference external" href="mailto:ivan.todorovich@gmail.com">ivan.todorovich@gmail.com</a>></li>
</ul>
</li>
<li><a class="reference external" href="https://www.pesol.es">Pesol</a>:<ul>
<li>Pedro Evaristo Gonzalez Sanchez <<a class="reference external" href="mailto:pedro.gonzalez@pesol.es">pedro.gonzalez@pesol.es</a>></li>
</ul>
</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id8">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/hr-holidays/tree/15.0/hr_holidays_public">OCA/hr-holidays</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>