Differential D25007 Diff 23 src/docs/user/userguide/calendar_exports.diviner

Changeset View

Standalone View

src/docs/user/userguide/calendar_exports.diviner

@title Calendar User Guide: Exporting Events		@title Calendar User Guide: Exporting Events
@group userguide		@group userguide

Exporting events to other calendars.		Exporting events to other calendars.

Overview		Overview
========		========

IMPORTANT: Calendar is a prototype application. See		IMPORTANT: Calendar is a prototype application. See
@{article:User Guide: Prototype Applications}.		@{article:User Guide: Prototype Applications}.

You can export events from Phabricator to other calendar applications like		You can export events from Phorge to other calendar applications like
Google Calendar or Calendar.app. This document will guide you through		Google Calendar or Calendar.app. This document will guide you through
how to export event data from Phabricator.		how to export event data from Phorge.

When you export events into another application, they generally will not be		When you export events into another application, they generally will not be
editable from that application. Exporting events allows you to create one		editable from that application. Exporting events allows you to create one
calendar that shows all the events you care about in whatever application you		calendar that shows all the events you care about in whatever application you
prefer (so you can keep track of everything you need to do), but does not let		prefer (so you can keep track of everything you need to do), but does not let
you edit Phabricator events from another application.		you edit Phorge events from another application.

When exporting events, you can either export individual events one at a time		When exporting events, you can either export individual events one at a time
or export an entire group of events (for example, all events you are attending).		or export an entire group of events (for example, all events you are attending).


Exporting a Single Event		Exporting a Single Event
========================		========================

▲ Show 20 Lines • Show All 41 Lines • ▼ Show 20 Lines	The policy modes for exports are:
- Public: Only public information (visible to logged-out users) will		- Public: Only public information (visible to logged-out users) will
be exported. This mode is not available if your install does not have		be exported. This mode is not available if your install does not have
public information (per `policy.allow-public` in Config).		public information (per `policy.allow-public` in Config).
- Privileged: All event information will be exported. This means that		- Privileged: All event information will be exported. This means that
anyone who knows the export URI can see ALL of the related event		anyone who knows the export URI can see ALL of the related event
information, as though they were logged in with your account.		information, as though they were logged in with your account.

WARNING: Anyone who learns the URI for an export can see the data you choose		WARNING: Anyone who learns the URI for an export can see the data you choose
to export, even if they don't have a Phabricator account! Be careful about how		to export, even if they don't have a Phorge account! Be careful about how
much data you export and treat the URI as a secret. If you accidentally share		much data you export and treat the URI as a secret. If you accidentally share
a URI, you can disable the export.		a URI, you can disable the export.

After finishing the process, you'll see a screen with some details about the		After finishing the process, you'll see a screen with some details about the
export and an ICS URI. This URI allows you to import the events which match		export and an ICS URI. This URI allows you to import the events which match
the query into another calendar application.		the query into another calendar application.

In Google Calendar, use {nav Other Calendars > Add by URL} to import the		In Google Calendar, use {nav Other Calendars > Add by URL} to import the
Show All 11 Lines