Erste Schritte mit der Scrivito Portal App

Erste Schritte mit der Scrivito Portal App

Wenn Sie den Web Interface Builder ausprobieren oder Ihre eigene Interface-Builder-basierte Website erstellen möchten, haben wir eine mit viel Funktionalität ausgestattete Beispielanwendung für Sie, die Scrivito Portal App, eine leichtgewichtige Business-Website mit Datenintegration für Kundenportale.

Um sich ein Bild davon zu machen, wie durchdacht der Interface Builder ist, brauchen Sie die App nicht zu installieren. Registrieren Sie sich einfach bei JustRelate über console.justrelate.com. Ihr Account und Ihre Interface-Builder-Test-Instanz werden dann automatisch angelegt. Klicken Sie anschließend in der Console auf “Edit with Scrivito”, um Ihre Instanz mit den Portal-Beispielinhalten ausstatten zu lassen und Ihre neue Website auszuprobieren.

Inhalte direkt bearbeiten

Sämtliche Website-Inhalte können in Arbeitskopien erstellt und bearbeitet werden. Mit Hilfe der Leiste auf der rechten Seite können Sie Arbeitskopien anlegen und veröffentlichen oder die Liste der Änderungen öffnen, um zu sehen, was bis jetzt geändert wurde. Erfahren Sie mehr über Arbeitskopien und die veröffentlichten Inhalte.

Das Web-Interface des Interface Builders zur Bearbeitung von Inhalten ist leicht zu bedienen: Wandern Sie mit dem Mauszeiger über die Seite, um die Widget-Rahmen sichtbar zu machen. Klicken Sie auf eines der Plus-Zeichen auf einem Rahmen, um ein Widget hinzuzufügen, oder verwenden Sie den kleinen „Griff“ rechts oben, um das Widget-Menü zu öffnen oder das Widget an eine andere Stelle auf der Seite zu ziehen. In der Anleitung für Redakteure finden Sie viele weitere nützliche Tipps.

Die Portal App lokal installieren

Als Entwickler können Sie die Portal App lokal installieren, um sie als Grundlage für Ihre neue Website zu verwenden! Wenn Sie zunächst die Konzepte hinter einer App, die auf dem Interface Builder basiert, kennenlernen möchten, siehe Wie funktioniert eine Interface-Builder-Anwendung? als Einführung.

Nachdem Sie sich wie oben beschrieben über console.justrelate.com bei JustRelate registriert haben, gehen Sie bitte folgendermaßen vor:

1Die App klonen und vorbereiten

Die Details zum Klonen und Vorbereiten der App finden Sie in dem entsprechenden ReadMe auf GitHub: https://github.com/Scrivito/scrivito-portal-app

In einem der Schritte zur Vorbereitung der App werden Sie gebeten, die ID Ihrer Interface-Builder-Instanz in eine Konfigurationsdatei einzutragen. Wenn Sie in der Console angemeldet sind und Ihren Account ausgewählt haben, kopieren Sie die rechts unten angegebene „Default instance ID“ in die Zwischenablage und fügen Sie sie dann in die Konfigurationsdatei ein.

2Die CORS-Quellen angeben

Damit Ressourcen zwischen Ihrem Interface Builder und Ihrer Web-Anwendung geteilt werden können, geben Sie die URL(s) Ihrer App im Reiter „Trusted origins“ der Console an. Klicken Sie auf „Add origin”, um einen weiteren CORS-Origin oder eine weitere URL einzutragen, unter der auf Ihre App zugegriffen wird.

Fertig! Und jetzt?

Wenn alles nach Plan verlaufen ist, können Sie nun Ihre Interface-Builder-Anwendung nutzen und Ihren Wünschen entsprechend anpassen! Um Inhalte mit der Benutzeroberfläche zu erstellen oder zu bearbeiten, öffnen Sie einfach edit.scrivito.com in Ihrem Browser und geben Sie die URL Ihrer App an, also http://localhost:8080.

Änderungen im „src“-Unterverzeichnis bewirken, dass die App mit der aktuellen Seite sofort neu geladen wird.

Fehler in der App, verursacht beispielsweise durch nicht richtig funktionierende React-Komponenten, werden in der Browser-Konsole ausgegeben, nicht im Terminal-Fenster. In letzterem werden lediglich Fehler beim Kompilieren, Probleme mit verwendeten Bibliotheken etc. protokolliert.

Beachten Sie bitte, dass das Layout, Design und Bildmaterial der Portal App gelegentlich aktualisiert werden, um aktuellen Trends, neuen Einsatzgebieten usw. Rechnung zu tragen.