With our Websites in Digital Signage plugin, you can add external web content to your slides. The plugin is a bit like a swiss army knife, you can add a simple URL, you can add HTML code and you can use Javascript to scroll to a specific section, get rid of GDPR pop-ups, and log in to sites like salesforce, etc.
The Website plugin is also amazing with HTML5 widgets.
Find the Website plugin
When logged in, find the playlist you want to add it to, open the playlist, and find the Website plugin at the top menu.
Options
Website – If the website is hosted on a server, use the “Website” option and paste the URL.
HTML code – If you have an HTML code snippet, you can paste the snippet to the code pop-up. Where to find widgets?
Pre-load website – Player will start loading the plugin 15 seconds before it will be displayed, so when the slide is displayed, the website has already loaded and is ready to display. If the website you want to display has some load animation or video set to autoplay, you can disable this option so that the animation does not run while the plugin is pre-loading.
Enable scrolling – By default the scrolling behavior is disabled so that the scroll bar is not visible. If you want users to interact with the site, you can enable scrolling.
Refresh periodically – The website is refreshed every time the slide is shown, however you can set the refresh interval to refresh more frequently.
Zoom – Depending on how the website is built, it may render different on certain devices. By adjusting zoom, you can make the page fit better.
Website scripting
Website Scripting execution is a very powerful feature, however, it requires some understanding of JavaScript code. This page provides common script examples, however, with enough programming experience, it’s possible to do complex workflows.
Please note that Website Scripting does not work in web preview and Samsung Tizen basedplayers because they display web content in an iframe element (whereas other players use webview element) that does not support this functionality due to how web security works. Website Scripting is supported in Android (version 3.0.8+), Windows, Linux, Mac, and Chrome extension (ChromeOS) players.
Scrolling to a position
The window.scrollTo function takes in 3 parameters:
context (null)
horizontal X coordinate (0)
vertical Y coordinate (500)
Usually vertical is the axis we want to scroll. In this case, we scroll 500 pixels vertically, but you need to experiment with the numbers to find the appropriate amount of pixels to scroll to. The scrollTo function call is wrapped in setTimeout function call, this delays the code execution to make sure the page is loaded. In this case, we delay execution by 1000 milliseconds, however depending on how the website is built, it may not be necessary. You can try setting the value to 0 and see if the page scroll still works.
This script forces to the page to refresh every 60 sections. It’s worth noting that it calls setTimeout that is executed only once, however since the script causes the page to reload which executes scripts again, so there is no need to use setInterval.
Website Scripting can be used to start a video on the page. This example will wait for the page to load 1 second, get all <video> tags, take the first one, and call play() function on it after. If the page has multiple video tags, this would start the first video it can find.
When it comes to logging into a website, there is no one-size-fits-all solution. Each website is a different system and needs a tailored approach. While JavaScript programming skills would be beneficial, it is certainly possible to create the script without any technical background. We gladly assist our subscription customers with simple scripts.
Login script performs the following actions:
Find username input field and fill it with our username
Find password input field and fill it with password
Find the login button and click it
First, we need to teach the script to find the elements in the web page. To do so, we need to find out what are the ids of the elements. While possible with every browser, we focus on Chrome in this guide. Navigate to the page you wish to automate the login procedure and open up developer tools:
Now from the developer tools pane that just open up select “Elements” tab if not already selected. Then click on the select element button (step 1) and mouse over the username input field and click on it (step 2). The HTML code will be highlighted that represents the username field, it should be an <input> tag. Most website creators assign a unique ID to that field that we can use to reference it in the script, in this example it is “user_login” (step3).
Repeat the same process for the password field. In our example, the password field id is “user_pass“. Ideally, the log in button has also id attribute present, in which case we have all the information needed to create the script:
Sometimes however the log in button may not have an id assigned, but instead, all fields are wrapped in a <form> element. In step 4 of the above screenshot, the form has an id assigned. Instead of clicking on the button, we can also call submit() function on the form itself:
document.getElementById('loginform').submit();
It could be possible however that the form does not have an id attribute assigned either. Then we can search for all <form> elements on the page and submit the first one we find, but beware that this only works if there is only one <form> on the page:
If you are very unlucky and none of the elements have an ID attribute assigned, then there are 2 options:
Contact the website developers and ask them to assign ID values to login page elements
Hire a developer to write the script – it’s still possible to find the elements, but it’s beyond the scope of this article. A qualified JavaScript developer should be able to develop the script in about 30 minutes to 1 hour
Microsoft login
Just replace replace username and password variables. This login script works for Microsoft, Office365, Hotmail and PowerBI sites.
var user = "YOUR_USERNAME_HERE";
var pass = "YOUR_PASSWORD";
function setValue(id, value){
document.getElementById(id).value = value;
document.getElementById(id).dispatchEvent(new Event("change"));
}
function clickButton(id){
document.getElementById(id).click();
}
setValue('i0116', user);
setTimeout(clickButton.bind(null, 'idSIButton9'), 100);
setTimeout(setValue.bind(null, 'i0118', pass), 500);
setTimeout(clickButton.bind(null, 'idSIButton9'), 1000);
Continuous scrolling
The script below will scroll the website from top to bottom at a given speed. This script is more complicated, but you don’t need to understand how it works. You can copy the script below and adjust the SPEED and JUMP_TO_TOP according to your needs.
var SPEED = 20; //change the speed for faster/slower scrolling. Value between 1 and 1000
var JUMP_TO_TOP = true; //Scrolls back to top when scrolling reaches bottom. either true or false
var fps = 100;
var speedFactor = 0.001;
var minDelta = 0.5;
var autoScrollSpeed = 10;
var autoScrollTimer, restartTimer;
var isScrolling = false;
var prevPos = 0, currentPos = 0;
var currentTime, prevTime, timeDiff;
window.addEventListener("wheel", handleManualScroll);
window.addEventListener("touchmove", handleManualScroll);
function handleManualScroll(){
currentPos = window.scrollY;
clearInterval(autoScrollTimer);
if (restartTimer){
clearTimeout(restartTimer);
}
restartTimer = setTimeout(function(){
prevTime = null;
setAutoScroll();
}, 50);
}
window.addEventListener("scroll", function (e) {
currentPos = window.scrollY;
if((window.innerHeight + window.pageYOffset) >= document.body.offsetHeight){
//scrolling reached bottom.
if(JUMP_TO_TOP){
window.scrollTo(0, 0)
currentPos = 0;
}
else{
clearInterval(autoScrollTimer);
}
}
});
function setAutoScroll(newValue){
if(newValue){
autoScrollSpeed = speedFactor * newValue;
}
if(autoScrollTimer){
clearInterval(autoScrollTimer);
}
autoScrollTimer = setInterval(function(){
currentTime = Date.now();
if(prevTime){
if(!isScrolling){
timeDiff = currentTime - prevTime;
currentPos += autoScrollSpeed * timeDiff;
if(Math.abs(currentPos - prevPos) >= minDelta){
isScrolling = true;
window.scrollTo(0, currentPos);
isScrolling = false;
prevPos = currentPos;
prevTime = currentTime;
}
}
}
else {
prevTime = currentTime;
}
}, 1000 / fps);
}
setAutoScroll(SPEED);
Widgets that work with our Website in Digital Signage
HTML Widgets are small code-based widgets that you can customize and design without having to think about coding at all.
There are tons of HTML widgets out there, the best option is to try your luck with a search engine, including the term HTML widget in the search query, for example, “Stock price HTML widget”. Here are some free ones that we’ve come across:
This is due to how HTML5 works. Iframe runs in a ‘sandbox’ as part of the browser window, whereas webview functions as a separate browser window. If the website you are trying to embed returns X-Frame-Options DENY/SAMEORIGIN header, the page cannot be displayed in an iframe because the website owner has forbidden it. However, the page is still rendered on our players that use webview instead.
What can be done?
You can contact the website maintainer or developer and ask them to lift the restriction.
You can use a player that displays the websites in a webview(see above) to bypass the restriction.
How can I log into websites with HTTP Basic Auth?
You can supply a username and password in a special URL format: http://username:[email protected]/
This sends the credentials in the standard HTTP Authorization header.
How can I identify the player device in my web application?
If you have a web application and you need to identify which device is making a request to your app, you can use a dynamic URL parameter {UUID} that the player will replace at run-time with its UUID. For example by using the following URL in the website plugin with a device that has UUID ABC123:
You can simply upload a PDF file to your library where our server will convert each page in the document to an image. However, if you have a PDF file that is frequently updated, you can link to it instead with a website plugin so it would always show the most recent version.
Displaying PDF via URL
Our Chrome extension (including ChromeOS), Linux, Mac, and Windows players have a built-in PDF reader, so displaying PDFs is straightforward. For other platforms, see the next FAQ answer. In addition, our Chrome extension offers some extra parameters that you can use to customize how the PDF is displayed. The parameters are added at the end of the file URL:
#page=2 – Opens the file on the second page.
#view=fith – Fits the page horizontally, the other option is fitv to fit vertically.
#zoom=150 – Zooms the page 150%.
You can also combine the parameters by chaining them together with the & sign, for example:
https://example.com/file.pdf#page=2&view=fith
Displaying PDF, Powerpoint, Excel, and Word documents using our website in digital signage
You can always upload these files to the library where our server will process them into images, but sometimes you want to link to a file directly, say on a Google Drive so you can edit it and have the changes go live right away. Our app on these platforms does not have a viewer for these formats by default, but it is possible to leverage Google docs or Microsoft office online viewers, here’s how:
If the widget does not display, you can also try hosting the HTML code on a public server, (for example https://htmlpasta.com/) or serve it from an HTML file in your server.
