**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.


**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**"

* Caption: "Automatically send an email with an updated calendar invite (.ics) for changes to date, time, location and participants."

* This defaults to checked (sending enabled)

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

* Text: "Email calendar updates are enabled. All participants will receive updated invites via email when you make changes."

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

* Text: "Email calendar updates are muted. Participants will not receive updated invites via email when you make changes."

* Clearly identify on the meeting side bar when a meeting is muted, adding a line to the meeting details section with text "Email calendar updates", showing the current status

* Add a new section in the meeting side bar, below meeting details, having a toggle component with the same label as the checkbox described above

* Add an info/warning banner to the top of the participants dialog, with the same captions as described above

* Toggling between states always results in a confirmation dialog being shown

* 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: "Mute email calendar updates?"

* Text: "Participants will no longer receive updated calendar invites via email with changes to the meeting. If they already had an invite for this meeting, it might no longer be accurate."

* Actions:

* "Cancel" (secondary)

* "Mute 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 informing them of changes to the meeting. One will be sent immediately now."

* Actions:

* "Cancel" (secondary)

* "Enable email updates" (danger) Begin of the insertion

* When a meeting is in the 'closed state', hide this option (display of the state and the action to change it).


End of the insertion Begin of the deletion


End of the deletion **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**

* <br>


**Out of scope**

* <br>