Wildfire offers a wide array of possibilities for customizing the Posting Content to Social Networks operation, such as: defining which social networks are supported, defining specific content that is to be posted to different networks, etc.
The Post to Social Network Parameters page, is a reference guide to the various configuration parameters associated with the Post operation.
This page discusses the following subjects:
- Network Section Names - This section lists the sections available for different social networks supported by Wildfire.
- Best Practices - This section lists guidelines that will help ensure your widget is successfully embedded in every Social Network.
- Posting Layouts - This section provides guidance on posting layouts using Wildfire.
- Issues specific to particular social networks are discussed in following child pages:
Network Section Names
The following table lists the sections that are available for different social networks supported by Wildfire.
You can restrict the list of sections displayed in the section selection dropdown by using the various [network-name]Sections parameters.
If a single section is available to a certain network, that section will be displayed without the section selection dropdown.
| Social Network | Available Sections |
| MySpace | About, Blog, Meet, Interests, Music, Movies, Television, Books, Heroes, Artist_Bio, Artist_Members, Artist_Influences, Artist_Sounds_Like, ProfileLayout, BlogLayout, AllLayouts |
| Friendster | ProfileLayout, Media, About, Meet |
| Tagged | aboutme, mywall |
| Hi5 | About, Interests, FavoriteMusic, FavoriteTVShows, FavoriteMovies, FavoriteBooks, FavoriteQuote |
| BlackPlanet | PersonalMessage, Blog |
| MiGente | PersonalMessage, Blog |
| Ameba | BlogSidebar, Profile |
Note:
Layout sections are meant to be used in conjunction with the
contentIsLayout parameter and will be displayed only if the contentIsLayout parameter is set to "true". This subject is explained in detail under the
Posting Layouts heading.
Example:
To restrict MySpace to show only the "About me" and "Who I'd Like to meet" sections, add the following to your configuration object:
conf['myspaceSections'] = 'About,Meet';
To force all MiGente posts to go to the blog:
conf['migenteSections'] = 'Blog';
Note: This example assumes the definition of a configuration object named 'conf', as described in the
Wildfire Configuration section in the Developer's Guide.
Best Practices
Technical best practices may vary by social network. Incorporating all of these guidelines will help ensure that your widget is distributed as widely as possible and is successfully embedded wherever your users want it to be.
This section provides some general embed code guidelines, followed by a table which elaborates the different capabilities of major social networks.
Additionally, you may find site-specific guidelines in each of our site-specific sections:
Embed Code Guidelines:
- We recommend avoiding <Javascript> and <iframe> tags in your embed code, as most social networks will block or strip out <Javascript> and <iframe> code when posted to a user’s profile, due to security reasons. The preferred type of embed code for Flash-based widgets will use HTML <object> and/or <embed> tags.
- Use a nested <object ...>...<embed ...></embed></object> embed code for the defaultContent parameter. Please follow this form:
<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,28,0" width="400" height="300" id="widget_name">
<param name="movie" value="http://www.domain.com/path/to/widget.swf" />
<param name="quality" value="high" />
<param name="allowScriptAccess" value="always" />
<param name="allowNetworking" value="all"/>
<embed src="http://www.domain.com/path/to/widget.swf" quality="high" allowScriptAccess="always" allowNetworking=”all” pluginspage="http://www.adobe.com/shockwave/download/download.cgi?P1_Prod_Version=ShockwaveFlash" type="application/x-shockwave-flash" width="400" height="300" name="widget_name"></embed>
</object>
- Make sure the classid attribute is included in the <object> tag. Without it, Internet Explorer running on PCs may display a security warning message in certain situations. Make sure the codebase attribute is included as well. The object tag should look something like this:
<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,28,0" ...> ... </object>
- The <embed> tag should use a closing </embed> tag instead of the abbreviated <embed ... /> form. This is for LiveJournal and Blogger.
- We recommend a width of 350 pixels for your widget to be viewed properly across all social networks.
Alternatively, if you wish to optimize your widget's size, you can create several instances of your widget in different sizes. Use the [network-name]Content parameter to define the widget which is to be posted to a specific social network. The following table elaborates maximum widths for widgets to be posted to social networks: | Social Network | Max Width | Variable | Resolution- Dependent | Theme- Dependent |
| Bebo | 350 | | | |
| BlackPlanet | 420 | | Yes | |
| Blogger | 410 | | | Yes |
| Facebook | 580 | | | |
| Freewebs | 510 | | | Yes |
| Friendster | 510 | Yes | Yes | |
| hi5 | 450 | | | |
| iGoogle | 400 | Yes | | |
| Live Spaces | 350 | | | |
| LiveJournal | | Yes | Yes | |
| MiGente | 420 | | Yes | |
| Multiply | 620 | | Yes | |
| MySpace | 420 | | Yes | Yes |
| MyYearbook | 490 | | Yes | |
| Netvibes | 410 | Yes | | |
| Orkut | 660 | | | |
| Piczo | | Yes | Yes | |
| Plageflakes | 410 | Yes | | |
| Tagged | 470 | | | |
| TypePad | 630 | | | Yes |
| Vox | 480 | | | |
| WordPress | No limit, scales to 450px | | | Yes |
- Sites that disable JavaScript access, such as MySpace, Friendster, Orkut, and LiveSpaces, prevent outbound links from Flash widgets. To walk around this issue, add code that will display a copy URL box to your widget.
Whitelisting:
Some social networks require that widgets be whitelisted; otherwise, their embed code will be stripped out when posted. The social networks that require whitelisting are currently Friendster and Hi5 (follow these links for guidance on how to add your widget to the relevant social network's whitelist).
Posting Layouts
Wildfire supports posting layouts to MySpace and Friendster.
When providing layout content, you generally need to perform the following three actions:
- On your configuration object, set the contentIsLayout parameter to 'true'.
- Decide which of the layout destinations (sections) you wish to support.
- Provide suitable content.
The following sections describe these steps in detail: