Modul PostMe

Aus FHEMWiki

Achtung: Work in progress. Bitte vorläufig Finger weg !

PostMe
Zweck / Funktion
Das Modul stellt eine komfortable Oberfläche bereit, um per Webinterface beliebige Listen ähnlich wie gelbe Klebezettel (Post-It&tm;) zu verwalten.
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Unterstuetzende Dienste
Modulname 95_PostMe.pm
Ersteller Prof. Dr. Peter A. Henning
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Einbinden in die FHEM-Anzeige

PostMes können in jede beliebige Webseite eingebunden werden. Beispielsweise<embed src="/fhem/PostMe_widget?type=pins&postit=PostIt"/>

kann auch das Standard-Attribut icon des diesem Postme-System zugeordneten Devices durch einen der folgenden Codes ersetzt werden.
  • Mit dem Code
<embed src="/fhem/PostMe_widget?type=pins&postit=<devicename>"/>

wird eine interaktive Liste aller Titelzeilen der PostMes dieses Systems angezeigt.

  • Mit dem Code
<embed src="/fhem/PostMe_widget?type=pin&postit=<devicename>&name=<name>"/>

wird ein einzelnes PostMe mit dem Namen <name> als Titelzeile angezeigt.

Art der Widgets

In diesen Darstellungen kann durch die Maus erreicht werden, dass zur einzeiligen Anzeige der Titelzeile der volle Inhalt des PostMes angezeigt wird.

  • Wenn das Attribut postmeClick auf 0 gesetzt ist (Default-Wert), erfolgt die Anzeige und das Löschen des PostMe-Inhaltes durch Überfahren bzw. Wegfahren des Mauszeigers auf die Titelzeile.
  • Wenn das Attribut postmeClick auf 1 gesetzt ist, muss die Titelzeile angeklickt werden, um den Inhalt zu sehen - und das entsprechens Fenster bzw. die Dialogbock explizit geschlossen werden.

Welcher Art die Anzeige des PostMe-Inhalte sist, wird durch ein anderes Attribut geregelt.

  • Wenn postmeStyle=jQuery" (Default-Wert), erfolgt die Anzeige in einer jQuery-Dialogbox.
  • Wenn postmeStyle=HTML", erfolgt die Anzeige in einem neuen (kleinen) Browser-Fenster.
  • Wenn postmeStyle=SVG", erfolgt die Anzeige in einer SVG-Viewbox.

Aussehen der widgets

Die oben genannten Widgets werden in ihrem Aussehen über Cascading Stylesheets gesteuert. Drei Klassen sind dafür relevant, sie sollten in die Datei style.css (oder, wenn man einen anderen Stylesheet-Präfix gesetzt hat, <präfix>style.css) eingetragen werden. Mit beispielhafter Farbe für die Widgets:

.postmeclass { background-color:#ffee80; padding:10px; border-color:black; border:groove}
.postmeclass2 { background-color:#ffee80; padding:10px;}
div.ui-widget-content {background-color: #ffee80; border-color:red;margin-top:-20px}