Feed widget should be able to display hyperkitty posts, here is an example:

Feed widget should be able to display hyperkitty posts, here is an example:

Feed widget should also be able to display blog posts, here is an example (understanding the inline commenting is likely not going to work but we should at least be able to display comment metadata.)

Feed widget should also be able to display blog posts, here is an example (understanding the inline commenting is likely not going to work but we should at least be able to display comment metadata.)

Different feed types will have panes in the hub admin edit hub mode where the feed URL / metadata can be input to pull it in. Here is an example that shows how a mailing list gets added to the feed:

Different feed types will have panes in the hub admin edit hub mode where the feed URL / metadata can be input to pull it in. Here is an example that shows how a mailing list gets added to the feed:

We also need to spec out the three different 'states' of a given piece of content in the feed widget:

• Summary: this is the "minimized" state... the short and sweet version, probably ellipisized in some manner depending on content

• Preview: the is the "maximized" state... the box might be taller and have more content / links / info / etc

• Full: this is either the external permalink the content originated from, some clever error message + clever cache of the page link if said content 404s, and for limited cases the hubs permalink (eg some admin foo)

Card Contextual Menu

Every card will have a little downward arrow in the the extreme upper right corner. This is called the card contextual menu.

The items available in this menu depend on the context of the card. :)

• The menu will always have a 'pin to library' item. A sub-menu of the 'pin to library' item will be a list of the libraries the user can pin to.
• The menu will also always have a permalink item. This points to the external permalink that the content came from. (For example, the URL of the blog post that a blog card is pulling from.)
• Save for later: this will add the card to a 'saved' tab in the user's personal stream. This is also always present.
• Filtering options (depends on context)
  • filter based on emitting hub ("Don't show me notifications from design-team")
  • filter based on emitting app ("Don't show me koji notifications anymore")
  • filter based on people ("Don't show me notifications involving John Doe")
  • filter means it won't show up in the default filtered stream. It will show up in the firehose stream, however.
• A policing option of some kind (if we want to go there) - "Report this post" "Report as spam" etc

Card Contextual Menu

Every card will have a little downward arrow in the the extreme upper right corner. This is called the card contextual menu.

The items available in this menu depend on the context of the card. :)

• The menu will always have a 'pin to library' item. A sub-menu of the 'pin to library' item will be a list of the libraries the user can pin to.
• The menu will also always have a permalink item. This points to the external permalink that the content came from. (For example, the URL of the blog post that a blog card is pulling from.)
• Save for later: this will add the card to a 'saved' tab in the user's personal stream. This is also always present.
• Filtering options (depends on context)
  • filter based on emitting hub ("Don't show me notifications from design-team")
  • filter based on emitting app ("Don't show me koji notifications anymore")
  • filter based on people ("Don't show me notifications involving John Doe")
  • filter means it won't show up in the default filtered stream. It will show up in the firehose stream, however.
• A policing option of some kind (if we want to go there) - "Report this post" "Report as spam" etc

Here's another mockup showing the contextual menu for a specific case.

Here's another mockup showing the contextual menu for a specific case.

Personal Stream Feed Widget

Here's how the feed widget works on a personal stream page.

Note there are four streams, tabbed at the top:
My stream - the 'firehose' of notifications for that user, with filters applied
My actions - the 'firehose' of notifications for that user, filtered to only show those that require the user to take an action in some way (e.g., pend to group membership request)
Saved notifications - any cards a user saved from the card contextual menu 'save link' item
All - the firehose - all notifications bound for that user with no filters appiied

Personal Stream Feed Widget

Here's how the feed widget works on a personal stream page.

Note there are four streams, tabbed at the top:
My stream - the 'firehose' of notifications for that user, with filters applied
My actions - the 'firehose' of notifications for that user, filtered to only show those that require the user to take an action in some way (e.g., pend to group membership request)
Saved notifications - any cards a user saved from the card contextual menu 'save link' item
All - the firehose - all notifications bound for that user with no filters appiied

(Sometimes bullets don't work here, trying to redo the bullets for the last comment here:)

Note there are four streams, tabbed at the top:

• My stream - the 'firehose' of notifications for that user, with filters applied
• My actions - the 'firehose' of notifications for that user, filtered to only show those that require the user to take an action in some way (e.g., pend to group membership request)
• Saved notifications - any cards a user saved from the card contextual menu 'save link' item
• All - the firehose - all notifications bound for that user with no filters appiied

The "My Stream" feed is the only one that shows the "This stream is filtered | View Filters" sticky above its stream. If you click on the "View Filters" link, you'll get a list of the applied filters and an opportunity to remove any given filter.

Alternatively, the user should be able to stop filtering a given type of notification by viewing it in the "All" (AKA firehose) stream and unfiltering it.

The "My Stream" feed is the only one that shows the "This stream is filtered | View Filters" sticky above its stream. If you click on the "View Filters" link, you'll get a list of the applied filters and an opportunity to remove any given filter.

Alternatively, the user should be able to stop filtering a given type of notification by viewing it in the "All" (AKA firehose) stream and unfiltering it.

The card categories / card contextual menu / personal stream feed widget mockups are located in the following file:

https://github.com/fedoradesign/fedora-hubs/blob/master/card-categories.svg

Card Categories

Card categories list where a given card in the feed widget came from. They are displayed in the upper right corner of each individual card. Each card has one card category assigned to it that displays in the feed widget.

Where Do the Card Category Names Come From?

In most cases, the card category is the same name as the hub that posted the notification to the feed widget. So if you're a member of the design-team hub, and there's a meeting reminder for the design-team that gets pushed to its hub, you'll get a notification in your feed with the card category of "design-team."

There are special cases where the what the card category string should be may be less obvious:

1. '''Mention''': If a card pops into a personal feed because someone in a Fedora hub mentioned the owner of that personal feed (whether or not the person is a member of that hub in particular), the name of the hub is what the card category will be.
2. '''Private Message''': If a card pops into a personal feed to notify you that someone sent you a private message, the card category for that notification card will be your personal hub username.
3. '''No Associated Hub''': If a card pops into a feed widget but doesn't have a hub associated with it (for example, a bodhi notification,) then the name of the app that posted the message to fedmsg will be the card category.

Card Categories

Card categories list where a given card in the feed widget came from. They are displayed in the upper right corner of each individual card. Each card has one card category assigned to it that displays in the feed widget.

Where Do the Card Category Names Come From?

In most cases, the card category is the same name as the hub that posted the notification to the feed widget. So if you're a member of the design-team hub, and there's a meeting reminder for the design-team that gets pushed to its hub, you'll get a notification in your feed with the card category of "design-team."

There are special cases where the what the card category string should be may be less obvious:

1. '''Mention''': If a card pops into a personal feed because someone in a Fedora hub mentioned the owner of that personal feed (whether or not the person is a member of that hub in particular), the name of the hub is what the card category will be.
2. '''Private Message''': If a card pops into a personal feed to notify you that someone sent you a private message, the card category for that notification card will be your personal hub username.
3. '''No Associated Hub''': If a card pops into a feed widget but doesn't have a hub associated with it (for example, a bodhi notification,) then the name of the app that posted the message to fedmsg will be the card category.

Some progress was made on this recently in #122. Still a ways to go, though!