Weblink: Unterschied zwischen den Versionen

Aus FHEMWiki
Zeile 37: Zeile 37:


=== "Stiller Weblink" (Webhook) ===
=== "Stiller Weblink" (Webhook) ===
Möchten man einen Befehl ausführen, sobald ein bestimmter Raum aufgerufen wird, können man einen "stillen Weblink" (Webhook) erstellen, der keinen sichtbaren Output erzeugt. Dies ermöglicht es, automatisierte Aktionen in FHEM auszulösen, ohne dass man dafür mehr tun als den Raum mit einem Webbrowser aufzurufen.
Möchten man einen Befehl ausführen, sobald ein bestimmter Raum aufgerufen wird, kann man einen "stillen Weblink" (Webhook) erstellen, der keinen sichtbaren Output erzeugt. Dies ermöglicht es, automatisierte Aktionen in FHEM auszulösen, ohne dass man dafür mehr tun muss als den Raum mit einem Webbrowser aufzurufen.


Hier der Code:
Hier der Code:

Version vom 13. September 2023, 17:25 Uhr


weblink
Zweck / Funktion
Platzhalter zur Anzeige benutzerdefinierter Links
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Frontends
Modulname 98_weblink.pm
Ersteller rudolfkoenig (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Das (Hilfs-)Modul weblink ermöglicht es, eigene Links in die Fhem Oberfläche einzubinden.

Voraussetzungen

Keine.

Anwendung

Define

Details in der commandref/weblinkdefine.

Attribute

Details in der commandref/weblink.

Bearbeitung

Da weblinks in der FHEM-Oberfläche keine einfache Möglichkeit bieten, in den Bearbeitungsmodus zu wechseln, empfiehlt es sich, z.B. den Weg über

  • list TYPE=weblink (listet alle definierten weblinks auf) oder
  • list name_des_weblinks (sofern der Name des gewünschten weblinks bekannt ist)

zu gehen.

Anwendungsbeispiele

Die Anwendung von Weblinks ist erläutert und bebildert z.B. auf der Seite UWZ. Des Weiteren werden auch Diagramme in der Regel als weblink des Typs fileplot definiert und eingebunden.

htmlCode-Typ, für simple aber wichtige Formatierungs-Ergänzungen

define weblink_test_web_archive_org weblink htmlCode { '<a href="https://web.archive.org">web.archive.org test</a>
' }

(weil die Usability von weblink durchaus ein Buch mit sieben Siegeln sein kann - siehe exemplarische Foren-Diskussion...)

"Stiller Weblink" (Webhook)

Möchten man einen Befehl ausführen, sobald ein bestimmter Raum aufgerufen wird, kann man einen "stillen Weblink" (Webhook) erstellen, der keinen sichtbaren Output erzeugt. Dies ermöglicht es, automatisierte Aktionen in FHEM auszulösen, ohne dass man dafür mehr tun muss als den Raum mit einem Webbrowser aufzurufen.

Hier der Code:

defmod WEB.WebHook weblink htmlCode {
  fhem("setreading WEB.WebHook bla $today $hms");;
  return "<!-- Comment: WEB.WebHook was executed to print this comment -->";
}
attr WEB.WebHook room Raum1,Raum2,Raum3

In diesem Codeausschnitt wird ein Webhook mit dem Namen "WEB.WebHook" erstellt. Wenn dieser Webhook aufgerufen wird, führt er den Befehl fhem("setreading WEB.WebHook bla $today $hms") aus, um ein Reading mit dem Namen "bla" zu setzen, das das aktuelle Datum und die Uhrzeit enthält.

Der Webhook erzeugt keinen sichtbaren Output für den Benutzer. Stattdessen wird ein unsichtbarer Kommentar in Form von generiert.

Zusätzlich können man mithilfe der attr-Zeile festlegen, in welchen Räumen dieser Webhook aktiv sein soll. In diesem Fall ist der Webhook in den Räumen "Raum1", "Raum2" und "Raum3" aktiv.

Links