History: Calendar Admin

            ! Calendar Admin
!! Enabling the Calendar Feature
From the Administration: Administration page, click on the features icon.  The calendar feature is enabled by clicking the check box in the top section of the admin page, then saving your changes. You now should see a Calendar item when you expand the Admin menu. 

{img src="display2052" link="display2052" width="700" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

!! Configuring the Global Calendar Settings
You can select the Calendar settings through the Main Application menu "Admin home > Calendar (icon)" {img src="img/wiki_up/date.png" } (which will lead you to __tiki-admin.php?page=calendar__)

{img src="display2053" link="display2053" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

||Group Calendar Sticky Popup|If enabled the calendar stays on screen after the mouse is moved away from event date
Group Calendar Item View Tab|((Help)) needed for this item
Default View Mode| Choose from "Day, Week, Month, Quarter, Semester, Year"
Calendar Manual Selection of time/date|((Help)) needed for this item
JSCalendar|Use a JavaScript calendar widget for event time/date entry
First Day of the Week| Choose from Saturday, Sunday, Monday or set it dependent on the language used
Split hours into periods of| Choose from 1, 5, 10, 15, and 30 minutes
First/Last Year in the dropdown| Allows the admin to set how many years are shown in the dropdown box for year when entering events.  Set it to -1 if you want last year visible, 0 if just want this year visible.  __Note:__ These fields are not active if you select JScalendar for event input.||


!! Create or edit calendars
Click on "Admin > Calendar" to go to Calendar Admin (__tiki-admin_calendars.php__). 

There are two sections (tables) to this screen: 
{img src="display2054" link="display2054" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

{img src="display2055" link="display2055" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

The following selections enable custom pulldown menus for additional descriptive fields:
* __Custom Locations:__
* __Custom Categories:__

''__Please note__: from v6.0 the label "Custom Categories" is changed to "Custom Classifications" to avoid confusion with permission categories.''

Other selections control specialized features:
* __Custom Participants:__ - only a specified list of registered users can use the calendar.
* __Custom Languages:__ - language selection from pulldown menu of available languages.
* __Custom Priorities:__ - select priority from 1-9.
* __Personal Calendar:__ - controls whether only the owner of the calendar will have access to this calendar.
!! Assigning permissions
{img src="display2056" link="display2056" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

!! Import a list of events
You can import a list of events in a csv (Comma Separated Values) file, through __tiki-calendar_import.php__.

{img src="display2057" link="display2057" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

* Column names on the first line:
+  -+ name,description,start date,start time,end date,end time,status,lang,categoryId,locationId,priority,url,categoryId+-
* ''subject column name can be used instead of name''
* Date format: See http://php.net/strtotime

!! Personal calendar
The personal calendar is a calendar where an event is only visible by the user that creates it. Physically it is a big unique calendar in the database that contains all the events. An event is displayed only for his creator. A personal calendar has special perms that needs to be reserved to work correctly. The admin can chooose a name for a personal calendar. You can have more than one personal calendar.

!! Urls
* the url to add an event directly to an specific calendar is
+ __tiki-calendar_edit_item.php?calendarId=5__, if 5 is the id of the calendar where you want the event to be stored
 
*The url to display one calendar is
+ __tiki-calendar.php?calIds=5__, if 5 is the id of the calendar you want to display

*To display more than one calendar
+ __tiki-calendar.php?calIds[]=5&calIds[]=1__, if 5 and 1 are the calendar ids

*To display all the calendars
+ __tiki-calendar.php?allCals=y__

*To display the calendars in mode list
+ __tiki-calendar.php?viewlist=list__
Other value for viewlist is table

*To display the calendars in mode list
+ __tiki-calendar.php?viewmode=month__
Other values for viewmode are day, week, month, quarter, semester, year

* Any of the above parameters can be cumulated
+__tiki-calendar.php?viewlist=list$calIds[]=5__

-=Related pages=-
* ((Calendar))
* ((Calendar User))
* ((Calendar Details))
* ((Js Calendar))
* ((Module calendar_new))