The Event Display Page

The Event Display Page is shown by default. It displays the list of upcoming events in chronological order by their start dates. The event list includes a header for each month. You can use the links at the top of the page to go directly to the events for any month. Each event starts with the date(s) on which it occurs, one or more icon(s) indicating the type of event, and the title of the event, which may serve as a link to a web page containing additional information. This may be followed by the time and/or location where the event will occur, a list of people to contact for more information, and a description of the event.

Filtering Events

At the top left of the Event Display Page is a set of controls that can be used to filter the events displayed in the event list.

The Events From and To fields allow you to limit the list to events occurring within a specified time period. Only events ending after the From date and starting before the To date will be displayed. The recommended format for dates is mm/dd/yyyy. See Specifying Dates for other possible date formats.

The Modified since field allows you to limit the list to events added or modified since the specified date. The special value "all" can be entered to show events regardless of the date they were added or modified.

The type selector allows you to limit the list to events of the specified type(s). You can select multiple types by holding the Ctrl key while selecting.

The area selector allows you to limit the list to events of interest in the specified area(s). See Areas for more information on specifying areas. You can select multiple areas by holding the Ctrl key while selecting.

The Update button updates the list to reflect the current specifications.

The Reset button resets the specifications to those in effect the last time the display was updated. Use this button if you have accidentally changed a field.

The Default button sets the specifications to your defaults and updates the list. If you are not logged in, the defaults display all types of events in all areas occurring in the next year, regardless of the date they were modified. If you are logged in, the defaults are those specified in your profile.

Other Controls

At the top right of the Event Display Page is a set of controls that allow you to log in or out, to edit your profile, and (if authorized) to add and edit events or access the administration page.

The current user name is displayed at the top right. If you are not logged in, this displays "Guest".

Below the user name is the Login button or the Logout button, depending on whether you are currently logged in. When the Login button is pressed, the Login Page is displayed to allow you to enter your user name and password. After logging in, you are returned to the Event Display Page with the filtering fields set to the values specified in your profile. Pressing the Logout button logs you out to prevent anyone else from modifying your profile, adding or editing events or accessing the administration page using your profile.

Below the Login/Logout button is the Register or Profile button, depending on whether you are currently logged in. Either button brings up the Registration/Profile Page, which allows you to create a new profile or edit your current profile.

If you are authorized to add and edit events, the Add Event button appears to the left of the user name. Pressing this button displays the Add Event Page, which allows you to describe the new event.

Below the Add Event button is the Edit Events button. When this button is pressed, Copy, Edit, and Delete buttons are displayed to the left of each event in the event list. The Edit and Delete buttons are displayed only if you are the owner of the event or if you are logged in as a calendar administrator. The Copy button displays a copy of the event in the Edit Event Page, where you can edit it to describe a new event. This is useful for adding a new occurrence of a regular event, such as a region meeting. The Edit button displays the event in the Edit Event Page, where it can be modified to add information or change the dates of a rescheduled event. The Delete button removes the event from the database.

When pressed, the Add Event button changes to the End Edit button, which removes the editing buttons from the event list.

If you are logged in as a calendar administrator, the Admin button appears below the Edit Events button. This button brings up the Administration Page, which can be used to back up the calendar database, control user authorization, and set user passwords.

Add/Edit Event Page

The Add or Edit Event Page allows authorized users to describe an event. As a minimum, each event description must include a start date, title, event type and area. It is highly recommended that a location and at least one contact also be provided. Remember, the more information you provide here, the better people will be able to plan to attend your event.

The Dates fields allow you to specify the start and end dates for the event. Only the start date is required for a single day event. The recommended format for dates is mm/dd/yyyy, although other formats can be used as described under Specifying Dates.

The Times fields can be used to indicate the start and end times for the event. You can specify both times, only the start time, or neither. Times can be specified using either 12 or 24 hour format (e.g. 5:00pm or 17:00).

You are required to supply a very brief Title for the event.

You must select at least one Event Type for the event. Multiple types can be selected by holding the Control key while selecting additional types.

You should provide the Location of the event. The more detail you provide (e.g. street address), the more people can find you without having to call for directions.

You are required to select at least one Area of interest for the event. See Areas for more information.

You should specify a Web Site address where people can find more information about the event or sponsoring organization, if available.

You should provide one or more Contacts for people to email or call for more information about the event.

You can provide additional information, such as cost, things to bring, etc. in the Description field.

It is highly recommended that you use the Preview button to check your event listing before submitting it. This will show you how your event will be listed and give you a chance to make corrections.

The Submit button will check your entries for errors, such as missing information or invalid dates. If no errors are found, the event will be added to the database and you will be given the opportunity to add a similar event, add a different event, or return to the calendar listing.

The Reset Form button resets all of the fields to the values they had when the page was last loaded.

The Return to Calendar button returns to the Event Display Page without saving the new or changed event

Registration/Profile Page

The profile page allows you to create or edit your profile. Currently, your profile contains your user name, password, and default event filter settings. Future enhancements may include notification of new or modified events or reminders of upcoming events.

The User Name field allows you to specify your user name. User names and passwords are case sensitive. Note that changing the user name for an existing profile is allowed.

The Old Password field appears only when updating an existing profile. It must be supplied if you attempt to change your user name or password.

The New Password and Confirm New Password or Password and Confirm Password fields allow you to specify and confirm your new password. The same password must be entered in both fields. These fields must be filled in when creating a new profile. They should only be filled in when changing an existing profile only if you intend to change your password.

The Events From, To, and Modified since date fields, as well as the event type and area selectors specify the default values used to filter events in the Event Display Page when you are logged in using this profile.

The Register or Update Profile button saves your changed profile in the database, logs you in using the new profile, and returns to the Event Display Page.

The Return to Calendar button returns to the Event Display Page without saving the new or changed profile

Administration Page

The Administration page allows authorized users to perform various administrative tasks.

The Backup button produces a mySQL script file that can be used to reproduce the current database. Your browser should prompt you to save this file to your local machine. To restore the database, the file needs to be copied to the server and sourced in the mysql command line application or similar application.

Pressing the Change Default Access button changes the default access level to the value selected to the right of the button. All new profiles created after the button is pressed will be given this access level.

The User selector allows you to select the user name whose password or access level is to be changed or whose profile is to be removed when one of the following buttons is pressed.

The Change User Access button changes the access level for the selected user to the value selected to the right of the button.

The Change User Password button changes the password for the selected user to the value specified in the field to the right of the button and in the Confirm New Password field below. The same value must be specified in both fields.

The Remove User button removes the profile for the selected user.

The Return to Calendar button returns to the Event Display Page.

Access Levels

Each user profile is given one of the following levels of access. Authorized users can change the default access level for new profiles or the current access level for existing profiles using the Administration Page.

  • View - View existing events.
  • Edit - Add new events and edit or delete events they added.
  • Admin - Add, edit, or delete any event. Perform administration tasks.

Specifying Dates

Dates can be specified in many different ways.

Absolute dates indicate a specific date, such as December 25, 2000. They can be specified in any of the following formats:

  • mm/dd/yy (12/25/00)
  • yyyy-mm-dd (2000-12-25)
  • dd mon yy (25 dec 02)
  • mon dd, yy (dec 25, 02)

Where mm is the numeric month (12), dd is the day of the month (25), yy is the year in either 2 (00) or 4 (2000) digit form, and mon is the month name, either fully spelled out (December) or as a three letter abbreviation (Dec). Other formats may also work, but these are know to work reliably.

Relative dates indicate a date relative to another date, such as one year from today. They can be specified in many ways, including:

  • +/-n years
  • +/-n months
  • +/-n weeks
  • +/-n days
  • today (+0 days)
  • tomorrow (+1 day)
  • yesterday (-1 day)

Relative dates can be combined with other relative dates and/or an absolute date. If no absolute date is specified, the current date is used.

Areas

The PNW4WDA is divided into areas defined by the three states it covers and the regions defined in the bylaws. In addition, this calendar defines areas for the portions of regions that lie in different states (e.g. Region 7 Washington and Region 7 Idaho). The Event Display Page allows you to specify the areas you are interested in. It then displays all events described as being of interest to any of the areas that overlap any of the areas you specified.

It is generally best to specify the smallest area of interest, both when describing events and when filtering events for display. An event described as being of interest to Region 7 will be displayed for people specifying interest in All, Washington, Idaho, Region 7, Region 7 Washington, or Region 7 Idaho areas. However, if the event is described as bein of interest to Region 7 Washington will be displayed for All, Washington, Region 7 and Region 7 Washington. Thus, a cleanup in Spokane should be described as being of interest to Region 7 Washington and a Washington State Caucus should be described as being of interest to Washington.

Credits

This calendar manager was written by Alan Dragoo, Spokane 4 Wheelers, ADragoo@aol.com, 509-893-9210


Copyright 2006 © All Rights Reserved
No portion of this material may be reproduced without the express written permission of the PNW4WDA
Web hosting donated by NetRiver