New App Action Contributions

Version 6

    NOTE: For a complete app action reference, refer to App Action Contribution Reference.

     

    What is it?

    In current release, Jive has introduced more app action contributions. That means apps can be integrated at more places within Jive.

    [Link to action contribution]

    What are the common use cases?

    • Displaying app links at various places in the Jive application

     

    How do I use it?

    Action contributions are added to the definition of an OpenSocial based application. They provide a distinct path--or place within the Jive UI, where a view of an application will be invoked. These are available in both an OpenSocial App that is part of a client app add-on, as well as a "regular" Jive App.

     

    Show me an example?

     

    Action Contribution - Top Nav Bar

    Path - jive/actions/navmenu

    Where will it show up - Top level create / edit navigation bar

    Screenshot from 2013-09-25 16:07:53.png

     

    Example

                <action id="com.jivesoftware.createModalNav"
                        path="jive/actions/navmenu"
                        label="Top Nav Action"
                        view="embedded.createModal"/>
    
    
    
    
    
    

     

     

     

    Action Contribution - Place Configuration

    Path -  jive/settings/places/space OR jive/settings/places/group OR jive/settings/places/project

    Where will it show up - Space / Group or Project creation modal

    • On Project/Place/Group page, click on Manage > Settings
    • Click Edit on "Project Features and Activity" tile

    Screenshot from 2013-09-25 16:33:13.png

    Example

                <action id="com.jivesoftware.configproject"
                      path="jive/settings/places/project" 
                      label="Project Config" 
                      view="embedded.config_project" />
    
    
    
    
    
    

     

    NOTES:

    • Developers can make use of "gadgets.actions.updateAction" to register callback function. On launch of the app, this callback will receive the current container (space / group or project) object

     

    Action Contribution - Place Tab

    Path - jive/tabs/places/space OR jive/tabs/places/group OR jive/tabs/places/project

    Where will it show up - Tab on Space / Group or Project detail page

    Screenshot from 2013-09-25 16:40:33.png

    Example

                <action id="com.jivesoftware.projecttab"
                      path="jive/tabs/places/project" 
                      label="Custom App Tab" 
                      view="canvas.tasks"/>
    
    
    
    
    
    

     

    NOTES:

    • On click of the tab, the appropriate view of app will get launched in canvas mode
    • Developers can make use of osapi.jive.core.container.getLaunchContext(function(resp){}); to retrieve the container (Space / Group or Project) information

     

    Action Contribution - Place Create Menu

    Path - jive/actions/places/space OR jive/actions/places/group OR jive/actions/places/project

    Where will it show up - Action menu of Space / Group or Project

    Screenshot from 2013-09-25 16:44:32.png

    Example

                <action id="com.jivesoftware.createModalProject"
                        path="jive/actions/places/project"
                        label="Custom Create"
                        view="embedded.createModal"/>
    
    
    
    
    
    

     

    NOTES:

    Developers can make use of "gadgets.actions.updateAction" to register callback function. On launch of the app, this callback will receive the current container (space / group or project) object

     

     

    Action Contribution - User Actions

    Path - jive/tabs/actions

    Where will it show up - Tab on Action left menu

    Screenshot from 2013-09-25 16:49:36.png

     

    Example

                <action id="com.jivesoftware.self"
                        path="jive/tabs/actions"
                        label="Custom Tab"
                        view="embedded.customTab"/>
    
    
    
    
    
    

     

    NOTES:

    • On click of the link, the appropriate view of app will get launched in canvas mode

    Action Contribution - User Profile

    Path - jive/tabs/profile

    Where will it show up - Action on User Profile Page

    Screenshot from 2013-09-25 16:55:32.png

    Example

                <action id="com.jivesoftware.others
                        path="jive/tabs/profile"
                        label="Custom Tab"
                        view="embedded.taskList"/>
    
    
    
    
    
    

     

    NOTES:

    • On click of the link, the appropriate view of app will get launched in canvas mode
    • Developers can make use of osapi.jive.core.container.getLaunchContext(function(resp){}); to retrieve the container (User) information

     

    NOTE: For a complete app action reference, refer to App Action Contribution Reference.