Metadata-Version: 2.1
Name: odoo-addon-event_stage_cancelled
Version: 18.0.1.0.0.2
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Event cancellation workflows
Home-page: https://github.com/OCA/event
License: AGPL-3
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

============================
Event cancellation workflows
============================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:87550ff34ff9aaa373001a3f38d1b3e4660fe162370913cc2002ac42149794ad
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fevent-lightgray.png?logo=github
    :target: https://github.com/OCA/event/tree/18.0/event_stage_cancelled
    :alt: OCA/event
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/event-18-0/event-18-0-event_stage_cancelled
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/event&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module adds the posibility of flagging an event stage as cancelled
so we can hook workflows onto it like cancelling registrations or
scheduling special mail events.

**Table of contents**

.. contents::
   :local:

Use Cases / Context
===================

Up to v14, events had an state field instead of configurable stages. A
lost feature with that change was the concept of a cancelled event and
with it the logic associated to it: when we cancelled an event, its
registrations were cancelled along with it.

Configuration
=============

To set a stage as cancelled:

- Go to *Events > Configuration > Event Stages* and choose the one you
  want to be the cancelled one.

To schedule a mail that triggers when the event is cancelled:

- Go to *Events* and select an event.
- Go to the *Communication* tab and add a new scheduler.
- Choose to trigger it *After the event cancellation*.
- Choose the other parameters like template or the interval.

When the event is cancelled, the corresponding mail will be sent to the
attendants who where confirmed at the moment of the cancellation.

Usage
=====

When you want to cancel an event an its registration, just click on the
*Cancel Event* button from the event itself.

A confirmation dialog will show up and if you confirm it, the linked
registrations will be cancelled as well.

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

- If you just change the stage to the cancelled one, the registrations
  won't be cancelled. This is avoided for the moment on purpose as a
  confirmation dialog would require an special ``ir.actions.client``
  implementation.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/event/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/event/issues/new?body=module:%20event_stage_cancelled%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Tecnativa

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

- `Tecnativa <https://tecnativa.com>`__

  - David Vidal

- `Heliconia Solutions Pvt. Ltd. <https://www.heliconia.io>`__

  - Bhavesh Heliconia

Maintainers
-----------

This module is maintained by the OCA.

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

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.

This module is part of the `OCA/event <https://github.com/OCA/event/tree/18.0/event_stage_cancelled>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
