$d
\n";
$ret .= "\n";
$ret .= "\n";
$ret .= "\n";
$ret .= " |
\n";
########################### Dashboard Tab-Liste ##############################################
$ret .= " \n";
########################################################################################
for (my $t=0;$t<$tabcount;$t++){
if ($t == $activetab - 1) {
$ret .= BuildDashboardTab($t, $d);
}
}
$ret .= " |
".$defs{$d}{TYPE}." | ||
|
\n";
$ret .= "
\n";
return $ret;
}
sub BuildDashboardTopRow($$$$){
my ($t,$id, $devicegroups, $groupsorting) = @_;
my $ret;
$ret .= "- \n";
$ret .= "
\n";
$ret .= "
\n";
$ret .= "\n";
$ret .= BuildGroupWidgets($t,"100",$id,$devicegroups,$groupsorting);
$ret .= "
\n";
$ret .= "\n";
my $currentcol = $colcount;
my $maxcolindex = $colcount - 1;
my $replace = "t" . $t . "c" . $maxcolindex . ",";
# replace all sortings referencing not existing columns
# this does only work if there is no empty column inbetween
while (index($groupsorting, "t".$t."c".$currentcol.",") >= 0) {
my $search = "t" . $t . "c" . $currentcol . ",";
$groupsorting =~ s/$search/$replace/g;
$currentcol++;
}
for (my $i=0;$i<$colcount;$i++){
$ret .= "
\n";
$ret .= "\n";
$ret .= BuildGroupWidgets($t,$i,$id,$devicegroups,$groupsorting);
$ret .= "
\n";
}
$ret .= "\n";
$ret .= "
\n";
$ret .= "\n";
$ret .= BuildGroupWidgets($t,"200",$id,$devicegroups,$groupsorting);
$ret .= "
\n";
$ret .= "\n";
$ret .= " \n";
$ret .= "
\n";
if (!$foundDevices) {
$ret .= "| Devices for group not found: $groupname |
| Check if the device/group attribute is really set |
| Check if the device spec is correctly written |
Dashboard
-
Creates a Dashboard in any group can be arranged. The positioning may depend the Groups and column width are made
- dashboard_tabcount
Returns the number of displayed tabs. (Does not need to be set any more. It is read automatically from the configured tabs) Default: 1 - dashboard_activetab
Specifies which tab is activated. Can be set manually, but is also set by the switch "Set" to the currently active tab. Default: 1 - dashboard_tabXname
Title of Tab at position X. - dashboard_tabXsorting
Contains the position of each group in Tab X. Value is written by the "Set" button. It is not recommended to take manual changes. - dashboard_row
To select which rows are displayed. top only; center only; bottom only; top and center; center and bottom; top,center and bottom.
Default: center - dashboard_width
To determine the Dashboardwidth. The value can be specified, or an absolute width value (eg 1200) in pixels in% (eg 80%).
Default: 100% - dashboard_rowcenterheight
Height of the center row in which the groups may be positioned.
Default: 400 - dashboard_rowcentercolwidth
About this attribute, the width of each column of the middle Dashboardrow can be set. It can be stored for each column a separate value. The values must be separated by a comma (no spaces). Each value determines the column width in%! The first value specifies the width of the first column, the second value of the width of the second column, etc. Is the sum of the width greater than 100 it is reduced. If more columns defined as widths the missing widths are determined by the difference to 100. However, are less columns are defined as the values of ignores the excess values.
Default: 100 - dashboard_rowtopheight
Height of the top row in which the groups may be positioned.
Default: 250 - "dashboard_rowbottomheight
Height of the bottom row in which the groups may be positioned.
Default: 250 - dashboard_tabXgroups
Comma-separated list of the names of the groups to be displayed in Tab X.
Each group can be given an icon for this purpose the group name, the following must be completed ":<icon>@<color>"
Example: Light:Icon_Fisch@blue,AVIcon_Fisch@red,Single Lights:Icon_Fisch@yellow
Additionally a group can contain a regular expression to show all groups matching a criteria. Example: .*Light.* to show all groups that contain the string "Light" - dashboard_tabXdevices
devspec list of devices that should appear in the tab. The format is:
GROUPNAME:devspec1,devspec2,...,devspecN:ICONNAME THe icon name is optional. Also the group name is optional. In case of missing group name, the matching devices are not grouped but shown as separate widgets without titles. For further details on the devspec format see:
Dev-Spec - dashboard_tabXicon
Set the icon for a Tab. There must exist an icon with the name ico.(png|svg) in the modpath directory. If the image is referencing an SVG icon, then you can use the @colorname suffix to color the image. - dashboard_colcount
Number of columns in which the groups can be displayed. Nevertheless, it is possible to have multiple groups
to be positioned in a column next to each other. This is depend on the width of columns and groups.
Default: 1 - dashboard_tabXcolcount
Number of columns for a specific tab in which the groups can be displayed. Nevertheless, it is possible to have multiple groups
to be positioned in a column next to each other. This depends on the width of columns and groups.
Default: - dashboard_tabXbackgroundimage
Shows a background image for the X tab. The image is not stretched in any way, it should therefore match the tab size or extend it. Standard: - dashboard_flexible
If set to a value > 0, the widgets are not positioned in columns any more but can be moved freely to any position in the tab.
The value for this parameter also defines the grid, in which the position "snaps in". Default: 0 - dashboard_showfullsize
Hide FHEMWEB Roomliste (complete left side) and Page Header if Value is 1.
Default: 0 - dashboard_showtabs
Displays the Tabs/Buttonbar on top or bottom, or hides them. If the Buttonbar is hidden lockstate is "lock" is used.
Default: tabs-and-buttonbar-at-the-top - dashboard_showtogglebuttons
Displays a Toogle Button on each Group do collapse.
Default: 0 - dashboard_backgroundimage
Displays a background image for the complete dashboard. The image is not stretched in any way so the size should match/extend the dashboard height/width. Default: - dashboard_debug
Show Hiddenfields. Only for Maintainer's use.
Default: 0
arbitrarily by drag'n drop. Also, the width and height of a Group can be increased beyond the minimum size.
Define
define <name> Dashboard
Example:
define anyViews Dashboard
Bestpractice beginner configuration
define anyViews Dashboard
attr anyViews dashboard_colcount 2
attr anyviews dashboard_rowcentercolwidth 30,70
attr anyViews dashboard_tab1groups <Group1>,<Group2>,<Group3>
Set
set <name> locklocks the Dashboard so that no position changes can be made
set <name> unlockunlock the Dashboard
Get
- N/A
Attributes
Dashboard
-
Erstellt eine Übersicht in der Gruppen angeordnet werden können. Dabei können die Gruppen mit Drag'n Drop frei positioniert
- dashboard_tabcount
Gibt die Anzahl der angezeigten Tabs an. (Dieser Parameter is veraletet, die Anzahl der Tabs wird aus der Dashboard-Konfiguration gelesen) Standard: 1 - dashboard_activetab
Gibt an welches Tab aktiviert ist. Kann manuell gesetzt werden, wird aber auch durch den Schalter "Set" auf das gerade aktive Tab gesetzt. Standard: 1 - dashboard_tabXname
Titel des X. Tab. - dashboard_tabXsorting
Enthält die Poistionierung jeder Gruppe im Tab X. Der Wert wird mit der Schaltfläche "Set" geschrieben. Es wird nicht empfohlen dieses Attribut manuelle zu ändern - dashboard_row
Auswahl welche Zeilen angezeigt werden sollen. top (nur Oben), center (nur Mitte), bottom (nur Unten) und den Kombinationen daraus.
Standard: center - dashboard_width
Zum bestimmen der Dashboardbreite. Der Wert kann in % (z.B. 80%) angegeben werden oder als absolute Breite (z.B. 1200) in Pixel.
Standard: 100% - dashboard_rowcenterheight
Höhe der mittleren Zeile, in der die Gruppen angeordnet werden.
Standard: 400 - dashboard_rowcentercolwidth
Über dieses Attribut wird die Breite der einzelnen Spalten der mittleren Dashboardreihe festgelegt. Dabei kann je Spalte ein separater Wert hinterlegt werden. Die Werte sind durch ein Komma (ohne Leerzeichen) zu trennen. Jeder Wert bestimmt die Spaltenbreite in %! Der erste Wert gibt die Breite der ersten Spalte an, der zweite Wert die Breite der zweiten Spalte usw. Ist die Summe der Breite größer als 100 werden die Spaltenbreiten reduziert. Sind mehr Spalten als Breiten definiert werden die fehlenden Breiten um die Differenz zu 100 festgelegt. Sind hingegen weniger Spalten als Werte definiert werden die überschüssigen Werte ignoriert.
Standard: 100 - dashboard_rowtopheight
Höhe der oberen Zeile, in der die Gruppen angeordnet werden.
Standard: 250 - "dashboard_rowbottomheight
Höhe der unteren Zeile, in der die Gruppen angeordnet werden.
Standard: 250 - dashboard_tab1groups
Durch Komma getrennte Liste mit den Namen der Gruppen, die im Tab 1 angezeigt werden. Falsche Gruppennamen werden hervorgehoben.
Jede Gruppe kann zusätzlich ein Icon anzeigen, dazu muss der Gruppen name um ":<icon>@<farbe>"ergänzt werden
Beispiel: Light:Icon_Fisch@blue,AVIcon_Fisch@red,Single Lights:Icon_Fisch@yellow
Der Gruppenname kann ebenfalls einen regulären Ausdruck beinhalten, um alle Gruppen anzuzeigen, die darauf passen.
Beispiel: .*Licht.* zeigt alle Gruppen an, die das Wort "Licht" im Namen haben. - dashboard_tabXdevices
devspec Liste von Geräten, die im Tab angezeigt werden sollen. Das format ist:
GROUPNAME:devspec1,devspec2,...,devspecN:ICONNAME Das Icon ist optional. Auch der Gruppenname muss nicht vorhanden sein. Im Falle dass dieser fehlt, werden die gefunden Geräte nicht gruppiert sondern als einzelne Widgets im Tab angezeigt. Für weitere Details bezüglich devspec: Dev-Spec - dashboard_tabXicon
Zeigt am Tab ein Icon an. Es muss sich dabei um ein exisitereindes Icon mit modpath Verzeichnis handeln. Handelt es sich um ein SVG Icon kann der Suffix @colorname für die Farbe des Icons angegeben werden. - dashboard_colcount
Die Anzahl der Spalten in der Gruppen dargestellt werden können. Dennoch ist es möglich, mehrere Gruppen
in einer Spalte nebeneinander zu positionieren. Dies ist abhängig von der Breite der Spalten und Gruppen.
Gilt nur für die mittlere Spalte!
Standard: 1 - dashboard_tabXcolcount
Die Anzahl der Spalten im Tab X in der Gruppen dargestellt werden können. Dennoch ist es möglich, mehrere Gruppen
in einer Spalte nebeneinander zu positionieren. Dies ist abhängig von der Breite der Spalten und Gruppen.
Gilt nur für die mittlere Spalte!
Standard: - dashboard_tabXbackgroundimage
Zeigt ein Hintergrundbild für den X-ten Tab an. Das Bild wird nicht gestreckt, es sollte also auf die Größe des Tabs passen oder diese überschreiten. Standard: - dashboard_flexible
Hat dieser Parameter einen Wert > 0, dann können die Widgets in den Tabs frei positioniert werden und hängen nicht mehr an den Spalten fest. Der Wert gibt ebenfalls das Raster an, in dem die Positionierung "zu schnappt". Standard: 0 - dashboard_showfullsize
Blendet die FHEMWEB Raumliste (kompleter linker Bereich der Seite) und den oberen Bereich von FHEMWEB aus wenn der Wert auf 1 gesetzt ist.
Default: 0 - dashboard_showtabs
Zeigt die Tabs/Schalterleiste des Dashboards oben oder unten an, oder blendet diese aus. Wenn die Schalterleiste ausgeblendet wird ist das Dashboard gespert.
Standard: tabs-and-buttonbar-at-the-top - dashboard_showtogglebuttons
Zeigt eine Schaltfläche in jeder Gruppe mit der man diese auf- und zuklappen kann.
Standard: 0 - dashboard_backgroundimage
Zeig in Hintergrundbild im Dashboard an. Das Bild wird nicht gestreckt, es sollte daher auf die Größe des Dashboards passen oder diese überschreiten. Default: - dashboard_debug
Zeigt Debug-Felder an. Sollte nicht gesetzt werden!
Standard: 0
und in mehreren Spalten angeordnet werden. Auch kann die Breite und Höhe einer Gruppe über die Mindestgröße hinaus gezogen werden.
Define
define <name> Dashboard
Beispiel:
define anyViews Dashboard
Bestpractice Anfängerkonfiguration
define anyViews Dashboard
attr anyViews dashboard_colcount 2
attr anyViews dashboard_rowcentercolwidth 30,70
attr anyViews dashboard_tab1groups <Group1>,<Group2>,<Group3>
Set
set <name> lockSperrt das Dashboard so das keine Positionsänderungen vorgenommen werden können
set <name> unlockEntsperrt das Dashboard
Get
- N/A
Attributes