@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
1@title Calendar User Guide: Importing Events
2@group userguide
3
4Importing events from other calendars.
5
6Overview
7========
8
9IMPORTANT: Calendar is a prototype application. See
10@{article:User Guide: Prototype Applications}.
11
12You can import events into Phorge to other calendar applications or from
13`.ics` files. This document will guide you through how to import event data
14into Phorge.
15
16When you import events from another application, they can not be edited in
17Phorge. Importing events allows you to share events or keep track of
18events from different sources, but does not let you edit events from other
19applications in Phorge.
20
21
22Import Policies
23===============
24
25When you import events, you select a visibility policy for the import. By
26default, imported events are only visible to you (the user importing them).
27
28To share imported events with other users, make the import **Visible To**
29a wider set of users, like "All Users".
30
31
32Importing `.ics` Files
33======================
34
35`.ics` files contain information about events, usually either about a single
36event or an entire event calendar.
37
38If you have an event or calendar in `.ics` format, you can import it into
39Phorge in two ways:
40
41 - Navigate to {nav Calendar > Imports > Import Events > Import .ics File}.
42 - Drag and drop the file onto a Calendar.
43
44This will create a copy of the event in Phorge.
45
46If you want to update an imported event later, just repeat this process. The
47event will be updated with the latest information.
48
49Many applications send `.ics` files as email attachments. You can import these
50into Phorge.
51
52
53.ics Files: Google Calendar
54===========================
55
56In **Google Calendar**, you can generate a `.ics` file for a calendar by
57clicking the dropdown menu next to the calendar and selecting
58{nav Calendar Settings > Export Calendar > Export this calendar}.
59
60
61.ics Files: Calendar.app
62========================
63
64In **Calendar.app**, you can generate an `.ics` file for a calendar by
65selecting the calendar, then selecting {nav File > Export > Export...} and
66saving the calendar as a `.ics` file.
67
68You can also convert an individual event into an `.ics` file by dragging it
69from the calendar to your desktop (or any other folder).
70
71When you import an event using an `.ics` file, Phorge can not
72automatically keep the event up to date. You'll need to repeat the process if
73there are changes to the event or calendar later, so Phorge can learn
74about the updates.
75
76
77Importing .ics URIs
78=====================
79
80If you have a calendar in another application that supports publishing a
81`.ics` URI, you can subscribe to it in Phorge. This will import the entire
82calendar, and can be configured to automatically keep it up to date and in sync
83with the external calendar.
84
85First, find the subscription URI for the calendar you want to import (see
86below for some guidance on popular calendar applications). Then, browse to
87{nav Calendar > Imports > Import Events > Import .ics URI}.
88
89When you import a URI, you can choose to enable automatic updates. If you do,
90Phorge will periodically update the events it imports from this source.
91You can stop this later by turning off the automatic updates or disabling
92the import.
93
94{icon lock} **Privacy Note**: When you import via URI, the URI often contains
95sensitive information (like a username, password, or secret key) which allows
96anyone who knows it to access private details about events. Anyone who can edit
97the import will also be able to view and edit the URI, so make sure you don't
98grant edit access to users who should not have access to the event details.
99
100
101.ics URIs: Google Calendar
102==========================
103
104In **Google Calendar**, you can get the subscription URI for a calendar
105by selecting {nav Calendar Settings} from the dropdown next to the calendar,
106then copying the URL from the {nav ICAL} link under **Private Address**. This
107URI provides access to all event details, including private information.
108
109You may need to adjust the sharing and visibility settings for the calendar
110before this option is available.
111
112Alternatively, you can use the URI from the {nav ICAL} link under
113**Calendar Address** to access a more limited set of event details. You can
114configure which details are available by configuring how the calendar is
115shared.
116
117
118.ics URIs: Calendar.app
119=======================
120
121**Calendar.app** does not support subscriptions via `.ics` URIs.
122
123You can export a calendar as an `.ics` file by following the steps above, but
124Phorge can not automatically keep events imported in this way up to date.
125
126
127Next Steps
128==========
129
130Continue by:
131
132 - returning to the @{article:Calendar User Guide}.