Publishing KickApps Widgets

From KickApps Documentation

You can publish your widgets on any web page that accepts HTML embeds, including Facebook and MySpace. There are several ways to publish widgets:

1. Copy widget embed code onto a web page.
2. Click-through to post your widget to Facebook, Twitter, or MySpace
3. Install widgets on your KickApps pages
4. Install widgets on Facebook page tabs

Contents 1 Copy widget embed code onto web pages 2 Post your widget on Facebook, Twitter, or MySpace 3 Install widgets on your KickApps pages 4 Special Note on Feeds 5 Changing the Default Player on Community Homepage

Copy widget embed code onto web pages

To add a widget to a web page by pasting its embed code,

1. Select File > Publish.
2. Click on a widget in your widget list.
3. The embed code for your selected widget is located in the text field under the "Publish to the web" tab at right. The dropdown above this field enables you to pick from two different types of embed code:
   1. Use Compatible embed code if you're embedding on a 3rd party site that doesn't support JavaScript (like MySpace)
   2. Use JavaScript embed code if you're embedding on your own site or any other site that doesn't mind if you use JavaScript. The JavaScript embed code has some powerful features, including the ability to specify alternate content for agents that don't have Flash (this is great for getting the pages containing your widgets indexed by search crawlers) and Flash version detection and automatic upgrades (to ensure people viewing your widget have the appropriate version of the Flash player that will render it). It also has a workaround for an issue in some browsers that forces the user to click in before loading your widget. JavaScript embed code is the preferred method for deploying KickApps widgets.
4. Once you've selected the type of embed code that you need, click the "Copy Embed Code" button to copy the code to your clipboard.
5. Paste the widget embed code into an HTML file, your profile on a social networking site, or anywhere else that accepts HTML embeds.

Post your widget on Facebook, Twitter, or MySpace

1. Select File > Publish.
2. Click on a widget in your widget list.
3. Click the "Publish to the web" tab under the widget preview image. You'll see buttons for Facebook and MySpace.
4. Click the Facebook icon to add your widget to Facebook, the Twitter button to add your widget to Twitter, or the MySpace button to add your widget to MySpace.
5. Follow the instructions to log in and add your widget to the network you've chosen.

Install widgets on your KickApps pages

If you're using KickApps apps that provide hosted web pages, follow the directions below to install widgets to these pages from the App Studio. If you're not using KickApps hosted pages, you should be! Learn how.

1. Select File > Publish
2. You'll be taken to the Widget Manager. In the Widget Manager, select the Publish to KickApps pages tab beneath the widget preview image.
3. Within this tab, check off the boxes next to the pages to which you'd like to publish your widget. If you're not sure which page is which, click their titles to visit them in a new browser tab.
4. To assign different widgets to different pages within the same screen, click the "Manage widgets on all KickApps pages" link, and such a screen will appear in a pop-up.
5. Click Save. Your updates will go live within 5 minutes.

Special Note on Feeds

When you publish a widget to a KickApps page, the widget's content will be populated dynamically by the page. For example, if you assign a particular feed or video to a video player in its Content panel in the App Studio, and then publish that video player to your KickApps-hosted video play page per the instructions above, when the video player loads on your video play page, it will play the video associated with that page, rather than the feed or video you assigned it in the App Studio. If you prefer to override the content supplied by the page with the content setting you make in the App Studio, you can do so by applying an Action on the component whose content you wish to define in the App Studio.

Changing the Default Player on Community Homepage

For example, by default the video player installed on the KickApps-hosted Community Homepage is set up to play the most recent video. If you would like it to play a different video or feed, open up the video player assigned to the Community Homepage in the App Studio, and:

1) Select the video player component, and

2) Add a new Action to it:

   Event => "Component Loaded"
   Action => "Update Property"
   Component => your video player name
   Property => "mediaURL"
    MediaURL ==> see Step 3, below

3) The value of "mediaURL" should be the URL of the feed or video you wish to play. (Tip: if you want to play a feed saved in the Feed Builder, go to the Feed Builder, select that feed, and click the Copy URL button near the top of the right column - it will be something like:

 http://serve.a-feed.com/service/getFeed.kickAction?feedId=900256&as=1234567).

4) You can leave the Select Feed: setting under Content on the AppStudio widget page alone, whatever you set here is overridden by the Action above.

Note: if your widget is larger than the space allotted for it in the selected page, you may need to alter the slot dimensions using CSS - or reduce your widget size!