Caution

This is the documentation for the current development branch of the CometVisu. It is possible that some of the described features are not yet available in the current release.

Also there might be lots of errors in this documentation as some parts of the content have been translated by an online translation service.

Plugin

The plugin component embeds compatible CometVisu plugins inside the tile structure. The wrapper loads the plugin code and renders its output directly at the place of the <cv-plugin> element. This is useful for content that already exists as a plugin, for example weather information inside a popup.

Within the tile schema, <cv-plugin> is currently mainly used with the OpenWeatherMap plugin. Additional plugins can be integrated in the same way when the configuration schema is extended accordingly.

<cv-small-status value-format="%d°" styling="">
    <label slot="value" style="font-size: 32px"/>
    <label slot="label" class="secondary">Outside</label>
    <cv-address slot="address" transform="DPT:5.010" mode="read">1/4/2</cv-address>
    <cv-popup slot="popup" modal="true">
        <cv-plugin>
            <openweathermap q="Somewhere" owID="12345677" appid="123456789" lang="en"/>
        </cv-plugin>
    </cv-popup>
</cv-small-status>

Allowed attributes

Element	Attribute
	Name	Content	Description
cv-plugin	name	string
	visible-on	mobile or desktop	Controls this element’s visibility by screen size.
	class	string	Add this value to the CSS class so that it can be formatted by a user provided style sheet.
	style	string	Custom CSS style rules for this widget.
	row	1, 2, 3, first, middle or last	Row number or position (first, middle, last)
	column	1, 2, 3, first, middle or last	Column number or position (first, middle, last)
	rowspan	integer	Number of rows this element spans
	colspan	integer	Number of columns this element spans

Allowed child elements and their attributes

Element	Attribute
Structure	Name	Content	Description
cv-plugin openweathermap	lang	en, de or fr	Language / format of the date
	appid	string	Personal access key as obtained from https://openweathermap.org/
	description	string	Describing text, displays the place name when left empty. “false” disables the display
	detailItems	integer	Displays details when set to 1 (default) and hides them when set to 0
	forecast24hItems	integer	Number of items to show (0…8)
	forecastDailyItems	integer	Number of items to show (0…4)
	showSunrise	true or false	Show the sun rise and set information
	owID	string	OpenWeatherMap city ID as defined in https://bulk.openweathermap.org/sample/city.list.json.gz
	q	string	When owID is not used: City name and country code divided by comma, use ISO 3166 country codes
	lat	string	When owID or q is not used: latitude of place
	lon	string	When owID or q is not used: longitude of place
	refresh	integer	Refresh interval of the data in minutes
	class	string	Add this value to the CSS class so that it can be formatted by a user provided style sheet.