Requirements Before You Begin
Access to the Signagelive Web Triggers API (sign up here)
Using Bubble.io, you can build apps that work in conjunction with the Signagelive Web Triggers API, allowing you to control your Signagelive Players remotely from anywhere in the world.
The possibilities are endless, so in this article, we will cover the basics of creating an app and pairing it with your Signagelive Network and Players. See the video below for a full walkthrough:
Creating an app
Log into your Bubble.io account and head to the Apps page
Select Create an app
Name your app and then click Get Started
In the top left-hand corner, click the Page:index drop-down, then click on Add a new page…
Give your page a name, and we’ll be ready to begin!
Immediately, you’ll be presented with a blank canvas to which you can begin adding elements. At this stage, we recommend starting by adding the Signagelive Plugin, which will be covered in the next section.
Importing and Configuring the Signagelive Plugin
Click on the Plugins menu located at the left-hand side of the bubble.io user interface
Click Add Plugins
Search for “Signagelive”, and you’ll find the Signagelive Web Triggers API plugin
Press Install, then close the Install New Plugins module
Please Note
By default, when Bubble.io queries our API, it returns All Players as a single entry; therefore, we recommend installing the free Toolbox plugin from Bubble.io this allows you to run Javascript functionality so that the data returned is automatically segmented out (and saves you having to do it manually!)
API Actions and What They Do
Below is a list of the available API Actions included in the Signagelive Web Triggers API plugin in bubble.io. For more information, see our Build Site.
All Players - retrieves a list of all Players on your attached Signagelive Network
All Groups - retrieves a list of all Groups on your attached Signagelive Network
Create Group - this will create a new Group of Players that will then be sent back to the Web Triggers API
Add Player To Group - Adds selected Players to whichever Group ID you have specified
Remove Player from Group - Removes selected Players to whichever Group ID you have specified
Get Triggers - gets a list of all available Triggers
Send Message - this allows you to send available Triggers to your specified Groups or Players
Remove Group - deletes specified Player Groups
Configuring your Data Types
Before building out your app's workflow, we need to define what data will be available from the moment a user reaches the home page of your app (for example, what Signagelive Network we are pulling data from). To do so, follow these steps:
Click on the Data menu located at the left-hand side of the bubble.io user interface
Click on the Data Types tab
In the New Type field, enter your specified Data Type
In our case, we’re going to create a data type called API (see video above), which will contain fields for your Signagelive Network ID, and the API Key and the API ID - this information would be supplied by our development team when you sign up for access via this form,
Once the Data Type and Fields have been created, head over to the App Data tab
With All APIS selected (on the left) click the New Entry button (this entry is to be added to the APIs area, which is why you need to ensure this is selected)
Complete each field with the information that had been supplied to you by our Signagelive Team after you had initially signed up for the Web Triggers API (you can leave the Slug field blank)
As per 5:20 of the video attached to this article, we recommend creating data types for your Triggers and Players as a minimum.
Upon completing the steps above, you will have successfully linked your Signagelive Network to your Bubble.io application.
Please Note
Depending on your use case, you will, of course, likely require more data types. Due to the endless possibilities here, we have only included the data type specific to linking your app to your Signagelive Network in this article (and Triggers and Players in the video above). Should you want advice on adding other data types into your Bubble.io application, we recommend referring to Bubble.io's own documentation for more advice on building out your databases unique to your use case.
Workflows, Recurring Workflows and Actions
As per the section above, how you wish to build your application will depend on your use case. Therefore, we recommend reviewing Bubble.io's own documentation for further advice on building these. See below:
If you need any further information, you can always check out our Build Site or see the following articles below: