|
|
|
|
Gigya's Developer Documentation > Wildfire Sharing Tool > API Reference > Configuration Parameters > Post to Social Network Parameters
Post to Social Network ParametersFrom $1Table of contents
The following parameters are associated with the Post operation:
defaultContentThe content to be posted. The content is a piece of HTML code or it may also be a text-area id (in case of JavaScript). Wildfire will post this content to the social network that was selected by the user.
[network-name]ContentIt is possible to specify different content to post for each social network supported by Wildfire. For this purpose, there are various parameters with the same name format: [network-name] (i.e. myspace, facebook, friendster, etc.) followed by "Content". For example: myspaceContent - The content to be used specifically for myspace. The content specified by [network-name]Content overrides the content specified by the defaultContent parameter, for the specific network. In other words, defaultContent is the content to be used by default for all social networks and [network-name]Content is the content to be used for the specific network. If the content includes the string "$network$", then on automatic posts it will be replaced with the network's name or with the word "unknown" if the code has been copied from a codebox. Usage Example:conf['myspaceContent'] = 'content posted to MySpace'; conf['facebookContent'] = 'content posted to Facebook'; conf['defaultContent'] = 'content posted to all other networks';
[network-name][section-name]ContentIt is possible to specify different content to post for each section of each social network. For this purpose, there are various parameters with the same name format: [network-name] (i.e. myspace, facebook, friendster, etc.) followed by [section-name] (i.e. About, Blog, ProfileLayout, etc.) followed by "Content". For example: myspaceProfileLayoutContent, The content to be posted specifically to myspace to the profile-layout section. You may find the list of section available for each network here. The content specified by [network-name][section-name]Content overrides the content specified by the defaultContent and by the [network-name]Content parameters, for the specific network and specific section. In other words, defaultContent is the content to be used by default for all social networks, [network-name]Content is the content to be used by default for the specific network for all sections and [network-name][section-name]Content is the content to be used for the specific network and specific section. If the content includes the string "$network$", then on automatic posts it will be replaced with the network's name or with the word "unknown" if the code has been copied from a codebox. Usage Example:conf['myspaceBlogContent'] = 'content posted to MySpace Blog section'; conf['myspaceContent'] = 'content posted to MySpace (all sections but Blog)'; conf['friendsterMediaContent'] = 'content posted to Friendster Media section'; conf['defaultContent'] = 'content posted to all other networks';
[network-name]UsernameIt is possible to specify a different usename for each social network supported by Wildfire. For this purpose, there are various parameters with the same name format: [network-name] (i.e. myspace, facebook, friendster, etc.) followed by "Username". For example: myspaceUsername – The user-name to be be used specifically for myspace. The name specified by [network-name]Username overrides the name specified by the defaultUsername parameter, for the specific network. Usage Example:conf['myspaceUsername'] = 'Bobo'; // MySpace user-name conf['facebookUsername'] = 'Momo'; // Facebook User-name conf['defaultUsername'] = 'Gogo'; // User name for all other networks
[network-name]SectionsA comma separated list of sections to be displayed in the section selection drop-down for the specific network. Only valid section names for the specific network will be displayed. If the result of this is that only a single section is to be displayed then it will be used but the dropdown will not be displayed at all. It is possible to set different sections for each social network supported by Wildfire. For this purpose, there are various parameters with the same name format: [network-name] (i.e. myspace, facebook, friendster, etc.) followed by "Sections". For example: myspaceSections - A comma separated list of sections to be displayed in the section selection drop-down specifically for myspace. Usage Example:conf['myspaceSections'] = 'About,Meet'; // restrict MySpace to show only the "About me" and "I'd Like to meet" sections conf['migenteSections'] = 'Blog'; // force all Migente posts to go to the blog
defaultPreviewURLUsing this parameter you can supply a URL of an image that will be used as your widget's preview image on all the networking sites which support such previews (such as Facebook). By default, if this parameter is not set, Wildfire will automatically create a preview for your widget.
[network-name]PreviewURLIt is possible to set different preview images for each social network that supports previews. For this purpose, there are various parameters with the same name format: [network-name] (i.e. facebook, igoogle, etc.) followed by "PreviewURL" For example: facebookPreviewURL specifies a preview to be used specifically for facebook. The URL specified by [network-name]PreviewURL overrides the URL specified by the defaultPreviewURL parameter, for the specific network. Usage Example:conf['myspacePreviewURL'] = 'http://mysite.com/images/myspacePreviewImage.jpg'; conf['facebookPreviewURL'] = 'http://mysite.com/images/facebookPreviewImage.jpg'; conf['defaultPreviewURL'] = 'http://mysite.com/images/defaultPreviewImage.jpg'
contentIsLayoutA boolean value indicating if the content is a layout. If set to 'true', there will be no sections' selection dropdown and the default section will be automatically decided. By default contentIsLayout value is "false". In this case, only sections which are not layout related are displayed in the sections' selection dropdown. Please refer to Posting Layouts for detailed explanation on the subject.
includeShareButtonA boolean that when set to 'true' causes Wildfire to append a "Share" button to your posted widget. Pressing a "Share" button sends the user to a page where he can share your widget with his email friends. The following screen-shot shows a preview of content being posted to Myspace, with the appended "Share" button:
showEmailAfterPostA boolean parameter, which determines if Wildfire offers the user to send an email to his friends after successful posting. The default value is "true".
Post to Facebook Parameters
useFacebookMystuffA boolean parameter. This parameter effects posting to Facebook. If this parameter is set to 'true', your widget will be posted to the "My Stuff" designated Facebook application. If this parameter is set to 'false', your widget will be posted to the "newsfeed" section in Facebook. By default, if you do not set this parameter, Wildfire will post you widget to "My Stuff" application. Please note that Facebook resizes flash content to fit the newsfeed and resizes preview images shown to users. The size limits are as follows: When posting widgets to Newsfeed ("Share"): Facebook will scale every widget to be exactly 320 pixels wide, unless scaling is disabled. If the widget is smaller then 320 pixels wide, Facebook will scale it up. This may give an undesirable result, thus we advise disabling scaling in such case. Preview image maximum size 160 pixels wide.
facebookPreviewURL2Using this parameter you may specify a URL of an image that will be used as your widget's preview image on the Wall Tab (Profile Box) section of Facebook. Facebook Wall Tab preview image has a size limit of maximum 184 pixels wide and 208 pixels high. By default, if you do not set this parameter, Wildfire will resize the default preview image, to match the specified size limit. The URL specified by facebookPreviewURL2 overrides the URL specified by the defaultPreviewURL and the [network-name]PreviewURL parameters, specifically for Facebook Wall Tab section.
facebookPreviewURL3Using this parameter you may specify a URL of an image that will be used as your widget's preview image on the Newsfeed section of Facebook. Facebook Newsfeed preview image has a size limit of maximum 160 pixels wide. By default, if you do not set this parameter, Wildfire will resize your default preview image, to match the specified size limitation. The URL specified by facebookPreviewURL3 overrides the URL specified by the defaultPreviewURL and the [network-name]PreviewURL parameters, specifically for Facebook Newsfeed section.
facebookAppIDThis parameter may be set with a Facebook application ID number. This will direct Wildfire to post your widget to the specified application rather to "My Stuff" when being posted to Facebook. You may contact Gigya and request to have a custom branded Facebook application be created for you, you will receive in return a facebook application id number, to be used with this parameter.
facebookURLBy default Wildfire will automatically post your content to Facebook using the specially created Wildfire application on the Facebook platform. This application will automatically handle everything for you, including the creation of images from your flash content. However, if you wish to override this behavior and open your own Facebook application you may use this parameter to provide the URL that Wildfire should open.
Deprecated ParametersThe following parameters are deprecated and should not be used. They are documented for backward compatibility.
useFacebookNewsfeed - Deprecated. A boolean parameter. If this parameter is set to 'true', your widget will be posted to the "newsfeed" section in Facebook. This parameter should no longer be used, please use useFacebookMystuff instead.
useMyspaceAPI - Deprecated. A boolean that tells the system to use the public myspace API for posting. Please note that when you enable this your widget code must be shorter then 1900 chars or the posts might fail. The default is false.
bulletinSubject – Deprecated. bulletinSubject is no longer supported for myspace. In myspace bulletin is now treated like any other section, please use widgetTitle instead.
bulletinHTML – Deprecated. bulletinHTML is no longer supported for myspace. In myspace bulletin is treated like any other section, please use regular content parameters instead. (i.e. myspaceBulletinContent, myspaceContent and so on.)
Tags:
|
||||
|