Metadata-Version: 2.0
Name: odoo8-addon-resource-calendar-rrule
Version: 8.0.1.0.0.99.dev6
Summary: Use flexible repetition rules to define your employees' or machines' availability
Home-page: UNKNOWN
Author: Therp BV,Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: ~=2.7
Requires-Dist: odoo (<9.0a,>=8.0a)
Requires-Dist: odoo8-addon-field-rrule

.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3

============================
RRules in resource calendars
============================

This module was written to extend the functionality of resource calendars to support more flexible schedules than the default implementation. Per calendar, you can create rules describing the schedule in a very similar manner to what most calendaring applications use for repeating appointments (technically: iCal recurrence rules, short rrule).

Usage
=====

To use this module, you need to:

#. go to a resource's calendar
#. instead of filling in a day of week, fill in the repetition rule

If your user is a member of the group `Full RRules in resource calendars`, you'll see the full RRule possibilities. This is not really usable for most mere mortals, so by default, users see a week matrix where they can fill in time slots in the morning and in the afternoon. Morning starts at 8.00, and the afternoon at 13.00. In case you want to change this, set the values `resource_calendar_rrule.simplified_morning` resp. `resource_calendar_rrule.simplified_afternoon` to some float with the hours in the integer part and minutes in the fraction.

.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
    :alt: Try me on Runbot
    :target: https://runbot.odoo-community.org/runbot/116/8.0

Known issues / Roadmap
======================

* implement the rrule version of all functions in ``resource.calendar``
* maybe also divert from current standard a bit because the current code assumes weekly repetition at many places
* an init hook to convert existing calendars to rrules would be nice
* allow to configure parameters via some settings wizard

Bug Tracker
===========

Bugs are tracked on `GitHub Issues
<https://github.com/OCA/hr/issues>`_. 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 feedback.

Credits
=======

Images
------

* Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.

Contributors
------------

* Holger Brunn <hbrunn@therp.nl>

Do not contact contributors directly about help with questions or problems concerning this addon, but use the `community mailing list <mailto:community@mail.odoo.com>`_ or the `appropriate specialized mailinglist <https://odoo-community.org/groups>`_ for help, and the bug tracker linked in `Bug Tracker`_ above for technical issues.

Maintainer
----------

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

This module is maintained by the OCA.

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.

To contribute to this module, please visit https://odoo-community.org.


