On Mon, Feb 23, 2009 at 9:31 AM, Attila Nagy <[email protected]>wrote:
> Hi Chris! > > It's nice to go through the list of parameters, since it's difficult > to find out the meaning of each parameters. > > Just a few questions: > > > http://<SHINDIG>/gadgets/ifr > > ?synd=<YOURCONTAINERNAME> > > Isn't the synd parameter outdated yet? As I see in the php code, the > container parameter supersedes it. it is indeed, however some gadgets still use it, so I have the suspicion it's safer to use both for a while more > > > > &container=<YOURCONTAINERNAME> > > > &viewer=<VIEWER ID> > > &owner=<OWNER ID> > > Is it necessary to pass the viewer and owner id's here? They are > encoded in the token, and I believe that is more secure. > The security token is fine and well from the server's point of view, but javascript has no way to decode security tokens, so from it's perspective it's nice-to-have info :) > > > &aid=<APPLICATION ID, CAN BE NUMERIC OR GADGET URL> > > &mid=<MODULE ID (AKA '4TH GADGET ON THIS PAGE') > > &country=<COUNTRY CODE> > > &lang=<LANG CODE> > > *&view=<INSERT VIEW NAME HERE: profile, home, canvas, preview> > > *&parent=<CONTAINER URL> > > > > &up_<FOO>=<BAR> > > Are the up_ prefixed parameters free for use? > Any user preference should be passed on the iframe url in the format of &up_<UP NAME>=<UP VALUE>. > > &st=<LONG ENCRYPTED TOKEN> > > &v=<CACHE BUSTING MD5 OF THE GADGET XML> > > &url=<URL OF GADGET'S XML FILE> > > #rpctoken=<RANDOM UNIQUE NUMBER> > > I believe it's worth to mention the nocache or the bpc (bypass cache) > parameter, that forces shindig to reload the given gadget. (Sandbox) > container implementers usually will need this. > Correct, both nocache=1 (standard way of doing things), as well as &bpc=1 (old orkut style) is supported, however only add that to the url when developing please, else you'll break your servers :) > Because I had some time figuring out the meaning of those values too, > I've dropped your notes to the cwiki: > http://cwiki.apache.org/confluence/display/SHINDIG/iframe+url+format > Awesome, thanks for doing so! > > -- > Nagy Attila Gabor >
