VSys One: Volunteer Management Software

Custom Calendars

Custom calendars in VSys Live let you assemble your own calendars with multiple different types of events and one or more view types. Once created, a calendar is placed on a VSys Live page just like any other content. The most common usage for these is to have two on your VSys Live site: one as the organization calendar and one as the personal calendar.

On the organization calendar you'd most commonly include:

Calendar items
Holidays
Open job slots for main calendar

And on the personal calendar:

Assignments
Calendar items
Holidays
Interviews
Open job slots for main calendar
Trainings

Custom calendar content sources

`Anniversaries`	Anniversaries based on Date active or Date started for people who meet a source relationships rule below.
`Assignments`	Assignments for the logged-in person, for the volunteers supervised by the logged-in person, or both.
`Assignments by shared job associations`	Assignments for other volunteers where the logged-in person has a job association for that job.
`Birthdays`	Birthdays for people who meet a source relationships rule.
`Calendar items`	Calendar items for the current VSys Live site. Can be filtered by news/calendar item tags.
`Expiring attributes`	Expiring certifications and/or trainings for the logged-in person and/or people who meet a source relationships rule.
`Holidays`	Defined holidays.
`Interviews`	Scheduled interviews for the logged-in person and/or people who meet a source relationship rule.
`Job slots`	Job slots filtered by job, location and status; optionally only those supervised by the logged-in person.
`News items`	News items for the current VSys Live site. Can be filtered by news/calendar item tags and news feeds.
`Notifications`	Notifications for the logged-in person.
`Open job slots based on job associations`	Open job slots for which the logged-in person has a job association. Can optionally allow or disallow signup for a slot directly from this calendar item.
`Open job slots for main calendar`	Open job slots designated as Show on main calendar in VSys Live while volunteers still needed. Can optionally allow or disallow signup for a slot directly from this calendar item.
`Projects`	Defined projects, but only those designated as Show on VSys Live as a calendar item.
`Self-reminder`	Generally only for VSys One users, shows reminders that the user has created for herself.
`Trainings`	Trainings for the logged-in person, for those supervised by the logged-in person, or for people who meet a source relationships rule.

All of these items let you set the background and font colors for the items as displayed. You should use high-contrast color schemes when possible for legibility.

Some of these items may include options such as:

Include "send message" link: Optionally includes hyperlinks that, when clicked, send an e-mail to the selected person. The sender does not see the e-mail address of the recipient, but the recipient does see the sender's address and can respond directly back to that sender by e-mail.
Include cancel assignment link: If present and the volunteer is allowed to self-cancel the assignment, lets the volunteer do so and prompt for comments.
Exclude full family name: Use for birthdays, anniversaries, etc., especially on public calendars that don't require anyone to be logged in.
For: Lets you choose one or more source relationships from which to find the people eligible to be used for this content source.

Source relationships

Some of these content sources can include people based on "source relationships".

Source relationship	Logged in	Description
`People in specific groups and/or with specific types`		People who meet the criteria in this source.
`People in the same groups`	Only if logged in	People who are in the same groups as the logged-in person.
`By relationship`	Only if logged in	People who have the selected relationships to the logged-in person. You'd most commonly use this to list a team leader's members' assignments/etc.
`People on lists`		People on one or more of the selected list(s).
`People on the same lists`	Only if logged in	People on the same list(s) as the logged-in person.
`People in the same job associations`	Only if logged in	People who have one or more job associations in common with the logged-in person.

Example

In this example we have a calendar with eleven different content sources on it. Each of these content sources will generate items that get displayed on the actual calendar when used.

Description	Not shown anywhere in VSys Live, use for your own purposes
Display type	Always `FullCalendar`.
Inactive	Checking this prevent the calendar from actually displaying in VSys Live.
View modes	Select one or more modes here, which represent how the calendar is rendered in VSys Live. You'll probably want to experiment with the options to see how they appear with your data.
Default view mode	When the calendar is first shown, it will use this mode, and the volunteer can then select one of the others.
Previous months to include	In generating the contents for the calendar, VSys will look back this many months to determine which items to display. Loading and displaying content can be time-consuming so don't show too far back in the past.
Future months to include	VSys will look this far into the future when determining which items to display.
Maximum width	How wide the overall calendar can be allowed to display. Normally left at `0` (no limit).
Height	How tall the overall calendar can be allowed to display. Normally left at `0` (no limit).
Aspect ratio	Normally left at `0`.
Popup font size	In the popups that appear when someone holds their mouse over a calendar item, this is the default size of the font.
Popup max width	Limits how wide the popups can be.
Popup additional CSS	Any CSS you enter here will be applied to all popups.
Always show six weeks tall in month view	Some months need five rows to display, some need six. (In very rare cases February, when it starts on a Sunday, only needs four.) Check this box to cause the calendar to always use six rows.
Line wrap contents	The actual calendar items will line wrap (become taller as needed to include their content) if this is checked, otherwise they'll be only one line tall and truncate their content.

Example content source

In this example, we're showing assignments for other volunteers where the status is "Volunteer requests replacement" (Statuses) and the logged-in person has that same job association with the statuses Active, Other, Preference, Substitute or Supervisor.

The logged-in person can sign up for this opening (Include signup link if requesting replacement). Doing so changes the status of the existing volunteer's assignment to "Cancelled by volunteer".
The logged-in person can send the current volunteer an e-mail (Include "send message" link).
Only the first name and last initial, e.g. "John D", will be displayed (Exclude full family name).

Example source relationship

In this example we've defined a source relationship, i.e. a list of people who are eligible to be shown in a content source. This source relationship would be a common one to use for birthdays, letting the logged-in user see the birthdays of the people that he works with, and possibly send them an e-mail.

Privacy

A volunteer can "opt-out" of being shown on certain calendars that are shared automatically with others using the contact flag "No sharing calendar with other volunteers". This only affects content sources "Assignments by shared job associations" and source relationships "People in the same groups", "People on the same lists" and "People in the same job associations".