.. include:: Images.txt
.. _CreateCalendarCategories:

==========================
Create Calendar Categories
==========================

.. include:: ../../Includes.txt

For organizational purposes, it is recommended that you create categories for your events. These categories can be attached either to one of the calendars or to all of them. Refer to Illustration 20.

- **Category title:** This is the only required field.

|img-27|
**Illustration 20: Calendar Categories Record**

- **Hide:** Hiding the Category will hide the Category and all associated events.

- **Header Style:** You can assign each category a different colored bullet that precedes the events in the Month View and the Header colors in the Day and Week views. To use the out-of-the-box bullet colors, simply enter the corresponding style in the Header Style field:

::

   Blue Bullets:      default_catheader
   Green Bullets:     green_catheader
   Grey Bullets:        grey_catheader
   Orange Bullets:       orange_catheader
   Pink Bullets:       pink_catheader
   Red Bullets:  red_catheader
   Yellow Bullets:        yellow_catheader

- **Body Style:** You can assign each category a different colored “Busy Time” in the Day and Week views. To use the out-of-the-box Busy Time colors, simply enter the corresponding style in the Body Style field:

::

   Blue:            default_catbody
   Green:               green_catbody
   Grey:          grey_catbody
   Orange:         orange_catbody
   Pink:         pink_catbody
   Red:            red_catbody
   Yellow:          yellow_catbody



|img-4| **Note**: If you would like to expand or change the color choices, you can do so by modifying the default style sheet (see :ref:`ModifyingTheDefaultCss`).

|img-4| **Note**: Starting with version 1.2.0 there is the possibility to define the according colors for the header- & body style fields in the page TS config. Per default there is already:

::

   options.tx_cal_controller.headerStyles = default_catheader=#557CA3,green_catheader=#53A062,orange_catheader=#E84F25,pink_catheader=#B257A2,red_catheader=#D42020,yellow_catheader=#B88F0B,grey_catheader=#73738C

   options.tx_cal_controller.bodyStyles = default_catbody=#6699CC,green_catbody=#4FC464,orange_catbody=#FF6D3B,pink_catbody=#EA62D4,red_catbody=#FF5E56,yellow_catbody=#CCB21F,grey_catbody=#9292A1'

The syntax is: “css\_style=color”

As a result, you'll get a drop down box, to choose the according color.

- **Calendar:** Determines which calendar you want to display this category. By limiting the category to a specific calendar, you can limit users or usergroups who can view the category's events (see :ref:`UsingMultipleCalendars` in the Advanced section).

- **Parent category:** This is an optional field that is only available when the Nested Categories option is selected in the Configuration form (see :ref:`CalendarBaseConfiguration`). This option allows you to create the category as a sub-category if you choose. Simply click on the Item you want the category to be associated with.

- **Allow shared user to select this category:** When enabled, a corresponding check box will appear with each category in the Legend box that allows Frontend users to hide or view particular categories. Events that are not associated with any category will appear in the Frontend regardless of the Frontend Category options selected.