You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

What is a Launcher button?

A Launcher button is another way your app can integrate into the Flock desktop and mobile clients and enable your users to Launch your app.

Launcher bar and Launcher buttons on desktop, as highlighted in red in the image below:

Apps tab and Launcher buttons on mobile:

The Launcher button of your app can be used to open a widget, open a browser or send an event to your app service. For eg

  • The Todo app uses the Launcher button to open a sidebar widget showing all the todo lists within that team
  • The Github app uses it to open a modal widget allowing one to configure the app

What are the available actions for a Launcher button?

When a user presses the Launcher button, you can configure it to do one of the below:

  • Launch a modal widget
  • Launch a sidebar widget
  • Launch a browser
  • Send an event to your app service

Alongwith launching the above widgets or browser, a client.pressButton event will also be passed as a parameter to the web app URL loaded in any of the above widgets or browser

How do I create a launcher button?

  1. Go through Creating an App to setup your app in the developer dashboard.
  2. In the Advanced Info section, enable the Launcher button.

    <launcher button image>

  3. Provide the below details:

    Tooltip textThis will be shown against your Launcher button to the user

    Select an appropriate action for the Launcher button

  4. Go through app installation and install this app into your own Flock account
  5. Whenever a user presses the Launcher button, the event client.pressButton along with a validation token will be appended to the corresponding client action you selected and sent to your service
  6. Verify the validation token and take the relevant action at your end

Code Samples