Kategorie:FHEM Tablet UI V3: Unterschied zwischen den Versionen

Aus FHEMWiki
K (Pahenning verschob die Seite FHEM Tablet UI v3 nach Kategorie:FHEM Tablet UI V3: Klärung)
Keine Bearbeitungszusammenfassung
 
Zeile 7: Zeile 7:
|ModOwner=setstate ({{Link2FU|7023|Forum}})
|ModOwner=setstate ({{Link2FU|7023|Forum}})
}}
}}
FTUI3 = [[FHEM Tablet UI v3]] ist ein funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server. Es ist die Nachfolgeversion von FHEM Tablet UI v2 aber nicht abwärtskompatibel. Ein Umstieg auf FTUI3 hat eine Neu-Programmierung der Oberfläche zur Folge.
FTUI3 = [[FHEM Tablet UI v3]] ist ein funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server. Es ist die Nachfolgeversion von FHEM Tablet UI V2 aber nicht abwärtskompatibel. Ein Umstieg auf FTUI3 hat eine Neu-Programmierung der Oberfläche zur Folge.


Mit Hilfe zahlreicher Komponenten, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.
Mit Hilfe zahlreicher Komponenten, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.
== Installation ==
Die Installation von FHEM Tablet UI v3 (FTUI3) erzeugt keinen großen Aufwand und besteht im Großen und Ganzen aus zwei Schritten:
*Dateien aus dem GitHub-Repository herunterladen
*Eine Beispieldatei anlegen
{{Hinweis|Diese Anleitung geht davon aus, dass FHEM unter Debian nach der Anleitung [https://debian.fhem.de Stable build using apt] installiert wurde.
Ist dies nicht der Fall, muss der Pfad '''/opt/fhem''' dementsprechend angepasst werden.}}
'''1.''' Zuerst müssen alle Dateien von FHEM Tablet UI in das FHEM-Verzeichnis '''/opt/fhem/www/ftui''' kopiert werden. Das geht mit folgendem '''update'''-Befehl über die FHEM-Befehlszeile.
:<code>update all https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</code>
:[[Datei:FTUI3_Installation_01.png|thumb|none|Schritt 1: Dateien kopieren]]
<nowiki>{{FTUI3 kann in weiterer Folge unter der URL </nowiki>'''<nowiki>http(s)://<fhem-server>:8083/fhem/ftui/index.html</nowiki>''' aufgerufen werden.
'''2.''' Damit FHEM Tablet UI mit FHEM kommunizieren kann, ist noch die '''longpoll'''-Einstellung im [[FHEMWEB]] Device festzulegen.
:<code>attr WEB longpoll websocket</code>
:bzw. bei Problemen mit ''websocket''
:<code>attr WEB longpoll 1</code>
:[[Datei:FTUI3_Installation_03.png|thumb|none|Schritt 3: longpoll einstellen]]
'''3.''' Weil FTUI noch nichts anzuzeigen hat, wird die Datei '''/opt/fhem/www/ftui/index-example.html''' nach '''/opt/fhem/www/ftui/index.html''' kopiert.
:<code>sudo cp -a /opt/fhem/www/ftui/index-example.html /opt/fhem/www/ftui/index.html</code>
:[[Datei:FTUI3_Installation_04.png|thumb|none|Schritt 4: index.html erstellen]]
'''4.''' Abschließend muss FHEM noch '''neu gestartet''' werden (''shutdown restart'') da das Attribut '''longpoll''' geändert wurde.
Somit ist FHEM Tablet UI bereit zur Verwendung und kann durch Aufruf der URL '''<nowiki>http://<fhem-server>:8083/fhem/ftui/</nowiki>''' oder den Link im FHEM-Menü geöffnet werden
== Update ==
Ein Update von FTUI kann ebenfalls über die FHEM-Kommandozeile erfolgen.
'''1.''' Prüfen der Änderungen seit dem letzten Download/Update durch Eingabe von:
:<code><nowiki>update check https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</nowiki></code>
'''2.''' Update der geänderten Dateien durch Eingabe von:
:<code><nowiki>update all https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</nowiki></code>
Eine weitere Option ist das Hinzufügen des FTUI-Git-Repositories zum allgemeinem Update-Vorgang von FHEM. Dabei wird dann bei einem FHEM-Update auch gleich FHEM Tablet UI aktualisiert, bzw. die Änderungen angezeigt.
:<code><nowiki>update add https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</nowiki></code>
Beachte: Das Ergebnis des o.g. Befehls wird in FHEM/controls.txt eingetragen, siehe auch [[Update#update_add]]


== Dokumentation ==
== Dokumentation ==

Aktuelle Version vom 2. August 2024, 16:12 Uhr

FHEM Tablet UI V3
Zweck / Funktion
Oberfläche für FHEM v3
Allgemein
Typ Inoffiziell
Details
Dokumentation Thema
Support (Forum) TabletUI
Modulname n.a.
Ersteller setstate (Forum )
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

FTUI3 = FHEM Tablet UI v3 ist ein funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server. Es ist die Nachfolgeversion von FHEM Tablet UI V2 aber nicht abwärtskompatibel. Ein Umstieg auf FTUI3 hat eine Neu-Programmierung der Oberfläche zur Folge.

Mit Hilfe zahlreicher Komponenten, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.

Dokumentation

https://github.com/knowthelist/ftui/

Best practices

FTUI3 Best Practices (aktuell in Arbeit)