openhab-core/bundles/org.openhab.ui.dashboard
Martin van Wingerden 5a21ca6b02 Updated copyrights to 2018 (#271)
Signed-off-by: Martin van Wingerden <martinvw@mtin.nl>
2018-01-03 09:26:13 +01:00
..
.settings code cleanup to match expectations of static analysis tool (#151) 2017-06-02 16:40:55 +02:00
ESH-INF/i18n Fix crowdin incompatibility (#245) 2017-12-05 13:57:36 +01:00
META-INF [unleash-maven-plugin] Preparation for next development cycle. 2017-12-17 23:40:22 +01:00
OSGI-INF Use new NetworkAddressService for Dashboard (#191) 2017-08-15 12:14:54 +02:00
src/main/java/org/openhab/ui/dashboard Updated copyrights to 2018 (#271) 2018-01-03 09:26:13 +01:00
templates Dashboard internationalization (#217) 2017-11-18 23:36:41 +01:00
web added a round white background to the favicon 2017-10-27 18:07:13 +02:00
.classpath code cleanup to match expectations of static analysis tool (#151) 2017-06-02 16:40:55 +02:00
.project initial commit of openhab core components 2015-12-26 23:22:23 +01:00
about.html added about files 2017-04-07 16:26:59 +02:00
build.properties fixed dashboard localization (#233) 2017-11-19 00:25:17 +01:00
pom.xml [unleash-maven-plugin] Preparation for next development cycle. 2017-12-17 23:40:22 +01:00
README.md Improve dashboard README (#254) 2017-12-10 16:39:55 +01:00

Dashboard

The openHAB dashboard is a landing page for the user where all openHAB UIs can be found. The Dashboard also supports links to external services. Links can be added to the dashboard by editing the $OPENHAB_CONF/services/dashboard.cfg configuration file.

Parameter Name Type Description
<unique-name>.link-name String Name which is shown in the openHAB dashboard.
<unique-name>.link-url String URL to external service.
<unique-name>.link-imageurl String URL to image which is shown in the dashboard.

Where <unique-name> is link unique identifier (see examples).

Image

A png image of 350px width and 200-250px height are recommended.

The imageurl property can either be a direct HTTP link or data URIs according to RFC2397. If data URIs are used, browser should support them as well. All five major browsers (Chrome, Firefox, IE, Opera and Safari) support data URIs. See e.g. https://www.base64-image.de to convert images to base64 coded data.

Example Configuration File

frontail.link-name=openHAB Log Viewer
frontail.link-url=http://<server-adddress>:9001
frontail.link-imageurl=../static/image.png

nodered.link-name=Node-RED
nodered.link-url=http://<server-adddress>:1880
nodered.link-imageurl=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAXwAAACfCAIAAA...QmCC

Note: nodered image data URL is not valid (it's shorten for the sake of clarity).