Subsections


2.1 OPT_YAPSGUI - Web-Oberfläche für YAPS

2.1.1 Einleitung

Dieses Paket bietet eine Web-Oberfläche zur Bedienung von YAPS. Es basiert auf dem OPT-Paket “YAPSGUI”, das ursprünglich von Felix Eckhofer (E-Mail: felix@fli4l.de) entwickelt wurde. Es setzt den Einsatz des Mini-HTTPDs aus dem HTTPD-Paket voraus.

2.1.2 Oberfläche

Ist das Paket installiert (siehe unten), ist es über die Web-Oberfläche des fli4l zu erreichen. Unter “Absender” und “Empfänger” einfach einen Eintrag aus dem Telefonbuch (s.u.) auswählen oder Nummer im Textfeld darunter von Hand eingeben, Nachricht verfassen, auf Abschicken klicken (nur einmal!) und hoffen, dass alles geklappt hat (Bestätigung abwarten...). Das Dropdown-Menü “Debuglevel” regelt, wie viele Meldungen “yaps” ausgibt. “0” gibt am wenigsten und “4” am meisten Meldungen aus.

Mit der Checkbox “Empfangsbestätigung” können Sie bestimmen, ob eine Empfangsbestätigung vom Netzbetreiber angefordert werden soll. Das funktioniert aber leider nicht bei jedem Netzbetreiber.

2.1.3 Telefonbücher

YAPSGUI bietet zur einfacheren Bedienung ein Telefonbuch, sowohl für Absender als auch für Empfänger. Dieses kann auch abhängig vom Benutzer verwaltet werden. Ob und wenn ja, welche Telefonbuch-Dateien verwendet werden sollen, wird in der Konfiguration angegeben (s.u.). Der Aufbau dieser Dateien entspricht dem Aufbau der Telefonbuch-Datei /etc/phonebook vom Imonc:

Nummer1=Name1
Nummer2=Name2
...

Im Namen ist jedes Zeichen außer dem Gleichheitszeichen “=” erlaubt. Ein Beispiel:

0170123456=Hans Müller-Lüdenscheidt
0162666555=Sabine v. und zu der Thann


Wichtig: Wenn die Telefonbuch-Dateien außerhalb der Weboberfläche bearbeitet werden, ist auf jeden Fall darauf zu achten, dass die letzte Zeile mit einem harten Zeilenumbruch (Enter) abgeschlossen wird!

2.1.4 Konfiguration

OPT_YAPSGUI
Steht dieser Wert auf “yes”, wird das Paket aktiviert. Das setzt natürlich voraus, dass die Variable OPT_YAPS auf “yes” steht und “yaps” somit installiert wird.

YAPSGUI_DEBUG
Der Standardwert für das Dropdown-Menü “Debuglevel”. Möglich sind Werte zwischen “0” und “4”. Standardmäßig ist “0” voreingestelt.

YAPSGUI_SENDER_TB_COMMON
Hier wird angegeben, wo das allgemeine Absender-Telefonbuch abgelegt werden soll, das für alle Benutzer gleichermaßen verfügbar ist. Das sollte nach Möglichkeit ein Ort sein, das einen Neustart des Routers überdauert, etwa eine Festplatte, ein USB-Stick oder eine CompactFlash-Karte, da die Einträge sonst nach dem Neustart wieder verschwunden sind! Standardmäßig ist /data/sndbook-common vorgegeben.

YAPSGUI_RECIPIENT_TB_COMMON
Hier wird angegeben, wo das allgemeine Empfänger-Telefonbuch abgelegt werden soll, das für alle Benutzer gleichermaßen verfügbar ist. Das sollte nach Möglichkeit ein Ort sein, das einen Neustart des Routers überdauert, etwa eine Festplatte, ein USB-Stick oder eine CompactFlash-Karte, da die Einträge sonst nach dem Neustart wieder verschwunden sind! Standardmäßig ist /data/rcvbook-common vorgegeben.

YAPSGUI_USER_N
Die Anzahl der Benutzer, die eigene Telefonbücher erhalten sollen. Alle anderen Benutzer verwenden automatisch das allgemeine Telefonbuch. Standardmäßig ist “0” vorgegeben, d.h. dass nur ein Telefonbuch existiert, das für alle Benutzer verwendet wird.

YAPSGUI_USER_x
Hier wird der Benutzername des x. Benutzers vermerkt, für den ein eigenes Telefonbuch geführt werden soll. Der Benutzername muss absolut identisch mit demjenigen aus der Konfiguration des Mini-HTTPDs sein (config/httpd.txt); insbesondere muss die Groß-/Kleinschreibung beachtet werden!

YAPSGUI_SENDER_TB_x
Hier wird angegeben, wo das Absender-Telefonbuch für den entsprechenden Benutzer abgelegt werden soll. Zur Auswahl des Speicherortes gilt das Gleiche wie für das allgemeine Absender-Telefonbuch (siehe hierzu die Beschreibung der Variable YAPSGUI_SENDER_TB_COMMON weiter oben). Standardmäßig ist /data/sndbook-userx vorgegeben, wobei das “x” durch die Nummer des Benutzers ersetzt wird.

YAPSGUI_SENDER_STD_x
Diese Variable regelt, welcher Absender-Eintrag beim Aufruf der Web-Oberfläche ausgewählt werden soll, wobei die Zählung bei Eins beginnt. Wird “0” angegeben (der voreingestellte Wert), wird anfangs gar kein Absender ausgewählt.

YAPSGUI_RECIPIENT_TB_x
Hier wird angegeben, wo das Empfänger-Telefonbuch für den entsprechenden Benutzer abgelegt werden soll. Zur Auswahl des Speicherortes gilt das Gleiche wie für das allgemeine Empfänger-Telefonbuch (siehe oben). Standardmäßig ist /data/rcvbook-userx vorgegeben, wobei das “x” durch die Nummer des Benutzers ersetzt wird.

YAPSGUI_RECIPIENT_STD_x
Diese Variable regelt, welcher Empfänger-Eintrag beim Aufruf der Web-Oberfläche ausgewählt werden soll, wobei die Zählung bei Eins beginnt. Wird “0” angegeben (der voreingestellte Wert), wird anfangs gar kein Empfänger ausgewählt.

2.1.5 Zugriffsrechte

Die Berechtigungsstufe für den httpd kann für das Senden und Ändern der Telefonbücher seperat vergeben werden. Bei HTTPD_RIGHTS_N muss dann “sms:send” bzw. “sms:edittb” angegeben werden. Ein Benutzer mit den Rechten “all” darf natürlich alles :)