Widget Builder – FAQ

Hier finden Sie die am häufigsten gestellten Fragen rund ums Thema Widgets und Widget Builder.

Widgets

Widgets sind Bausteine für die Gestaltung von Intranet-Seiten. Sie zeigen spezielle Inhalte auf beliebigen Seiten und in News im Intranet an. Widgets sind, nachdem sie von einem Redakteur auf einer Seite platziert wurden, für alle Leser sichtbar.

Mehr Infos zum Thema Widgets findet ihr hier.

Widget-Inhalte können statisch oder dynamisch sein und werden in grafischer Form präsentiert. Die Informationen werden zum Aufrufzeitpunkt aus der Staffbase-Plattform oder auch aus externen Quellen (z.B. andere IT-Systeme, APIs) geladen. Die angezeigten Informationen können abhängig vom Nutzerkontext unterschiedlich sein.

Ja – eurer Kreativität sind keine Grenzen gesetzt! Es können Widgets erstellt werden, welche statische Daten anzeigen. Für die Anzeige von Live-Daten benötigt ihr eine Programmierschnittstelle (API) und ggf. die erforderlichen Rechte darauf. Der Widget Builder ist darauf ausgelegt, jede API einzubinden und die zurückgelieferten Ergebnisse so darzustellen, wie ihr das konfiguriert.

In der Staffbase-Plattform gibt es für Redakteure von Haus aus bereitgestellte Widgets. Diese sind in der Staffbase Plattform gespeichert/gehostet.

Eigene Widgets (Custom Widgets) können nicht in der Staffbase-Plattform, sondern müssen selbst auf einem öffentlich verfügbaren Server gespeichert/gehostet werden. Der Widget Builder übernimmt diese Aufgabe für alle hier erstellten eigenen Widgets. Diese werden in Microsoft Azure gehostet.

Widget Builder

Der Widget Builder ist eine webbasierte Lösung für das Erstellen von Widgets und das anschließende Veröffentlichen der erstellten Widgets in eurem Staffbase Studio. Nach dem Veröffentlichen stehen die Widgets den Redakteuren zur Einbettung in Seiten oder News im gewohnten Widget-Dialog zur Verfügung.

Der Widget Builder ist eine externe Applikation, die nicht in eurer Staffbase-Plattform , sondern separat in Microsoft Azure gehostet wird. Der Zugriff erfolgt über den Browser.

Ein Administrator in eurer Staffbase-Plattform installiert den Widget Builder im Staffbase Studio (siehe dazu: Wie installiere ich als Administrator den Widget Builder in meiner Staffbase-Plattform?). Anschließend können neue Widgets im Widget Builder erstellt oder auch verändert werden. Jede Veränderung muss anschließend veröffentlicht werden. Die Widgets werden dann automatisch in eurer Staffbase-Plattform sichtbar.

Eine Schritt-für-Schritt-Anleitung dazu findet ihr hier.

Neu veröffentlichte oder veränderte Widgets sind innerhalb von wenigen Sekunden in Staffbase sichtbar bzw. aktualisiert.

Anleitungen

Für die initiale Installation sind administrative Rechte in der Staffbase-Plattform erforderlich. Anschließend haben Administratoren sowie von ihnen berechtigte Rollen und Gruppen Zugriff auf den Widget Builder. Innerhalb der Staffbase-Plattform sind die Widgets dann wie alle anderen Widgets nutzbar.

Für den Login im Widget Builder wird nach der erstmaligen Installation (siehe dazu: Wie installiere ich als Administrator den Widget Builder in meiner Staffbase-Plattform?) nur noch eure Staffbase URL, d.h die URL eurer Staffbase-Plattform benötigt. Ihr benötigt keinen separaten Account für den Widget Builder – alles läuft über euren Staffbase Account.

Voraussetzungen

  • Der aktuelle Staffbase Nutzer hat die Rolle Administrator
  • Das Feature-Flag „oauthclients_settings“ ist aktiviert. Dies ist zu daran zu erkennen, dass im Studio links in der Navigation ein Punkt „OAuth Konfigurationen“ sichtbar ist.

Es ist eine einmalige Registrierung des Widget Builders in eurer Staffbase-Plattform notwendig. Dabei wird eine dauerhafte Verbindung zwischen dem Widget Builder und Staffbase hergestellt.

 

Folgenden Schritte sind auszuführen:

  1. Meldet euch in eurer Staffbase-Plattform an.
  2. Besucht die Website des Widget Builders (den Link erhaltet ihr von eurem JASP Ansprechpartner) und klickt auf „Registrieren“.
  3. Verbindet euch mit eurer Staffbase-Plattform, indem ihr die Staffbase URL eurer Umgebung angebt und auf die Schaltfläche „Verbinden“ klickt.
  4. Ihr gelangt nun automatisch zum Studio eurer Staffbase-Plattform. Klickt dort im angezeigten vorausgefüllten Dialog „SPA“ auf die Schaltfläche „Erstellen und zurück“.
  5. In eurer Staffbase-Plattform wurde automatisch die OAuth Konfiguration für den Widget Builder angelegt. Ihr werdet nun auf die Weiterleitungs-Seite des Widget Builders umgeleitet.
  6. Kopiert die angezeigte URL in die Zwischenablage und klickt anschließend auf die Schaltfläche „Öffnen Sie die benutzerdefinierten Widget-Einstellungen von Staffbase„.
  7. Nun öffnet sich der Dialog „Custom Widgets“ aus dem Staffbase Studio im neuen Tab. Dort fügt ihr im Eingabefeld „Widget-Bundle“ die URL aus der Zwischenablage wieder ein und bestätigt dies mit Klick auf den Button „Installieren„.
  8. Der Registrierungsvorgang ist jetzt abgeschlossen. Alle Nutzer der eben registrierten Staffbase-Plattform können sich von nun an im Widget Builder anmelden und ihn nutzen.
YouTube

Mit dem Laden des Videos akzeptieren Sie die Datenschutzerklärung von YouTube.
Mehr erfahren

Video laden

PGRpdiBjbGFzcz0idmlkZW8tc2hvcnRjb2RlIj48aWZyYW1lIHRpdGxlPSJTaWduIHVwIHwgV2lkZ2V0IEJ1aWxkZXIgZm9yIFN0YWZmYmFzZSIgd2lkdGg9IjEyMDAiIGhlaWdodD0iNjc1IiBzcmM9Imh0dHBzOi8vd3d3LnlvdXR1YmUtbm9jb29raWUuY29tL2VtYmVkL0wySzJlZWxhN21jP2ZlYXR1cmU9b2VtYmVkIiBmcmFtZWJvcmRlcj0iMCIgYWxsb3c9ImFjY2VsZXJvbWV0ZXI7IGF1dG9wbGF5OyBjbGlwYm9hcmQtd3JpdGU7IGVuY3J5cHRlZC1tZWRpYTsgZ3lyb3Njb3BlOyBwaWN0dXJlLWluLXBpY3R1cmU7IHdlYi1zaGFyZSIgYWxsb3dmdWxsc2NyZWVuPjwvaWZyYW1lPjwvZGl2Pg==

Handlebars ist eine Vorlagen-Engine, die von Entwicklern verwendet wird, um dynamische HTML-Dateien zu erstellen. Eine Vorlagen-Engine ist ein Tool, das dabei hilft, HTML-Code zu generieren, indem es Platzhalter verwendet, die später mit Inhalten gefüllt werden können. Handlebars bietet eine einfache Syntax, die es Anwendern erleichtert, dynamische Inhalte in Widgets zu integrieren, ohne sich Gedanken darüber machen zu müssen, wie der HTML-Code generiert wird.

Mehr dazu unter: https://handlebarsjs.com/

Berechtigungen

Momentan gibt es noch keine Rechte-Begrenzung für das Verändern von Widgets im Widget Builder. Nach der Registrierung durch einen Administrator, können also auch Redakteure auf die Konfiguration der Widgets zugreifen.

Dieses Konzept wird sich in naher Zukunft ändern. Unser Ziel ist, dass Administratoren eine Liste von Nutzern und/oder Nutzergruppen aus Staffbase im Widget Builder berechtigen können. Dementsprechend können bald ausschließlich Administratoren und die von ihnen berechtigten Nutzer Widgets konfigurieren.

Dieses Konzept existiert in dieser Form (noch) nicht. Angelegte Widgets können prinzipiell von allen Redakteuren genutzt werden.

Nein, der Widget Builder hat keine Schreibrechte in eurer Staffbase-Plattform. Er kann somit weder Seiten anlegen noch existierende Inhalte verändern und stellt somit keinerlei Risiko bei der Nutzung in Produktivsystemen dar.

Datenschutz

Es werden keinerlei personenbezogenen Daten erhoben oder in irgendeiner Form gespeichert. Auch die in Staffbase gespeicherten personenbezogenen Daten werden nicht im Widget Builder gespeichert.

Jegliche Eingaben zur Konfiguration von Widgets werden in der Datenbank des Widget Builder gespeichert. Das beinhaltet alle Werte, die der Administrator bei der Konfiguration eines Widgets als Werte in ein Feld eingibt. Nach der Registrierung werden außerdem die Zugangsdaten für die Authentifizierung von APIs im Klartext in der Datenbank des Widget Builder gespeichert.