This is not full documentation by a long way but shouldhelp you get started with JEvens 1.5/2.0.

New Events Structure

In order to accomodate repeat exceptions, and iCal imports a whole new way of representing events has been implemented.  This follows the iCal model and you will see there is a whole new way of creating events.

ICal Subscriptions

You can either import or create 'calendars' (currently called 'iCal Subscriptions) in one of 3 ways:

  1. Importing from a URL
  2. Importing from a file on your local drive
  3. Created from scratch

Taking these in turn.  If you click on ical subscriptions and then click new you can try them out.

The "Unique Identifier" is just a label you will use to identify your calendar.

The "Category" is the category into which events in this calendar will be placed.

1. Importing from a URL

Calendars imported from a URL (i.e. from a Google Calendar) can be 'refreshed' at a later date.  You can reload the calendar whenever you want by clicking the green reload button in the list of ical subscriptions.

2. Importing from a File

Calendars imported from a local ical File.  These can not be refreshed after the initial import.

3. Native or Raw Calendars

These are empty calendars you create yourself.

Updating ALL iCal feeds at once

As of JEvents 3.1.9 we have incorperated a new feature to allow updating all iCal Subscriptions at once. The url would be:

http://yourdomain.com/index.php?option=com_jevents&task=icals.reloadall

JEvents - User authorisation

We have implemented a more advanced user authorisation mechanism in JEvents 1.5/2.0.  If you click the "configuration" button in the admin view of the component you can specify if you want to enable "user by user" authorisation or general user level authorisation.  If you choose to enable "User Authorisation" you will need to assign authorisation to speficic users to enable them to manage events in the front end of the site.  Remember if you enable "user authorisation" any users who will be able to create events will need to be added to the list of authorised users - not even "Super Administrators" will be able to add events unless they are listed as an authorise user.

Managing Ical Events in the Frontend

Managing individual events and repeats is best done in the frontend since you see the events in their full date context.  If you login to the frontend as a user authorised to manage events you will see handy "edit" icon on each event title bar and also a "add event" link under the calendar.

Managing Ical Events in the Admin Interface

You can look at the iCal events for given calendars and/or categories.  The BIG difference between this list and the old events list is that you can click on a little icon in each row to see the repeats/recurrences of the event.

Editing Ical Events

You can click on an event to edit it - the layout is slightly different and the definition of repeats is completely different since it now follows the ical model.

IMPORTANT NOTE: If you edit an event from an imported iCal you must save it to a native calendar since a refresh of the calendar as a whole would eliminate your changes otherwise.  If you have a good idea for an alternative approach please let us know.

Editing Repetitions

From the list of repetitions (or when suitably logged in from the frontend) you can edit or even delete individual repetitions .  This is best done the the frontend of the site.