Instagram widgets

From SpinetiX Support Wiki

Jump to: navigation, search

This page is about Instagram data-driven widgets included into Elementi 2017 and Elementi 2018.

Introduction

Icon instagram widgets.png

These widgets – all included in our Elementi software right from the start – securely connect to Instagram and are purposely built for digital signage, bringing out the best of your social media content to any number and combination of screens. The result: connecting social media content that auto-updates and helps engage with your Instagram fans. Here are few applications of the Instagram widgets:

  • Promote your products on-site by using your Instagram page.
  • Showcase daily specials by posting on Instagram .
  • Source engaging media content directly from Instagram .

Getting started

Getting started is easy; download Elementi software, launch it and create away! Just follow the 4 quick steps below:

  1. Get Elementi.
  2. Open Elementi and on the main window, click on the "Widgets" tab.
  3. Scroll down and open the "Instagram" folder. Pick a widget.
  4. Include that widget into your content and configure it.

Instagram widgets

Elementi software comes with several Instagram widgets accessible from "Widgets" tab within the Browse panel of the Elementi GUI.

Instagram widgets in Elementi
  • Single Post
    Displays a single Instagram post using pre-formatted design. The images are displayed one after another, with or without a transition effect in between, similarly to a slideshow.
  • Multi Post
    Displays a one or more images on the same page using pre-formatted design. The images are displayed one after another, with or without a transition effect in between, similarly to a playlist.
  • Media Crawler
    Displays the images from Instagram using a continuous scrolling effect.
  • Media Playlist
    Displays a playlist of images from Instagram.
  • Media Crawler
    Displays the images from Instagram using a continuous scrolling effect.
  • Slideshow
    Displays slides composed of text & media layers, which are automatically filled out with the data from Instagram. The slides are displayed one after another, with or without a transition effect in between, similarly to a playlist.
  • Horizontal Table, Vertical Table, and Table
    Displays slides composed of multiple cells of text & media layers, which are automatically filled out with the data retrieved from Instagram. The slides are displayed one after another, with or without a transition effect in between, similarly to a playlist.


Note Notes:
  • Each of the widgets above can be customized using the options provided under "Properties" tab - for more details go to the dedicated page of each widget type, linked above.
  • These widgets can only be used on a single screen when creating a multiscreen project; for multiple screens, a data feed widget must be used instead.

Single Post

This widget displays a single post using pre-formatted design. The posts are displayed one after another, with or without a transition effect in between, similarly to a playlist. Note that only post with images are displayed with this widget.

Single Post properties

The following properties, found under "Properties" tab, can be used to customize the widget:

  • Data
    Click the Data Feed Properties button to open the Data Properties dialog and set up the data source.
  • Locale
    Select the locale used for displaying dates and numbers.
  • Slide duration
    Enter the number of seconds each slide is displayed on the screen.
  • Transition
    Click the Transition Properties button to open the "Transition Properties" dialog and select the transition effect and its properties.
  • Looping
    Select whether the widget ends after the last slide or loops to the first one.
  • Likes
    • Show Likes
      Select whether the number of likes should be shown.
    • Text
      Enter the text to be displayed next to the likes.

Multi Post

This widget displays one or more posts on the same page using pre-formatted design. The posts are displayed one after another, with or without a transition effect in between, similarly to a playlist. Note that all post with some text are displayed by this widget.

Multi Post properties

The following properties, found under "Properties" tab, can be used to customize the widget:

  • Data
    Click on the Data Feed Properties button to open the Data Properties dialog and set up the data source
  • Slide duration
    Enter the number of seconds each slide of tweets is displayed on the screen.
  • Transition
    Click the Transition Properties button to open the "Transition Properties" dialog and select the transition effect and its properties.
  • Looping
    Select whether the widget ends after the last tweet or loops to the first one.
  • Number of rows
    Enter the number of rows to be displayed on a single slide.
  • Number of columns
    Enter the number of rows to be displayed on a single slide.
  • Delay per cell
    Enter the number of seconds to wait before displaying the next cell of the table.
  • Headers
    • Show header
      Select whether the Instagram logo and the header text should be displayed.
    • Text
      Enter the text to be displayed next to the Instagram logo.

Configuration

Each of the widgets above can be customized using the options provided under "Properties" tab - for more details go to the dedicated page of each widget type, linked above.

Data source setup

Data Properties

To edit the properties related to the data source, click on the Data Feed Properties button. This opens the "Data Properties" dialog, which allows changing the following:

  • Account
    Select one of the connected Instagram accounts or click "Connect account..." if none was previously connected.
  • Selection
    Select the source of the data to be displayed between "My Posts", "My Likes", "Follow", "Search by Tag" and "Search by Location".
    • Username
      If "Follow" is chosen above, this option lets you enter the name of the user's data to be displayed.
    • Tag
      If "Search by Tag" is chosen above, this option lets you enter the tag to be searched.
    • Latitude, Longitude, Radius
      If "Search by Location" is chosen above, these options let you enter the location to be searched.
  • Size
    Select at which resolution the images are to be retrieved.
  • Max count
    Enter the maximum number of images to be retrieved.
  • Refresh
    Enter a number, optionally followed by s (implicit), m or h, to specify the period after which the widget should refresh the feed data (this is useful especially when the widget is running in a loop); the minimum accepted value is 60 seconds. Using "When document opens" will refresh the data only when the document is re-opened.


Note Notes:
  • At any point, the data source configuration can be tested by clicking on the "Test..." button.
  • Starting with April 4th 2018, Instagram Platform Team decided to immediately disable some capabilities (previously set for July 31, 2018 or December 11, 2018 deprecation), which resulted in the lost of the capability to display your user likes and the content of users you follow.

Secure data access

"Info"
Security is a fundamental element to consider when giving access to your personal data and we've created our data-driven widgets with that in mind. To ensure secure access and permission control, without exposing any user credentials, Cockpit must authorize any request for third-party data. For that, you need to do the following:
  1. Create a Cockpit account, if you don't have one.
  2. Register your Elementi license into your Cockpit account.
  3. Add your players into your Cockpit account.
  4. Connect your Instagram account to your Cockpit account.

Instagram channel connection

Using the Instagram widgets requires having your Instagram account connected with the Cockpit account where your Elementi license is registered. For that, follow these steps:

  1. Select the "Account" option as "Connect account...".
  2. Click the URL displayed within the "Connect Account..." dialog.
  3. The Instagram sign-in page is opened;
    • follow the steps on that page to sign into your Instagram account.
  4. Allow the SpinetiX app to access the specified information of your Instagram account.
  5. Return to Elementi and click the "OK" button within the "Connect Account..." dialog.
  6. At this point, your Instagram account appears in the "Account" drop-down box.


Note Note:
The Instagram account can be disconnected at any time from Cockpit from the "Channels" page.

Troubleshooting

See also

This page was last modified on 9 August 2018, at 17:04.