Using the Alternate Experience URL

Version 1

    Overview

    Jive App developers are now able to specify an alternate experience URL, which will be used in place of consuming the embedded experience if it isn't normally possible for the user to do so. Functional details are discussed in the following doc. The functionality is as follows:

    If the URL is provided, and if the app artifact link is clicked within Jive:

     

    • Guest (anonymous) users will be redirected to the URL in a separate window.
    • Users who have not yet installed the app will get the embedded market, and it will surface a link. Clicking that link will take the user to that site in a separate window. Note that the embedded apps market needs to handle the case of unavailable or banned/blacklisted app.

     

    New .closeApp arguments

    Apps will be permitted to call the container .closeApp(..) function with an updated format which is consistent with the Opensocial 2.5 spec.

     

    Example using icon:

    {

        "url": "http://www.yahoo.com",

        "context": {

            "id": "EDIT_ME_ID",

            "lastUpdated": "2012-Jan-23"

        },

        "preferredExperience": {

            "target": {

                "type": "gadget",

                "view": "embedded.json"

            },

            "display": {

                "type": "text",

                "label": "JAF Delux Productions",

                "icon": "http://apphosting.jivesoftware.com/apps/livedev/aron.racho/rtejsondropper/images/dropper-16x16.png"

            }

        }

    }


    Example using preview image:

    {

        "url": "http://www.yahoo.com",

        "context": {

            "id": "EDIT_ME_ID",

            "lastUpdated": "2012-Jan-23"

        },

        "previewImage": "http://apphosting.jivesoftware.com/apps/livedev/aron.racho/rtejsondropper/images/dropper-128x128.png",

        "preferredExperience": {

            "target": {

                "type": "gadget",

                "view": "embedded.json"

            },

            "display": {

                "type": "image",

                "altText": "JAF Delux Productions"

            }

        }

    }

     

    Notes:

    1. The original format used by Jive will still be supported.
    2. Icons or preview images can be relative to gadget.xml, or absolute.