Requirements File Name: comments_inbox_reqs.html
Comments Inbox Page Requirements
 
Change Log
Version Date Author Changes Notes
1.0 11/07/2006 Kevin Puleo Added requirements  
2.0 12/18/2006 Kevin Puleo Changed requirements based on apix strategy  
2.1 1/23/2007 Kevin Puleo Sort Icon added to top row of table  


Introduction
The purpose of this page is allow members to view a summary of comments made to their UGC (User Generated Content)..

Requirements
The message center defaults to displaying received comments. Comments will never expire on the actual UGC URL however the comment summary line item will be removed from the user's comment inbox unless another comment has been made within 30 days. Only commented UGC items get added to the list and they only stay in the list if the comments have been made within the last 30 days. To view this page the user must be logged in and be the content owner. See message center for more general page features. The requirements outlined in this doc are specific to comments received.




Navigation
There is a set of controls that will be available to the user to help them manage their comments.
  1. Comments (##) - The number in parens next to Comments in the nav box is a sum of the new comments (unread) and the number of new responses (unread) in flagged comments
  2. Flagged Comments - Links to a page that shows all of the comments flagged by the user within a 30 day period. See that page for more detailed requirements.




Supporting Controls
There is a set of controls that will be available to the user to help them manage their message inflow and outflow.
  1. Select - Actions only apply to items displayed on the page currently. Select actions may be stacked upon one another so it is feasable that the user could select the unread and read link for instance to check those items on
    1. All - adds a checkmark to all messages. The checkbox is located in the first column of every row. This checkbox is unchecked by default.
    2. None - Any checked rows will become unchecked
    3. Unread - any unread messages will become checked
    4. Read - Any read items will become checked
  2. Checked Actions - once a line item is checked on an action may be applied to it
    1. Delete - removes all checked items. doing this refreshes the page and line items from the next set of 50 messages will be used to fill in the gaps. So the remaining items on the display page collapse and the next set of messages fill in after the collapse to make 50 max on a page.
    2. Mark as Read - all checked items lose their boldness (unread status) - if the checked item is already in read status the staus remains unchanged
    3. Mark as Unread - all checked items get an unread status attached to it
  3. Sorting - messages may be sorted using the column links at the top of the messages list on each page. Sorting cannot be stacked so there is no boolean functions like seeing the oldest from ordering membernames Z-A, sorting works on the whole pool of messages not just the messages displayed on the current page. The sort is defaluted to newest comments first.
    1. Content - sorts alphabetically - click once sorts UGC content title A-Z, click again without selecting another sort link then the sort goes UGC content title Z-A
    2. New - sorts numerically - click once and the most commented item is at the top and descends from there - click again and the least commented UGC line item is at the top and descends from there
    3. Last Comment - sorts alphabetically - click once sorts the last member's name to comment A-Z, click again without selecting another sort link then the sort goes last member's membername Z-A
    4. Date recieved - If this is the first sort link to be selected after page load then the order switches from newest to oldest to oldest to newest. Select the link again and the order goes back to newest to oldest.
      1. Sort Icon - Since this column is the default column for sorting it also has a sorting indicator icon at the top of the column. The order is newest to oldest but if the column is selected again the sort would be oldest to newest and the icon would be flipped to indicate the change. If a different cloumn is selected then that column would receive the icon while being removed from its current column




Message Display
    General
  1. If the comment inbox is empty a message should disply where the line items normally would be that says something like, "You have not received any comments yet. Try posting more pics, stories, and hollas!"
  2. Messages are displayed with the newest first - so by date column
    1. Newness is defined by when the user last logged in and if they have clicked on that comment line item or not. If the line item is marked as "unread" (bolded) then the comments are considered new as well.
  3. There are 50 line items displayed before pagination begins
    1. There should be an indicator of what chunck of 50 is being viewed and of how many ie 1-50 of 130
    2. There should also be a way to traverse ahead or back with next and previous buttons to go back and forwared a page and also allow user's to skip to any page with a page link indicator button ie < Previous | 1 | 2 | 3 | 4 | 5 | Next >
  4. There should also be a general summary that indicates how many new comments have been made on N UGC ie "You have 10 new comments on 4 items."
  5. Each line item has these components
    1. Checkbox - used for giving the message an action (see above)
    2. UGC Content title
    3. New - displays number of new comments to the UGC since the users last visit to mlab
    4. Last Comment - displays the name of the member who put in the last comment
    5. Date Received - dates are displayed with date and time stamp of time sent by sender not by time downloaded by recipient
  6. The line items are summaries and house no actual comment content information. When someone comments on a piece of UGC that UGC item gets added to the list on this page as a line item. The line item becomes bolded and, based on the time of the last comment, is placed in the appropriate order.
    1. Example: Person A comments on UGC#1 at 3PM then Person B comments on UGC#2 at 3:15PM then the line items would look something like this (in order):
      1. Content=UGC#2 Title - New=1 - Last comment=Person B - Date Received=3:15PM
      2. Content=UGC#1 Title - New=1 - Last comment=Person A - Date Received=3PM
    2. But, if Person C comments on UGC#1 at 3:20PM the the lline items would look something like this (in order):
      1. Content=UGC#1 Title - New=2 - Last comment=Person C - Date Received=3:20PM
      2. Content=UGC#2 Title - New=1 - Last comment=Person B - Date Received=3:15PM
  7. When a message row is rolled over by the user the whole row highlights with a color (HEX and function TBD but for now use the demoed color and fade)
  8. The whole row should be selectable so if the mouse is highlighting a row even though it is not over a text link the onclick should take the user to the actual message.
  9. Selecting a row item will remove the boldness of the line item and then take the user to the actual URL of the UGC with the comments displaying therby exiting the user from the message center.
  10. The line item will remain in the list unbolded with the last information displayed befor being clicked on. If someone comments on the UGC again within 30 days then the above rules apply except that the New # resets to 0 then adds in the new comments so if the new # was previously 14 and the line item was marked as "read" and then 2 people have since made comments that new # would change to 0 and the line item becomes bold and potentially moves from its slot position to a higher or lower position depending on the date and time of the last comment