Main URLs:

The user interface: /local/
The admin interface: /local/admin/

Users

Signing Up
Users signup by going to /local/signup.php or simply clicking the link on the splash screen. After filling in all the fields, the user will be forced to login for the first time using his/her password. The first page a user will see is the Request Group Access page, which is the first step in asking access for groups. Once the user checks the groups of interest and clicks "request", emails will be sent to the primary group administrator of each group.

The Main Page

Once logging in from the splash screen, users will be presented with their home page, which lists all the calendars that the user has access to. At the end of the list, users can see which calendars that they do not have access to and have been specified as “guest viewable”. Users can request access to groups that they are not in by clicking on the link under “Functions” on the side bar of the home page. From the same link users can also change their user information, such as email, passwords, etc.


Once clicking on a calendar name from the home page, users will be presented with a month view of the corresponding calendar.

Clicking on a date in the month view will, quite intuitively, bring users to a daily view of the date, which lists in detail the events and times that have already been signed up.

Add Event

Under the day viewusers can add events through the submission form towards the bottom of the page.

Under both the monthly and daily view, users have a calendar panel where they can jump from calendar to calendar (of course, users are limited to calendars that they can access).

Delete/Change Event

Users may modify their events by clicking “Delete/Modify events” on the link bar at the bottom of each page.

Request Group access

On the main page, users are allowed to get a read-only monthly view of calendars that have been given the "guest view" privledge. However, should a user want to formally request access, the user can go to the Home page, click on the request group link on the left. Emails will be sent out to primary group administrators."



Administrators

Sysadmin: the sysadmin user has access to all groups and calendars in the system. Only system administrators can add groups and modify group administrators. You cannot delete the sysadmin account from LoCal.

Group administrators: these are administrators that can add/delete/modify calendars in an existing group, change/add/delete users in Local, grant permissions to allow users to access groups, and generate invoices. An administrator must be part of the group to be an admin. (Eg, the group administrator can change group access for LoCal users, including him/herself. If the admin were to remove his/her own admin status, they would also lose complete access to the group once logging out.Important: Note that calendar administrators are limited to only groups that the sysadmin has given permission to. (E.g. not only do group administrators have fewer privileges than the sysadmin, they will only be able to modify a subset of existing groups) Users can become group administrators only from a “blessing” by the sysadmin. (Instructions on how to do this are below).

The difference  in primary group administrators and a “normal” or other group administrators, is that the primary group admin is responsible for granting permission to users who request access to their particular group. The primary group administrator by default is always the sysadmin. Only the sysadmin can modify group administrators of a group.

Admin Home (/local/admin/)

All administrators can access the Admin Home page. Administrators can change the announcements to calendars that they have permission to administer. On the left is the admin toolbar, where administrators can manage users, groups, and generate invoices.

Add Group

Only the sysadmin user can add and delete groups. This can be done by clicking Manage Groups from the admin home page and then clicking “Add Group.” A wizard will take you through the process to add a group: Create a name for the group, assigning calendar administrators, and adding the initial calendar to the group.

Managing Groups

Click on “Manage Groups” from the Admin Home page, click “Edit” next to the group of interest to edit the Group. You be brought to a the Group view where you will be able to modify the group information, such as system administrators, descriptions, announcements, and a panel to add and delete calendars of the group. 

To add a group administrator(s), you must be the sysadmin Click “Add Group Administrator” on the Group view page. You will see a text box to add group administrators. Type in the list of user(s) you wish to give admin permissions to. Use the radio buttons to specify which group admin is to be the primary admin for that group. If a user was originally not part of a group that he/she was being made an admin of, they will be part of that group. Unlike the sysadmin, a group admin must explicitly be part of the group to be an admin of it.

To add a calendar, go to the group view page for the group of interest. At the bottom of the page is a list of calendars in the group. Click “Add Calendar” to bring up the add calendar form.

Fill in all the information and click apply. If the calendar met all the specifications, you will see a “success” message and a “snapshot” of  the calendar you just added—changing one of these fields after a “success” message will not add another calendar, only update the information that you have already entered.

To modify an existing calendar, click edit next to the calendar name of interest under the group-view page. This will bring you to a form similar to the add calendar page.

To delete an existing calendar, click “delete” next to the calendar name. You cannot delete the last calendar of a group. If you wish to do so, then you must delete the entire group from the Local system.

Managing Users

Click on “Manage users” from the Admin home page. You will see a partial list of the users currently registered in the system. Click the Next and Previous buttons to navigate through the entire list. Alternatively, you can enter a search criteria at the bottom of the page and click search find a user faster.

Invoicing
This functionality is premature in this version. However, administrators can generate invoices by clicking “Generate Invoice” the Admin tool bar. Invoices can be generated for a specific user or by group, then by fiscal year, month, or a custom date. Invoices can be saved and emailed (users are actually notified of their saved invoice and have to manually login to Local to view their invoice), printed (local makes a system to call to lpr after converting the HTML invoice to Postscript), or simply displayed.