{docbook}
    <highlights>
        <itemizedlist>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Calendar_views">Calendar views</link>
				</para>
				<para>
				Introduction to the Calendar interface and its components.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Manage_calendar_groups">Manage a calendar group</link>
				</para>
				<para>
				Steps to create, edit and remove a calendar group.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Create_calendars">Create a calendar</link>
				</para>
				<para>
					Steps to create a personal calendar, calendar for a group or a remote calendar.
                </para>
            </listitem>
			<listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Edit_calendar">Edit a calendar</link>
				</para>
				<para>
					Steps to edit details and properties of a calendar, to set the calendar color, and to delete a calendar.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="Export_and_import_calendar">Export/Import a calendar</link>
				</para>
				<para>
				Steps to import calendars or export calendars to a calendar application that supports ICalendar format.
                </para>
            </listitem>
			<listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Share_calendar">Share a personal calendar</link>
				</para>
				<para>
					Information about setting permissions on your shared calendar, steps to share your personal calendar with other users so that they can participate in all activities of this calendar.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Schedule_event">Schedule an event</link>
				</para>
				<para>
					Steps to perform common actions with events in Calendar: Create, edit, delete, import and export events.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Schedule_task">Schedule a task</link>
				</para>
				<para>
				Steps to perform common actions with events in Calendar: Create, edit, delete, import and export tasks.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Search_for_events_tasks">Search for events/tasks</link>
				</para>
				<para>
					Steps to find existing events/tasks according to specific search conditions.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.More_actions">More actions</link>
				</para>
				<para>
					Steps to perform other useful actions in Calendar to take advantage of all productivity features.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.Agenda_gadget">Add My Agenda gadget to your page</link>
				</para>
				<para>
					Steps to add <emphasis role="bold">My Agenda</emphasis> gadget to your page to list upcoming events and tasks from your personal calendar.
                </para>
            </listitem>
            <listitem>
                <para>
                   <link linkend="CSUser_guide.How_to_use_Calendar.My_tasks">Add My Tasks gadget to your page</link>
				</para>
				<para>
					Steps to add the <emphasis role="bold">My Tasks</emphasis> gadget to your page to list upcoming tasks of the current day from your personal calendar.
                </para>
            </listitem>
        </itemizedlist>
    </highlights>
{docbook}

{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}

* [Manage your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Manage_Contacts]
* [Email your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Email_Contacts]
* [Chat with your contacts|#Platform_User_Guide.Collaboration.Communicate_with_Contacts.Chat]

h1. Calendar views {anchor:id="CSUser_guide.How_to_use_Calendar.Calendar_viewsRoleNotInToc"}

The Calendar interface has 5 basic components.

!images/calendar-interface.png|align="center" width="150mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*

||Number||Description||
|!images/1.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Toolbar* contains most of actions in Calendar, such as adding an event/task, switching between view modes and more.|
|!images/2.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Search Pane* where you can perform quick and advanced searches.|
|!images/3.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Mini calendar* which can be hidden by clicking !images/Upper_arrow_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0" !.|
|!images/4.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Calendars pane* which includes 3 categories: Personal Calendars, Shared Calendars, and Group Calendars. Each category may include various calendar groups.|
|!images/5.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Calendar View pane* where you can create tasks/events quickly and view your own tasks/events.|

{docbook}
<note>
    <para>
    In eXo Platform, the left pane of <emphasis role="bold">Calendar</emphasis> is hidden by default. To show this pane, select <emphasis role="bold">Toggle Left Pane</emphasis> on the toolbar.
    </para>
    <para>
    If a calendar is not selected, its events and tasks will be hidden from the  <emphasis role="bold">Calendar View Pane</emphasis>. You can show/hide the events/tasks by simply clicking the calendar name.
    </para>
</note>
{docbook}

h1. Manage a calendar group {anchor:id="CSUser_guide.How_to_use_Calendar.Manage_calendar_groupsRoleNotInToc}
The calendar groups allow you to categorize your calendar types easily. Each calendar group may contain one or more calendars added by users. There will be a default calendar group named *My Group* in the *Personal Calendars* category.

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Calendar.Add_new_calendar_group">
        <emphasis role="bold">Add a new calendar group</emphasis>
    </para>
</citetitle>
{docbook}

This function allows you to organize and personalize calendars in your own way.
{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> at the right of the <guilabel>Calendars</guilabel> pane, then select <guilabel>Add Group</guilabel> from the drop-down menu.
</para>
{docbook}

!images/add_group.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

*2.* Enter the group name, and its description in the respective fields. {anchor:id="Calendar_groups_form"}

!images/Add_calendar_group_form.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to finish.
</para>
{docbook}

{docbook}
<para>
    After you have created a Space for a group, one calendar with the same name as that of your group will be created automatically in the <guilabel>Group Calendars</guilabel> pane.
</para>
{docbook}

{docbook}
<note>
    <para>
    After you have created a Space for a group, one calendar with the same name as that of your group will be created automatically in the <guilabel>Group Calendars</guilabel> pane.
    </para>
    <para>
    The calendar group without any calendars inside it will not be displayed in <guilabel>Personal Calendars</guilabel>.
    </para>
    <para>
    You can also add a new calendar group by clicking <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
          </inlinemediaobject> next to the <guilabel>Group</guilabel> field when <link linkend="Create_personal_calendar">creating a personal calendar</link>.
    </para>
</note>
{docbook}

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Calendar.Edit_calendar_group">
        <emphasis role="bold">Edit a calendar group</emphasis>
    </para>
</citetitle>
{docbook}

This function allows you to change the name and description of a specific calendar group.

*1.* Hover your cursor over the calendar group that you want to edit, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
   <emphasis role="bold">2.</emphasis> Click <guilabel>Edit</guilabel> from the drop-down menu to open the <guilabel>Calendar Groups</guilabel> form.
</para>
{docbook}

{docbook}
<para>
   <emphasis role="bold">3.</emphasis> Make changes on the <guilabel>Group Name</guilabel> or on the <guilabel>Description</guilabel> fields, then click <guibutton>Save</guibutton> to accept your changes.
 </para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Calendar.Delete_calendar_group">
        <emphasis role="bold">Delete a calendar group</emphasis>
    </para>
</citetitle>
{docbook}

Once a calendar group is deleted, all calendars inside it are also deleted.

*The first way*

*1.* Hover your cursor over the calendar group that you want to delete, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Click <guilabel>Delete</guilabel> from the drop-down menu.
 </para>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.
</para>
{docbook}

*The second way*

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Calendar Groups</guilabel> form by <link linkend="CSUser_guide.How_to_use_Calendar.Add_new_calendar_group">adding a new calendar group</link> or by <link linkend="CSUser_guide.How_to_use_Calendar.Edit_calendar_group">editing a calendar group.</link>
</para>
{docbook}

*2.* Click !images/Delete_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! corresponding to the calendar group you want to delete in the *Groups* table.

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.
</para>
{docbook}

The deleted calendar group will be removed from the *Groups* table.
h1. Create a calendar {anchor:id="CSUser_guide.How_to_use_Calendar.Create_calendarsRoleNotInToc"}

You may create a [personal calendar|#Create_personal_calendar] or [group calendar|#Create_group_calendar] that can be shared with specific users or groups to your desires. You can also create a calendar which is synchronized with a [remote calendar|#Create_remote_calendar].

{docbook}
<citetitle>
    <para xml:id="Create_personal_calendar">
        <emphasis role="bold">Create a personal calendar</emphasis>
    </para>
</citetitle>
{docbook}

{docbook}
<note>
<para>
All personal calendars will be put in the <emphasis role="bold">Personal Calendars</emphasis> pane.
</para>
</note>
{docbook}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Follow either of the following ways to open the <guilabel>Calendar</guilabel> form.
</para>
{docbook}

*The first way*

{docbook}
<para>Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject>, then select <guilabel>Add Calendar</guilabel> from the drop-down menu.
</para>
{docbook}

*The second way*

*i.* Hover your cursor over the calendar which you want add calendar, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
 <emphasis role="bold">ii.</emphasis> Click <guilabel>Add Calendar</guilabel> from the drop-down menu. By this way, the group that contains your new calendar is already selected.
</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Fill in fields of the <guilabel>Calendar Details</guilabel> tab.
</para>
{docbook}

!images/Calendar_form.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry>Field</entry>
                  <entry>Description</entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry>
                    <guilabel>Display Name</guilabel>
                  </entry>
                  <entry>The calendar name which is displayed.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Description</guilabel>
                  </entry>
                  <entry>The brief description of the calendar.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Groups</guilabel>
                  </entry>
                  <entry> The list of groups under the <emphasis role="bold">Personal Calendars</emphasis> category. Click <inlinemediaobject>
                      <imageobject role="fo">
                        <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="1" width="4mm"/>
                      </imageobject>
                      <imageobject role="html">
                        <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="0" width="4mm"/>
                      </imageobject>
                    </inlinemediaobject> to select one existing group that contains your calendar from the drop-down list. Or, click <inlinemediaobject>
                      <imageobject role="fo">
                        <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                      </imageobject>
                      <imageobject role="html">
                        <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                      </imageobject>
                    </inlinemediaobject> to create a new group that contains your calendar. The newly created group is only displayed in the <emphasis role="bold">Personal Calendars</emphasis> category after you finish creating the calendar. </entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Country (Language)</guilabel>
                  </entry>
                  <entry>The location and language of the calendar. You can change the default value by following steps in the <link linkend="CSUser_guide.How_to_use_Calendar.Edit_calendar_settings">Edit Calendar settings</link> section.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Time Zone</guilabel>
                  </entry>
                  <entry>The display time zone for the calendar activities. You can personalize your calendar time zone by following steps in the <link linkend="CSUser_guide.How_to_use_Calendar.Edit_calendar_settings">Edit Calendar settings</link> section.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Color</guilabel>
                  </entry>
                  <entry>The display color of the calendar activities that can be personalized.</entry>
                </row>
              </tbody>
            </tgroup>
</informaltable>
{docbook}

{docbook}
<warning>
<para>If you select the <guilabel>Groups</guilabel> tab and tick either of the checkboxes, your added calendar will be put in the <emphasis role="bold">Group Calendars</emphasis> category, NOT in the <emphasis role="bold">Personal Calendars</emphasis> category.
</para>
</warning>
{docbook}

{docbook}
<para>
 <emphasis role="bold">3.</emphasis> Click <guilabel>Save</guilabel> to finish your creation.
</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Create_group_calendar">
        <emphasis role="bold">Create a group calendar</emphasis>
    </para>
</citetitle>
{docbook}

{docbook}
<note>
<para>
All group calendars will be put in the <emphasis role="bold">Group Calendars</emphasis> pane.
</para>
</note>
{docbook}

*1.* Follow steps as stated in the [Create a personal calendar|#Create_personal_calendar] section to give details for your new calendar.

{docbook}
<para>
  <emphasis role="bold">2.</emphasis> Select the <guilabel>Groups</guilabel> tab.
</para>
{docbook}

!images/Groups_tab.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*3.* Tick checkboxes corresponding to groups that contain your created calendar. The users of the selected groups can only view this calendar.

* Grant the *Edit* permission to specific users of your selected group as follows: {anchor:id="Grant_Edit_Permission"}

{docbook}
<para>
<emphasis role="bold">i.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/user_selector_icon.png" format="PNG" scalefit="1" width="3mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/user_selector_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject>
to open the <guilabel>User Selector</guilabel> form. This form will help you select a specific user you want to share.
</para>
{docbook}

!images/Calendar_user_selector.png|align="center" width="80mm"  fo:scalefit="1" html:scalefit="0"!


*ii* Click the user you want to share the *Edit* permission.

* Grant the *Edit* permission to membership types of your selected group.

{docbook}
<para>
<emphasis role="bold">i.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/membership_selector_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/membership_selector_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject>
to open the <guilabel>User Selector</guilabel> form. </para>
{docbook}


*ii.* Select a membership type of each group. Select \* if you want to assign the *Edit* permission to all memberships of each group.

{docbook}
<note>
<para>You can select more users/memberships by repeating the above steps. The selected users/memberships will be updated in corresponding textboxes.
</para>
<para>You can delete your selected users/memberships manually in each textbox.
</para>
</note>
{docbook}

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click <guibutton>Save</guibutton> to finish creating your new group calendar.</para>
{docbook}

Your newly added calendar will appear in the shared groups.

{docbook}
<citetitle>
    <para xml:id="Create_remote_calendar">
        <emphasis role="bold">Create a remote calendar</emphasis>
    </para>
</citetitle>
{docbook}

{docbook}
<note>
<para>
To create a remote calendar in the <emphasis role="bold">Calendar</emphasis> application successfully, you need to learn about the calendar settings of the relevant provider. For more information about types of remote calendars, refer to <link linkend="More_about_iCal_CalDAV">this section.</link>
</para>
</note>
{docbook}

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Open the <guilabel>Subscribe Calendar</guilabel> form via one of the following ways.</para>
{docbook}

*The first way*

{docbook}
<para>Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject>, then select <guilabel>Remote Calendar</guilabel> from the drop-down menu.</para>
{docbook}

*The second way*

*i.* Hover your cursor over the personal calendar which you want to add remote calendars, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
<emphasis role="bold">ii.</emphasis> Click <guilabel>Remote Calendar</guilabel> from the drop-down menu.</para>
{docbook}

!images/subscrible_calendar.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

*2.* Select the type of the remote calendar: iCalendar or CalDAV.

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Enter the URL linking to your calendar server in the <guilabel>URL</guilabel> field.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click <guibutton>Next</guibutton> to go to the <guilabel>Remote calendar</guilabel> form. </para>
{docbook}

!images/Remote_calendar_form.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

*5.* Fill in the fields. The asterisk (\*) next to each field means that it is required to enter value in the field.

{docbook}
<para>
<emphasis role="bold">6.</emphasis> Tick the <guilabel>Use Authentication</guilabel> checkbox, then enter the username and password of your remote calendar server if the remote server requires verification.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">7.</emphasis> Click <guibutton>Save</guibutton> to accept your creation.</para>
{docbook}

{docbook}
<para>After setting up the remote calendar, you will see one auto-generated group named <guilabel>Remote</guilabel> in the <emphasis role="bold">Personal Calendars</emphasis> pane. The <guilabel>Remote</guilabel> group contains your remote calendars.</para>
{docbook}

!images/remote_calendar.png|align="center" width="50mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<note>
<para>
After creating a remote calendar, you can ONLY VIEW all events and tasks which are created in the remote calendar server right in the <emphasis role="bold">Calendar</emphasis> application by clicking it and selecting <guilabel>Refresh</guilabel> from the drop-down menu.
</para>
</note>
{docbook}

*More information about types of remote calendars*: {anchor:id="More_about_iCal_CalDAV"}

* *iCalendar*:
iCalendar provides a link to an online .ics file from another calendar servers, such as Google Calendar, Yahoo Calendar, or eXo Calendar (including public URL or private URL).

An example of a Google Calendar URL:

http://www.google.com/calendar/ical/Webdesignteam%40gmail.com/public/basic.ics

* *CalDAV*:
CalDAV is an open protocol that allows you to access calendars via WebDAV. With CalDAV, you can publish and subscribe to calendars, share them collaboratively, synchronize among multiple users or devices.

*Google*: https://www.google.com/calendar/dav/your_gmail_account@gmail.com/events/

*Yahoo*: https://caldav.calendar.yahoo.com/dav/your_yahoo_account@yahoo.com/Calendar/calendar_name/

For example:

https://www.google.com/calendar/dav/hoavuvn@gmail.com/events/

h1. Edit a calendar {anchor:id="CSUser_guide.How_to_use_Calendar.Edit_calendarRoleNotInToc"}

{docbook}
<note>
<para>
You can ONLY edit personal calendars and group calendars which have been created by yourself.
</para>
<para>
For group calendars which are created by another users, you can ONLY edit them if you are granted the <emphasis role="bold">Edit</emphasis> permission.
Meanwhile, for shared calendars, you cannot edit them. If you are granted the <emphasis role="bold">Edit</emphasis> permission on them by the calendar creators, you can ONLY have the right on their tasks or events (for example, adding/modifying/deleting, exporting/importing).
</para>
</note>
{docbook}

{docbook}
<para>
          <emphasis role="bold">1.</emphasis> Hover your cursor over the calendar which you want to edit, then click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/Calendar-gear-icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/Calendar-gear-icon.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject> that appears.
</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click <guilabel>Edit</guilabel> from the drop-down menu. The form to edit the calendar will be different, depending on your selected calendar type. For example, if you select a personal calendar, the form only contains the <guilabel>Calendar Details</guilabel> tab.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Make changes on the calendar, then click <guibutton>Save</guibutton> to accept your changes.</para>
{docbook}

{docbook}
<citetitle>
    <para xml:id="Set_calendar_color">
        <emphasis role="bold">Set the calendar color</emphasis>
    </para>
</citetitle>
{docbook}

The *Calendar* application allows you to select different colors for all types of calendars to recognize them easily.

*1.* Hover your cursor over the calendar which you want to set the color, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

*2.* Select one color from the available 32-color palette.

{docbook}
<citetitle>
    <para xml:id="CSUser_guide.How_to_use_Calendar.Delete_calendar">
        <emphasis role="bold">Delete a calendar</emphasis>
    </para>
</citetitle>
{docbook}

This function allows you to remove any calendars and all their events/tasks.

{docbook}
<note>
<para>
You cannot delete group calendars created by ANOTHER users if you are not granted the <emphasis role="bold">Edit</emphasis> permission.
</para>
</note>
{docbook}

*1.* Hover your cursor over the calendar which you want to delete, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Select <guilabel>Remove</guilabel> from the drop-down menu.
</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

h1. Export/Import a calendar {anchor:id="Export_and_import_calendarRoleNotInToc}

{docbook}
<note>
<para>
You can only export the calendar which contains at least one event or task. Besides, for shared and group calendars, you can only export/import them if you have the <emphasis role="bold">Edit</emphasis> permission.
</para>
</note>
{docbook}

{docbook}
<citetitle>
<para xml:id="Export_calendar">
<emphasis role="bold">Export a calendar</emphasis>
</para>
</citetitle>
{docbook}

This function allows you to export a calendar and its events/tasks into a separate file on your device.

*1.* Hover your cursor over the calendar which you want to export, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Click <guilabel>Export</guilabel> from the drop-down menu to open the <guilabel>Export Calendars</guilabel> form.
</para>
{docbook}

!images/export_calendars.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Enter the exported file name in the <guilabel>File Name</guilabel> field and select its format from the <guilabel>Export Format</guilabel> drop-down menu. At present, only the <guilabel>ICalendar(.ics)</guilabel> format is supported.</para>
{docbook}

{docbook}
<note>
<para>Your selected calendar cannot be exported if you untick the checkbox next to its display name.
</para>
</note>
{docbook}

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click <guibutton>Save</guibutton> to finish your export.
</para>
{docbook}

{docbook}
<note>
    <para>
    You can only open the exported file if you have an application installed on your device that supports its format.
    </para>
</note>
{docbook}

{docbook}
<citetitle>
<para xml:id="Import_calendar">
<emphasis role="bold">Import a calendar</emphasis>
</para>
</citetitle>
{docbook}

This function allows you to import one or more calendars stored in a file from your device to a selected calendar in the *Calendar* application.

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Calendar</guilabel> form via one of the following ways.
</para>
{docbook}

*The first way*

{docbook}
<para>Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject>
at the right top of the calendars list, then select <guilabel>Import</guilabel> from the drop-down menu.</para>
{docbook}

*The second way*

*i.* Hover your cursor over the personal calendar group which you want to import, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
 <emphasis role="bold">ii.</emphasis> Click <guilabel>Import</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<note>
<para>This way is only activated for calendar groups under the <emphasis role="bold">Personal Calendars</emphasis> category.
</para>
</note>
{docbook}

*The third way*

*i.* Hover your cursor over the calendar which you want to import, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
<emphasis role="bold">ii.</emphasis> Click <guilabel>Import</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Calendar</guilabel> form will appear differently, depending on your selected way.</para>
{docbook}

!images/Import_calendar_form.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Select a format type from the <guilabel>Format</guilabel> drop-down menu. At present, the <emphasis role="bold">Calendar</emphasis> application only supports the <guilabel>.ics</guilabel> and <guilabel>.csv</guilabel> formats.</para>
{docbook}

{docbook}
 <para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Browse...</guibutton> or click directly the <guilabel>Upload Files</guilabel> field to open the <guilabel>File Upload</guilabel> form.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Select a file from your device, then click <guilabel>Open</guilabel> to upload your selected file.
</para>
{docbook}

* Click !images/Delete_icon_calendar.png|width="5mm" fo:scalefit="1" html:scalefit="0"! next to the name of your uploaded file if you want to remove it and upload again.

{docbook}
<para>
          <emphasis role="bold">5.</emphasis> Click <inlinemediaobject>
            <imageobject role="fo">
              <imagedata fileref="images/down_arrow_icon1.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
            <imageobject role="html">
              <imagedata fileref="images/down_arrow_icon1.png" format="PNG" scalefit="0" width="4mm"/>
            </imageobject>
          </inlinemediaobject> next to the <guilabel>Import To</guilabel> field, then select the calendar to which you want to import your uploaded file from the drop-down list.
      </para>
{docbook}

{docbook}
<itemizedlist>
          <listitem>
            <para>Also, you can create a totally new calendar to which your uploaded file will be imported by clicking <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject>. The <guilabel>Calendar</guilabel> form now turns into the below form.</para>
          </listitem>
</itemizedlist>
{docbook}

!images/Import_calendar_form1.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*i.* Create the new calendar by following similar steps as stated in the [Create a personal calendar|#Create_personal_calendar] section.
{docbook}
<itemizedlist>
          <listitem>
            <para>If you select another calendar of the <guilabel>Group Calendar</guilabel> type, the <guilabel>Edit Permission</guilabel> field will appear right under the <guilabel>Groups</guilabel> field. For more details, see <link linkend="Grant_Edit_Permission">here.</link>
            </para>
          </listitem>
</itemizedlist>
{docbook}

*ii.* Click !images/subtract_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to narrow the form which allows you to import your uploaded file to either of existing calendars.

{docbook}
<para>
<emphasis role="bold">6.</emphasis> Click <guibutton>Save</guibutton> to complete.
</para>
{docbook}
h1. Share a personal calendar {anchor:id="CSUser_guide.How_to_use_Calendar.Share_calendarRoleNotInToc"}

This function allows you to share your personal calendar with other users, so that they can participate in all activities of this calendar.

You can set permissions on your shared calendar to two levels:

* *View permission* allows shared users to view the shared calendar and its events/tasks, but cannot change any information. It means that the shared users cannot add/edit/delete events or tasks, or edit, import and export the shared calendar.

* *Edit permission* allows shared users to view, import and export the shared calendar or add, edit, delete events/tasks inside the shared calendar. However, you cannot edit detailed information of a shared calendar, such as its display name.

{docbook}
<note>
<para>
If other users share their calendars with you, you will see shared calendars in the <emphasis role="bold">Shared Calendars</emphasis> category.
</para>
</note>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Share a personal calendar</emphasis>
</para>
</citetitle>
{docbook}

*1.* Hover your cursor over the calendar which you want to share, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click <guilabel>Share</guilabel> from the drop-down menu to open the <guilabel>Share Calendar</guilabel> form.</para>
{docbook}

!images/share_calendar.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Calendar Name</guilabel>
                </entry>
                <entry>The name of the calendar which you have selected to share.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>User Name</guilabel>
                </entry>
                <entry>The name of the users with whom you want to share your calendar.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Group</guilabel>
                </entry>
                <entry>The name of the groups with whom you want to share your calendar.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Edit Permission</guilabel>
                </entry>
                <entry>This option allows granting the edit permission on the calendar to the selected users/groups.</entry>
              </row>
            </tbody>
          </tgroup>
</informaltable>
{docbook}

*3.* Select users or groups by manually entering the correct names into the textboxes;

Or, click !images/user_selector_icon.png|width="9" fo:scalefit="1" html:scalefit="0"! or !images/group_selector_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to open the forms to select users or groups respectively.

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click the <guilabel>Edit Permission</guilabel> checkbox if you want to grant the <guilabel>Edit</guilabel> permission to your selected users/groups.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">5.</emphasis> Click <guibutton>Save</guibutton> to accept sharing your personal calendar.</para>
{docbook}

{note}
* If you select to share with any group, you will see a popup showing the sharing process:

!images/Share_calendar_popup.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

* You cannot abort your sharing till the process is finished.
{note}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Share a calendar using iCal</emphasis>
</para>
</citetitle>
{docbook}

iCal provides a link that allows users to download a _\*.ics_ file which contains all events and tasks of a calendar. iCal is supported by many popular products, such as Microsoft Outlook, Google Calendar, Apple iCal.

* *Public URL*: The Public URL link allows you to share your calendar with other users. They do not need to have Calendar accounts to download the file, but they must use a calendar application which supports the .ics to open and view it. By default, Public URL is empty and it is only accessible when public access is explicitly enabled.

* *Private URL*: iCal is used for personal use. It means that as the creator of the calendar, you can download it to your computer and use any calendar applications which support .ics format to open it. You can also import it into another calendar.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Get the link to download iCal</emphasis>
</para>
</citetitle>
{docbook}


*1.* Hover your cursor over the calendar which you want to get iCal, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
 <emphasis role="bold">2.</emphasis> Click <guilabel>Edit</guilabel> from the drop-down menu to open the <guilabel>Calendar</guilabel> form.
</para>
{docbook}

!images/calendar_detail.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

*3.* Get a Public URL or Private URL by clicking !images/ICAL_icon.png|width="15" fo:scalefit="1" html:scalefit="0"!. For Public URL, you must assure that the iCal is public. If it is not public, simply click the "Disable Public Access" link.

{docbook}
<para>One <guilabel>Calendar Feed</guilabel> form will pop up.</para>
{docbook}

!images/calendar_feed.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
 <emphasis role="bold">4.</emphasis> Copy the link in the <guilabel>Calendar Feed</guilabel> form, then send it to another users. The shared users can use this link to download the <emphasis role="italic">.ics</emphasis> file which can be opened in popular calendar applications, such as Microsoft Outlook, Google Calendar, Apple iCal.
</para>
{docbook}

h1. Schedule an event {anchor:id="CSUser_guide.How_to_use_Calendar.Schedule_eventRoleNotInToc"}

{anchor:id="CSUser_guide.How_to_use_Calendar.View_event_details"}
Before learning to schedule an event, you should know how to view an event of a specific calendar with its details:

*The first way*

Hover your cursor over the event to see its detailed view.

!images/view_detailed_event.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*The second way*

{docbook}
<para>Right-click the event in the <guilabel>Calendar View pane</guilabel>, then select <guilabel>View</guilabel> from the drop-down menu.</para>
{docbook}

!images/view_detailed_event2.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <emphasis role="bold">Preview</emphasis> form will appear.</para>
{docbook}

!images/event_preview_form.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>At the <guilabel>Preview</guilabel> form, if the event includes attachments, you can download them by directly clicking its title. If the attachment is an image, you can also click <guilabel>View</guilabel> to preview it.</para>
{docbook}

h2. Create a new event {anchor:id="CSUser_guide.How_to_use_Calendar.Create_new_event"}
h3. Quick add an event {anchor:id="Quick_add_events"}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Quick Add Event</guilabel> form via either of 4 ways:
</para>
{docbook}

*The first way*

Click !images/event_button.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the toolbar.

!images/add_event_calendar.png|align="center" width="150mm"  fo:scalefit="1" html:scalefit="0"!

*The second way*

{docbook}
<para>Right-click the <emphasis role="bold">Calendar View pane</emphasis>, then select <guilabel>Add New Event</guilabel> from the drop-down menu.</para>
{docbook}

!images/add_new_event.png|align="center" width="150mm"  fo:scalefit="1" html:scalefit="0"!

*The third way*

*i.* Hover your cursor over the calendar which you want to add new events, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
<emphasis role="bold">ii.</emphasis> Click <guilabel>Add Event</guilabel> from the drop-down menu.
</para>
{docbook}

*The forth way*

Click the appropriate time slot in the calendar view pane. Drag your cursor to alter the length of the event. For more details, see the [Drag and drop an event|#Drag_drop_event] section.

{docbook}
<para>The <guilabel>Quick Add Event</guilabel> form will appear.</para>
{docbook}

!images/quick_add_event.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry>Field</entry>
                    <entry>Description</entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry>
                      <guilabel>Event Summary</guilabel>
                    </entry>
                    <entry>The event title which is required.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Description</guilabel>
                    </entry>
                    <entry>The detailed description of the event.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>From</guilabel>
                    </entry>
                    <entry>The starting time of the event.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>To</guilabel>
                    </entry>
                    <entry>The ending time of the event.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>All Day</guilabel>
                    </entry>
                    <entry>If the event does not have a specific time, select the <guilabel>All Day</guilabel> option. This option allows setting the event duration to be all day or not. If you do not check this option, you have to define the starting date/time and ending date/time. By default, the starting date and ending date is the current date. </entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Calendar</guilabel>
                    </entry>
                    <entry>The calendar which contains the event.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Event Category</guilabel>
                    </entry>
                    <entry>The category which contains the event. </entry>
                  </row>
                </tbody>
              </tgroup>
</informaltable>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Give information for your event. Click <guilabel>More Details</guilabel> to show the event in more details that allows you to define more properties of the event.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to complete.
</para>
{docbook}

h3. Add a detailed event {anchor:id="Add_detailed_events"}

With a detailed event, you can:

* Save time by [creating a recurring event|#Create_recurring_event] rather than entering each instance separately.
* [Create a reminder for upcoming events|#Create_event_reminder] with your own notification settings.
* [Add participants to an event|#Invite_people_to_event].
* [View the availability time of participants|#View_time_availability].

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add a detailed event</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Open the <emphasis role="bold">
                <link linkend="Quick_add_events">Quick Add Event</link>
              </emphasis> form, then click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/more_details_button.png" format="PNG" scalefit="1" width="15mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/more_details_button.png" format="PNG" scalefit="0" width="15mm"/>
                </imageobject>
              </inlinemediaobject> to open the <guilabel>Add/Edit Event</guilabel> form.
</para>
{docbook}

!images/Add_event_detailed_tab.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

*2.* Give details of your event in fields of tabs.

{docbook}
<para>
<emphasis role="bold">i.</emphasis> In the <guilabel>Detail</guilabel> tab, you can:
</para>
{docbook}

{docbook}
<itemizedlist>
              <listitem>
                <para>Follow similar steps as stated in the <emphasis role="bold">
                    <link linkend="Quick_add_events">Quick Add Event</link>
                  </emphasis> section.</para>
              </listitem>
              <listitem>
                <para>Also,  </para>
                <itemizedlist>
                  <listitem>
                    <para>Enter the location name where the event will take place in the <guilabel>Location</guilabel> field.</para>
                  </listitem>
                  <listitem>
                    <para>Select the priority level of this event, including None, Normal, High and Low, in the <guilabel>Priority</guilabel> field.</para>
                  </listitem>
                  <listitem>
                    <para>Tick the <guilabel>Repeat</guilabel> checkbox if you want to create a recurring event. For more details, see the <link linkend="Create_recurring_event">Create a recurring event</link> section.</para>
                  </listitem>
                  <listitem>
                    <para>Click <inlinemediaobject>
                        <imageobject role="fo">
                          <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                        </imageobject>
                        <imageobject role="html">
                          <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                        </imageobject>
                      </inlinemediaobject> to open the <guilabel>Attach Files</guilabel> form if you want to attach any files, such as map, or invitation card, with your event.</para>
                  </listitem>
                </itemizedlist>
              </listitem>
            </itemizedlist>
{docbook}

{docbook}
<para>
 <emphasis role="bold">ii.</emphasis> In the <guilabel>Reminders</guilabel> tab, you can create a reminder for your event. For more details, see the <link linkend="Create_event_reminder">Create a reminder for upcoming events</link> section.</para>
{docbook}

{docbook}
<para>
 <emphasis role="bold">iii.</emphasis> In the <guilabel>Participants</guilabel> tab, you can add participants to your event by selecting the system users or contacts from your Address Book. For more details, see the <link linkend="Invite_people_to_event">Add participants to an event</link> section.</para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">iv.</emphasis> In the <guilabel>Schedule</guilabel> tab, you can view the availability time of users, or change date and time for your event and apply them into the <guilabel>Details</guilabel> tab. For more details, see the <link linkend="View_time_availability">View the availability time of participants</link> section.
  </para>
{docbook}

{docbook}
<para>
  <emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to finish creating your detailed event.
</para>
{docbook}

{docbook}
<para>
There will be a confirmation message. Click <guibutton>Save and Send</guibutton> to save and send the invitation, or <guibutton>Save</guibutton> to only save.
</para>
{docbook}


You will see the event updated in your Activity Stream of your Space or Group Space.

!images/activity_stream.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

The event will be updated in your *Activity Stream* with its brief information, such as description, location, start time and end time. You can even deny or accept participating in this event directly in *Activity Stream* without going to the *Calendar* application.

{docbook}
<citetitle>
<para xml:id="Create_recurring_event">
<emphasis role="bold">Create a recurring event</emphasis>
</para>
</citetitle>
{docbook}


{docbook}
<para>In the <guilabel>Detail</guilabel> tab, tick the <guilabel>Repeat</guilabel> checkbox to open the <guilabel>Repeating event</guilabel> form.</para>
{docbook}

!images/Repeat_event_form.png|align="center" width="90mm"  fo:scalefit="1" html:scalefit="0"!

Here, you can define the repeating time for your event as follows:

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Select the type for your repeating event from the <guilabel>Repeat</guilabel> option.
</para>
{docbook}

{docbook}
           <itemizedlist>
              <listitem>
                <para>
                  <guilabel>Daily:</guilabel> The event will be repeated every day.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Weekly:</guilabel> The event will be repeated every week.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Monthly:</guilabel> The event will be repeated every month.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Yearly:</guilabel> The event will be repeated every year.</para>
              </listitem>
            </itemizedlist>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Select the frequency for repeating your event in the <guilabel>Repeat Every</guilabel> option. The selected frequency will work on the <guilabel>Repeat</guilabel> value.  For example, if you set <guilabel>Weekly</guilabel> in the <guilabel>Repeat</guilabel> option and <emphasis role="bold">5</emphasis> in the <guilabel>Repeat every</guilabel> option, the event will be repeated every 5 weeks.</para>
{docbook}


*3.* Select the option for ending your repeating event by ticking the relevant checkbox.
{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>Never</guilabel>: Your repeating event will never end.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>After [X] occurrences</guilabel>: Your repeating event will end after X occurrences.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>By this date</guilabel> Your repeating event will end before your specified date. Point your cursor over the textbox and select the date from the drop-down calendar.</para>
              </listitem>
</itemizedlist>
{docbook}

{docbook}
<citetitle>
<para xml:id="Create_event_reminder">
<emphasis role="bold">Create a reminder for upcoming events</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>The <emphasis role="bold">Calendar</emphasis> application provides 2 options for reminding users who will take part in events. A reminder includes the summary information of the event, such as title, time and location. To use this feature, go to the <guilabel>Reminders</guilabel> tab. </para>
{docbook}

!images/add_edit_event.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>Remind by Email:</guilabel> This option is to remind users of upcoming events via emails. This option is set default. If you do not use this option, simply untick the checkbox.</para>
              </listitem>
</itemizedlist>
{docbook}
{docbook}
<informaltable>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry>Field</entry>
                    <entry>Description</entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry>
                      <guilabel>Send an mail before the event starts in</guilabel>
                    </entry>
                    <entry>The interval time that the reminder will be repeated before an event starts.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Repeat</guilabel>
                    </entry>
                    <entry>Tick the checkbox to set the frequency for sending the email reminder before the event takes place.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Also send reminders to</guilabel>
                    </entry>
                    <entry>The list of email addresses to which the reminder will be sent. The default value is the email address of the event creator. Click <inlinemediaobject>
                        <imageobject role="fo">
                          <imagedata fileref="images/Add_more_button1.png" format="PNG" scalefit="1" width="17mm"/>
                        </imageobject>
                        <imageobject role="html">
                          <imagedata fileref="images/Add_more_button1.png" format="PNG" scalefit="0" width="17mm"/>
                        </imageobject>
                      </inlinemediaobject> to add more email addresses. To delete an email address, simply click <inlinemediaobject>
                        <imageobject role="fo">
                          <imagedata fileref="images/Delete_icon_calendar.png" format="PNG" scalefit="1" width="5mm"/>
                        </imageobject>
                        <imageobject role="html">
                          <imagedata fileref="images/Delete_icon_calendar.png" format="PNG" scalefit="0" width="5mm"/>
                        </imageobject>
                      </inlinemediaobject> corresponding to it. </entry>
                  </row>
                </tbody>
              </tgroup>
</informaltable>
{docbook}

{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>Show a notification pop-up:</guilabel> This option is to remind users of upcoming events via pop-up messages.</para>
              </listitem>
 </itemizedlist>
{docbook}
{docbook}
<informaltable>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry>Field</entry>
                    <entry>Description</entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry>
                      <guilabel>When the event starts in next</guilabel>
                    </entry>
                    <entry>The interval time that the pop-up reminder will be repeated before the event starts.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Repeat</guilabel>
                    </entry>
                    <entry>Tick the checkbox to set the frequency for sending the pop-up message before the event takes place.</entry>
                  </row>
                </tbody>
              </tgroup>
            </informaltable>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add more emails</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/Add_more_button1.png" format="PNG" scalefit="1" width="12mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/Add_more_button1.png" format="PNG" scalefit="0" width="12mm"/>
                </imageobject>
              </inlinemediaobject> to open the <guilabel>Select an Email</guilabel> form.</para>
{docbook}

*2.* Tick checkboxes corresponding to email addresses you want to select;

{docbook}
<para>Or, use the <emphasis role="bold">Search</emphasis> function to search for your expected email addresses. Also, to narrow your search results, select the address book where you want to perform your search from the <guilabel>Address Books</guilabel> drop-down menu. </para>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Add</guibutton> to add your selected emails, or click <guibutton>Replace</guibutton> to replace existing emails with your selected emails.</para>
{docbook}

{docbook}
<para>The list of your selected email addresses are displayed right below the <guilabel>Also send reminders to</guilabel> field of the <guilabel>Reminders</guilabel> tab.</para>
{docbook}

{docbook}
<citetitle>
<para xml:id="Invite_people_to_event">
<emphasis role="bold">Add participants to an event</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>If you want to invite people to attend an event, go to the <guilabel>Participants</guilabel> tab. This tab contains options to add participants and to send invitation mails.</para>
{docbook}

!images/add_edit_event_participant_tab.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Select the privacy of your event by ticking the <guilabel>Private</guilabel> or <guilabel>Public</guilabel> checkbox. At present, public or private has informative meaning only.</para>
{docbook}

*2.* Set the status of participants during the time when your event takes place.

{docbook}
<itemizedlist>
              <listitem>
                <para>If <guilabel>Busy</guilabel> or <guilabel>Outside</guilabel> is ticked, the time when the participants take part in the event/task will be in red when viewing the event/task schedule. </para>
              </listitem>
              <listitem>
                <para>If <guilabel>Available</guilabel> is ticked, the time when the participants take part in the event/task will be in white.</para>
              </listitem>
</itemizedlist>
{docbook}

{docbook}
<para>
              <emphasis role="bold">3.</emphasis> Select participants who will take part in the event by clicking <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> to open the <guilabel>Invitations</guilabel> form.</para>
{docbook}

Here, you can select contacts from your Address Book or users who have registered in the system as follows:

*i.* Click !images/address_book_icon.png|width="3mm" fo:scalefit="1" html:scalefit="0"! or !images/user_selector_icon.png|width="3mm" fo:scalefit="1" html:scalefit="0"! respectively.

{docbook}
<para>
<emphasis role="bold">ii.</emphasis> Select your desired contacts/users by ticking the checkboxes, or do the <emphasis role="bold">Search</emphasis> function to find out your contacts/users quickly. Then, click <guibutton>Add</guibutton> to add your selected contacts/users to the <guilabel>Participants</guilabel> pane.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">iii.</emphasis> Enter your invitation message into the <guilabel>Invitation Message</guilabel> pane.
</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">iv.</emphasis> Click <guibutton>Save</guibutton> to add your selected contacts/users to the <guilabel>Participants</guilabel> table.</para>
{docbook}

{docbook}
<itemizedlist>
              <listitem>
                <para>If the <guilabel>Invitation Sent</guilabel> checkbox is ticked, participants will receive invitations via emails. Your selected participants will be updated in the the <guilabel>Participant</guilabel> table. Their statuses, which may be <guilabel>Yes</guilabel>, <guilabel>No</guilabel> or <guilabel>Pending</guilabel>, are listed in the <guilabel>Status</guilabel> column. These statuses depend on the participants' confirmation when they receive invitations: <guilabel>Yes</guilabel>, <guilabel>No</guilabel> or <guilabel>Not sure</guilabel>.</para>
                <itemizedlist>
                  <listitem>
                    <para>If the participants answer <guilabel>Yes</guilabel>, their statuses will be <guilabel>Yes</guilabel>. It means that the participants accept to join the event.</para>
                  </listitem>
                  <listitem>
                    <para>If the participants answer <guilabel>No</guilabel>, their statuses will be <guilabel>No</guilabel>. It means that the participants will not join the event.</para>
                  </listitem>
                  <listitem>
                    <para>If the participants answer <guilabel>Not sure</guilabel>, their statuses will be <guilabel>Pending</guilabel>. It means that the participants have not decided to take part in the event or not yet. </para>
                  </listitem>
                  <listitem>
                    <para>Click <inlinemediaobject>
                        <imageobject role="fo">
                          <imagedata fileref="images/Delete_icon.png" format="PNG" scalefit="1" width="4mm"/>
                        </imageobject>
                        <imageobject role="html">
                          <imagedata fileref="images/Delete_icon.png" format="PNG" scalefit="0" width="4mm"/>
                        </imageobject>
                      </inlinemediaobject> in the <guilabel>Action</guilabel> bar to remove one participant from the <guilabel>Participants</guilabel> list.</para>
                  </listitem>
                </itemizedlist>
              </listitem>
            </itemizedlist>
{docbook}

*4.* Tick one checkbox corresponding to your desired option of sending invitations to participants in the *Invitations sent*. This option is loaded by default with the value defined in the Calendar Settings.


{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>Never</guilabel>: Never send the invitation to any participants.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Always</guilabel>: Automatically send the invitation to the participants.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Asked</guilabel>: There will be a confirmation message for you to select.</para>
              </listitem>
</itemizedlist>
{docbook}

The participants will receive an invitation mail, for example with the following content, which allows you to import the event directly into their calendars. {anchor:id="Mail.Accept_deny_import_event"}

!images/invitation_mail.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>Agree and Import</guilabel>: Accept attending at the event in the invitation mail and importing it into the calendars to remind them of this event.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Yes</guilabel>: Accept attending at the event without importing it into the calendar.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>No</guilabel>: Refuse to attend at the event.</para>
              </listitem>
</itemizedlist>
{docbook}


{docbook}
<citetitle>
<para xml:id="View_time_availability">
<emphasis role="bold">View the availability time of participants</emphasis>
</para>
</citetitle>
{docbook}

!images/add_edit_event_schedule.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>Go to the <guilabel>Schedule</guilabel> tab to check the availability of the participants in a defined slot time. By default, it is the start and end time of the event which you define in the <guilabel>Detail</guilabel> tab.  You can easily detect the schedule conflicts to manage the alternate meeting time that works best for all participants.  </para>
{docbook}

{docbook}
<note>
<para>This function is only for checking the availability of participants, who are the system users. It means that you cannot see the availability of participants who are selected from your <emphasis role="bold">Address Book</emphasis>.
</para>
</note>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add participants</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/add_selector_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/add_selector_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> in the left pane to select users from the <guilabel>Select Users</guilabel> form.</para>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Delete participants</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>Tick the checkboxes corresponding to users in the <emphasis role="bold">Participants</emphasis> list, then click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/delete_selector_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/delete_selector_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject>. The deleted users will be removed from the participants list of both <guilabel>Schedule</guilabel> and <guilabel>Participants</guilabel> tabs.</para>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Apply selected date</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<note>
<para>It is required to have at least 1 user in the <emphasis role="bold">Participants</emphasis> list.
</para>
</note>
{docbook}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Enter the time manually into the <guilabel>From</guilabel> and <guilabel>To</guilabel> fields;</para>
{docbook}

{docbook}
<para>Or, tick the <guilabel>All Day</guilabel> checkbox if your event will be hold for all day;</para>
{docbook}

{docbook}
<para>Or, hover your cursor over the time pane to visually select the available time of users. The selected period will become green and the corresponding time will be automatically updated into the <guilabel>From</guilabel> and <guilabel>To</guilabel> fields.</para>
{docbook}

{docbook}
<note>
<para>If you do not see any available time for your selected date in the time pane, you can switch to another dates by clicking
<inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/Left_arrow_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
          </inlinemediaobject>/
		  <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/Right_arrow_icon.png" format="PNG" scalefit="1" width="4mm"/>
            </imageobject>
          </inlinemediaobject> to check another time availability of users.
</para>
</note>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click the <guilabel>Apply Selected Date</guilabel> checkbox to accept applying the selected date and time into the <guilabel>Detail</guilabel> tab. </para>
{docbook}

h2. Edit an event {anchor:id="CSUser_guide.How_to_use_Calendar.Edit_event}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Add/Edit Event</guilabel> form by doing one of two following ways:</para>
{docbook}

*The first way*

Double-click the event you want to edit.

*The second way*

{docbook}
<para>Right-click the event that you want to edit and select <guilabel>Edit</guilabel> from the drop-down menu.</para>
{docbook}

!images/Edit_event_menu.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <guilabel>Add/Edit Event</guilabel> form is displayed with information that is similar when adding your event.</para>
{docbook}

*2.* Edit information of the selected event to your desires.

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to complete.</para>
{docbook}

{docbook}
<note>
    <para>
    For shared and group calendars, you can only edit their events if you have the edit permission.
    </para>
</note>
{docbook}

{docbook}
<tip>
    <para>
    When editing an event, you can add/remove the attachment files or download them by directly clicking their titles.
    </para>
    <para>
    If you only want to change the starting date and time of the event, you can also use the drag-and-drop feature to edit the time for the event directly on the <emphasis role="bold">Calendar View pane</emphasis>.
    </para>
</tip>
{docbook}

h2. Drag and drop an event {anchor:id="Drag_drop_event"}
The drag-and-drop feature helps you change the starting date and time of an event more conveniently. You only need to click the event, drag and drop it into another date or new time area in the *Calendar View pane*.

You also can hover your cursor over the *Scroll* button to alter the event period.


!images/drag_mouse.png|align="center" width="70mm"  fo:scalefit="1" html:scalefit="0"!

According to the features of the Calendar pane view, the drag-and-drop feature can be applied to the date and time differently.

{docbook}
<itemizedlist>
            <listitem>
              <para>In the <guilabel>Day</guilabel> view, all events are shown in a day, so you can change the time of the event in one day only.</para>
            </listitem>
            <listitem>
              <para>In the <guilabel>Week</guilabel> and <guilabel>Work Week</guilabel> views, all events are shown in a week, so you can change both the event time and the event date.</para>
            </listitem>
            <listitem>
              <para>In the <guilabel>Month</guilabel> view, all events are shown in a month, so you can change the event date only. You can also change more events at the same time by ticking their checkboxes and using the drag-and-drop feature.</para>
            </listitem>
</itemizedlist>
{docbook}

{docbook}
<note>
    <para>
    For shared and group calendars, you can only drag and drop their events if you have the <emphasis role="bold">Edit</emphasis> permission on these calendars. If you drag and drop an event of one calendar on which you do not have the edit permission, you will get a warning message.
    </para>
</note>
{docbook}

h2. Export/Import an event {anchor:id="CSUser_guide.How_to_use_Calendar.Export_import_event}

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Export_event">
<emphasis role="bold">Export an event</emphasis>
</para>
</citetitle>
{docbook}

This function allows you to export one event into a file on your device. This file can be imported to use in another *Calendar* application.

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Right-click the event that you want to export, then select <guilabel>Export</guilabel> from the drop-down menu.</para>
{docbook}

!images/export.png|align="center" width="60mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <guilabel>Export Calendars</guilabel> form will appear.</para>
{docbook}

!images/export_calendar_form.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*2.* Enter a file name, and select the export format.

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to accept exporting the event.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to save the exported file into your device.</para>
{docbook}

{docbook}
<note>
    <para>
    In fact, exporting an event means exporting a calendar with one event only. Therefore, the exported file format and the way to export an event is similar to the way to export a calendar with multiple events and tasks.
    </para>
</note>
{docbook}

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Import_event">
<emphasis role="bold">Import an event</emphasis>
</para>
</citetitle>
{docbook}

You can import an event into a specific calendar. The process to import an event is similar to importing a calendar. For more details, see the [Import a calendar|#Import_calendar] section.

h2. Delete an event {anchor:id="CSUser_guide.How_to_use_Calendar.Delete_event"}
This function allows you to remove events from a calendar.

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Right-click the event you want to delete, then click <guilabel>Delete</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Delete an event in the Month view
</emphasis>
</para>
</citetitle>
{docbook}

*1.* Tick the checkboxes corresponding to the events you want to delete.

*2.* Click !images/delete_checked_button.png|width="12mm" fo:scalefit="1" html:scalefit="0"! on the *Month* information bar.

!images/month_view_calendar_panel.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

{docbook}
<note>
    <para>
    For shared and group calendars, you can only delete their events if you have the <emphasis role="bold">Edit</emphasis> permission on these calendars.
    </para>
</note>
{docbook}

h1. Schedule a task {anchor:id="CSUser_guide.How_to_use_Calendar.Schedule_taskRoleNotInToc"}

Before learning to schedule a task, you should know how to view a task with its details.

To view details of a task, do one of the following ways:

*The first way*

Hover your cursor over the task to open the task preview pane.

!images/view_tasks_details1.png|align="center" width="90mm" fo:scalefit="1" html:scalefit="0"!

*The second way*

{docbook}
<para>Right-click the task in the <emphasis role="bold">Calendar View pane</emphasis>, then select <guilabel>View</guilabel> from the drop-down menu.</para>
{docbook}

!images/view_tasks_details2.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>The <guilabel>Preview</guilabel> form will be displayed.</para>
{docbook}

!images/preview_task.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>At the <guilabel>Preview</guilabel> form, if the task includes attachments, you can download them by directly clicking its title. If the attachment is an image, you can also click <guilabel>View</guilabel> to preview it.</para>
{docbook}

h2. Create a new task {anchor:id="CSUser_guide.How_to_use_Calendar.Create_new_task"}
You have 2 ways to add a new task:

* [Quick add|#CSUser_guide.How_to_use_Calendar.Quick_add_task]: allows you to create the most basic event details.
* [Detailed add|#CSUser_guide.How_to_use_Calendar.Add_detailed_task]: allows you to create events with advanced details.

h3. Quick add a task {anchor:id="CSUser_guide.How_to_use_Calendar.Quick_add_task"}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Quick Add Task</guilabel> form via the following ways:</para>
{docbook}

*The first way*

Select !images/Task_button_icon.png|width="10mm" fo:scalefit="1" html:scalefit="0"! on the *Toolbar*.

*The second way*

{docbook}
<para> Right-click the <guilabel>Calendar View pane</guilabel>, then select <guilabel>Add New Task</guilabel> from the drop-down menu.</para>
{docbook}

!images/Quick_add_task_menu.png|align="center" width="150mm"  fo:scalefit="1" html:scalefit="0"!

*The third way*

*i.* Hover your cursor over the calendar which you want add tasks, then click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that appears.

{docbook}
<para>
 <emphasis role="bold">ii.</emphasis> Click <guilabel>Add Task</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
     <emphasis role="bold">2.</emphasis> Fill in fields of the <guilabel>Quick Add Task</guilabel> form. <anchor id="Step2_quick_add_task"/>
 </para>
{docbook}

!images/Quick_add_task_form.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry>Field</entry>
                    <entry>Description</entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry>
                      <guilabel>Task</guilabel>
                    </entry>
                    <entry>The name of the task.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Note</guilabel>
                    </entry>
                    <entry>The note of the task. </entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>From</guilabel>
                    </entry>
                    <entry>The starting date/time of the task.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>To</guilabel>
                    </entry>
                    <entry>The ending date/time of the task.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>All Day</guilabel>
                    </entry>
                    <entry>Tick the checkbox to set the task duration to be all day. If you do not check this option, you have to select the starting date/time and ending date/time. By default, the starting and ending dates are the current ones.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Calendar</guilabel>
                    </entry>
                    <entry>The calendar which includes the task.</entry>
                  </row>
                  <row>
                    <entry>
                      <guilabel>Task Category</guilabel>
                    </entry>
                    <entry>The category which includes the task.</entry>
                  </row>
                </tbody>
              </tgroup>
            </informaltable>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to finish creating your new task; or click <guilabel>More Details</guilabel> to open the <link linkend="CSUser_guide.How_to_use_Calendar.Add_detailed_task">Add a detailed task</link> form.</para>
{docbook}


h3. Add a detailed task {anchor:id="CSUser_guide.How_to_use_Calendar.Add_detailed_task"}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Quick Add Task</guilabel> form by following steps as stated in the <link linkend="CSUser_guide.How_to_use_Calendar.Quick_add_task">Quick add a task</link> section.</para>
{docbook}

{docbook}
<para>
              <emphasis role="bold">2.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/more_details_button.png" format="PNG" scalefit="1" width="17mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/more_details_button.png" format="PNG" scalefit="0" width="17mm"/>
                </imageobject>
              </inlinemediaobject> in the <guilabel>Quick Add Task</guilabel> form to open the <guilabel>Add/Edit Tasks</guilabel> form.</para>
{docbook}

!images/add_edit_tasks.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*3.* Give details of your task in the fields of tabs.

{docbook}
<para>
   <emphasis role="bold">i.</emphasis> In the <guilabel>Detail</guilabel> tab, you can:</para>
{docbook}

{docbook}
<itemizedlist>
              <listitem>
                <para>Follow the <link linkend="Step2_quick_add_task">Step 2</link> to provide basic information for your task.</para>
              </listitem>
              <listitem>
                <para>Also,</para>
                <itemizedlist>
                  <listitem>
                    <para>Select the user to whom you want to delegate the task in the <guilabel>Task Delegations</guilabel> tab. For more details, see the <link linkend="Assign_task_delegation">Assign a task delegation</link> section.</para>
                  </listitem>
                  <listitem>
                    <para>Select the priority level of the task from the <guilabel>Priority</guilabel> drop-down menu.</para>
                  </listitem>
                  <listitem>
                    <para>Select the category of the task from the <guilabel>Task Category</guilabel> drop-down menu. You can add a new category by clicking <inlinemediaobject>
                        <imageobject role="fo">
                          <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                        </imageobject>
                        <imageobject role="html">
                          <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                        </imageobject>
                      </inlinemediaobject>.</para>
                  </listitem>
                  <listitem>
                    <para>Select the status of the task from the <guilabel>Task Status</guilabel> drop-down menu: Need Action, In Process, Completed or Canceled.</para>
                  </listitem>
                  <listitem>
                    <para>Attach files to your task by clicking <inlinemediaobject>
                        <imageobject role="fo">
                          <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                        </imageobject>
                        <imageobject role="html">
                          <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                        </imageobject>
                      </inlinemediaobject>.</para>
                  </listitem>
                </itemizedlist>
              </listitem>
            </itemizedlist>
{docbook}

{docbook}
<para>
              <emphasis role="bold">ii</emphasis> In the <guilabel>Reminders</guilabel> tab, you can create one notification to remind you of your task. For more details, see the <link linkend="Create_task_reminder">Create a reminder</link> section.</para>
{docbook}

{docbook}
<para xml:id="Assign_task_delegation">
<citetitle><emphasis role="bold">Assign a task delegation</emphasis></citetitle>
</para>
{docbook}

{docbook}
<para>This function is done in the the <guilabel>Detail</guilabel> tab. To delegate a task to users, simply enter their names manually, or click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> to select users from the <guilabel>Select Users</guilabel> form.</para>
{docbook}

{docbook}
<para xml:id="Create_task_reminder">
<citetitle><emphasis role="bold">Create a reminder</emphasis></citetitle>
</para>
{docbook}

The reminder function is used to remind users of their tasks. A reminder includes the summary information of the task, such as title, time, and place where the task will happen.

{docbook}
<para>This function is done in the <guilabel>Reminders</guilabel> tab. To create a reminder for a task, see the <link linkend="Create_event_reminder">Create a reminder for upcoming events</link> section for more details. </para>
{docbook}

h2. Edit task details {anchor:id="CSUser_guide.How_to_use_Calendar.Edit_task_details}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Right-click the task you want to edit, then select <guilabel>Edit</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Add/Edit Tasks</guilabel> form will be displayed.</para>
{docbook}

!images/add_edit_tasks_details.png|align="center" width="130mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Modify the information of your selected task, then click <guibutton>Save</guibutton> to finish.</para>
{docbook}

{docbook}
<note>
    <para>
    For shared and group calendars, you can only edit their tasks if you have the <emphasis role="bold">Edit</emphasis> permission on these calendars.
    </para>
</note>
{docbook}


{docbook}
<tip>
    <para>
    When editing the task, you can add, remove or download attachments by directly clicking their titles.
    </para>
    <para>
     If you only want to change the starting date and time of the task, you can also use drag-and-drop feature to edit the time for the task directly on the <emphasis role="bold">Calendar View pane</emphasis>.
    </para>
</tip>
{docbook}


h2. Drag and drop a task {anchor:id="CSUser_guide.How_to_use_Calendar.Drag_drop_task}
Like dragging and dropping an event, *drag-and-drop* is a feature to change the starting date and time of a task conveniently. You only need to click and hold your cursor over the task, drag and drop it to a new day and a new time area in Calendar View pane.

{docbook}
<itemizedlist>
            <listitem>
              <para>To change a task duration (in the Day, Week and Work Week views only), point your cursor to the <guilabel>Scroll</guilabel> button at the bottom of the task and drag it.</para>
            </listitem>
            <listitem>
              <para>To change the date and time of a task, simply drag and drop the task to another area.</para>
              <itemizedlist>
                <listitem>
                  <para>In the <guilabel>Day</guilabel> view, all tasks are shown in 1 day, so you can change the task time in one day only.</para>
                </listitem>
                <listitem>
                  <para>In the <guilabel>Week</guilabel> and <guilabel>Work Week</guilabel> views, all tasks are shown in 1 week, so you can change both the task time and date.</para>
                </listitem>
                <listitem>
                  <para>In the <guilabel>Month</guilabel> view, all tasks are shown in 1 month, so you can change the task date only. You can also change the date for multiple tasks at the same time by ticking their checkboxes and using the drag-and-drop feature.</para>
                </listitem>
              </itemizedlist>
            </listitem>
</itemizedlist>
{docbook}

{docbook}
<note>
    <para>
    For shared and group calendars, you can only drag and drop their tasks if you have the <emphasis role="bold">Edit</emphasis> permission on these calendars. If you drag and drop the task that you do not have the <emphasis role="bold">Edit</emphasis> permission, you will receive a warning message informing that you are not allowed to edit this task.
    </para>
</note>
{docbook}

h2. Export/Import a task {anchor:id="CSUser_guide.How_to_use_Calendar.Export_import_task}

{docbook}
<note>
    <para>
    Exporting/Importing a task means exporting/importing a calendar with one task only. Therefore, the exported/imported file format and the way to export/import a task is similar to the way to export/import a calendar with multiple events and tasks.
    </para>
</note>
{docbook}

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Export_task">
<emphasis role="bold">Export a task</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Right-click the task that you want to export, then select <guilabel>Export</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>The <guilabel>Export Calendars</guilabel> form will appear.</para>
{docbook}

!images/export_calendars1.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*2.* Enter the file name and export format.

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to accept exporting the task. </para>
{docbook}

{docbook}
<para>
<emphasis role="bold">4.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to save the exported file into your local disk.</para>
{docbook}

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Import_task">
<emphasis role="bold">Import a task</emphasis>
</para>
</citetitle>
{docbook}

This function allows importing a task from your local device into a specific calendar. For more details, see the [Import Calendar|#Import_calendar] section.

h2. Delete a task {anchor:id="CSUser_guide.How_to_use_Calendar.Delete_task}
{docbook}
<para>
<emphasis role="bold">1.</emphasis> Right-click the task you want to delete, then click <guilabel>Delete</guilabel> from the drop-down menu.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click <guibutton>OK</guibutton> in the confirmation message to accept your deletion.</para>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">
Delete a task in the Month view
</emphasis>
</para>
</citetitle>
{docbook}

*1.* Tick the checkboxes corresponding to the task you want to delete, then click !images/delete_checked_button.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the *Month* information bar.

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click <guilabel>OK</guilabel> in the confirmation message to accept your deletion.</para>
{docbook}
{docbook}
<note>
    <para>
    For shared or group calendars, you can only delete their tasks if you have the <emphasis role="bold">Edit</emphasis> permission on these calendars.
    </para>
</note>
{docbook}

h1. Search for events/tasks {anchor:id="CSUser_guide.How_to_use_Calendar.Search_for_events_tasksRoleNotInToc"}
This function allows finding existing events/tasks according to specific search conditions easily. There are 2 search types: *Quick search* and *Advanced search*.

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Quick_search">
<emphasis role="bold">Perform a quick search</emphasis>
</para>
</citetitle>
{docbook}

This function allows you to do a quick search with specific keywords in all your events/tasks. All events/tasks having the text matching with your search term will be returned.

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Enter a word in the <guilabel>Search</guilabel> field at the right corner of the toolbar.</para>
{docbook}

!images/search_panel.png|align="center" width="50mm"  fo:scalefit="1" html:scalefit="0"!

*2.* Click !images/search_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to perform your search.

{docbook}
<citetitle>
<para xml:id="CSUser_guide.How_to_use_Calendar.Advanced_search">
<emphasis role="bold">Perform an advanced search</emphasis>
</para>
</citetitle>
{docbook}

This function allows you to make a search with multiple criteria.

*1.* Click !images/Advanced_search_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! next to the search box.

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Define your search criteria in the <guilabel>Advanced Search</guilabel> form.</para>
{docbook}

!images/Calendar_advanced_search.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*

{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Text</guilabel>
                </entry>
                <entry>The search term or keyword for searching.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Type</guilabel>
                </entry>
                <entry>The type you want to search with 3 options. If you leave this field "blank", both events and tasks are retrieved. If you select <guilabel>Task</guilabel>, you will see one more field named <guilabel>Task Status</guilabel> right after <guilabel>Category</guilabel>.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Calendar</guilabel>
                </entry>
                <entry>The calendar on which you want to perform your search. </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Category</guilabel>
                </entry>
                <entry>The category of event/task to conduct your search.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Task Status</guilabel>
                </entry>
                <entry> The status of the task: Need Actions, Completed, In Process, Canceled. </entry>
              </row>
              <row>
                <entry>
                  <guilabel>Priority</guilabel>
                </entry>
                <entry>The priority of your needed tasks/events: Normal, High or Low. If you leave <emphasis role="bold">blank</emphasis> in the field, your search will be done to all priority levels.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>From Date</guilabel>
                </entry>
                <entry> Only the events/tasks having 'To date' greater than or equal the date entered in the <guilabel>From Date</guilabel> field are listed in the results form. You can manually input or select the date from drop-down calendar.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>To Date</guilabel>
                </entry>
                <entry>Only the events/task having 'From date' less than or equal to the date entered  in the <guilabel>To date</guilabel> field are listed in the results form. You can input the date manually or select the date from the mini calendar.</entry>
              </row>
            </tbody>
          </tgroup>
</informaltable>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Search</guibutton> to perform your search. All events/tasks matching with your criteria will be listed in the results form.</para>
{docbook}

{docbook}
<note>
    <para>
    At the <guilabel>Search Result</guilabel> form, you can also view, edit or delete one event/task by right-clicking it and selecting one action from the drop-down menu.
    </para>
</note>
{docbook}

h1. More actions {anchor:id="CSUser_guide.How_to_use_Calendar.More_actionsRoleNotInToc"}

In Calendar, you can perform other actions that will help you take advantage of all Calendar productivity features. You can keep track of all events with RSS, change the Calendar settings to your own preferences or use categories to manage tasks and events.

h2. Generate RSS {anchor:id="CSUser_guide.How_to_use_Calendar.Generate_rss}
This function allows you to publish your calendar as an RSS feed. It will build a URL that helps you keep track of all events via the RSS reader.

{docbook}
<para>
<emphasis role="bold">1.</emphasis> Open the <guilabel>Feeds</guilabel> tab by following either of the ways:</para>
{docbook}

*The first way*

Click directly !images/RSS_icon2.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the toolbar.

*The second way*

{docbook}
<para>Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Settings_icon_calendar.png" format="PNG" scalefit="1" width="13mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Settings_icon_calendar.png" format="PNG" scalefit="0" width="13mm"/>
              </imageobject>
            </inlinemediaobject> on the toolbar to open the <guilabel>Calendar Settings</guilabel> form, then select the <guilabel>Feeds</guilabel> tab.</para>
{docbook}

!images/calendar_setting.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Click <guibutton>Add</guibutton> to open the <guilabel>Edit Feed</guilabel> form.</para>
{docbook}

!images/edit_feed.png|align="center" width="100mm"  fo:scalefit="1" html:scalefit="0"!

*Details:*
{docbook}
<informaltable>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry>Field</entry>
                  <entry>Description</entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry>
                    <guilabel>Name</guilabel>
                  </entry>
                  <entry>The name of the feed which is required.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>URL</guilabel>
                  </entry>
                  <entry>The link of the feed which is required.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Calendars</guilabel>
                  </entry>
                  <entry>The calendars into which your created feed is applied. </entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Add more</guilabel>
                  </entry>
                  <entry>Add the calendar that you want to get RSS feed.</entry>
                </row>
              </tbody>
            </tgroup>
</informaltable>
{docbook}

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Input the name of RSS in the <guilabel>Name</guilabel> field.</para>
{docbook}

{docbook}
<para>
            <emphasis role="bold">4.</emphasis> Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/generate_rss_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/generate_rss_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> to generate the RSS link. The URL will be automatically generated into the <guilabel>URL</guilabel> field. Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/reset_rss_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/reset_rss_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> to reset the RSS link.</para>
{docbook}

{docbook}
<para>
            <emphasis role="bold">5.</emphasis> Input the calendar name that you want to get the RSS feed in the <guilabel>Add more</guilabel> field, then click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject> to add your selected calendar.</para>
{docbook}

* Click !images/Delete_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! corresponding to the calendar name to delete your added calendar.

{docbook}
<para>
<emphasis role="bold">6.</emphasis> Click <guibutton>Save</guibutton> to accept generating the feed, then click <guibutton>OK</guibutton> in the notification message.</para>
{docbook}

The created feed will be shown like the illustration below.

!images/calendar_setting_feeds.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

* Here, you can get the RSS link by clicking !images/rss_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!. Copy and paste this address link into another Calendar products which support RSS to directly view this calendar in that application.

!images/calendar_feed1.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

h2. Edit Calendar settings {anchor:id="CSUser_guide.How_to_use_Calendar.Edit_calendar_settings}
In the *Calendar* application, you can change default values for its settings.

{docbook}
<para>
  <emphasis role="bold">1.</emphasis> Open the <guilabel>Calendar Settings</guilabel> form via either of the following ways:</para>
{docbook}

*The first way*: Click !images/calendar_settings_button.png|width="13mm" fo:scalefit="1" html:scalefit="0"! on the *Toolbar*.

{docbook}
<para>
            <emphasis role="bold">The second way</emphasis>: Click <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Arrow_icon_calendar.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject>, then select <guilabel>Calendar Settings</guilabel> from the drop-down menu.</para>
{docbook}

!images/calendar_settings.png|align="center" width="40mm"  fo:scalefit="1" html:scalefit="0"!

*2.* Make changes on your calendar settings.

!images/settings_tab.png|align="center" width="120mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">i.</emphasis> In the <guilabel>Settings</guilabel> tab, you can change values in the following fields:</para>
{docbook}

{docbook}
<informaltable>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry>Field</entry>
                  <entry>Description</entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry>
                    <guilabel>View Type</guilabel>
                  </entry>
                  <entry>The view type of Calendar View Pane. You can define the default view type when you start the <emphasis role="bold">Calendar</emphasis> application (Day, Week, Work Week, Month, Year, List).</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Date Format</guilabel>
                  </entry>
                  <entry>The date format which is displayed in Calendar, such as Starting date, Ending date of events/tasks.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Time Format</guilabel>
                  </entry>
                  <entry>The time format which is displayed in Calendar, such as the time of Starting date, or Ending Date and the time displayed in Calendar View Pane.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Country (Language)</guilabel>
                  </entry>
                  <entry>The default geographical location displayed in Calendar.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Time Zone</guilabel>
                  </entry>
                  <entry>The default time zone displayed in Calendar. </entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Week Start On</guilabel>
                  </entry>
                  <entry>The first day of the week displayed in the <emphasis role="bold">Week</emphasis> and <emphasis role="bold">Work Week</emphasis> views.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Show Working Times</guilabel>
                  </entry>
                  <entry>Click the checkbox to display the working times when viewing the calendar. The working time can be defined by selecting Starting and Ending time.</entry>
                </row>
                <row>
                  <entry>
                    <guilabel>Send Event Invitations</guilabel>
                  </entry>
                  <entry>
                    <para>Tick one checkbox to set the default value for sending an email event invitation when you create an event. There are 3 options:<informalexample>
                        <informalexample/>
                      </informalexample>Never: The event invitation will not be sent to any participants.<informalexample>
                        <informalexample/>
                      </informalexample>Always: The event invitation will automatically be sent to the participants.<informalexample>
                        <informalexample/>
                      </informalexample>Asked: There will be a confirmation message to ask whether you want to send the invitation or not.</para>
                  </entry>
                </row>
              </tbody>
            </tgroup>
          </informaltable>
{docbook}

{docbook}
<para>
            <emphasis role="bold">ii.</emphasis> In the <guilabel>Displayed Calendars</guilabel> tab, you can define which calendars to be displayed in the <emphasis role="bold">Calendar</emphasis> application by simply ticking checkboxes.</para>
{docbook}

{docbook}
<para>
<emphasis role="bold">iii.</emphasis> In the <guilabel>Feeds</guilabel> tab, you can generate an RSS feed as stated in the <link linkend="CSUser_guide.How_to_use_Calendar.Generate_rss">Generate RSS</link> section.</para>
{docbook}

h2. Manage categories {anchor:id="CSUser_guide.How_to_use_Calendar.Manage_categories}
Categories are used to classify events and tasks. For example, you could use a 'Meeting' category for all meetings with your colleagues or customers in your company. By default, Calendar provides 5 available categories: Calls, Meeting, Holiday, Clients, Anniversary. You can add and view events/tasks in default categories. In addition, you also can edit, delete default categories or create new categories by yourself.

h3. Add a new category {anchor:id="CSUser_guide.How_to_use_Calendar.Add_new_category}

*1.* Click !images/add_category_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! at the right corner of the *Toolbar*.

!images/plus.png|align="center" width="50mm"  fo:scalefit="1" html:scalefit="0" !

{docbook}
<para>The <guilabel>Event Categories</guilabel> form will appear. <anchor id="Event_categories_form"/>
</para>
{docbook}

!images/event_categories_form.png|align="center" width="80mm"  fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">2.</emphasis> Enter the category name and its description in the <guilabel>Event Category</guilabel> and <guilabel>Description</guilabel> fields respectively, then click <guibutton>Save</guibutton> to finish.</para>
{docbook}

Your newly created category then appears in the Categories table.

h3. Edit/Delete a category {anchor:id="CSUser_guide.How_to_use_Calendar.Edit_delete_category}
This function allows you to change name and description of a selected category.

*1.* Click !images/add_category_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the information bar to open the [Event Categories form|#Event_categories_form].

*2.* Click !images/edit_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! or !images/Delete_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! corresponding to the category which you want to edit or delete respectively in the Categories table.

{docbook}
<para>
 <emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to finish editing/deleting your selected category.</para>
{docbook}

h1. Add My Agenda gadget to your page {anchor:id="CSUser_guide.How_to_use_Calendar.Agenda_gadgetRoleNotInToc"}

The *My Agenda* gadget is a utility associated with the *Calendar* application. This gadget is used for listing upcoming events and tasks from your personal calendar.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add My Agenda gadget to your Dashboard</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>
 <emphasis role="bold">1.</emphasis> Click the <emphasis role="bold">Add Gadgets</emphasis> link on your Dashboard to open the <guilabel>Gadget Directory</guilabel>.</para>
{docbook}

{docbook}
<para>
          <emphasis role="bold">2.</emphasis> Drag and drop the <guilabel>My Agenda</guilabel> gadget to you Dashboard. You can rearrange this gadget to get different layouts.</para>
{docbook}

!images/Gadget_Directory.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>You will see the <guilabel>My Agenda</guilabel> gadget in the Dashboard as below:</para>
{docbook}
!images/Agenda_gadget_sample.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<citetitle>
<para xml:id="Configure_the_Agenda_gadget">
<emphasis role="bold">
Configure the My Agenda gadget
</emphasis>
</para>
</citetitle>
{docbook}

*1.* Click !images/Calendar-gear-icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to open the *Agenda* gadget settings.

!images/Agenda_gadget_settings.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<informaltable>
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Field</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <guilabel>Number of Items to Display</guilabel>
                </entry>
                <entry> The maximum number of the events and tasks which will be shown.</entry>
              </row>
              <row>
                <entry>
                  <guilabel>Calendar</guilabel>
                </entry>
                <entry> Name of your personal calendar.</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
{docbook}

*2.* Select your desired preferences.

{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to accept your changes.</para>
{docbook}

{docbook}
<tip>
    <para>
     By clicking the <guilabel>Show My Calendars</guilabel> link, you will go to the Portal page that contains the <emphasis role="bold">Calendar</emphasis> application.
    </para>
</tip>
{docbook}


h1. Add My Tasks gadget to your page {anchor:id="CSUser_guide.How_to_use_Calendar.My_tasksRoleNotInToc"}
The *My Tasks* gadget is a utility associated with the *Calendar* application. This gadget is used for listing upcoming tasks of the current day from your personal calendar.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add My Tasks gadget to your Dashboard</emphasis>
</para>
</citetitle>
{docbook}

The procedure is similar to [adding Agenda gadget to your Dashboard|#CSUser_guide.How_to_use_Calendar.Agenda_gadget]
{docbook}
<para>You will see the <guilabel>My Tasks</guilabel> gadget in the Dashboard as below:</para>
{docbook}
!images/My_Tasks_gadget_sample.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!


