Installation der Erweiterungen auf GS 3.2 - marneu/GS3 GitHub Wiki

Spezielle Erweiterungen gegenüber der GS3 3.2

Neue Features

  • Anbindung eines/mehrerer Cloud vCard Adressbücher
  • automatische Synchronisation der Cloud Adressbücher (gleicher Stand auf Smartphone und GS Telefonbuch)
  • Cloud Adressbücher können public zur Verfügung gestellt werden
  • eigene Einträge bleiben innerhalb GS (ähnlich speichern auf SIM beim Handy)
  • Auswahl im persönlichen Telefonbuch erweitert um Kategorien/Gruppen (analog zur Cloud Zuordnung)
  • Anzeige mehrerer Rufnummern der gleichen Person in Reihenfolge der Cloud gesetzten Präferenz
  • Weitere Zuordnung einer Telefonnummer (home/cell/work)
  • XML Ausgabe für IPPhoneDirectory (neuere Telefone) (Beispiel Snom)

Bei der Entwicklung wurde die vCard Anbindung mit ownCloud realisiert und getestet.

Die Erweiterungen sind im Vorgriff auf eine mögliche GS 3.3 zu sehen und werden im Tree GS3 3.2 implementiert. In der derzeitigen 3.2 laufen sie erst wenn die Datenbank erweitert wird. Wer es ausprobieren möchte kann mit dem SQL Script https://github.com/marneu/GS3/blob/3.2/misc/scripts/upgrade-pb-3.2-3.3.sql seine Datenbank auf den erforderlichen Stand bringen. Das Skript kann ausgeführt werden bevor die Änderungen im Übrigen implementiert werden. Vorher wird dringend zu einer vollständigen Sicherung geraten.

Neue/geänderte Funktionen im GS3 Menü

Auf der GS3 Webseite hat der Benutzer folgende neue Möglichkeiten.

Startseite

In der Übersicht wird der Synchronisation Status für die Cloud Telefonbücher angezeigt.

Telefonbuch (Persönlich)

Wenn ein Cloud Telefonbuch geladen ist und dort Gruppenzuordnungen erfolgt sind, dann kann bei der Suche die Kategorie ausgewählt werden um nur die Nummern dieser Gruppe anzuzeigen (kürzere Listen). Alle Kategorien zeigt die ursprüngliche Liste an. Gleiche Namen werden unterdrückt für eine bessere Übersicht. Lokation zeigt, zu welchem Ziel die Rufnummer führt (cell/work/home etc.). Ob ein Telefonbuch Eintrag aus GS3 oder aus der Cloud stammt ist am Ende des Eintrages erkennbar. Einträge, welche der Cloud entstammen, sollten auch in der Cloud geändert werden, da die Cloud lokale Änderungen überschreiben könnte (The cloud always wins). Das gilt nicht für Einträge, die nicht aus einer Cloud Anbindung entstammen.

Cloud Import (Neuer Menüpunkt unter Telefonbuch)

Hier werden die URL/WEB Adresse, der Benutzername und das Kennwort der vCard Server angegeben. Der Refresh Zyklus kann geändert werden, per default wird ein Tag (1d) voreingestellt. Die erste Synchronisation beginnt innerhalb 30 Minuten wenn der cron Job (s.o.) installiert worden ist. Die Auswahl von public läßt das Adressbuch für alle sichtbar werden, Änderungen können dann ausschließlich in der Cloud ausgeführt werden und werden durch den Sync wieder ins Adressbuch importiert.

Wer sein Telefonbuch aus der Cloud auch/bereits auf dem Smartphone synchronisiert hat anschließend die Einträge auf dem persönlichen GS3 Telefonbuch identisch. Es werden nur vCards importiert, die mindestens eine Rufnummer haben.

XML Aufruf für VoIP Endgeräte

Am Beispiel des Snom D765 kann auf dessen Konfigurations Web Seite unter http(s)://<snomip>/fkey.htm die Action URL eingestellt werden um Telefonbücher anzuzeigen.

Beispiele:

  • P11: http://<gemeinschaft>/gemeinschaft/prov/snom/private-phonebook-xml.php?user=<username> Es wird das vollständige Telefonbuch angezeigt.
  • P12: http://<gemeinschaft>/gemeinschaft/prov/snom/private-phonebook-xml.php?user=<username>&cat=Familie Es wird das Telefonbuch angezeigt mit Einträgen die der Gruppe Familie zugeordnet worden sind.

Unter Taste '*' wird bei Gruppenanzeigen immer das komplette Telefonbuch geladen.

Voraussetzungen zum Betrieb

Wer nicht auf die 3.3 warten will muss selbst Hand anlegen, die folgende Beschreibung sollte dabei helfen.

Unter /opt/gemeinschaft/... werden zusätzliche Skripte installiert oder geändert (relevant ist der Pfad hinter https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/...)

Änderung Skripte

Die folgenden Skripte werden überschrieben, zuvor wird eine Sicherung empfohlen:

  1. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/gui/inc/modules.php
  2. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/gui/mod/home_home.php
  3. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/gui/mod/pb_private.php
  4. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/gui/styles/original.css
  5. Datei https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/dialplan-scripts/in-get-callername.agi

Neue Skripte

Die folgenden Skripte werden neu benötigt, ggf. muss der ganze Ordner geholt werden:

  1. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/sbin/gs-carddav-reader-to-db
  2. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/gui/mod/pb_category.php
  3. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/gui/mod/pb_cloud.php
  4. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/prov/private-phonebook-xml.inc
  5. Datei: https://github.com/marneu/GS3/blob/3.2/opt/gemeinschaft/htdocs/prov/snom/private-phonebook-xml.php
  6. Ordner: https://github.com/marneu/GS3/tree/3.2/opt/gemeinschaft/lib/carddav
  7. Ordner: https://github.com/marneu/GS3/tree/3.2/opt/gemeinschaft/lib/xml

Feedback und Issues

Bis zu einem eventuellen Erscheinen der offiziellen GS 3.3 bitte hier ausschließlich Probleme mit den neuen Funktionen melden. Eingeschränkt wird hier ausdrücklich auf die neuen Funktionen, andere Bestandteile von GS3 sind auf der https://github.com/ammoma/GS3 Seite richtig aufgehoben.

Issues: https://github.com/marneu/GS3/issues

⚠️ **GitHub.com Fallback** ⚠️