Lozinski's Calendar!

Detailed Informational Window

This is the window where users can:
  • view every detail to all the selected day's events
  • add, move, edit, or delete events on the given day provided these options are enabled
If the option "Use PopUp" is enabled, the detailed informational window will "popup" in a separate browser window.


Displaying all the Events and Details for the Selected Day

The separate detailed informational window always displays every event and all the supplied information for that event, regardless of what value is set for the configuration item "Max Number of Entries to Display". However, what the user sees is dependent on whether user editing is allowed.

Main Day View with User Editing Disabled
If user editing is disabled, the detailed informational window will display all of the fields for each event as entered by the user: heading, heading icon, heading image, description, description image, user who last modified the particular event, and email contacts.

The display will also include the associated event number which is generated automatically by the program.

There will be no option allowing users to add new events, or move, edit, and delete events currently listed:

Users not having permissions to add, edit, move, or delete events.


The "webmaster" for the selected calendar and the "administrator" can ALWAYS edit the calendar, regardless if user editing is disabled.

To do so as:

Administrator:
  1. Log into the administrative form
  2. Click the "Update a Calendar" button
  3. Click the "View/Edit Event(s)" button next to the calendar to update
  4. Select the day to edit the details for
  5. Edit the day's details

Webmaster:
  1. Log into the webmaster configuration form
  2. Click the "Edit Caledar's Events" button at the top of the page
  3. Click the day to edit the details for
  4. Edit the day's details


Main Day View with User Editing Enabled
If user editing is enabled, the detailed informational window will display all the information as described in section "Main Day View with User Editing Disabled", along with the following buttons:
  • an "add" button to allow users the ability to add a new event to the selected day
  • "move", "edit", and "delete" buttons next to each event currently listed for the selected day, depending on what permissions users were granted in the User Permissions section of the configuration form.

    Clicking the:
    • "move" button will bring up the form allowing users to move the event from the current day to any number of other selected days. This action will delete the event from the current day.


    • "edit" button will bring up the form fields prepopulated with the current values to allow for easier editing.


    • "delete" button will bring up the form with most of the information not being editable. This screen serves more or less as a "confirmation" screen before actually deleting the event.


    Users having permissions to add, edit, move, or delete events.



It is important to note that unless an event was edited by the "webmaster" or the "administrator" for the current calendar, only the user who originally entered the selected event has permission to move, edit, or delete the selected event!

If the event was entered by a user, and subsequently moved or edited by the "webmaster", only the "webmaster" or "administrator" can perform further actions on the event!

If the event was entered by a user or "webmaster", and subsequently moved/edited by an "administrator", only the "administrator" can perform further actions on the event!


Adding an Event

The steps to "add" an event to a calendar. Each user will need to select values and provide information as appropriate:
  1. Click on a date link to launch the detailed informational window
  2. Click the "Add" button
  3. Enter the username
  4. Enter the user's password
  5. Type in a "heading", select a "heading icon", or provide a URL to a "heading image"
  6. Click the "add this event" button

The event should be added to the calendar, with the detailed informational window and the main calendar window refreshing to reflect the latest changes.


Editing an Event

The steps to "edit" an event on a calendar. Each user will need to select values and provide information as appropriate:
  1. Click a date link to launch the detailed informational window
  2. Click the "Edit" button next to the event to be edited
  3. Enter the username
  4. Enter the user's password
  5. Select the days the edits are to be applied to
  6. Edit the information in the fields as appropriate
  7. Click the "edit this event" button

The event should be edited on the calendar, with the detailed informational window and the main calendar window refreshing to reflect the latest changes.


Moving an Event

The steps to "move" an event from one day to several on a calendar:
  1. Click a date link to launch the detailed informational window
  2. Click the "Move" button next to the event to be moved
  3. Enter the username
  4. Enter the user's password
  5. Select the days to move the event to
  6. Click the "move this event" button

The event should be moved to the specified days on the calendar, with the detailed informational window and the main calendar window refreshing to reflect the latest changes.


Deleting an Event

The steps to "delete" an event to a calendar:
  1. Click a date link to launch the detailed informational window
  2. Click the "Delete" button next to the next to be deleted
  3. Enter the username
  4. Enter the user's password
  5. Select the days to delete the event from
  6. Click the "delete this event" button

The event should be deleted from the calendar, with the detailed informational window and the main calendar window refreshing to reflect the latest changes.


Form View with Fields for User Editing - the Juicy Details

What Fields are Editable When?
If enabled, this is the window which displays the input fields allowing users to add, edit, move, or delete an event for the selected day on the calendar. Below is a table detailing which field values are "N"ot Editable (fixed) or "E"ditable, depending on the whether the user is adding, editing, moving, or deleting the event:

 AddEditMoveDelete
Username E E E E
Password E E E E
Heading E E N N
Days E E E E
Description E E N N
Start Time E E N N
End Time E E N N
Heading Link E E N N
Heading Image E E N N
Heading Icon E E N N
Description Image E E N N
Email List E E E N
Calendars Affected E E E E

Below is an explanation of each input field. When describing the type of input the field accepts, it is assumed to be in a mode where the field is editable as shown in the above table:

Username field Password field Heading Heading Link Heading Icon Heading Image Description Description Image Date field Start Time field End Time field Email List Calendars To Apply Changes To
Showing all fields enabled.


  • Username
    This field is required for every action for every user takes unless the option Allow Anonymous Postings is enabled.

    If the option "Use "cookies" to remember userIDs?" is enabled, this field may be prepopulated with the user's id.


  • Password
    This field is required for every action for every user takes unless the option Allow Anonymous Postings is enabled.

    If the option "Use Cookies to remember user passwords" is enabled, this field may be prepopulated with the user's password.

    Users cannot change their passwords! Only the "webmaster" for the current calendar or an administrator can change a password for a user.


  • Heading
    The heading is a textual title for the event. No HTML input is allowed in the heading. When a user initially adds an event to the calendar, they must supply a heading, provide a heading image, or select a heading icon.

    The heading field is displayed in every calendar view.

    The size of the heading may vary as follows depending on how the "Scaling Factor" configuration for the calendar is set:
    1. "none" - The heading can be a maximum of 30 characters
    2. "a little" - The heading can be a maximum of 20 characters
    3. "a lot" - the heading can be a maximum of 10 characters


  • Heading Link
    An optional field. Allows users to input a URL so when a heading, heading icon, and/or heading image is supplied, it can be clicked to take the calendar viewer to this supplied URL.

    The URL can be any valid URL -- a link to another web page, the mailto option, image, movie, or anything else you can provide a URL to.

    No protocols are supplied. That is "http://", "https://", "mms://", "ftp://", or any other protocols are not automatically inserted.

    This field works the same way as if setting the HREF attribute in an anchor tag. For example, to link to another page on the current server, any of the following will work:
    1. http://yourdomain.com/the_page.html
    2. /the_page.html
    To link to another page on another website, DO NOT enter "www.that_website.com" as that is NOT a valid URL! The user will have to enter "http://www.that_website.com"!



  • Heading Icon
    When a user initially adds an event to the calendar, they must either supply a heading, provide a heading image, or select a heading icon. The list of icons displayed comes from the images residing in the specified "icons" directory for this calendar. A heading icon is displayed as part of the overall heading for this event in the main calendar view (regardless of the selected viewing format) and the detailed informational window.

    Heading icons are not displayed if:


  • Heading Image
    When a user initially adds an event to the calendar, they must either supply a heading, provide a heading image, or select a heading icon. The heading image field allows users to input a URL to an image that will be displayed next to the heading for this event.

    Heading images will be displayed in the main calendar view (regardless of the viewing options set) and within the detailed informational window.

    It is strongly suggested that heading images are not huge so they do not take up a lot of space in the main calendar view.

    Heading images are not displayed if:


  • Description
    An optional field.

    Descriptions are not affected by the scaling configuration option.

    The configuration item "Allow HTML tags in description field" determines if the description may allow HTML input, or just accept plain text.

    A short note is displayed next to the title of this field informing users of the format options:

    HTML Disabled

    HTML Enabled



  • Description Image
    An optional field. The description image field allows users to input a URL to an image that will be displayed next to the description for this event.

    This image will only be displayed on the main calendar view if "Use Images" is set to "yes" AND the user has selected any of the following viewing options:
    • "with both Headings and Details"
    • "just current week's details"
    • "with inline day view window"
    The description image will always be displayed in the detailed informational window.

    If the "Use images for this calendar?" configuration option is disabled for this calendar, this field will not be present, and any previously entered images will not be shown.



  • Dates
    This field is required for every action. The current day is selected by default.

    The user will have the option to select days from the current month up through 11 months in advance depending on how the item Max Number of Months after the Current Month to Display for selecting dates on which to add, edit, move, or delete an event is set.

    To ADD Dates:

    • If the option Use PopUp is enabled, the user may select multiple days from a "mini" calendar by clicking "Add Dates" button and then clicking the desired dates:

      Click the Add Dates button to bring up a mini calendar


    • If the option Use PopUp is disabled, the user may select/deselect multiple days from the drop-down list.

      To do so:
      1. Windows: hold down either "ctrl" or "shift" to select/deselect individual days or a group of days respectively.


      2. Macintosh: hold down the "command" or "option" keys to select/deselect multiple days


      3. Unix: the "ctrl" and "shift" keys provide similar functionality as that on a windows platform.

    Depending on whether a user is adding, editing, moving, or deleting an event, the days selected will have different meanings, as described below:

    1. Adding - will add the event to all of the days selected from the list.


    2. Editing - will edit the event only on those days selected.

      If the event exists on days NOT selected, the edited changes will NOT be applied to those days.

      If a day is selected that the event does not exist on, no changes will be applied to the affected date.

      Edited changes will only take effect on the days selected where the selected event actually exists.


    3. Moving - will delete the event from the date currently being viewed, and move the event to the selected dates.

      If the event already exists on a target date, the user will be prompted to first remove the event from the target date before moving the event to that target date. This helps to ensure an event is not accidentally over-written.


    4. Deleting - will delete the event from the selected days only.

      If the event exists on days that are not selected, the event will NOT be deleted from those days.

      If the event does not exist on a selected day, no action is taken on that day.

    To DELETE Dates:

    • If the option Use PopUp is enabled:
      1. click the desired dates to remove
      2. click the "Delete Dates" button.

    • If the option Use PopUp is disabled:
      1. click to the desired dates to remove
      2. ensure they are deselected.



  • Start time
    An optional field. The configuration item "Military or Standard time" determines if this is displayed in "military" time or "standard" time.

    Increments are allowed in 5, 10, 15, 20, or 30 minute intervals.

    A 4-digit time is always displayed. If cofigured to be displayed in "standard" time, "AM" or "PM" will be displayed next to each time. Thus 3am in standard time will be displayed as "0300 AM".

    By default, the current start time (if editing an event) is displayed.

    The start time is always displayed as part of the heading information.

    If no start time is specified, but an end time is specified, then the start time in the heading information will be displayed as a question mark "?" character. Think of it as meaning you don't know when things are going to start.



  • End Time
    Same properties and functionality as start time, except that if a start time is specified, but no end time is specified, then the end time information will be displayed as a question mark "?" character. Think of it as meaning you know when the event is going to start, but have no idea when it'll end.



  • Email List
    An optional field. Allows the user to enter the email addresses that should be notified ONLY when the current event is added, edited, or moved. The list of email addresses is fixed when a user chooses to delete the event.

    There is no option to set up "reminders" (ie, 2 days before the event is scheduled to happen, 2 hours before, etc)!

    Email addresses should be entered one per line. Do NOT separate email addresses with commas, semicolons, or any other character!



  • Calendars to apply to
    If the "Allow this calendar to be shared with others" option is enabled for this calendar, this selection list will display the name of the current calendar and that of any other calendars that have this option enabled as well.

    By default, the current calendar is selected. Depending on whether a user is adding, editing, moving, or deleting an event, the calendars selected will have different meanings, as described below:
    1. Adding - will add the event to all of the calendars selected from the list.


    2. Editing - will edit the event only on those calendars selected. If the event exists on calendars NOT selected, the edited changes will NOT be applied to those calendars. If a calendar is selected that the event does not exist on, no changes will be applied.


    3. Moving - will delete the event from the date currently being viewed, and move the event to the selected dates on the selected calendars.

      Events CANNOT be moved from one calendar to another!


    4. Deleting - will delete the event from the selected days on the selected calendars only.

      If the event exists on calendars that are not selected, the event will NOT be deleted from those calendars.

      If the event does not exist on a selected calendar, no action is taken on that calendar.
"It got us what we wanted. That's all that matters."
http://www.davelozinski.com