Facebook

Controlling the Posting Destination

Use the useFacebookMystuff configuration parameter to control the destination of your Widget.

To post your Widget to the Newsfeed section in Facebook, set the useFacebookMystuff configuration parameter to 'false':

conf['useFacebookMystuff'] = 'false';  // This will cause your Widget to be posted to the Newsfeed section

If the useFacebookMystuff parameter is set to 'true' or is not set at all, your widget will be posted to "My Stuff", a designated Facebook application.

Posting to Newsfeed

Please note that Facebook resizes Flash content and preview images to fit the Newsfeed. The resize logic is as follows:

• Widget - Unless scaling is disabled, Facebook will scale every Widget to be exactly 320 pixels wide. If the Widget is smaller then 320 pixels wide, Facebook will scale it up. As this may produce undesirable results, we recommend disabling scaling in such a case.
  

  // AS2:
  if (Stage.width < 320)  Stage.scaleMode = "noScale"; 
  
  // AS3:
  if (this.stage.stageWidth < 320) this.stage.scaleMode =flash.display.StageScaleMode.NO_SCALE;

• Preview image - The size limit for the Facebook Newsfeed preview image is 160 pixels wide. By default, Wildfire will resize your default preview image to match the specified size limitation. If you wish to override this behavior, please use the facebookPreviewURL3 configuration parameter and provide your own 160-pixel wide preview image. The value of this parameter should be the URL of your Facebook Newsfeed preview image:

  conf['facebookPreviewURL3'] = "http://mySite/images/previewImage160px.gif";

Posting to "My Stuff"

"My Stuff" is a Facebook application created by Gigya to serve as a container for Widgets on the Facebook platform. 

When the user posts a Widget to My Stuff, it will appear in its full size on the My Stuff page. Additionally, while posting, users are given the option to publish their Widgets in a few other locations:

• Newsfeed - The user may choose to "Share" the Widget, by pressing the "Share" button. If the user decides to share, the Widget will appear in his Newsfeed section. In this case, the behavior of the Widget and the preview image follow the description above in the  Posting to Newsfeed section.
   
• When posting, the user may click on the "Add to Profile" button, and publish a preview of the Widget in two locations:
   

  • The Boxes Tab and the "My Stuff" Tab - In this case a preview image is displayed in these tabs. Clicking on the preview image will open the full-sized Widget.
    
    
    
    The size of the preview image is equivalent to the Widget's full size. By default, Wildfire will automatically generate a preview image for your Widget from your Flash content. If you wish to override this behavior and provide your own preview image, you may do so by using the facebookPreviewURL configuration parameter. The value of this parameter should be the URL of your preview image:

    conf['facebookPreviewURL'] = "http://mySite/images/previewImage.gif";

     

  • Wall Tab - In this case, a preview image is displayed in this tab. Clicking on the preview image will open the full-sized Widget in the My Stuff page.
     
    The size of the Wall Tab preview image is limited to 184 pixels wide and 208 pixels high. By default, Wildfire will resize your default preview image to match the specified size limitation. If you wish to override this behavior and provide your own 184x208 pixel preview image, you may do so by using the facebookPreviewURL2 configuration parameter. The value of this parameter should be the URL of your Facebook Profile Box preview image:

    conf['facebookPreviewURL2'] = "http://mySite/images/previewImage184x208px.gif";

Ask Gigya to Create a Custom Branded Facebook Application

You can request to have a Custom Branded Facebook application be created for you. contact us via support@gigya-inc.com so that we can setup a dedicated Facebook application for you. When the setup is complete, we will send you an ID number for your dedicated application. Once received, please proceed to add the facebookAppID parameter to Wildfire and set its value to the ID number you received. For example:

conf[‘facebookAppID’]="123";

Open your Own Facebook Application

If you have created your own designated Facebook application, you may instruct Wildfire to post Widgets to your Facebook application, using the facebookURL configuration parameter. The value of this parameter should be the URL that you would like Wildfire to open when your users post to Facebook.