Häufig gestellte Fragen

Konzepte

Was ist ein headless CMS?

Ein headless CMS ist ein Content-Management-System, das den Ort, an dem Inhalte verwaltet werden, von dem Bildschirm trennt, auf dem die Inhalte angezeigt werden. „headless" bedeutet hier, dass kein fester Bildschirm (UI) angekoppelt ist.

Beim herkömmlichen Ansatz sind der Ort, an dem Inhalte verwaltet werden, und der Website-Bildschirm, auf dem sie angezeigt werden, zu einem Ganzen verbunden. Ein headless CMS trennt diese beiden. Inhalte werden an einem Ort verwaltet und über einen vereinbarten Weg ausgeliefert (eine API, eine Methode, bei der Daten nach festgelegten Regeln über eine Adresse ausgetauscht werden). So lässt sich derselbe Inhalt auf mehreren verschiedenen Bildschirmen wie einer Website oder einer mobilen App weiterverwenden.

WEEGLOO entspricht diesem headless CMS. Wenn Sie Inhalte im Content-Studio erstellen und veröffentlichen, holt sich eine Website oder App diese veröffentlichte Fassung und zeigt sie auf dem Bildschirm an. Die gesamte Funktionsweise von WEEGLOO wird unter Wie es funktioniert behandelt.

Auf welche Weise werden Inhalte bereitgestellt?

WEEGLOO stellt Inhalte über eine RESTful API auf JSON-Basis bereit (JSON ist ein zeichenbasiertes Datenformat für den Datenaustausch). Eine API ist ein Weg, über den nach festgelegten Regeln Daten über eine Adresse ausgetauscht werden.

Je nach Verwendung sind mehrere APIs aufgeteilt.

  • Die CDA (Content Delivery API), die veröffentlichte Inhalte ausliest: Sie wird verwendet, wenn eine Website oder App Inhalte holt und Besucherinnen und Besuchern anzeigt.
  • Die CMA (Content Management API), die Inhalte erstellt und verwaltet: Sie wird verwendet, wenn Sie Aufgaben wie das Verfassen, Bearbeiten und Veröffentlichen, die Sie im Content-Studio erledigen, per Code ausführen.

Da Lesen und Verwalten so getrennt sind, können Sie in verschiedenen Umgebungen genau den benötigten Weg auswählen und Inhalte nutzen. Welche API Sie in welcher Situation verwenden, wird in der API-Referenz behandelt.

Kann ich WEEGLOO auch in einer mobilen App verwenden?

Ja. Wie unter Was ist ein headless CMS? beschrieben, verwaltet WEEGLOO Inhalte getrennt von dem Bildschirm, auf dem die Inhalte angezeigt werden. So lässt sich derselbe Inhalt sowohl auf einer Website als auch in einer mobilen App weiterverwenden. Die Art, wie eine App veröffentlichte Inhalte abruft, ist dieselbe wie im Web.

Wenn Sie die Mitglieder-Anmeldung in eine mobile App (Android, iOS) einbinden, gibt es einen Unterschied. Die Verbindung, über die das Ergebnis nach der Anmeldung an die App zurückgegeben wird, unterscheidet sich vom Web, sodass ein eigener technischer Schritt nötig ist. Dieser Schritt wird unter Auth API behandelt.

Ein fertiges Beispiel, in dem eine mobile App mit WEEGLOO verbunden wird, sehen Sie von Anfang bis Ende unter Lauf-Tracker-Dienst.

Content-Verwaltung

Wie kann ich Inhalte in mehreren Sprachen ausspielen?

Um Content oder Media in mehreren Sprachen bereitzustellen, fügen Sie zunächst dem Space eine Sprache (Locale) hinzu.

  1. Wechseln Sie im linken Menü in den Verwaltungsbildschirm Locale der Space-Einstellungen.
  2. Drücken Sie oben rechts die Schaltfläche + Hinzufügen und wählen Sie in der Auswahlliste die gewünschte Sprache.
  3. (Optional) Legen Sie das Fallback Locale fest. Das ist die Sprache, die stattdessen angezeigt wird, wenn der Wert dieser Sprache leer ist.
  4. Drücken Sie Speichern.

Nachdem Sie das Locale hinzugefügt haben, müssen Sie bei jedem Field, das je Sprache einen eigenen Wert aufnehmen soll, die Mehrsprachigkeit einschalten. Öffnen Sie im Bearbeitungsbildschirm des Content Type die Field konfigurieren des betreffenden Field und prüfen Sie im Tab Einstellungen, ob Lokalisierung für dieses Field aktivieren eingeschaltet ist.

Ausführliche Informationen werden unter Mehrsprachigkeit verwalten behandelt.

Wie führe ich eine Gültigkeitsprüfung von Content durch?

Die Gültigkeitsprüfung ist eine Funktion, mit der Sie an ein Field Bedingungen für „die Werte, die in dieses Feld kommen dürfen" knüpfen. Werte, die die Bedingung nicht erfüllen, werden nicht gespeichert, sodass verhindert wird, dass sich fehlerhafter Content ansammelt.

Welche Bedingungen sich knüpfen lassen, ist je nach Field-Art unterschiedlich. Bei einem Field, das Media verknüpft, gibt es zum Beispiel Bedingungen, die die hochladbaren Dateiarten oder die Datei- und Bildgröße beschränken, und bei einem Zahlen-Field Bedingungen, die den Wertebereich festlegen.

Um an ein Field eine Gültigkeitsprüfung anzuhängen, gehen Sie folgende Schritte durch.

  1. Gehen Sie zum Bearbeitungsbildschirm des Content Type und drücken Sie das Field, an das Sie eine Bedingung knüpfen wollen.
  2. Wechseln Sie in der Field konfigurieren zum Tab Validations.
  3. Es erscheinen die für diese Field-Art möglichen Bedingungen. Wählen Sie die benötigte Bedingung und richten Sie sie ein.

Ausführliche Informationen werden unter Gültigkeitsprüfung behandelt.

Wie lege ich den Titel von Content fest?

Der Content-Titel ist der Name, an dem Sie die einzelnen Einträge in der Content-Liste erkennen. Jedes Field vom Typ ShortText lässt sich als Titel verwenden.

Öffnen Sie im Bearbeitungsbildschirm des Content Type das Field, das Sie als Titel verwenden wollen, und legen Sie fest, dass dieses Field als Titel verwendet wird. Den Titel kann je Content Type nur ein einziges Field tragen. Ist also bereits ein anderes Field als Titel festgelegt, heben Sie dieses zuerst auf und legen das neue dann fest.

Den Ablauf, wie Sie ein Field beim ersten Anlegen als Titel festlegen, behandelt Content-Modellierung.

Organization- und Space-Verwaltung

Wie kann ich Benutzer einladen?

Damit Sie einen Benutzer in einen Space holen können, muss dieser Benutzer zuerst zu einer Organization gehören. Deshalb beginnt die Zusammenarbeit mit der Einladung in eine Organization.

Benutzer in eine Organization einzuladen, können Benutzer mit der Rolle Owner oder Admin.

  1. Wechseln Sie zum Einstellungsbildschirm der Organization.
  2. Drücken Sie im linken Menü Membership.
  3. Drücken Sie oben rechts die Schaltfläche Einladen und senden Sie die Einladung, indem Sie Angaben wie die E-Mail-Adresse und die zu vergebende Rolle eingeben.

Die eingeladene Person wird sofort Mitglied. Es gibt keinen gesonderten Schritt zum „Annehmen", und an die eingeladene E-Mail-Adresse wird eine Hinweis-E-Mail gesendet.

Ausführliche Informationen zu Einladung und Rollen werden unter Organization und Space behandelt.

API

Ist der Wert von sys.id eindeutig?

Ja. sys.id wird dienstweit eindeutig erzeugt. Deshalb überschneidet sich der Wert auch nicht mit Ressourcen, die zu einer anderen Organization oder einem anderen Space gehören.

Welche Informationen in sys enthalten sind, wird unter Systemeigenschaften (sys) behandelt.

Wie frage ich die referenzierten Ressourcen eines Content ab?

Mit dem Parameter include können Sie in einer einzigen Anfrage einen Content zusammen mit den referenzierten Ressourcen abrufen, auf die er verweist.

GET /v1/spaces/{spaceId}/contents?include=1

Die obige Anfrage ruft die Content-Liste ab und holt dabei die verknüpften Referenzdaten bis zu einer Tiefe von einer Ebene mit. Wenn Sie den Wert auf 2 oder 3 erhöhen, werden tiefere Ebenen aufgelöst und mitgeholt.

include lässt sich nicht nur bei Content, sondern beim Abfragen aller Ressourcen auf dieselbe Weise verwenden. Ausführliche Informationen werden unter Gemeinsame Abfrageparameter behandelt.

Wird eine OR-Verknüpfung in den Suchbedingungen unterstützt?

Die REST API unterstützt nicht direkt, mehrere Bedingungen mit OR zu verknüpfen (holen, wenn auch nur eine von zweien zutrifft). Wenn Sie mehrere Bedingungen gemeinsam in einer Anfrage angeben, kommen nur Ergebnisse, die alle erfüllen (AND). Wenn Sie OR benötigen, senden Sie für jede Bedingung eine eigene Anfrage und führen die erhaltenen Ergebnisse zusammen.

Wie Sie eine Liste über Bedingungen eingrenzen, wird unter Gemeinsame Abfrageparameter behandelt.

Zahlung und Tarife

Kann ich den Tarif ändern?

Sie können den Tarif jederzeit anheben (Upgrade) oder senken (Downgrade). Bei einem Upgrade wird für den verbleibenden Abrechnungszeitraum anteilig abgerechnet, ein Downgrade gilt ab dem nächsten Abrechnungszeitraum.

Die Limits und Preise je Tarif werden unter Tarife behandelt.

Wie wird der API-Verbrauch berechnet?

Viele Content-Plattformen berechnen den Verbrauch anhand der Anzahl der API-Aufrufe (Anzahl der Anfragen). WEEGLOO berechnet den Verbrauch nicht anhand der Anzahl der Aufrufe, sondern anhand der tatsächlich ausgetauschten Datenmenge (Datenübertragungsvolumen). Bei gleich vielen Anfragen wird also mehr Verbrauch erfasst, wenn die ausgetauschten Daten größer sind.

Die Tarife Free, Basic und Pro schließen ein festgelegtes monatliches Datenübertragungsvolumen in die monatliche Gebühr ein. In der Tariftabelle wird dieses Übertragungsvolumen zusätzlich als umgerechnete Anzahl der Aufrufe angegeben, damit Sie es abschätzen können. Auch Vorgänge, bei denen eine einzelne Suche als mehrere Aufrufe berechnet wird, wie etwa Advanced Search, werden aus diesem Übertragungsvolumen bestritten.

Wenn Sie mehr Verbrauch als das festgelegte Übertragungsvolumen benötigen, können Sie den Tarif Enterprise nutzen, bei dem nach tatsächlichem Verbrauch abgerechnet wird. Die Datenübertragungslimits je Tarif werden unter Tarife behandelt.