**As** a user of meetings
**I want to** understand when meeting module sends out emails
**so that** I can control them, or possibly suppress them

**Context: Current implementation**

Emails are currently sent out in these cases:

* **One-time invitations**: Inviting a new user to a one-time meeting sends out an email to that user only

* **Completing a series template:** After setting up a meeting series and clicking 'Complete template', meeting invitation is sent to every invitee in the template

* **Changing date or time**: If there are changes to the meeting start time or hour, in a one-time or recurring meeting, or when the entire series is moved, an email is sent out to all invitees

* **Meeting Cancellations**: When a meeting is canceled (deleted), an email notification is sent to inform all invitees that the meeting will no longer take place. Begin of the insertion

* **Copying meetings**: An email is sent out to all invitees when a one-time meeting or meeting series occurrence is copiedEnd of the insertion


**Acceptance criteria**

* Have a per meeting setting to toggle sending email notifications

* Controlled via a checkbox (in the creation and copy forms only - edit forms will not have this checkbox)

* Label: "**Send email calendar updates**"

* This defaults to checked (sending enabled)

* When checked, show an info banner below the option:

* For one-time meetings: Begin of the insertion"All participantsEnd of the insertion Begin of the deletion "Email calendar updates are disabled. ParticipantsEnd of the deletion will Begin of the deletion notEnd of the deletion receive Begin of the insertionupdated calendar invites viaEnd of the insertion Begin of the deletion anEnd of the deletion email informing them of your changes."

* For recurring meetings: "Email calendar updates are enabled for the meeting series. All participants will receive updated calendar invites informing them of your changes to this template or to individual occurrences."

* When unchecked, show a warning banner below the option:

* For one-time meetings: "Email calendar updates are disabled. Participants will not receive an email informing them of your changes."

* For recurring meetings: "Email calendar updates are disabled for the meeting series. Participants will not receive an email informing them of your changes to this template or to individual occurrences."

* Add a new section in the meeting side bar, below meeting details labelled "**Email calendar updates**"

* When updates are enabled:

* One-time meetings:

* Description: "Enabled. All participants will receive updated calendar invites via email informing them of changes."

* Button: Disable (icon: striked through bell)

* Series templates: Same as above

* Series occurrences:

* Description: "Enabled. All participants will receive updated calendar invites via email informing them of changes.
To change this, edit the series template."

* There is no button to change state

* When updates are disabled:

* One-time meetings:

* Description: "Disabled. Participants will not receive an email informing them of changes."

* Button: Enable (icon: bell)

* Series templates: Same as above

* Series occurrences:

* Description: "Disabled. Participants will not receive an email informing them of changes.
To change this, edit the series template."

* There is no button to change state

* Add a banner to the bottom of the meeting details edit dialog and to the top of the participants dialog

* When updates are enabled (info banner):

* One-time: "All participants will receive updated calendar invites via email informing them of your changes."

* Series template: "Email calendar updates are enabled for the meeting series. All participants will receive updated calendar invites informing them of your changes to this template or to individual occurrences."

* Series occurrence: "Email calendar updates are enabled for the meeting series. All participants will receive updated calendar invites informing them of your changes to this occurrence."

* When updates are disabled (warning banner):

* One-time: "Email calendar updates are disabled. Participants will not receive an email informing them of your changes."

* Series template: "Email calendar updates are disabled for the meeting series. Participants will not receive an email informing them of your changes to this template or to individual occurrences."

* Series occurrence: "Email calendar updates are disabled for the meeting series. Participants will not receive an email informing them of your changes to this occurrence."

* When toggling through the sidebar, show a [DangerWarning dialog](https://qa.openproject-edge.com/lookbook/inspect/primer/open_project/danger_dialog/default) (without the need for checkbox confirmation when trying to go from one state to another:

* From enabled to muted:

* Icon: `warning` (scheme: danger)

* Title: "Disable email calendar updates?"

* Text: "Participants will no longer receive updated calendar invites via email when there are changes to the meeting date, time, location or participants. If they already had an invite for this meeting, it might no longer be accurate."

* Actions:

* "Cancel" (secondary)

* "Disable email updates" (danger)

* From muted to enabled:

* Icon: `warning` (scheme: danger)

* Title: "Enable email calendar updates?"

* Text: "All participants will receive updated calendar invites via email every time there is a change to the meeting date, time, location or participants."

* Actions:

* "Cancel" (secondary)

* "Enable email updates" (danger)

* When a meeting is in the 'closed state' or cannot be edited, hide this sidebar section (display of the state and the action to change it).


**Technical notes**

* Add a meetings column "muted:boolean" that is checked for one-time and templates (in case of series)

* Respect this flag when sending out any notification

* For a series, the mute flag on the template controls notifications for all occurrences of the series


**Permissions and visibility considerations**

* "Edit meetings" necessary to be able to toggle between states Begin of the insertion


**Note for QA**

* As part of this WP, the meeting status action buttons were also updated to look like the email calendar updates button and should now be blueEnd of the insertion