Weblink - Versionsgeschichte

Ph1959de: Sichtung/Korrektur der letzen Änderungen

2023-09-14T16:30:52Z

Sichtung/Korrektur der letzen Änderungen

← Nächstältere Version		Version vom 14. September 2023, 18:30 Uhr
Zeile 8:		Zeile 8:
	\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])		\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])
	}}		}}

	Das (Hilfs-)Modul [[weblink]] ermöglicht es,		Das (Hilfs-)Modul [[weblink]] ermöglicht es,
			* Links,
	*Links,		* HTML-Code,
	*HTML-Code,		* iframes,
	*iframes,		* Bilder und
	*Bilder,		* Listen in die [[FHEMWEB\|Fhem Oberfläche]] einzubinden.
	*~~und~~ Listen in die [[FHEMWEB\|Fhem Oberfläche]] einzubinden.


	Um dem Nutzer maximale Freiheit in der Gestaltung zu bieten, werden für Weblinks keine "Dekorationen" oder ein Bearbeitungslink hinzugefügt. Das ist auch notwendig, wenn man komplett nicht sichtbaren HTML Code in die Seite einbauen möchte. Will man einen Bearbeitungslink anzeigen, fügt man diesen selbst dem Quelltext hinzu.		Um dem Nutzer maximale Freiheit in der Gestaltung zu bieten, werden für Weblinks keine "Dekorationen" oder ein Bearbeitungslink hinzugefügt. Das ist auch notwendig, wenn man komplett nicht sichtbaren HTML Code in die Seite einbauen möchte. Will man einen Bearbeitungslink anzeigen, fügt man diesen selbst dem Quelltext hinzu.
Zeile 47:		Zeile 44:
	<img src="https://www.dwd.de/DE/wetter/wetterundklima_vorort/niedersachsen_bremen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561366" height="357" width="330"></img>\		<img src="https://www.dwd.de/DE/wetter/wetterundklima_vorort/niedersachsen_bremen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561366" height="357" width="330"></img>\
	<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="357" width="330"></img></syntaxhighlight>		<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="357" width="330"></img></syntaxhighlight>
	Bei dem Beispiel wird auch ein Link zum Bearbeiten mit erzeugt		Bei dem Beispiel wird auch ein Link zum Bearbeiten mit erzeugt.

	===HTML-Link darstellen===		===HTML-Link darstellen===

	In diesem Beispiel wird ein Link auf die Webseite web.archive.org erzeugt:		In diesem Beispiel wird ein Link auf die Webseite web.archive.org erzeugt:

Zeile 61:		Zeile 57:
	[[Datei:Bildschirmfoto vom FHEMWEB mit einem Weblink Link.png\|ohne\|mini]]		[[Datei:Bildschirmfoto vom FHEMWEB mit einem Weblink Link.png\|ohne\|mini]]
	=== "Stiller Weblink" (Webhook)===		=== "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.		Möchte 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:

Torxgewinde: /* HTML-Link darstellen */

2023-09-13T17:58:37Z

HTML-Link darstellen

← Nächstältere Version		Version vom 13. September 2023, 19:58 Uhr
Zeile 53:		Zeile 53:
	In diesem Beispiel wird ein Link auf die Webseite web.archive.org erzeugt:		In diesem Beispiel wird ein Link auf die Webseite web.archive.org erzeugt:

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

	Alternativ kann man einen weiteren Link zum Bearbeiten des Weblinks selbst hinzufügen:		Alternativ kann man einen weiteren Link zum Bearbeiten des Weblinks selbst hinzufügen:
			<syntaxhighlight lang="bash">defmod testLink weblink htmlCode <a href="/fhem?detail=testLink">edit</a>\
	<~~code~~>~~define weblink_test_web_archive_org2~~ weblink htmlCode ~~{ '<nowiki>~~<a href="/fhem?detail=~~weblink_test_web_archive_org2~~">edit</a>~~</nowiki><nowiki>~~<br \>~~</nowiki><nowiki>~~<a href="https://web.archive.org">web.archive.org test</a></~~nowiki>' }</code~~>		<br \>\
	[[Datei:Weblink ~~mit einfachem~~ Link.png\|ohne\|mini]]		<a href="https://web.archive.org">web.archive.org test</a></syntaxhighlight>
			[[Datei:Bildschirmfoto vom FHEMWEB mit einem Weblink Link.png\|ohne\|mini]]
	=== "Stiller Weblink" (Webhook)===		=== "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.		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.

Torxgewinde: /* Bearbeitung */

2023-09-13T17:45:06Z

Bearbeitung

← Nächstältere Version		Version vom 13. September 2023, 19:45 Uhr
Zeile 16:		Zeile 16:
	*Bilder,		*Bilder,
	*und Listen in die [[FHEMWEB\|Fhem Oberfläche]] einzubinden.		*und Listen in die [[FHEMWEB\|Fhem Oberfläche]] einzubinden.


			Um dem Nutzer maximale Freiheit in der Gestaltung zu bieten, werden für Weblinks keine "Dekorationen" oder ein Bearbeitungslink hinzugefügt. Das ist auch notwendig, wenn man komplett nicht sichtbaren HTML Code in die Seite einbauen möchte. Will man einen Bearbeitungslink anzeigen, fügt man diesen selbst dem Quelltext hinzu.

	==Anwendung ==		==Anwendung ==
Zeile 55:		Zeile 58:

	<code>define weblink_test_web_archive_org2 weblink htmlCode { '<nowiki><a href="/fhem?detail=weblink_test_web_archive_org2">edit</a></nowiki><nowiki><br \></nowiki><nowiki><a href="https://web.archive.org">web.archive.org test</a></nowiki>' }</code>		<code>define weblink_test_web_archive_org2 weblink htmlCode { '<nowiki><a href="/fhem?detail=weblink_test_web_archive_org2">edit</a></nowiki><nowiki><br \></nowiki><nowiki><a href="https://web.archive.org">web.archive.org test</a></nowiki>' }</code>
			[[Datei:Weblink mit einfachem Link.png\|ohne\|mini]]

	=== "Stiller Weblink" (Webhook)===		=== "Stiller Weblink" (Webhook)===

Torxgewinde: /* htmlCode-Typ, für simple aber wichtige Formatierungs-Ergänzungen */

2023-09-13T17:36:47Z

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

← Nächstältere Version		Version vom 13. September 2023, 19:36 Uhr
Zeile 46:		Zeile 46:
	Bei dem Beispiel wird auch ein Link zum Bearbeiten mit erzeugt		Bei dem Beispiel wird auch ein Link zum Bearbeiten mit erzeugt

	===~~htmlCode~~-~~Typ, für simple aber wichtige Formatierungs-Ergänzungen~~===		===HTML-Link darstellen===

	~~<code>define weblink_test_web_archive_org weblink htmlCode { '<a href="https://~~web.archive.org~~">web.archive.org test</a><br>' }</code>~~		In diesem Beispiel wird ein Link auf die Webseite web.archive.org erzeugt:

	~~(weil die Usability von~~ weblink ~~durchaus ein Buch mit sieben Siegeln sein~~ kann ~~- siehe exemplarische Foren-Diskussion~~...)		<code>define weblink_test_web_archive_org weblink htmlCode { '<a href="https://web.archive.org">web.archive.org test</a>' }</code>

			Alternativ kann man einen weiteren Link zum Bearbeiten des Weblinks selbst hinzufügen:

			<code>define weblink_test_web_archive_org2 weblink htmlCode { '<nowiki><a href="/fhem?detail=weblink_test_web_archive_org2">edit</a></nowiki><nowiki><br \></nowiki><nowiki><a href="https://web.archive.org">web.archive.org test</a></nowiki>' }</code>

	=== "Stiller Weblink" (Webhook)===		=== "Stiller Weblink" (Webhook)===

Torxgewinde: /* Bilder und Bearbeitungslink als HTML einfügen */

2023-09-13T17:32:13Z

Bilder und Bearbeitungslink als HTML einfügen

← Nächstältere Version		Version vom 13. September 2023, 19:32 Uhr
Zeile 35:		Zeile 35:
	===Bilder und Bearbeitungslink als HTML einfügen===		===Bilder und Bearbeitungslink als HTML einfügen===
	[[Datei:Weblink mit HTML Code um Bilder des DWD einzubinden.png\|rand\|ohne\|mini\|Weblink mit zwei externen Bildern des DWD]]		[[Datei:Weblink mit HTML Code um Bilder des DWD einzubinden.png\|rand\|ohne\|mini\|Weblink mit zwei externen Bildern des DWD]]


	Will man Bilder in die FHEMWEB Oberfläche einbinden, so kann man wie folgt ein Device erstellen.		Will man Bilder in die FHEMWEB Oberfläche einbinden, so kann man wie folgt ein Device erstellen.

Torxgewinde: Weblink mit Bildern hinzugefügt, Link zum Bearbeiten erwähnt und Beispiel dazu

2023-09-13T17:30:35Z

Weblink mit Bildern hinzugefügt, Link zum Bearbeiten erwähnt und Beispiel dazu

← Nächstältere Version		Version vom 13. September 2023, 19:30 Uhr
Zeile 9:		Zeile 9:
	}}		}}

	Das (Hilfs-)Modul [[weblink]] ermöglicht es, ~~eigene Links in die [[FHEMWEB\|Fhem Oberfläche]] einzubinden.~~		Das (Hilfs-)Modul [[weblink]] ermöglicht es,

	~~== Voraussetzungen ==~~		*Links,
	~~Keine~~.		*HTML-Code,
			*iframes,
			*Bilder,
			*und Listen in die [[FHEMWEB\|Fhem Oberfläche]] einzubinden.

	== Anwendung ==		==Anwendung ==
	=== Define ===		===Define===
	Details in der {{Link2CmdRef\|Anker=weblinkdefine}}.		Details in der {{Link2CmdRef\|Anker=weblinkdefine}}.

	=== Attribute ===		===Attribute===
	Details in der {{Link2CmdRef\|Anker=weblink}}.		Details in der {{Link2CmdRef\|Anker=weblink}}.

	=== Bearbeitung ===		===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		Da ''weblinks'' in der FHEM-Oberfläche frei gestaltet werden können, wird kein Link zum Bearbeiten angezeigt. Es empfiehlt es sich, z.B. den Weg über
	* <code>list TYPE=weblink</code> (listet alle definierten ''weblinks'' auf) oder		*<code>list TYPE=weblink</code> (listet alle definierten ''weblinks'' auf) oder
	* <code>list name_des_weblinks</code> (sofern der Name des gewünschten ''weblinks'' bekannt ist)		*<code>list name_des_weblinks</code> (sofern der Name des gewünschten ''weblinks'' bekannt ist)
	zu gehen.		zu gehen. Die Kommandos gibt man in die Befehlszeile ein und erhält eine Liste von weblink-Devices die man dort anklicken kann. Alternativ kann man einen Link zum Bearbeiten mit erstellen.

	== Anwendungsbeispiele ==		==Anwendungsbeispiele==
	Die Anwendung von Weblinks ist erläutert und bebildert z.B. auf der Seite [[UWZ]]. Des Weiteren werden auch [[SVG\|Diagramme]] in der Regel als ''weblink'' des Typs '''''fileplot''''' definiert und eingebunden.		Die Anwendung von Weblinks ist erläutert und bebildert z.B. auf der Seite [[UWZ]]. Des Weiteren werden auch [[SVG\|Diagramme]] in der Regel als ''weblink'' des Typs '''''fileplot''''' definiert und eingebunden.

	=== htmlCode-Typ, für simple aber wichtige Formatierungs-Ergänzungen ===		===Bilder und Bearbeitungslink als HTML einfügen===
			[[Datei:Weblink mit HTML Code um Bilder des DWD einzubinden.png\|rand\|ohne\|mini\|Weblink mit zwei externen Bildern des DWD]]


			Will man Bilder in die FHEMWEB Oberfläche einbinden, so kann man wie folgt ein Device erstellen.

			<syntaxhighlight lang="bash">
			defmod DWDWetterNiedersachsenAktuell.webview weblink htmlCode \
			<a href="/fhem?detail=DWDWetterNiedersachsenAktuell.webview">edit</a><br />\
			\
			<img src="https://www.dwd.de/DE/wetter/wetterundklima_vorort/niedersachsen_bremen/_functions/bildgalerie/wetter_aktuell.jpg?view=nasImage&nn=561366" height="357" width="330"></img>\
			<img src="https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif" height="357" width="330"></img></syntaxhighlight>
			Bei dem Beispiel wird auch ein Link zum Bearbeiten mit erzeugt

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

	<code>define weblink_test_web_archive_org weblink htmlCode { '<a href="https://web.archive.org">web.archive.org test</a><br>' }</code>		<code>define weblink_test_web_archive_org weblink htmlCode { '<a href="https://web.archive.org">web.archive.org test</a><br>' }</code>
Zeile 36:		Zeile 53:
	(weil die Usability von weblink durchaus ein Buch mit sieben Siegeln sein kann - siehe exemplarische Foren-Diskussion...)		(weil die Usability von weblink durchaus ein Buch mit sieben Siegeln sein kann - siehe exemplarische Foren-Diskussion...)

	=== "Stiller Weblink" (Webhook) ===		=== "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.		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.

Torxgewinde: /* "Stiller Weblink" (Webhook) */

2023-09-13T16:27:09Z

"Stiller Weblink" (Webhook)

← Nächstältere Version		Version vom 13. September 2023, 18:27 Uhr
Zeile 51:		Zeile 51:
	Der Webhook erzeugt keinen sichtbaren Output für den Benutzer. Stattdessen wird ein unsichtbarer Kommentar in Form von <code>< !-- Kommentar: WEB.WebHook wurde ausgeführt, um diesen Kommentar auszugeben -- ></code> generiert.		Der Webhook erzeugt keinen sichtbaren Output für den Benutzer. Stattdessen wird ein unsichtbarer Kommentar in Form von <code>< !-- Kommentar: WEB.WebHook wurde ausgeführt, um diesen Kommentar auszugeben -- ></code> 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.		Zusätzlich kann 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==		==Links==
	*Forenthema {{Link2Forum\|Topic=75172\|LinkText=weblink - wie editieren?}}		*Forenthema {{Link2Forum\|Topic=75172\|LinkText=weblink - wie editieren?}}

Torxgewinde: /* "Stiller Weblink" (Webhook) */

2023-09-13T16:26:45Z

"Stiller Weblink" (Webhook)

← Nächstältere Version		Version vom 13. September 2023, 18:26 Uhr
Zeile 49:		Zeile 49:
	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.		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 <!-- Kommentar: WEB.WebHook wurde ausgeführt, um diesen Kommentar auszugeben --> generiert.		Der Webhook erzeugt keinen sichtbaren Output für den Benutzer. Stattdessen wird ein unsichtbarer Kommentar in Form von <code>< !-- Kommentar: WEB.WebHook wurde ausgeführt, um diesen Kommentar auszugeben -- ></code> 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.		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.

Torxgewinde: /* "Stiller Weblink" (Webhook) */

2023-09-13T16:25:32Z

"Stiller Weblink" (Webhook)

← Nächstältere Version		Version vom 13. September 2023, 18:25 Uhr
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:

Torxgewinde: /* "stummer weblink", Webhook */

2023-09-13T16:24:39Z

"stummer weblink", Webhook

← Nächstältere Version		Version vom 13. September 2023, 18:24 Uhr
Zeile 36:		Zeile 36:
	(weil die Usability von weblink durchaus ein Buch mit sieben Siegeln sein kann - siehe exemplarische Foren-Diskussion...)		(weil die Usability von weblink durchaus ein Buch mit sieben Siegeln sein kann - siehe exemplarische Foren-Diskussion...)

	==="~~stummer weblink~~", Webhook===		=== "Stiller Weblink" (Webhook) ===
	~~Will~~ man einen Befehl ausführen sobald ein bestimmter Raum aufgerufen wird, ~~kann~~ man einen Weblink erstellen, der ~~keinerlei Ausgabe~~ erzeugt. ~~Er wird ausgeführt~~, ~~ist aber unsichtbar:~~		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.
	~~<code>defmod WEB~~.~~WebHook.weblink weblink htmlCode { fhem("setreading WEB.WebHook.weblink bla $today $hms");; return; }~~

	attr WEB.WebHook~~.weblink~~ room Raum1,Raum2,Raum3</~~code~~>		Hier der Code:
			<syntaxhighlight lang="bash">
			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
			</syntaxhighlight>
			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 <!-- Kommentar: WEB.WebHook wurde ausgeführt, um diesen Kommentar auszugeben --> 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==		==Links==
	*Forenthema {{Link2Forum\|Topic=75172\|LinkText=weblink - wie editieren?}}		*Forenthema {{Link2Forum\|Topic=75172\|LinkText=weblink - wie editieren?}}