History: Calendar

Source of version: 44 (current)

! {icon name="calendar"} Calendar

This page is the documentation of Tikis __Calendar__ feature.
For __calendar syncronisation__ of Tiki calendars with other apps, please see  ((CalDAV)) which was implemented in ((Tiki21)) via ((SabreDAV)). See also ((CardDAV)) and ((Calendar Invitations by email)).

{DIV(class="row")}{DIV(class="col-sm-9")}{DIV(class="lead")}Tiki has several calendar-related features. These enable creating, viewing and editing multiple event calendars that can display as a full page or in a ((module)), and can also show ((tracker)) data and ((Action Calendar|site content activity)).{DIV}
__To activate and access__
Activiate the feature on ''tiki-admin.php?page=features'' and then click the Calendar icon {icon name="calendar" title="Image may vary depending on the icon set in use."} on the Admin Panel or go to ''tiki-admin.php?page=calendar''.{DIV}{DIV(class="col-sm-3")}{img src="display989" link="display989" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}{DIV}{DIV}
~tc~ Preference documentation generated from https://sourceforge.net/p/tikiwiki/code/HEAD/tree/trunk/lib/prefs/ ~/tc~
~tc~ To update documentation see https://dev.tiki.org/How-to-get-commit-access ~/tc~
{PREFDOC(tab="calendar")/}

!! General


There are several time/date- and calendar-related features:

* The ((Mini Calendar)): MyTiki's personal calendar. A simple appointment list.
* The __Calendar__: Tiki's main calendar. This can display:
** The ((Tools Calendars)) which report system-created lists of changes/additions, such as the creation or edit of a wiki page, upload of a file, including date and time, user, and description. This requires the permission tiki_p_view_tiki_calendar.
** The __Event Calendars__ which show user created information such as events or appointments, and requires the permission tiki_p_view_calendar.  Different calendars can be created, with distinct permissions for each. It is also possible to setup a Personal calendar here. This duplicates the mini-calendar feature but with integration with the other calendars (so you can see in one view both your personal events and the other events).
* The feature ((jscalendar)) adds a nifty date picker to Event Calendars. (and trackers)
* The ((modules)) calendar and calendar_new add a small calendar to a lateral column with events in hover boxes
* A plugin is available to display tracker data in a calendar-type of display of items, useful for project management, where you can drag & drop to move or click & drag to resize the duration of events. See ((PluginTrackerCalendar)).

!! Example
For the moment there is no possibility to include a calendar formated like tiki-calendar.php into a wiki page, beyond the ((PluginTrackerCalendar)). To display a calendar in that format one must use a link
{CODE(colors="c")}[domain/tiki-calendar.php?calIds=1|Display Calendar Nr 1]{CODE}

To display multiple calendars use the following code
{CODE(colors="c")}[domain/tiki-calendar.php?calIds~0=4&calIds~1=6|Display Calendar Nr 4 and Nr 6]{CODE}

Example of usage in a wiki page through the plugin module and several modules inside.

{img src="tiki-download_file.php?fileId=138" align="center" alt="tiki3_calendar_3x1.png (27.04 Kb)"}

!! Key Functions and Sub-features
* Calendar tab provides view of appointments for a time period set by administrator
* Event tab allows for event scheduling
* Events can be all day long.
* Several categories for simple selection.
* Import Events from a CSV - using ''url/tiki-calendar_import.php'' ([Calendar+Admin#Import_a_list_of_events|see details])
* You can change your site's date and time preferences in ''url/tiki-admin.php?page=general''

!! Some calendar features
* Calendar names are now translatable (but not individual events).
** This is useful if you have a calendar ID which has events in several languages. Ex. Training/Formation for CalendarID #4 and each event's info (ex.: name/description) can be in any language or you can make bilingual. The translation of the calendar name label is done like any other translation string in Tiki (lang/**/language.php or lang/**/custom.php or ((Interactive Translation)).
* New options have been added to set default new events to all day, and another option to put the name of the event on each day.
* New look of calendars in every views, especially in week view which is now displayed with hours details. Events on multiple days are also better displayed. In week view, when there is more than 3 events, a special zone will be displayed and the overbox will contain all details,
* New recurrence feature to have the same event each week/month/year between two dates or for X occurences. An event from an occurence can be modified later. When modifying an event from a recurrence, TikiWiki will ask the user if he wants to change only the current event, all the events of the recurence, or events of the recurence which were not already modified,
* New iCal export feature,
* New option to choose the calendars to display by default. Also keep in database the user last calendar choices in order to keep use the same filter when he comes back,
* New "standard colors" when creating a calendar to ease the choice of calendar colors

!!! Related Links
* ((CalDAV))
* ((Calendar User))
* ((Calendar Admin))
* ((Js Calendar))
* ((Module calendar_new))

!!! Aliases
* (alias(User Calendar))
* (alias(Calendars))
* (alias(event))
* (alias(calendar of events))
* (alias(event calendar))
* (alias(Scheduling))