Link Search Menu Expand Document
Object by Object Dokumentation

CMS Einrichtung

Einrichten eines Contentful Accounts und eines Contentful Space

Einrichtung eines Accounts und eines Workspace (Space), falls noch nicht vorhanden, wird hier erklärt.

WICHTIG: Die Default Locale des Space muss auf de-DE gestellt werden unter Settings > Locales

API-Key

Der API-Key ist notwendig für den späteren Zugriff der mobilen Apps auf die reguläre und auf die Vorschau-Schnittstelle des CMS.

  • Die Spiel-App verwendet die reguläre Schnittstelle (Content Delivery API).
  • Die Portal Editor Companion App verwendet die Vorschau-Schnittstelle (Content Preview API).

Der API-Key besteht aus der Space ID und jeweils einem Access-Token für die Content Delivery API und die Content Preview API.

Erzeugen des API-Key

Falls im Contentful Space unter Settings > API keys > “Content delivery/preview tokens” noch kein Token existiert, oben rechts “Add API key” klicken.

Gespeicherten API-Key abrufen

Der API-Key-Eintrag befindet sich im Contentful Space unter Settings > API keys > Content delivery/preview tokens.

  • Für die Spiel-App: Space ID und Content Delivery API access token kopieren
  • Für Portal Editor: Space ID und Content Preview API access token kopieren

Importieren des Datenbank-Schemas

Das Datenbankschema der Content-Modelle kann als JSON-Datei importiert werden. Der Import erfolgt mit der Contentful CLI (Dokumentation).

Die Resourcen zum Datenbankschema befinden sich im Repository 03 Contentful CMS Resources.

Nach Installation der Content CLI und Download der Resourcen folgen die nächsten Schritte in der Command Line.

Wechsel in den Resourcen-Ordner:

cd path/to/resources

Login:

contentful login

Ein Browserfenster wird geöffnet, Access Token vom Browser in die Commandline kopieren.

Anzeigen der Space ID:

contentful space list

Die angezeigte Space ID hier eintragen:

contentful space use <Space ID>

(Auswahl mit Enter bestätigen)

Nun werden zunächst die benötigten Extensions erstellt:

contentful extension create --id 3P46UsGOZLvTS1I6f736cI --name "ENUM Link Object Type" --field-types Symbol --srcdoc extensions/extension_ENUM_Link_Object_Type.html
contentful extension create --id 1MVkPIZAlZmpisc8ia0G9v --name "ENUM Story Color" --field-types Symbol --srcdoc extensions/extension_ENUM_Story_Color.html
contentful extension create --id dpD5Hy3r5HPextp7tOn4J --name "Bool (false)" --field-types Boolean --srcdoc extensions/extension_Bool_false.html
contentful extension create --id 7BPZSATAe4N8M9PhluqAjw --name "ENUM Container Type" --field-types Symbol --srcdoc extensions/extension_ENUM_Container_Type.html
contentful extension create --id 34bFqaY9FkZDm9KmyGr0XK --name "ENUM Anchor Alignment" --field-types Symbol --srcdoc extensions/extension_ENUM_Anchor_Alignment.html
contentful extension create --id 3IYBwhYMMsWS0LYZ8FWFyR --name "ENUM Fragmentation" --field-types Integer --srcdoc extensions/extension_ENUM_Fragmentation.html

Schließlich kann das Datenbankschema importiert werden:

contentful space import --content-file database_scheme.json

Nach Ausloggen aus Contentful im Browser und Wiedereinloggen steht das Datenbankschema zur Verfügung.