Document calendar embed parameters

This describe additional parameters in order to embed a calendar using  iframes.

Signed-off-by: jo <jooola@users.noreply.github.com>
This commit is contained in:
Jonas L 2021-05-31 23:53:53 +02:00 committed by backportbot[bot]
parent d29eca74be
commit 19fa5fc3c6

View file

@ -94,7 +94,14 @@ Calendars can be published through a public link to make them viewable (read-onl
There's also an « embedding code » that provides an HTML iframe to embed your calendar into public pages.
Multiple calendars can be shared together by adding their unique tokens to the end of an embed link. Individual tokens can be found at the end of each calendar's public link. The full address will look like
``https://cloud.example.com/index.php/apps/calendar/embed/token1-token2-token3``
``https://cloud.example.com/index.php/apps/calendar/embed/<token1>-<token2>-<token3>``
To change the default view or date of an embedded calendar, you need to provide an url that look like ``https://cloud.example.com/index.php/apps/calendar/embed/<token>/<view>/<date>``.
In this url you need to replace the following variables:
- ``<token>`` with the calendar's token.
- ``<view>`` with one of ``month``, ``week``, ``day``, ``listMonth``, ``listWeek``, ``listDay``. The default view is ``month`` and the normally used list is ``listMonth``.
- ``<date>`` with ``now`` or any date with the following format ``<year>-<month>-<day>`` (e.g. ``2019-12-28``).
On the public page, users are able to get the subscription link for the calendar and download the whole calendar directly.