The Digitalskilting.com Portal allows you to manage your content and Players. On the left side of the Digitalskilting.com Portal, there is a main menu which provides all the navigation you need during your day-to-day usage of Digitalskilting.com.

 

Main Menu
This main menu includes the following sections:


Media - upload your Media files to be used by the Players


Playlists - setup a Playlist, which is made up of sequences of Media and Widgets that are shown one after the other 

 

Widgets - use Widgets, which are small applications designed to show information, like RSS tickers, clocks, text-based content, and more


Shows - create layouts, arranging Playlists, Media or Widgets on a virtual screen


Schedules - create a date/time-based Schedule to set which Show, Media or Playlist should be displayed 


Monitors - setup your Players and assign them Default Content to use and, optionally, a Schedule for time-based content overrides


These are the sections you will be using in order to manage your content and your Players.

Main Area
In the middle area of the Portal, you see the respective parts of the Digitalskilting.com Portal when you will click on them. These include lists of Media, Playlists and other content files you have created as well as other configuration forms that you may use throughout the Digitalskilting.com Portal.

Settings Menu
In the top-right corner, there is a drop-down configuration menu. This contains all the stuff that you rarely access:


My User Profile - settings that have to do with you, as a User of your Digitalskilting.com Account (your own timezone, your name and email, etc)


Upload Progress & Help Icons
Right next to the Settings Menu, you will see 2 icons. One icon provides you with a progress indicator for Media uploads (an encoding, if applicable), while the other icon provides you with a drop-down menu for accessing help options. Check Help Icons for more insight.


Pushing Changes to Monitors
It is very important to note that every time you make changes to any items within your Digitalskilting.com account, you have to click on the red flashing "Push to Players" button on the left side of the Portal above the Main Menu in order for these changes to take place in the affected players. Check Pushing Changes to Monitors for more information.

 
 

Monitor Status


Online Monitors. This shows how many of your monitors are online displaying at the time you log into the portal.
Subscription Capacity. Depending on the Digitalskilting.com plan you have selected (i.e. how many screens you want to deploy), this indicates the number of monitors you have created in the portal.
Registered Devices. This indicates how many of your screens have been "paired" to their players ( Digitalskilting.com players).


Monitor Locations
In this section, you set the location of each monitor on Google Maps.

 

Remember the Basics
This section provides you with a "shortcut" to the same options that appear in the main menu (i.e add a media file, create a playlist, create show), allowing you to do the same actions but faster.

Want to add new monitors?
In this section, there is an easy step-by-step guide to assist you with adding more monitors and expanding your digital signage.

Recent Activity (Enterprise plan only)
The Activity log shows you which of your users are currently logged in to your account (or have logged in in the past) as well as what actions were taken by these users. It shows details such as: what time users logged in, which media were edited, created, deleted, etc. Here you can see only the last 10 activities. For further information click on the drop-down menu in the top right of your Screen and click on the Activity Log tab.

 

Images

Supported Formats
Digitalskilting.com supports any image file type that can be displayed in a modern browser. These include JPEG, PNG, and GIF (including light animations). Images are not resized automatically, they are delivered and played back exactly as you have uploaded them. It is not recommended to use images with a resolution higher than 1920×1080, because they can slow down playback. In this case, try to resize them before uploading.

 

Managing Images
In the "Images" section, you can see a list of the images currently uploaded into your Digitalskilting.com account. Image information is organized in the following columns:

the Name of the Image
the Timestamp (date and time) that the Image was uploaded
a Preview (thumbnail) of the actual image
an Actions column, with 3 buttons for making changes
In this list, you can:

  
Preview the Image by clicking on the thumbnail in the "Preview" column.

  
Duplicate the Image, by creating a copy.

 
Change the details of an Image by clicking the blue "edit" button. Here, you can also substitute the actual image, and it will be changed wherever it is used. Check out the "Adding an Image" section below for details on the fields.

  
Delete a single Image. The image will be removed from any Playlists or Shows where it was previously used, and it will not be available in the portal for future use. 
Delete multiple images. Click on the images you want to delete and press on the delete button of just one. 


Search for a specific image using the search tool.

  
Move to another Workspace.

you can move images to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.

By clicking on the "Edit" or "Duplicate" option of an Image file, there is a button under the thumbnail of the Image which leads to a complete Image Editor, where you can modify the way the Image looks (Crop, rotate, resize), add filters, text, stickers and many more.

 

Adding an Image

To add a single image, you click on the "+ Add a New Image" button found at the bottom of the Images listing.

As a next step, you are requested to choose if you want to upload your own photo or choose photos from among many stock images from our Gallery.

 

 

You will also find the following fields where you can:

a. see the Source of the image file

b. type in the Name of the Image

c. add an optional Description for it

d. add Tags to the uploaded image

e. set the Default Duration of the image if you decide to add it to a playlist.

f. From the advanced features, you can set the Play From /Play Until parameters. In other words, you can set the expiration date, which means that you can choose the exact date and time that this image will display in your playlist or show or you can set the "Always" and "Forever" setting and the image will never expire.


Clicking "Save" will upload the image.

 

 

Adding Multiple Images

To add multiple images at once, click on the "+ Add Multiple Images" button. In the File selection dialog box that appears, keep the Ctrl button on your keyboard pressed to select multiple images. All selected images will be automatically uploaded.

 

REMEMBER: After making changes in your Account, you need to Push Changes to your Monitors

 
 

Videos

In the videos section, you can upload and manage a wide variety of video formats. Videos that you upload on Digitalskilting.com are automatically converted to industry-standard formats (H.264 with AAC audio). 

 

Supported Formats
YouTube videos are supported out-of-the-box, so they just get downloaded in the best possible quality (up to 720p right now).
Live Streaming Videos (YouTube, UStream, or custom HLS or RTMP/RTSP streams). These will have to be delivered by the stream in H.264 format to make sure they will be played back on Digitalskilting.com Players.


PowerPoint files are converted to videos on our servers, retaining all transitions and animations.


Managing Videos
In the "Videos" section, you can see a list of the videos currently uploaded into your Digitalskilting.com account. Video information is organized in the following columns:

the Name of the video
the Timestamp (date and time) that shows when the video was uploaded
a Preview (thumbnail) of the actual video
an Actions column, with 3 buttons for making changes
In this list, you can:


Preview the video by clicking on the thumbnail in the "Preview" column.


Duplicate a video, by creating a copy.


Change the details of a video by clicking the blue "edit" button. Here, you can also substitute the actual video, and it will be changed wherever it is used. Check out the "Adding a Video" section below for details on the fields.


Delete a single video. The video will be removed from any Playlists or Shows where it was previously used, and it will not be available in the portal for future use.


Delete multiple video files. Click on the videos you want and press on the delete button of just one.


Search for a specific video using the search tool.


Move to another Workspace. You can move Videos to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.


Adding a Video
To add a single video file, you click on the "+ Add Video/YouTube/PowerPoint" button found at the bottom of the Videos list. You then need to select the type of Video source. You can choose from:

 

Video File - upload one or more Video files from your computer to Digitalskilting.com
YouTube Video - use a link to a YouTube video which the Player will then download directly from YouTube and playback locally
PPT File - upload one or more PowerPoint (PPT or PPTX) files from your computer - they get converted to a video on Digitalskilting.com retaining all animations and transitions
Video Stream - use a Live Video Stream from the Internet or a local source, including YouTube Live, uStream, and UDP/RTP/HLS streams
Video Wall - read instructions on how to set up a Video Wall with Digitalskilting.com
After you provide the Video source, you need to also provide:

the name of the video
an optional description for it
Clicking "Save" will upload (or just save) the video.

 

Just a quick note: In regard to the "Video Upload" source type, there is an option to upload the exact file for playback and not the normalized version. This option is generally recommended for advanced users only since playback of the original video file might fail. Enabling this option while uploading will inhibit encoding, decreasing the time required for the video to be available, but also prevent a thumbnail for the video from being created.

Advanced Options for Videos (all types)
For all Video source types (uploads, YouTube videos, live streams, etc), you have the following advanced options:

Play Since /Play Until
In the advanced features, you can set the Play Since/Play Until parameters. In other words, you can set the expiration date which means that you can choose the exact date and time that Video will display in your playlist/show or you can set it to "Always" and "Forever" and the Video will never expire.

 

Fix Video Orientation
This option allows you to set the correct orientation for a Video. This is for the specific Video alone. This way, you can use Videos that were originally saved with the wrong orientation. 

So, if you have a video that is not displayed properly, you can use this setting to show it correctly.

Keep in mind that this setting only affects playback and does not actually rotate the Video file itself.

 

Crop Video
This option allows you to set crop margins for a Video. This is for the specific Video alone. You can crop out by percentage for any side of the video.

For example, if you set the "Right" cropping to 10%, then 10% of the video's width will be cropped out during playback. Same goes for all edges.

Keep in mind that this setting only affects playback and does not actually crop the Video file itself.

 

Enable Subtitles
First of all, you have to upload the Video in your account and also the video must have embedded* subtitles.

 

Embedded subtitles

Embedded subtitles are stored inside the video file (or video container) as a stream - in the same way, that video and audio streams are stored inside the video file. Not all video container formats can have embedded subtitles and there are limitations to what subtitle formats are supported for each video container format.

After, that you can toggle the "Enable Subtitles" button to ON in order to display subtitles on your screen.

 

Right now, subtitle tracks are not supported by Digitalskilting.com out of the box. But there is a workaround you can use to display subtitles for uploaded videos.

 

Note that YouTube videos with subtitles cannot be used this way. You will need to download the video and subtitles in your computer and manage them as Video files that you upload to Digitalskilting.com.

 

Preparing Videos
Subtitles are supported only for videos that you upload. In order for this workaround to work, you will need to make sure that the video files are compatible.

You will need to repackage the video file and subtitle track as a single MKV file. Make sure that the subtitle track is the first track since the code above will play only the 1st subtitle track of the MKV file. You have two options for preparing the MKV file:
Easy but slow way: Use Handbreak, adding the video source file and adding the subtitle track.
Hard but fast way: If your video is already in H.264 format, then you just need to repackage it (not re-encode it). Use ffmpeg like this:
ffmpeg -i video.mp4 -i subtitle.srt -c copy output.mkv

After you prepare the video file, you will have a single MKV file, with a video track encoded in H.264 and a subtitle track.

Uploading Videos With Subtitles
To upload the videos:

Got to the "Videos" section and click the button to add a new Video.
Select the video file.
Toggle to Enable Subtitles and click Save.
Assign the Video to your player and click "Push to players".
You should now be able to see subtitles for this video.

Disabling Subtitles
To disable the subtitles, toggle the "Enable Subtitles" to OFF.
 

Managing Audio Assets

In the “Audio Assets” section, you can see a list of the Audio Assets currently uploaded into your Digitalskilting® account. Information about your audio files is organized in the following columns:

  • the Name of the Audio Asset.

  • the Uploaded column shows the date and time that the Audio Asset was created in the account.

  • a Preview (thumbnail) of the Audio Asset.

  • an Actions column, with 3 buttons for making changes.

In this list, you can:


Preview the Audio Asset by clicking on the thumbnail in the “Preview” column and open the Audio Asset in order to hear it in your browser.


Duplicate the Audio Asset, by creating a copy.


Change the details of an Audio Asset by clicking the blue “Edit” button. Here, you can also substitute the Audio Asset, and it will be changed wherever it is used. Check out the “Adding an Audio Asset” section below for details on the fields.


Editing Multiple Audio Assets (Bulk Edit). To edit multiple Audio Assets at once, check the audio files that you want to edit and click the Edit button in one of them. By doing so, a new window will pop up with all the settings (Remove Tags, Add tags, Play Since, Play Until)


Delete a single Audio Asset. The Audio Asset will be removed from any Playlists or Shows where it was previously used, and it will not be available in the Portal for future use.
Delete multiple Audio Assets. Click on the Audio Assets you want and press on the delete button of any one of them.


Search for a specific Audio Asset using the search tool.


Move to another Workspace. You can move Audio Assets to different Workspaces. Choose the Workspace of your choice and click Move.

This feature is only available in the Enterprise plan.

 

Adding an Audio Asset

 

To add a single Audio file, you click on the "+ Add an Audio Asset" button found at the bottom of the Audio Asset list. You then need to select the type of Audio source. You can choose from:

 

  • Audio File - upload one or more Audio files from your computer to Digitalskilting®

  • YouTube Audio - use a link to a YouTube video which the Player will then download directly from YouTube and playback locally only the Audio of the video

  • Audio Stream - use a Live Audio Stream from the Internet or a local source, including YouTube Live, Ustream, and UDP/RTP/HLS streams

After you provide the Audio source, you need to also provide

  • the name of the Audio file

  • an optional description for it

  • a tag for the Audio file

Clicking "Save" will upload (or just save) the Audio.

 

Managing Web Pages

In the “Web Pages” section, you can see a list of the web pages currently uploaded into your Digitalskilting® account. Information about web pages is provided in the following columns:

  • the Name of the web page.

  • the Timestamp (date and time) that the web page was created in the account.

  • the Address of the web page.

  • a Preview (thumbnail) of the web page.

  • an Actions column, with 3 buttons for making changes.

In this list, you can:


Preview the web page by clicking on the thumbnail in the “Preview” column and it opens the web page in another tab.


Duplicate the web page, by creating a copy.


Change the details of a web page by clicking the blue “Edit” button. Here, you can also substitute the web page, and it will be changed wherever it is used. Check out the “Adding a Web Page” section below for details on the fields.


Editing Multiple Web-pages (Bulk Edit). To edit multiple web-pages at once, check the web-pages that you want to edit and click the Edit button in one of them. By doing so, a new window will pop up with all the settings (Remove Tags, Add tags, Play Since, Play Until)


Delete a single web page. The web page will be removed from any Playlists or Shows where it was previously used, and it will not be available in the portal for future use.
Delete multiple web pages. Click on the web pages you want and press on the delete button of any one of them.


Search for a specific web page using the search tool.


Move to another Workspace. You can move web pages to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.

Adding a Web Page

To add a web page click on the “+ Add a Web Page” button found at the bottom of the Web Pages list. As a next step you have to:

  1. enter the Name of the web page

  2. enter an optional Description for it

  3. fill in the Web Page address in the required field.

Clicking “Save” will upload the web page.

 

Web-page's Advanced Features

  1. Play Since / Play Until 
    In other
    words you can set the expiration date which means that you can choose the exact date and time that Web-page will display in your playlist/show or you can set it to "Always" and "Forever" and the Web-page will never expire.

  2. Fallback Image
    If a web page or web widget isn’t loading or a player is offline, you can choose an image to appear instead of a black or white error screen. Just click inside the box and choose your image from your account.

  3. Zoom factor (%)
    Is set to 100% by default. By altering it you zoom in (>100) or out (<100) of the web-page by the given percentage.

  4. Auto Adjust Zoom
    Is also enabled by default, to adjust the zoom for monitors with a width other than 1920 pixels so that they look the same.

  5. Disable Private Browsing 
    Web pages by default open in private browsing mode to prevent caching issues. You can use the toggle to disable it.

  6. Enable Chrome 
    Some modern web-pages do not work properly with WebKit. Currently, when using chromium, the web-page can't have transparency.

    6.1 Retain Session Data: By
    default this feature is disabled when using chromium. If you want to keep the same session for this web-page, even after a device reboot, you can click on the toggle button to enable it. Upon enabling this option, the "Disable Private Browser" option will be enabled as well.
    6.2 Enable Flash Player: By
    default this feature is disabled when using chromium. If a web-page requires a flash player to display the web-page content, you can click on the toggle to enable it.

  7. Ignore Certificate Errors
    We made it possible for users to disable Certificate checks for a Web Page so they can display internal sites without valid certification. If you are facing a certificate issue with your web-page, just toggle the button to ON and the web-page will ignore any certificate errors.

  8. Scripting Engine (Run Custom Script)
    You can click on the toggle to enable the scripting engine feature, where you can actually add scripts to run after a web-page is loaded in order to modify and navigate it as you wish. For more information please check out the Web Scripting Engine section in the user manual.

 

REMEMBER: After making changes in your Account, you need to Push Changes to your Monitors

 

I'm a paragraph. Click here to add your own text and edit me. It's easy.

Managing Document Files

In the "All Documents" section, you can see a list of the PDF, Word, Excel and PowerPoint files currently uploaded into your Digitalskilting® account. Information about your document files is organized in the following columns:

  • the Name of the file

  • the Timestamp (date and time) that the PDF, Word, Excel or PowerPoint file was uploaded

  • a Preview (thumbnail) of the document file.

  • an Actions column, with 3 buttons for making changes

In this list, you can:


Preview the Document file by clicking on the thumbnail (zoom icon) in the "Preview" column.


Duplicate the Document file, by creating a copy.


Change the details of a PDF, Word, Excel or PowerPoint file by clicking the blue "edit" button. Here, you can also substitute the actual document file, and it will be changed wherever it is used. Check out the "Adding a Document" section below for details on the fields.


Delete a single Document file. The document will be removed from any Playlists or Shows where it was previously used, and it will not be available in the Portal for future use.
Delete multiple Document files. Click on the documents you want and press the delete button of just one.


Search for specific a PDF, Word, Excel or PowerPoint file using the search tool.


Move to another Workspace. You can move Document files to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.

 

Adding a Document

To add a single document, you click on the "+ Add Document" button found at the bottom of the list. As a next step you are requested to provide:

  • the Name of the document (if you want to change it from its original name)

  • an optional Description for it

  • any Tags for the uploaded document you want

  • the Play Since /Play Until parameters. In other words, you can set the expiration date which means that you can choose the exact date and time that PDF, Word, Excel or PowerPoint file will display in your playlist/show or you can set it to "Always" and "For Ever" and the Document file will never expire.

  • Default page duration: the default duration of each slide/page is set to 10 seconds. However, you can change this for ALL pages included in the document.

  • Page Exceptions: When you want specific slides/pages of the file to be skipped or have a different duration, use the "Set duration for a specific page" button and specify the number of the page, as well as the desired duration. In case you want to skip a page completely simply set its duration to "0".

Clicking "Save" will upload the Document file.

 

 

Managing Widgets

In the "Widgets" section, you can see a list of the widgets currently uploaded into your Digitalskilting® account. Information about Widgets is organized in the following columns:

  • the Name of the Widget

  • the Type of the Widget

  • an Actions column, with 3 buttons for making changes

In this list, you can:


Change the details of a Widget by clicking the blue "edit" button. Here, you can also substitute the actual widget, and it will be changed wherever it is used. Check out the "Adding a Widget" section below for details on the fields.


Duplicate the widget, by creating a copy


Delete a single widget. The widget will be removed from any Playlists or Shows where it was previously used, and it will not be available in the Portal for future use.
Delete multiple widgets. Click on the widgets you want and press the delete button of just one.


Move to another Workspace. You can move widgets to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.


Search for a specific widget using the search tool.

 

Adding a Widget

To add a widget click on the green "Add Widget" button found at the bottom of the Widgets list.

Then you have to choose between Standard or Custom Widgets.

 

REMEMBER: After making changes in your Account, you need to push changes to your Monitors

Managing Playlists

In this section, you can see a list of the playlists currently uploaded into your Digitalskilting® account. Information about your playlists is organized in the following columns:

  • the Name of the playlist

  • the Description of the playlist

  • the Timestamp (date and time) that the playlist was either created or last modified

  • a Media Types column showing what kind of media files are used in the playlist

  • an Actions column, with 3 buttons for making changes

In this list, you can:


Change the details of a Playlist by clicking the blue "edit" button. Here, you can make changes to the contents of the playlist by removing and/or adding items. You can also substitute the actual Playlist, and it will be changed wherever it is used. Check out the "Adding a Playlist" section below for details on the fields.


Duplicate the playlist, by creating a copy.


Delete a single playlist. The playlist will be removed from any Shows where it was previously used, and it will not be available in the Portal for future use.
Delete multiple playlists. Click on the playlists you want and press the delete button of just one.


Move to another Workspace. You can move playlists to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.


Search for a specific playlist using the search tool.

 

Adding a Playlist

 

To add a playlist, you click on the green "+ Add Playlist" button found at the bottom of the Playlist list. As a next step you are requested to provide:

 

  • the Name of the Playlist and

  • an optional Description for it

  •  

Playlist-drag from a library to fill

- You can see an empty filmstrip where you will add your media files.

Below the filmstrip, you'll find your account library with all the media files available to you. You can see them ALL or you can locate them under their respective category (Images, Videos, Web Pages, Widgets, Audio Assets, Documents, Playlists). Also, you can use the search button to find your media file.

- By pointing to any media file in the library you can click on the preview (zoom icon), or the arrow to upload it to the playlist. Alternatively, you can drag and drop the item to the filmstrip to upload it.

-You can change the position of the media files by 'dragging-and-dropping' so that they are in the order you want.

  • By default, Widgets and WebPages have a duration in the playlist of 20 seconds. You can change this on the filmstrip under the preview of the media file, either by typing the duration yourself or using the "+" /"-" button respectively.

  • By default, Images also have a duration in the playlist of 5 seconds. You can change this on the filmstrip under the preview of the media file, either by typing the duration yourself or using the "+" /"-" button respectively.

  • By default, Videos have a fixed display time (the duration of the video itself)

Clicking "Save" will create the Playlist.

 

 

Creating/Editing Playlists with a large number of media files

In case your playlists contain numerous media files, you have the option to activate the Folder View for your convenience.

To see in detail how you manage playlists with the Folder View on.

REMEMBER: After making changes in your Account, you need to push changes to your monitors

 

Managing Shows

In the "Shows" section you can see a list of the shows already created in your Digitalskilting® account. Show information is organized in the following columns:

  • the Name of the Show

  • the Timestamp (date and time) that the Show was created or last modified

  • an Actions column, with 3 buttons for making changes

In this list, you can:


Change the details of a Show by clicking the blue "edit" button. Here, you can also substitute the show, and it will be changed wherever it is used. Check out the "Adding a Show" section below for details on the fields.


Duplicate the show, by creating a copy


Delete a single Show. The show will be removed and it will not be available in the Portal for future use.
Delete multiple shows. Click on the shows you want and press the delete button of just one.


Move to another Workspace. You can move shows to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.


Search for a specific show using the search tool.

 

Adding a Show

To add a show, you click on the "+ Add Show"  button found at the bottom of the Show list. First, you are requested to name your new Show.

Below the "Name" box, there are three buttons where all your Playlists, Media files, and Widgets can be found in order to add them to the show you are about to create.

To add a Playlist/Media file/Widget  click on the relevant icon and a window will appear where you are requested to:

  • Select the playlist/media file/widget of your choice
    Choose the fitting options on the screen.


    Your options are:

  • "Fit": show the whole content within the area assigned (may add some empty space or black bars at the edges, again not distorting images or videos)

  • "Crop": zoom-in so that it covers the whole area assigned (may crop some edges, but it will not distort images or videos)

  • "Stretch": show the whole content, stretching it to match the area assigned (no cropping, empty spaces or black bars, but it might distort images and videos)

  • Optionally, Enable Transparency of the region. This is useful for content with transparency and for the "fit" option above.

 

Once selected, you can "Preview" your item on the screen simulator below and you can Delete it by clicking the button or Edit it by clicking on the "cogwheel" button.

You can use the arrows on the screen to change its size and/or location. Alternatively in the "Show Editor" section, you can be as accurate as you wish by entering manually the Top/Width, Left/Height measurements.

You also have the option to disable or Enable the Grid on your screen simulator, which will alter the way you place the item by dragging it. By disabling the grid you can literally place the item anywhere on the screen simulator.


Under the "Layering" section, all the items (playlists, widgets, media files) added in the show are listed in the order you added them, with the "top layer" is the last added. This order of layering is very easily modified by dragging and dropping items in the desired hierarchy.

 

Example from the above Layering setup: 

The RSS CNN Ticker is at the top of the Layering setup, which means it has the highest priority and covers any other Media.

On the other hand, the apple image is at the bottom of the Layering setup, which means it has the lowest priority and will be covered by any other media.



Clicking "Save" will save the show.

 

REMEMBER: After making changes in your Account, you need to push changes to your Monitors

 

Managing Schedules

In the "Schedules" section, you can see a list of schedules currently created in your Digitalskilting® account. Information about schedules is organized in the following columns:

  • the Name of the Schedule

  • the Timestamp (date and time) that the Show was uploaded or last modified

  • an Actions column, with 3 buttons for making changes

In this list, you can:


Change the details of a Schedule by clicking the blue "edit" button. Here, you can also substitute the actual schedule, and it will be changed wherever it is used. Check out the "Adding a Schedule" section below for details on the fields.


Duplicate the schedule, by creating a copy


Delete a single schedule. The schedule will be removed and it will not be available in the portal for future use.
Delete multiple schedules. Click on the schedules you want and press on the delete button of just one.


Move to another Workspace. You can move schedules to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.


Search for a specific schedule using the search tool.

 

Adding a Schedule

To add a new schedule click on the "+ Add Schedule" button found at the bottom of the Schedules list.

As a next step you are requested to name your new schedule and then set the shows, media or playlists you want to display.

The calendar that appears gives you the option to view the month, week or even day of your choice, by clicking on the relevant buttons. By default you can see the current date, however, you can move to the previous or next month/week/day by clicking on the arrows next to the "today" button.

On the right side of the screen, there is the "Entries" column under which you can find all of the Shows, Media, and Playlists that you will assign and use within a specific Schedule.

 

As a next step, click on "+Add" button and use the drop-down menu to choose between a show, media or playlist category in the "New Event" window that appears. Once you pick a content category (ie a Show), a new drop-down menu appears from which you can select the specific show, media or playlist you want to use in your schedule.

-To change the show, media or playlist you want to schedule, click on the arrow next to the "Show" option.

 

-To set the Start Date and Time you want your show, media or playlist displayed, fill in the information in the "First Start" box. To schedule the time, click on the clock icon.

-To set the End Date and Time for the content you will display, again fill in the information in the "First Stop" box. To schedule the time, click on the clock icon.

-The next box, "Repeat", indicates the frequency your show, media or playlist will be displayed. Click to choose one of the options provided:

  • Once, if you want your Show, Media or Playlist to play back during specific hours on a specific day/date only.

  • Daily, if you want to set which days of the week you want your Show, Media or Playlist to playback.

  • Weekly, if you want your Show, Media or Playlist to be displayed once per week.

  • Monthly, if you want your Show, Media or Playlist to be displayed once per month.

  • Yearly, if you want your Show, Media or Playlist to be displayed once per year.

-Finally, " Repeat Until" indicates the time-frame you want to set your schedules for. You can either set a specific date and time or click "End of time"  so that your schedule will be always displayed as indicated.


 

Below you can see an example setup:

The Turned Off Show will play Daily (you can choose the days that the show will play) from 16:12:48 until 17:12:48 and repeat until "End of time".

Clicking "Save" will create your schedule.

Another Schedule example: 

After creating a schedule, you should go to the Monitor settings and apply the schedule you have created to the Monitor, as seen below.

 

Keep in mind that the default content of the Monitor will only be used to fill in any empty time-slots in the assigned Schedule.

  1. Added an event from 9:00 AM - 5:00 PM for "show5". 

  2. Added another event from 12:00 PM to 12:15 PM for "show_all". Making sure to adjust the order of the shows on the right, so that the "show_all" has greater priority than "show5", as seen below:

  3. After saving the new schedule, make sure you have assigned it to your Monitor from the Monitor configuration. Do not forget to press the "Push to Players" button.

With the above configuration :

  • the show5 will play from 9:00-12:00 

  • show_all will play from 12:00-12:15 (because show_all has greater priority over show5) and

  • show5 will continue to play from 12:15 until 5:00


Regarding the priority that you give your Schedule's content, "show_all" will overlap with "show5" when the time comes to start playing the show, but because you have given it greater priority (you placed it at the top of the schedule's hierarchy), "show_all" will play instead of "show5".

Schedules have priority over Default Content. If a Show, Media or Playlist is assigned as Default Content on the Monitor and a Schedule is also assigned, the Default Content will be displayed on the screen during gaps in the Schedule as the Schedule takes priority.

Turning on/off your Screen

In the Schedule Section, the first Show that appears in the list of all available/created Shows in your account is the "Turned Off" Show. Setting this in a Schedule results in your monitor automatically turning off.

REMEMBER: After making changes in your Account, you need to push changes to your Monitors

 

Managing monitors

In this section, you can manage the monitors you created. Note that you can create as many monitors in the Digitalskilting® Portal as your subscription allows you to. You can even manage unregistered monitors (i.e. not paired with an actual player) but the content cannot be pushed to an actual screen and be displayed.

In the initial screen, you can see a list of the monitors currently created in your Digitalskilting® account. Monitor information is organized in the following columns:

  • the Name of the Monitor

  • the ID of the monitor

  • the Assigned scheduled pushed to the monitor

  • the Default Content that will be displayed when there is no active schedule

  • the Status of the Monitor (Online, Offline, Initialized, Waiting)

  • an Actions column, with 2 buttons for making changes

In this list, you can:


Change the details of a Monitor by clicking the blue “Edit” button. Check out the “Adding a Monitor” section below for details on the fields.

  
Duplicate the Monitor, by creating a copy with all the configuration settings.


Move to another Workspace. You can move Monitors to different Workspaces. Choose the Workspace of your choice and click Move. This feature is only available in the Enterprise plan.


Delete a single Monitor.
Delete multiple monitors. Click on the monitors you want and press on the delete button of any one of them.


Search for a specific monitor using the search tool.

 

Adding a Monitor

When you click "Add Monitor" you will be prompted to a new page. The new page contains all the required information for your monitor. The Tabs that you will see are 8:
Basic Info, Wireless, 3G/4G/LTE, Static IPs, Proxy, Advanced, Status, and Location. 

 

Web Scripting Engine (Last modified OCT.12.18)

Digitalskilting® provides a great feature that's an absolute necessity when it comes to Digital Signage; the ability to modify or navigate a web page. What does that mean?

  • You can fill out forms (username/password) and submit them.

  • After the Web Page loads, you can navigate to a different page.

  • You can run custom JavaScript code, essentially doing anything you want on the web page.

  • You can wait for the web page to load, pausing for a specific time interval.

  • And much more!

 

Here are some Use Cases we have compiled:

  • Use Form-based Authentication

  • Navigate to a Specific Page (after Authentication)

  • Change the Contents of a Web Page

  • Change the Styling of a Web Page

  • Scroll to the exact area you need

 

 

Use Cases

 

Use Form-based Authentication

Many websites require you to fill out a username and password on a form, and then you have to click a button in order to login. This can be automated via the scripting engine.

Navigate to a Specific Page (after Authentication)

You can first login and then navigate to specific web pages in the website. You can also add timeouts, and have navigation occurring at regular intervals.

 

Change the Contents of a Web Page

You can change any part of the HTML of a Web Page. This allows you to change stuff easily, like removing pop-ups, removing headers, footers, or other excessive content areas, and keep only what you need to show.

 

Change the Styling of a Web Page

You can change any part of the HTML of a Web Page and add your own styles. This allows you to change text color, change the background of the page to be transparent (so that you can use it as an overlay in Digitalskilting®), make text larger or smaller, and many more options.

 

Scroll to the exact area you need

Using JavaScript, you can scroll the web page and focus on the exact content you need to see.

 

 

Introduction

Workspaces provide an advanced way to setup detailed access permissions. With Workspaces, you can assign Users specific access rights to specific content items (Media, Playlists, etc) or specific Monitors. The Workspaces feature allows you to define multiple sets of Content+Screens and then assign access rights to Users for these sets.

Imagine you are a company with multiple branches, each with some screens. You want to manage some of the content centrally, but also allow your local store managers to partially manage some content (e.g. playlist) based on their local audience. This is a typical case where you setup one Workspace per local store, and assign each manager access to the matching Workspace, while giving an HQ employee access to all Workspaces.

The Workspaces feature is flexible enough that it allows you to implement any kind of access restriction scenario. If you have difficulty setting it up on your own, please reach out and we will help you optimize your use of our Enterprise Plan.

The "Active Workspace" Menu

With the "Workspaces" feature available in your Digitalskilting® Account, a drop-down menu appears in the top-right corner of the Digitalskilting® Portal. This menu allows you to select the Workspace you want to work on, as well as manage Workspaces (creating, editing, or deleting them). 

 

When you select a Workspace from the drop-down menu, then

  • you will only see the content items (Media, Widgets, Playlists, Shows, Schedules) and Monitors that are placed within that Workspace, and

  • any item that you create will be placed in the currently selected Workspace.

Also, when creating or editing items that reference other items, like

  • Playlists referencing Media and other Playlists

  • Shows referencing Media and Playlists

  • Schedules referencing Shows, Media and Playlists

  • Monitors referencing a Schedule and a Show, Playlist or Media

then, in the selection area, you see all items from across Workspaces that you have, at least, "read" access to. So, for example, if you have read/write access to Workspace A and read-only access to Workspace B, and try to create a Playlist in Workspace A, then you will be able to use any Media from both Workspaces A and B. To find out more on how to assign specific access rights to Workspaces,

 

Using "All"

If you select "All", then you will see the items (Media, Playlists, Monitors, etc.) from all Workspaces that you have at least "Read" access to.

This is especially useful if you have access to multiple Workspaces, as it allows you to see items across Workspaces and easily find what you are looking for. Note that "All" is the pre-selected option when you login to the Digitalskilting® Portal.

If you try to create an item while "All" is select, then a pop-up will appear urging you to select a Workspace to place the new item.

 

The "Default Workspace"

The "Default Workspace" is the Workspace where all your content resides when you subscribe to the "Enterprise" Plan. Since the "Standard" and "Pro" Plans do not have the Workspaces feature, all content items that existed before you upgrade to the "Enterprise" Plan are placed in the "Default Workspace". Then, you can move the items that you want from the "Default Workspace" to the Workspaces you create later on.

The "Default Workspace" also serves another purpose; whenever you delete a Workspace, all items left in that Workspace are automatically placed in the "Default Workspace". The same applies when you downgrade from the "Enterprise" Plan to the "Standard" or "Pro" Plans; all Workspaces are deleted and all items in your account are placed in the "Default Workspace".

Keep in mind that the "Default Workspace" is just another Workspace; you can assign permissions to it and place items in it, just like you can do with any other Workspace. You just can't rename or delete it, it is always there.

Your Workspaces

After the "Default Workspace" entry, the Workspaces that you have created follow in alphabetical order.

As an Admin, you can see all Workspaces in your Digitalskilting® Account. But as a regular User, you might not have access to all Workspaces in your Digitalskilting® Account (including the "Default Workspace"). In the drop-down menu, you only see Workspaces that you have access to. In the case of a non-Admin User having access only to a single Workspace (or any Workspace at all), then they will not see the "Active Workspace" menu. This is to make the Digitalskilting® Portal much easier to use for simple Users without complex access.

Using "Manage Workspaces ..."

 

The last item in the "Active Workspace" Menu is the "Manage Workspaces ..." item. Clicking here gets you to the Workspace

Management screen, which is detailed in the following paragraph.

Managing Workspaces

 

In the Workspace Management section, you can create as many Workspaces as you need. The only thing to provide is a Name (which appears in the drop-down list) and a Description with any extra details you might need. As soon as you add your Workspaces, you will see them appear in the "Active Workspace" dropdown menu. Some tips:

  • The Workspace Management screen is only available to the Users with "Admin" permission, including the Account Owner (who always has "Admin" permission).

  • You can later change the Name and Description of the Workspaces, so there's no need to worry about choosing a name and description.

  • The "Active Workspace" drop-down menu always shows the "All" and "Default Workspace" items first. Then, all Workspaces you create are listed in alphabetical order. If you want to show Workspaces in a specific order, just prefix their names with numbers in ascending order.

  • Keep in mind that, if you delete a Workspace, all items in it will be moved to the "Default Workspace"

 

Assigning Users Roles in Workspaces

Having Workspaces without restricting access to them does not make much sense. As an Admin, you can assign Users in your Digitalskilting® Account specific access rights to each Workspace.

If the Workspaces feature is available in your Digitalskilting® Account, then the User Management screen changes. You are then able to assign Users specific Roles in specific Workspaces. Check out the section called Custom roles

 
 

Users (0ct.30.18)

In this section, you can see the list of all your existing users in the account, identified by their e-mail addresses, together with their assigned permissions.

There is one user-defined as the "Owner" of the account who can add (invite) more users. The "Owner" cannot be deleted from the Digitalskilting® account at any point. However, the additional users can be either edited or deleted, with the corresponding buttons appearing in the right field under the "Actions" column.

To add a new user, click on the "Invite User" button. In the screen that appears there are the User Details to be added, or edited in the event of an existing user. The following fields appear under "User Details":

  • First Name 

  • Last Name

  • E-mail

  • Password

  •  

Below this information, there is a table that allows you to set permissions for the new user or change the existing permission settings for an existing user:

  • Is Admin: For the user to have access to all fields, manage and edit items in the account and behave as an Admin user, click on the "All" box next to the "Is Admin" column. By clicking on this box, all boxes will be automatically clicked too.

  • Manage Users: To have a user only dealing with new users or editing/deleting existing users, just click on the box next to the column.

  • Manage Subscription: To have a user only dealing with the subscription and billing details of the account, just click on the box next to this column,

  • Media: To have a user managing the whole range of activities within media files, just click All. As you can see next to the "All" column, there are 4 more columns determining specified access to users. The user can View, Change, Create, Delete media files.

  • Playlists: To have a user managing the whole range of activities within playlists, just click All. As you can see next to the "All" column, there are 4 more columns determining specified access to users. The user can View, Change, Create, Delete playlists.

  • Shows: To have a user managing the whole range of activities within shows, just click All. As you can see next to the "All" column, there are 4 more columns determining specified access to users. The user can View, Change, Create, Delete shows.

  • Schedules: To have a user managing the whole range of activities within schedules, just click All. As you can see next to the "All" column, there are 4 more columns determining specified access to users. The user can View, Change, Create, Delete schedules.

  • Monitors: To have a user managing the whole range of activities within shows, just click All. As you can see next to the "All" column, there are 4 more columns determining specified access to users. The user can View, Change, Create, Delete monitors.

  •  

You will notice that, in many cases, clicking one box automatically clicks other boxes too. This happens because some categories contain items belonging to other categories and therefore one cannot exist without the other. Also, some actions cannot take place without other actions also occurring.

 

Example 1 
If you give a user the authority to "View" Schedules by clicking on the relevant box, it automatically means that the user will also be able to view Media files, Playlists and Shows, since they are all contained in schedules. Hence, by clicking "View" schedules, "view" will be automatically selected for Media, Playlists and Shows.

 

Example 2 
If you give a user the authority to "Change" Shows, it automatically means that the user will also be able to view them and since Shows contain Playlists and Media files, that user will be able to view those files too. Therefore, clicking "Change" Shows will automatically select "View" on Shows, Playlists and Media.

 

Permissions (Oct 29,2018)

There are 2 distinct permissions that a User can be assigned:

  • Administrator: This Permission provides unrestricted access to the whole Digitalskilting® Account. Beyond that, the “Administrator” permission is required for a User to:

    • manage other Users of the Digitalskilting® Account (creating, editing, or deleting them)

    • manage Workspaces (creating, editing, or deleting them)

    • manage Custom Roles (creating, editing, or deleting them)

    • create or delete Devices (editing is allowed for other authorized Users as well, check out Roles below)

    • manage Tags (creating, editing, or deleting them)

    • manage global settings for the Digitalskilting® Account (Password Policy and SAML)

    • receive all email notifications for devices going offline/online

  • Manage Subscription: This Permission provides access to the Subscription-related screens of the Digitalskilting® Account. It can be useful to allow access to Purchasing or Accounting departments, so that they can see billing history, invoices, and so on, and also be able to change the subscription. Users with this Permission:

    • have access to all subscription-related screens

    • can upgrade/downgrade/modify the subscription

    • can see the billing history, invoices, credit card charges, and so on

    • receive emails that have to do with purchasing and billing (orders, failed charges, shipping tracking code notifications, etc)

The above two Permissions are set per User and have nothing to do with Roles or Workspaces.

Standard Roles

To make it easy for the vast majority of our Users, we have defined a set of standard Roles. In the “Standard” and “Pro” Plans, you can assign only one Role to each User, while in the “Enterprise” Plan you can assign a User one Role per Workspace (see the “Roles in Workspaces” section below).

 

Here is a short description of each of the Standard Roles:

All Access

Full access to everything

Content Viewer

Read-only access to content-related items (Media, Playlists, Shows, Schedules, etc)

Content Manager

Read/Write access to content-related items (Media, Playlists, Shows, Schedules, etc)

Content Publisher

Same as "Content Manager", but also allowed to click "Push to Players"

Media Creator

Only upload new Media or change existing Media in-place

Media Manager

Read/Write access to Media

IT Manager

Only read/write Device configuration

Publisher

Only view Content (no Write access), but also allowed to click "Push to Players"

Here is a detailed description of each of the Standard Roles and the access it provides:

[Enterprise Plan only] Roles in Workspaces

If you have Workspaces available in your Account, then you can assign Users one Role per Workspace.

[Enterprise Plan only] Roles in Workspaces

If you have Workspaces available in your Account, then you can assign Users one Role per Workspace.

Clicking the "Add" button located in the "Workspace Permissions" section will display a pop-up that allows you to assign the User a Role in a specific Workspace.

 

This way, a User may have full access to a Workspace, while having limited Read-Only access to another Workspace. Therefore, you can create flexible structures that allow you to delegate access based on your exact needs.

Note that you cannot assign a User more than 1 Role per Workspace. If you need to do so, you might need to create a Custom Role (see next section).

[Enterprise Plan only] Custom Roles

If you need to provide a User with customized Permissions, then you need to create a Custom Role.

IMPORTANT

Keep in mind that if a new feature with new permission is added, then your Custom Roles will not have this new permission. The Digitalskilting® Team manages the predefined standard Roles and will add new Permissions to them based on the description of each Role.

To access the Role Management screen,

  1. go to the "Users" section, accessible from the top-right menu of the Digitalskilting® Portal

  2. click on "+ User"

  3. in the "Workspace Permissions" section, click the "Add" button

  4. in the pop-up window that appears, click on the "Manage Roles" link

In this screen, you can see all the Standard Roles as well as the Custom Roles that you have created.​

You can add a Custom Role and define the detailed Permissions that this Role will provide.

 

For the Standard Roles, clicking on the magnifying glass button shows you the detailed Permission for that Role.

 

Why develop an HTML Widget?

HTML Widgets get downloaded to each Player, so they have several benefits over providing the same experience over an online HTML web page or Web Widgets.

HTML Widgets are great because of they:

  • are local, so they load even without a working Internet connection.

  • have no CORS restrictions. You can create Widgets that pull in data from any online web site. E.g. retrieve stock market prices from an online web page without any prior arrangement and show them as you wish.

  • are playback-aware, so they are notified when they are "loaded", "shown", and "hidden". This makes better use of bandwidth.

  • can store/cache contents locally across reboots. Web Pages cannot store data that survive a reboot.

  • will soon have access to an API that will enable you to directly interact with the playback engine.

 

What are the requirements?

Required skills

Anyone who can develop an HTML5/Javascript web page can develop a Widget. No special skills are required. We also provide you with some required tools:

  • full documentation on how Widgets work

  • complete examples you can download and test

 

Creating an HTML Widget

Make sure you read the next section of the Developer's guide to create your widget or use one of our samples. After you are done, then you can upload it to DigitalSkilting.com.

 

To create an HTML Widget, go to "Custom Widgets" and select to add a new HTML widget. In the form that appears:

  • type in the Name of the widget

  • choose an icon for your widget

  • add an optional Description for it

  • define the Zoom Factor (%)

  • toggle Auto Adjust Zoom

  • choose if you want to Enable Chromium

  • upload your ZIP file

  • write down the UI Configuration

Click "Save" to upload your custom widget.

 

Building a HTML widget

In this guide, you will build your first Custom Widget, the "Simple Clock". This is a very quick example, to show you all the steps required to create a Widget.

The tutorial goes through the following steps:

  1. Quickly create a simple Widget, without any type of configuration, to see the minimum steps required. This Widget is a simple digital clock.

  2. We then add two configuration options to the Simple Clock; the font size and an option to show seconds or not. We create the code needed as well as the definition for the configuration options so that the user can easily define the configuration through the DigitalSkilting.com UI.

  3. Following this step, is a small modification to enhance performance. The clock should only start when actually shown on screen, and it should stop when the Widget goes off screen.

  4. Finally, we show you some basic CSS code on how you can have a transparent background for your Widget.

Simple Clock Widget

 

1. Create the index.html

Every Widget has a single entry point, the "index.html" file. The web viewer loads up this HTML file locally from the storage of the Player.

If you don't have an HTML editor, you can use this one: Notepad++

Let's create a sample. Using your favorite editor, create a file called "index.html" with the following contents:

index.html

 

<!DOCTYPE html>

<html>

<head>

<script>

 

function startTime() {

    var today = new Date();

    var h = today.getHours();

    var m = today.getMinutes();

    var s = today.getSeconds();

    m = checkTime(m);

    s = checkTime(s);

    document.getElementById('txt').innerHTML =

    h + ":" + m + ":" + s;

    var t = setTimeout(startTime, 500);

}

function checkTime(i) {

    if (i < 10) {i = "0" + i};  // add zero in front of numbers < 10

    return i;

}

</script>

</head>

<body onload="startTime()">

 

<div id="txt" style="font-size: 48px"></div>

 

</body>

</html>

2. Create the zip package

Every Widget is packaged as a zip archive. You add the "index.html" and any other file you want in that zip archive. Keep in mind that the "index.html" file must be in the main folder of the zip archive and all related resources must use relative paths.

Since we do not have any other file, just add the "index.html" file you create above to a new zip file called "SimpleClock.zip".

3. Upload your Custom Widget to your DigitalSkilting.com Account

To use your newly created Custom Widget, you need to upload it to the DigitalSkilting.com Portal.

  1. Log in to your DigitalSkilting.com Account.

  2. On the main menu on the left, click on "Widgets".

  3. Click on the button in the lower-right corner saying "Upload Custom Widget".

  4. Click on the "Create" button to upload your new Custom Widget.

  5. Fill out the form:

    1. Name: Type "Simple Clock". That's the name of your Custom Widget, which your users will see when they try to add a new instance of your Custom Widget. Try keeping this as short as possible, 2-3 words max.

    2. Description: Type in a description for your Custom Widget, so that your users can read and understand what this Widget does exactly.

    3. Zoom Factor (%) and Auto Adjust Zoom have the same meaning as for Web Pages. Skip them for this example.

    4. Click on the New ZIP file field and select the zip archive "SimpleClock.zip" you created above.

    5. The UI Configuration field is used only if you want your users to supply configuration parameters to your Widget. Since your Widget does not have any parameters (yet), leave this blank.

  6. Click the "Save" button to upload and create your new Custom Widget.

 

4. Use your Custom Widget

Your Custom Widget should now be available for use. First, create an instance of your Custom Widget.

  1. Log in to your DigitalSkilting.com Account.

  2. On the main menu on the left, click on "Widgets".

  3. Click on the button saying "Add Widget". In the drop-down menu that appears, you should select "Simple Clock".

  4. A form will appear. Since we do not have any configuration parameters yet for our Custom Widget, the only (always there) parameters are:

    1. Name: a name for this Widget instance you are creating. Use "My Clock no1".

    2. Description: a more detailed description, if needed.

  5. Click on the "Save" button to create the new instance of your Widget.

Now, go ahead to your Show and add the Widgets instance to show it on screen!

Add Options to the Clock

Most Widgets will require some form of configuration options. This configuration can be different for each instance of your Widget (that is, each time you actually use your Widget).

For our Simple Clock Widget, let's say we want to add the following configuration options:

  • Clock Font Size: specify the exact font size in pixels (Integer)

  • Show Seconds: an option to show the seconds part of the clock or not (Boolean)

To add these options to your Widget, you need to do 3 things:

  1. Modify the Widget code to accept the configuration values.

  2. Add an init_widget(config) function that is called by the player when the widget has finished loading and passes the json configuration parameters.

  3. Provide a UI form specification, so that DigitalSkilting.com will create a form for editing these options for your Widget instances.

 

Modify the Widget Code

 

Modify the Widget code as follows:

index.html

 

<!DOCTYPE html>

<html>

<head>

<script>

 

var use_seconds = true;

function startTime() {

    var today = new Date();

    var h = today.getHours();

    var m = today.getMinutes();

    var s = 0

    m = checkTime(m);

    txtEl = document.getElementById('txt')

 

    if(use_seconds){

        s = today.getSeconds();

        s = checkTime(s);

        txtEl.innerHTML = h + ":" + m + ":" + s;

    }

    else{

        txtEl.innerHTML = h + ":" + m;

    }

    var t = setTimeout(startTime, 500);

}

function checkTime(i) {

    if (i < 10) {i = "0" + i};  // add zero in front of numbers < 10

    return i;

}

function init_widget(config) {

        if (!config) {

            return;

        }

     

        if("clock_font_size" in config){

            var pixels = config.clock_font_size + "px"

            document.getElementById('txt').style.fontSize = pixels;

        }

 

        if("use_seconds" in config){

            use_seconds = config.use_seconds;

        }

         

        startTime()

         

}

</script>

</head>

<body>

 

<div id="txt" style="font-size: 48px"></div>

 

</body>

</html>

Zip the updated index.html file and re-upload the zip file to your "Simple Clock" Custom Widget.

As you can see, we added the "init_widget" function, which takes the arguments and uses them to properly configure the Widget.

 

Provide a UI Configuration Form

To allow DigitalSkilting.com to configure your Widget, you must provide a detailed specification of your configuration fields. To do this, you use JSON Schema. You just paste the JSON Schema text to the text area.

For the 2 configuration values we need now,

  • the "schema" value defines the editors for each of your fields,

  • the "fields" value is optional and defines the order the fields will appear in the form.

Here is the JSON Schema to use:

UI Configuration

 

{

  "fields": [

    "clock_font_size",

    "use_seconds"

  ],

  "schema": {

    "clock_font_size": {

      "editorAttrs": {

        "max": 999,

        "min": 1,

        "step": 1

      },

      "title": "Clock Font Size",

      "type": "Number",

      "validators": [

        "required",

        "number"

      ]

    },

    "use_seconds": {

      "title": "Use Seconds",

      "type": "Checkbox"

    }

  }

}

Go to your "Simple Clock" Custom Widget and paste the above code into the "UI Configuration" textarea, and click Save.

 

Test it out

Try adding a new instance of your "Simple Clock" Widget. It should now appear with the 2 fields you added above. Try using it and add the Widget to a Show to get it on a screen, and test it out.

Making the clock efficient

Just like all content types in DigitalSkilting.com, widgets are pre-loaded during playback. This means that it may take several seconds (or even minutes) between loading the widget instance on the player's web viewer, and actually getting the widget to show on screen. This has two effects:

  • If your Widget is not static (e.g. you show a playlist of images), then you need to know when your widget is displayed, so that you can start your sequence.

  • If your Widget is resource-heavy, then you are wasting player resources that could result in a bad playback experience.

In the "Simple Clock" case, none of the above applies, but let's say that you wanted to start the clock once the widget is shown, and stop the clock once the widget is hidden.

Modify the Widget code as follows:

index.html

 

<!DOCTYPE html>

<html>

<head>

<script>

 

var use_seconds = true;

 

function startTime() {

    var today = new Date();

    var h = today.getHours();

    var m = today.getMinutes();

    var s = 0

    m = checkTime(m);

    txtEl = document.getElementById('txt')

 

    if (use_seconds) {

        s = today.getSeconds();

        s = checkTime(s);

        txtEl.innerHTML = h + ":" + m + ":" + s;

    }

    else {

        txtEl.innerHTML = h + ":" + m;

    }

    window.t = setTimeout(startTime, 500);

}

 

 

function checkTime(i) {

    if (i < 10) {i = "0" + i};  // add zero in front of numbers < 10

    return i;

}

 

function init_widget(config) {

        if (!config) {

            return;

        }  

        if("clock_font_size" in config){

            var pixels = config.clock_font_size + "px"

            document.getElementById('txt').style.fontSize = pixels;

        }

        if("use_seconds" in config){

            use_seconds = config.use_seconds;

        }

}

 

function start_widget(){

    startTime()

}

 

function stop_widget(){

    if(window.t){

        clearTimeout(window.t);

    }

}

 

</script>

</head>

 

<body>

 

<div id="txt" style="font-size: 48px"></div>

 

</body>

</html>

 

Zip the updated index.html file and re-upload the zip file to your "Simple Clock" Custom Widget.

 

Modifications explained

As you can see, we now do not start the clock on page load, and we added two functions:

  • The start_widget function is called just before the Widget is shown on screen. At that point, we start our clock.

  • The stop_widget function is called just after the Widget is removed from the screen. At that point, we stop our clock.

The second call is not really necessary in our case since the Web Viewer will terminate and all resources will be freed, but it is good to know. Some Widgets require finalization calls to backend services in order to save their state.

Adding Transparency

If the user activates the transparency checkbox, then the Widget is rendered in an offscreen buffer, and then copied to the screen. This results in a low refresh rate for the Widget contents. Keep that in mind when you create Widgets.

Keep in mind that this does NOT work with the "Chromium" web rendering engine. You need to have that toggle disabled in order to support transparency.

To enable background transparency in your Widget, just add the following CSS to your Widget code.

Transparency CSS

html, body {

        background-color: transparent;

}

For the Simple Clock, modify the Widget code as follows:

index.html

<!DOCTYPE html>

<html>

<head>

<style type="text/css">

      html, body {

        background-color: transparent;

      }

</style>

<script>

 

var use_seconds = true;

 

function startTime() {

    var today = new Date();

    var h = today.getHours();

    var m = today.getMinutes();

    var s = 0

    m = checkTime(m);

    txtEl = document.getElementById('txt')

 

    if (use_seconds) {

        s = today.getSeconds();

        s = checkTime(s);

        txtEl.innerHTML = h + ":" + m + ":" + s;

    }

    else {

        txtEl.innerHTML = h + ":" + m;

    }

    window.t = setTimeout(startTime, 500);

}

function checkTime(i) {

    if (i < 10) {i = "0" + i};  // add zero in front of numbers < 10

    return i;

}

function init_widget(config) {

        if (!config) {

            return;

        }

        if("clock_font_size" in config){

            var pixels = config.clock_font_size + "px"

            document.getElementById('txt').style.fontSize = pixels;

        }

        if("use_seconds" in config){

            use_seconds = config.use_seconds;

        }

}

 

function start_widget(){

    startTime()

}

 

function stop_widget(){

    if(window.t){

        clearTimeout(window.t);

    }

}

 

</script>

</head>

 

<body>

 

<div id="txt" style="font-size: 48px"></div>

 

</body>

</html>

Zip the updated index.html file and re-upload the zip file to your "Simple Clock" Custom Widget. The Simple Clock should now have a transparent background.