This article applies primarily to event display and modification on the public front-end of your Joomla web site. Users with access to the administrative back end will be able to view and modify all events without restriction.
Calendar and Category Permissions
JCal Pro® is designed with a redundant set of access controls that govern how calendars, categories and events are displayed on the public front end of the Joomla web site.
When a JCal Pro® view is requested (by clicking a JCal Pro® menu link or a link with JCal Pro® itself), the permissions of all calendars and categories are first queried. As described elsewhere in the user manual, calendars and categories can each be associated with a Joomla usergroup: Guest, Registered, Author, Editor, Publisher, Manager, Administrator and Super Administrator.
Depending on the status of the user, JCal Pro® then displays events in the appropriate calendars and categories such that all access controls are respected. For example, if an event is in a category that is restricted to Registered users, events in this category will only be shown if a Registered Users or a user in a higher user group is logged into the web site (i.e. the events will be hidden from Guests).
If an event is in a category that is restricted to Registered Users, and a calendar that is restricted to Managers, the access control of both the category and the calendar must be respected. Thus, these events will be will only be shown if a Manager or a user in a higher user group is logged into the web site (i.e. the events will be hidden from Guests, Registered Users, Authors, Editors and Publishers).
Event Modification Permissions
In JCal Pro®, users have the ability to modify and delete events on the front end of the Joomla web site. These privileges are assigned to specific Joomla usergroups (Guest, Registered, Author, Editor, Publisher, Manager, Administrator and Super Administrator) in the General Settings.
To edit an event on the front end, the modification permissions, calendar permissions and category permissions (above) must all be satisfied. For example, if event edits are restrited to Editors, then only this usergroup will be able to submit event edits (note that moderating changes to events is handled by seperate permissions), and these modifications will be restricted to events in calendas and categories available to Editors.
Similar restictions apply for deleting events, though this process is not moderated.
When a user creates a new event, this user is called the Event Owner. For public events, the event owner attribute is mostly ignored except in the administrative back end where events in the JCal Pro® Event Manager can be sorted by Event Owner.
The main benefit of of event ownership is the ability of Events Owners to create private events (see below).
When events are created, the are assigned one of three privacy settings that affect their visibility and modification on the front end of your Joomla web site:
- Public - these events are visible to Guests and all other Joomla usergroups (in accordance to the calendar and category permissions described above).
- Private - these events are only visible when the Event Owner is logged in. Private events are most commonly used when creating Private Calendars.
- Read-only Private - these events are are visible to Guests and all other Joomla usergroups (in accordance to the calendar and category permissions described above, but can only be edited on the front end by the event owner. Read-only Private events are useful when working in collaborative enviromments where multiple users have the abilty to submit and moderate events but require control over editing events.