# Feature MEET-305 - A single 'My Meetings' iCal calendar subscription action so users can always have their calendars in sync with the meetings

Project: Stream Meetings
Status: closed
URL: https://community.openproject.org/work_packages/MEET-305

## Planning

| Attribute | Value |
| --- | --- |
| Date |  |
| Priority | Medium |
| Target versions | 17.0.0 |
| Votes | 3 |
| List |  |
| Roadmap |  |
| Relevance |  |

## OPEN POINTS / FEEDBACK

| ID | Subject | Status | Decision |
| --- | --- | --- | --- |
| MEET-391 | How should we handle meetings that are part of a series, that a user has been added to | new |  |

## Use cases

_No work packages_

## Features and Chunks

| ID | Subject | Type | Status | Assignee | Target versions | Spent time |
| --- | --- | --- | --- | --- | --- | --- |
| MEET-411 | Add X-WR-CALNAME property for the calendar | Implementation | closed |  | 16.5.0 |  |

## Bugs and other work packages

| ID | Type | Subject | Status | Assignee | Target versions | Spent time | Module |
| --- | --- | --- | --- | --- | --- | --- | --- |
| MEET-404 | Bug | Missing spaces and characters on token creation caption | closed |  | 16.4.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| MEET-403 | Bug | Subscribed meeting calendar doesn't update when changes are made | closed |  | 16.4.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| MEET-396 | Bug | All meetings from calendar link show as not accepted but user cannot react to them | closed |  | 16.4.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| MEET-393 | Bug | Thunderbird does not import all of the user's meetings | closed |  | 16.4.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| MEET-390 | Bug | When subscribing to iCal with link from the 'My meetings' page, meetings the user is not invited to also are added | closed |  | 16.4.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| MEET-389 | Bug | One time meeting calendar invite menu point doesn't have the right phrasing | closed |  | 16.4.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| MEET-429 | Bug | Recurring meeting returns exclusion dates for all instantiated meetings | closed |  | 16.5.1 |  | Modules and project features / Meetings |
| MEET-401 | Bug | Meeting subscription link doesn't import all of the user's meetings | rejected |  | 16.6.0 |  | Modules and project features / Meetings, Modules and project features / Calendar |
| OP-17851 | Bug | Wrong time indicated for some meetings in iCal download | closed |  | 17.0.0 |  | Modules and project features / Meetings |
| MEET-446 | Bug | Changing the schedule of a recurring meeting leads to multiple entries in the iCal export for past dates | closed |  | 17.1.0 |  | Modules and project features / Meetings |
| MEET-430 | Bug | Meetings creeping away in thunderbird | closed |  |  |  | Modules and project features / Meetings |
| MEET-426 | Bug | Wrong time indicated for some meetings shown via iCal subscription  | rejected |  |  |  | Modules and project features / Meetings |

## Technical Details

| Attribute | Value |
| --- | --- |
| Module | Modules and project features / Meetings, Modules and project features / Calendar |
| Feature Flag |  |
| Requires doc change | Yes |
| Enterprise plan | Community (COM) |

## Details

| Attribute | Value |
| --- | --- |
| Pull preview |  |
| Mockups |  |
| Build Number |  |
| Found in mobile app version |  |
| Follow-up feedback e-mail |  |
| Accessibility | No |

## People

| Attribute | Value |
| --- | --- |
| Assignee |  |
| Accountable |  |
| Product manager |  |
| Feature Lead |  |
| Developers | Klaus Zanders |
| Designer | Parimal Satyal |
| Ordered by |  |
| Signed off by |  |
| Interest by |  |

## Estimates and progress

| Attribute | Value |
| --- | --- |
| PD (min) |  |
| PD (max) |  |
| Work |  |
| Labor costs |  |

## Description

**As** an OpenProject user and participant to multiple meetings  
**I want to** be able to see all my meetings in my calendar software  
**so that** I don't miss anything and know that the dates are all up to date

**Acceptance criteria**

Currently, .ics files generated by Meetings is unreliable. A meeting moderator doesn't know what actions automatically send invites to all users and has no way to disable it if they're using a separate tool (like Open-Xchange) to handle meeting invites.

This is set 1 to fix the problem of unreliable meeting invites and transparent black box behaviour and give users more clarity. The goal is eventually have full CalDAV support: <mention class="mention" data-id="63465" data-type="work_package" data-text="###63465">\#\#\#63465</mention> 

**Acceptance criteria**

  - There is an action called 'Subscribe to calendar' in the kebab menu on the my meetings page, and in the settings.
    
      - It makes it possible to add 'OpenProject {Instance name}" as a new calendar in the user's external calendar tool, like OpenXChange, Outlook or Apple Calendar
        
          - This calendar will be read-only; no interactions like accepting/declining invitations will be possible
    
      - This generates a new iCal subscription token for meetings, using our usual token creation form but with the following copy:
        
          - **Step 1:**
            
              - Title: New iCal subscription token for meetings
            
              - Banner: *we don't need it here yet (the user doesn't yet don't know what URL we're talking about)*
            
              - Text: "This token will generate an iCal subscription URL that lets you view all your meetings in an external calendar application."
            
              - Input field with label: "Token name"
                
                  - Placeholder text: ''
                
                  - Caption: 'You can name it after where you will use it, such as"My phone" or "Work computer."'
        
          - **Step 2:**
            
              - Title: An iCal meeting subscription token has been generated  
                Text: "Treat the following URL as you would a password. Anyone who has access to it can view all your meetings."
            
              - A copyable read-only text field with the generated token URL
            
              - Banner (warning): "This is the only time you will see this token. Make sure to copy it now."
                
                  - Change source text of existing translation: `my.access_token.token_value_warning`

  - For individual .ics files:
    
      - We continue to leave the option open
    
      - For one-time meetings, change phrasing from "Send email to all participants" to "Send email invite to participants"
    
      - When creating or editing meetings, there is a checkbox called 'Send calendar update to participants'. This is:
        
          - Unchecked by default
        
          - Has a caption: "Enabling this will send all participants an email with a new .ics file with the most up to date meeting information"
        
          - If checked, show a Danger dialog:
            
              - "This will email all participants a new calendar invite but will not remove their old one. If you make changes to the meeting afterwards, it will not be reflected until you send them an updated .ics. Are you sure you want to continue?"

**Technical notes**

  - *To be discussed*

  - *\[open\] Any way to detect duplicates for when the user is subscribed to the calendar and tries to add an individual .ics event to their calendar?*

**Permissions and visibility considerations**

  - The feature is hidden behind a feature flag so we can test it out on community.

**Translation considerations**

  - *Key terms and phrases in the key languages*

**Out of scope**

  - <mention class="mention" data-id="63465" data-type="work_package" data-text="###63465">\#\#\#63465</mention>
