Example of a gift registry Atom feed rendered in a remote widget

An Atom feed for a gift registry provides data about the registry event for display in a remote widget. To customize the feed formatting JSP files for the Atom feed, you must understand how the XML elements in the JSP files map to the text and images a customer sees in the remote widget.

This example shows a gift registry remote widget created in KickApps App Studio using a WebSphere Commerce template. The template specifies which elements from the feed to display. The numbered callouts in the screen capture show the data coming from the Atom feed. The text and images that are not marked with a callout are editable parts of the widget template.

The WebSphere Commerce remote widget templates do not use the Atom standard <content> element in the feed formatting JSP file to display each feed entry. Instead, the templates use Atom extension elements that are also provided in the feed formatting JSP file. These extension elements provide more granular feed data for display in Flash widgets. This makes it easier to edit and rearrange the data in the widget. If you are customizing a feed formatting JSP file to add an additional piece of data from the gift registry to a feed for a remote widget, you must add a new Atom extension element.

Feed data	Type of data	Atom element	Feed formatting JSP fragment
1	Gift registry name	<title>	SerializeGiftListDataAtom.jspf
2	Number of items listed in the gift registry that have not been purchased	Atom extension element: <totalItemsNeeded>
3	Number of items listed in the gift registry that have already been purchased	Atom extension element: <totalItemsBought>
4	This button supports a link to the storefront to display the gift registry associated to this widget. (The button itself is part of the widget template).	<link>
5	Event month	Atom extension element: <eventMonthDesc>
6	Event day (numeric)	Atom extension element: <eventDay>
7	Event year	Atom extension element: <eventYear>