Calendar:Server Based Invitation Handling: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
=Server Based Invitation Handling=
[[Calendar:Feature_Implementations| <<Back to Features]]


The following proposed change is needed to handle invitations send out by a calendar server.
=Server Based Invitation Dialog UI Specification=
 
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0;  border: 1px #cccccc solid; border-collapse: collapse; width: 100%"
 
|- align="left"
| colspan="2" bgcolor="#cccccc"  | '''Specification Status'''
|-
|-
| width="150" | '''Author''' || Frank Loehmann
|-
| width="150" | '''Last Change''' || [[User:frankL|Frank Loehmann]] 17:20, 09. October 2006 (PDT)
|-
| width="150" | '''Status''' || Preliminary
|-
|}
 
== Abstract ==
This specification covers the UI of the Invitation dialog needed to accept and reject event invitations delivered i.e. by a WCAP provider.
 
__TOC__


==Mock-up for a new link showing up in the calendar UI==
==Mock-up for a new link showing up in the calendar UI==


The following change is needed to give the user feedback, that there are unhandled/open invitations on the server.
The "Invitation" link below the calendar subscription area gives the user an entry point to the Invitation dialog. Furthermore it gives feedback how many unhandled/open invitations are on the calendar server. A number in brackets at the end of the link indicates how many new invitations are present. This number will be updated every 10 Minutes. If there are no invitations "(0)" is being displayed. If there is no calendar using WCAP provider, the link is hidden completely.


[[Image:Server_Based_Invitation_Handling_Mockup_2.png|Mock-up for a new invitation link in the calendar UI]]
[[Image:Server_Based_Invitation_Handling_Mockup_2.png|Mock-up for a new invitation link in the calendar UI]]
=== "Invitation" Hyperlink  ===
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0;  border: 1px #cccccc solid; border-collapse: collapse; width: 100%"
|-
| width="200"  bgcolor="#dddddd" | '''Property''' || bgcolor="#dddddd" | '''State'''
|-
| '''Show:'''
| Hidden if no WCAP calendar ist present.
|-
| '''On Click:'''
| Opens the Invitation Dialog.
|-
| '''EN-US:'''
| Invitations (n)
|-
| '''Ger:'''
| Einladungen (n)
|}


Interaction Description:
Interaction Description:
* The link 'Invitations (n)' appears only if at least one invitation has not been responded.
* The link 'Invitations (n)' appears permanent if a WCAP based calendar is subscribed.
* (n) in the link shows the current number of 'open' invitations.
* (n) in the link shows the current number of 'open' invitations. Shows "0" if there is no unconfirmed inviation.


==Invitation Dialog==


==Mock-up for the Invitation Dialog==
The Invitation dialog uses the same dialog layout used by the Mozilla update or download dialogs.


[[Image:Server_Based_Invitation_Handling_Mockup_1.png|Mock-up for server based invitation handling.]]
[[Image:Invitation_Dialog.png|Mock-up for server based invitation handling.]]


Interaction Description:
=== String Table for Invitation Dialog ===
* Response ListBox content:
{| border="2" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0;  border: 1px #cccccc solid; border-collapse: collapse; width: 100%"
** 'Click here to respond' default text to guide the user will be exchanged with 'I will decide later' if list box has been opened.
|-
** 'Yes, I will attend'
| width="200"  bgcolor="#dddddd" | '''Property''' || bgcolor="#dddddd" | '''State'''
** 'No, I will not attend'
|-
** 'I will decide later'
| '''Dialog Title EN-US:'''
** 'Remove from my calendar'
| Invitations (n)
|-
| '''Dialog Title Ger:'''
| Einladungen (n)
|-
| '''Label 1 EN-US:'''
| Repeating Event
|-
| '''Label 1 DE-Ger:'''
| Wiederholender Termin
|-
| '''Label 2 EN-US:'''
| Location:
|-
| '''Label 2 DE-Ger:'''
| Ort:
|-
| '''Label 3 EN-US:'''
| Organizer
|-
| '''Label 3 DE-Ger:'''
| Organisator
|-
| '''Label 4 EN-US:'''
| Event Details...
|-
| '''Label 4 DE-Ger:'''
| Termindetails...
|-
| '''Label 5 EN-US:'''
| All day event
|-
| '''Label 5 DE-Ger:'''
| Ganzt�giges Ereignis
|-
| '''Label 6 EN-US:'''
| None
|-
| '''Label 6 DE-Ger:'''
| Kein
|-
| '''Note 1 EN-US:'''
| No unconfirmed invitations found.
|-
| '''Note 1 DE-Ger:'''
| Keine unbest�tigten Einladungen gefunden.
|-
| '''Note 2 EN-US:'''
| Updating list of invitations.
|-
| '''Note 2 DE-Ger:'''
| Aktualisieren der Einladungsliste.
|-
| '''Button 1 EN-US:'''
| Accept
|-
| '''Button 1 DE-Ger:'''
| Annehmen
|-
| '''Button 2 EN-US:'''
| Decline
|-
| '''Button 2 DE-Ger:'''
| Ablehnen
|-
|}
 
===General Dialog Description===
* Unconfirmed event invitations of the past (past day) will not be displayed except if it is a repeating event with a starting date in the past.
* Already confirmed or rejected invitation will not be displayed the next time the dialog is shown
* All invitations entries have the same height in the GUI
 
===Dialog Interaction Description===
* Dialog title show number of unconfirmed events
* The dialog is resizeable.
* The dialog shows two invitation by default.
* Updating
** The unconfirmed invitations are being cashed and automatically updated every 10 minutes for a faster dialog appearance.
** Content is being updated on calling the dialog
*** Graphical endless progress indicator is shown right behind the text "Updating list of invitations.", if an update is in progress. The text and the control are shown centered in the empty listbox
*** If no unconfirmed event is present, the note "No unconfirmed invitations found." is shown in the middle of the listbox.
* Icon (1.) shows current invitation status:
** Unconfirmed
** Accepted
** Declined
* Buttons are shown for selected listbox entry
** "Accept" (6.) Button of selected listbox entry (2.) is shown
** "Decline" (7.) Button of selected listbox entry (2.) is shown
* "Repeating event" text is shown only if the event is a recurring event.
* Location: "None" is shown if no location is given.
* "Event Details..." link calls the read only Event dialog (not designed yet).
* "OK" Button: Closes dialog and commits changes of the invitation status to the server.
* "Cancel" Button: Closes dialog and dismisses all changes made in the dialog.
 
== References ==
 
* Test Case Specification: <Open Issue>


* Unconfirmed event invitations of the past will not be displayed except if it is a repeating event with a starting date in the past.
[[category:calendar|Server Based Invitation Handling]]
* Already confirmed and rejected invitation will not be displayed the next time the dialog is called.
* 'Tentatively' events are shown until they are events of the past, or they have been  confirmed/rejected by the user.
* Response ListBox: 'Remove from my calendar' will send the 'No, I will not attend' status to the organizer and removes the event from the personal calendar
* (Default sorting is by or order of receipt. This is associated with 'Event Summary' column which is the default column).
* The 'Attend All Events' set all  response list boxes to 'Yes, I will attend'
* The dialog is resizeable and the 'Event Summary' column gets stretched

Latest revision as of 12:48, 12 July 2007

<<Back to Features

Server Based Invitation Dialog UI Specification

Specification Status
Author Frank Loehmann
Last Change Frank Loehmann 17:20, 09. October 2006 (PDT)
Status Preliminary

Abstract

This specification covers the UI of the Invitation dialog needed to accept and reject event invitations delivered i.e. by a WCAP provider.

Mock-up for a new link showing up in the calendar UI

The "Invitation" link below the calendar subscription area gives the user an entry point to the Invitation dialog. Furthermore it gives feedback how many unhandled/open invitations are on the calendar server. A number in brackets at the end of the link indicates how many new invitations are present. This number will be updated every 10 Minutes. If there are no invitations "(0)" is being displayed. If there is no calendar using WCAP provider, the link is hidden completely.

Mock-up for a new invitation link in the calendar UI

"Invitation" Hyperlink

Property State
Show: Hidden if no WCAP calendar ist present.
On Click: Opens the Invitation Dialog.
EN-US: Invitations (n)
Ger: Einladungen (n)


Interaction Description:

  • The link 'Invitations (n)' appears permanent if a WCAP based calendar is subscribed.
  • (n) in the link shows the current number of 'open' invitations. Shows "0" if there is no unconfirmed inviation.

Invitation Dialog

The Invitation dialog uses the same dialog layout used by the Mozilla update or download dialogs.

Mock-up for server based invitation handling.

String Table for Invitation Dialog

Property State
Dialog Title EN-US: Invitations (n)
Dialog Title Ger: Einladungen (n)
Label 1 EN-US: Repeating Event
Label 1 DE-Ger: Wiederholender Termin
Label 2 EN-US: Location:
Label 2 DE-Ger: Ort:
Label 3 EN-US: Organizer
Label 3 DE-Ger: Organisator
Label 4 EN-US: Event Details...
Label 4 DE-Ger: Termindetails...
Label 5 EN-US: All day event
Label 5 DE-Ger: Ganzt�giges Ereignis
Label 6 EN-US: None
Label 6 DE-Ger: Kein
Note 1 EN-US: No unconfirmed invitations found.
Note 1 DE-Ger: Keine unbest�tigten Einladungen gefunden.
Note 2 EN-US: Updating list of invitations.
Note 2 DE-Ger: Aktualisieren der Einladungsliste.
Button 1 EN-US: Accept
Button 1 DE-Ger: Annehmen
Button 2 EN-US: Decline
Button 2 DE-Ger: Ablehnen

General Dialog Description

  • Unconfirmed event invitations of the past (past day) will not be displayed except if it is a repeating event with a starting date in the past.
  • Already confirmed or rejected invitation will not be displayed the next time the dialog is shown
  • All invitations entries have the same height in the GUI

Dialog Interaction Description

  • Dialog title show number of unconfirmed events
  • The dialog is resizeable.
  • The dialog shows two invitation by default.
  • Updating
    • The unconfirmed invitations are being cashed and automatically updated every 10 minutes for a faster dialog appearance.
    • Content is being updated on calling the dialog
      • Graphical endless progress indicator is shown right behind the text "Updating list of invitations.", if an update is in progress. The text and the control are shown centered in the empty listbox
      • If no unconfirmed event is present, the note "No unconfirmed invitations found." is shown in the middle of the listbox.
  • Icon (1.) shows current invitation status:
    • Unconfirmed
    • Accepted
    • Declined
  • Buttons are shown for selected listbox entry
    • "Accept" (6.) Button of selected listbox entry (2.) is shown
    • "Decline" (7.) Button of selected listbox entry (2.) is shown
  • "Repeating event" text is shown only if the event is a recurring event.
  • Location: "None" is shown if no location is given.
  • "Event Details..." link calls the read only Event dialog (not designed yet).
  • "OK" Button: Closes dialog and commits changes of the invitation status to the server.
  • "Cancel" Button: Closes dialog and dismisses all changes made in the dialog.

References

  • Test Case Specification: <Open Issue>
Retrieved from "https://wiki.allizom.org/index.php?title=Calendar:Server_Based_Invitation_Handling&oldid=61893"