@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: Exporting Events
2@group userguide
3
4Exporting events to other calendars.
5
6Overview
7========
8
9IMPORTANT: Calendar is a prototype application. See
10@{article:User Guide: Prototype Applications}.
11
12You can export events from Phorge to other calendar applications like
13**Google Calendar** or **Calendar.app**. This document will guide you through
14how to export event data from Phorge.
15
16When you export events into another application, they generally will not be
17editable from that application. Exporting events allows you to create one
18calendar that shows all the events you care about in whatever application you
19prefer (so you can keep track of everything you need to do), but does not let
20you edit Phorge events from another application.
21
22When exporting events, you can either export individual events one at a time
23or export an entire group of events (for example, all events you are attending).
24
25
26Exporting a Single Event
27========================
28
29To export a single event, visit the event detail page and click
30{nav Export as .ics}. This will download an `.ics` file which you can import
31into most other calendar applications.
32
33Mail you receive about events also has a copy of this `.ics` file attached to
34it. You can import this `.ics` file directly.
35
36In **Google Calendar**, use {nav Other Calendars > Import Calendar} to import
37the `.ics` file.
38
39In **Calendar.app**, use {nav File > Import...} to import the `.ics` file, or
40drag the `.ics` file onto your calendar.
41
42When you export a recurring event, the `.ics` file will contain information
43about the entire event series.
44
45If you want to update event information later, you can just repeat this
46process. Calendar applications will update the existing event if you've
47previously imported an older version of it.
48
49
50Exporting a Group of Events
51===========================
52
53You can export a group of events matching an arbitrary query (like all events
54you are attending) to keep different calendars in sync.
55
56To export a group of events:
57
58 - Run a query in Calendar which selects the events you want to export.
59 - Example: All events you are attending.
60 - Example: All events you are invited to.
61 - Example: All events tagged `#meetup`.
62 - Select the {nav Use Results... > Export Query as .ics} action to turn
63 the query into an export.
64 - Name the export with a descriptive name.
65 - Select a policy mode for the export (see below for discussion).
66 - Click {nav Create New Export} to finish the process.
67
68The **policy modes** for exports are:
69
70 - **Public**: Only public information (visible to logged-out users) will
71 be exported. This mode is not available if your install does not have
72 public information (per `policy.allow-public` in Config).
73 - **Privileged**: All event information will be exported. This means that
74 anyone who knows the export URI can see ALL of the related event
75 information, as though they were logged in with your account.
76
77WARNING: Anyone who learns the URI for an export can see the data you choose
78to export, even if they don't have a Phorge account! Be careful about how
79much data you export and treat the URI as a secret. If you accidentally share
80a URI, you can disable the export.
81
82After finishing the process, you'll see a screen with some details about the
83export and an **ICS URI**. This URI allows you to import the events which match
84the query into another calendar application.
85
86In **Google Calendar**, use {nav Other Calendars > Add by URL} to import the
87URI.
88
89In **Calendar.app**, use {nav File > New Calendar Subscription...} to subscribe
90to the URI.
91
92Next Steps
93==========
94
95Continue by:
96
97 - returning to the @{article:Calendar User Guide}.