Is there anything built into the API for displaying and capturing user preferences on the front-end side? For example, is there anything similar to the <UserPref> tags offered in the iGoogle API? Or would I need to build a custom form for capturing user preferences using <yml:form>? Then I can save and manage them using gadgets.Prefs from the OpenSocial API right?

Thanks Jon. Quick follow-up question...

I'm trying to set preferences by doing something along the lines of:

var prefs = new gadgets.Prefs();
prefs.set('key', 'value');

I'm getting the following error:

Error: setprefs feature required to make this call.
Source File: http://l.yimg.com/kj/yap/combo?/common/js/...jzEFXUKkxxQ-.js
Line: 28

I read the following in the docs:

"YAP supports the Gadget Core APIs, except for Prefs, Views, and the Feature-Specific API."
"However, YAP v1.0 does not support the OpenSocial RESTful API or Gadget XML definitions."

Can I set prefs or is this functionality not yet supported? If it is supported, how do I require the setprefs feature? Since YAP doesn't support GadgetXML definitions, I don't think I can use <Require feature="setprefs"/> in the ModulePrefs correct?

I'm fetching and displaying content from my own custom RSS feed. I'd like to let users set preferences/settings for things like:

- how many items they would like to display.
- which dates (pubDate RSS node) to display items from.
- which categories (category RSS node) to display items from.

So basically these would be preference specific to my application, not related to OpenSocial or YAP functionality/integration.

This is easily done with Google Gadgets by using <UserPref> tags and gadgets.Prefs from the OpenSocial API.

Without <UserPref> and gadgets.Prefs support, I'd have to code my own HTML form to capture the user preferences, but they would only persist for the user's current session; I couldn't save them for return use.