- \n
- Die unbegrenzte Anzahl von Frontends. Die Inhalte k\u00f6nnen also nicht nur auf einer Webseite, sondern etwa auch in einer App ver\u00f6ffentlich werden.<\/li>\n
- Das Frontend kann flexibler gestaltet werden, da man frei von jeglichen Frameworks oder Systemen entwickeln kann.<\/li>\n
- Microservices sind performanter als monolithische Systeme, somit kann ein Headless CMS schneller sein als viele klassische CMS.<\/li>\n<\/ul>\n
Was ist strapi?<\/h1>\n
Strapi<\/a> ist ein 2016 in Frankreich gegr\u00fcndetes Unternehmen, welches das gleichnamige Open Source Headless CMS anbietet. Die Software von Strapi richtet sich in erster Linie an Frontend Entwickler, denen durch das System das Entwickeln eines Backends extrem erleichtert werden soll. Strapi kann dazu verwendet werden, sowohl Inhalte als auch Strukturen f\u00fcr Inhalte zu schaffen. Auch verf\u00fcgt es \u00fcber einen Medien Manager, welcher zur Verwaltung von Bildern und Daten dient, als auch \u00fcber ein Rechte System. In seiner Grundversion ist Strapi kostenlos. F\u00fcr Erweiterungen und Support k\u00f6nnen spezielle Pakete<\/a> erworben werden. Als Umgebung dient Strapi node.js. Kompatibel ist es mit verschiednen Datenbank Systemen wie etwa MySQL<\/a>, SQLite<\/a> oder MariaDB<\/a>. Strapi liefert jedoch auch schon fertige Docker Container<\/a>, mit denen die Software in wenigen Schritten gestartet werden kann. Auf die Daten des Systems kann \u00fcber eine Rest API<\/a> zugegriffen werden. Auch ist die Erweiterung mithilfe von Plugins m\u00f6glich.<\/p>\n
Das Konzept<\/h2>\n
Der Content-Types Builder<\/strong> ist eine der wichtigsten Funktionen in Strapi. Damit lassen sich die Datenstrukturen, also die Content-Typen, anlegen. Diese k\u00f6nnen dann mit Inhalten bef\u00fcllt werden. Der Content-Types Builder richtet sich somit an den Entwickler der das CMS einrichtet und die Struktur f\u00fcr die Inhalte festlegt. Grunds\u00e4tzlich wird zwischen zwei Content-Types unterschieden: Collection-Types und Single-Types. Collection-Types sind Inhalte von denen es sp\u00e4ter viel Instanzen geben wird, etwa Artikel auf einem Blog oder Produkte in einem Shop. Single-Types sind f\u00fcr Strukturen die nur einmal instanziiert werden, etwa die Inhalte einer Startseite. Die Typen lassen sich aus vielen weitern Datentypen zusammenbauen wie Texten, Medien und strukturierten JSON<\/a> Daten. Auch lassen sich Beziehungen zwischen den Datentypen herstellen. In der Abbildung sind die Felder aus denen sich die Datentypen zusammensetzen lassen zu sehen:<\/p>\n
![\"Strapi](\"https:\/\/informatik.htwk-leipzig.de\/seminar\/wp-content\/uploads\/2021\/01\/conetent-typen.png\")
<\/p>\nCollection-Types<\/strong> und Single-Types<\/strong> k\u00f6nnen nach ihrem Anlegen mit Inhalten bef\u00fcllt werden. Das Rechte System von Strapi erlaubt hierbei zu unterscheiden, ob ein Nutzer die Datentypen anlegen und editieren kann oder ob er nur Instanzen davon erzeugen und diese bearbeiten kann. Nutzer die nur Inhalte bearbeiten k\u00f6nnen sind Editoren. Super Admins hingegen k\u00f6nnen auch die Datentypen ver\u00e4ndern und Autoren haben nur Zugriff auf ihre eigenen Inhalte. Bei dem Bef\u00fcllen der Datentypen mit Inhalten ist die Media Library<\/strong> ein n\u00fctzliches Tool wor\u00fcber sich Bilder hochladen und einbinden lassen.<\/p>\n
M\u00f6chte man von au\u00dfen, etwa von einem Frontend, auf die \u00fcber Strapi ver\u00f6ffentlichten Inhalte zugreifen, so geschieht dies \u00fcber API-Endpoints<\/strong>. Strapi legt f\u00fcr jeden Typ eine Adresse an, die dem Namen des Types entspricht. \u00dcber diese Adresse k\u00f6nnen dann alle Inhalte von diesem Typ abgerufen, bearbeitet, gel\u00f6scht oder neu angelegt werden. Damit der Endpoint jedoch von au\u00dfen ansprechbar ist, muss dieser erst f\u00fcr die REST-API freigeben werden.<\/p>\n
Strapi liefert bereits eine Benutzerverwaltung f\u00fcr das Backend mit, auch ein Authentifizierungssystem<\/strong> f\u00fcr ein m\u00f6gliches Frontend ist implementiert und die API-Endpoints k\u00f6nnen f\u00fcr verschiedne Nutzer freigeben werden. M\u00f6chte man Strapi erweitern, so k\u00f6nnen daf\u00fcr Plugins geschrieben werden oder bereits Existierende \u00fcber den Marketplace<\/strong> geladen werden.<\/p>\n
Tutorial<\/h1>\n
Strapi Installieren (Docker)<\/h2>\n
Strapi l\u00e4sst sich mit Hilfe von yarn oder npm schnell und einfach installieren. Da der Prozess jedoch mit Docker<\/a> einfacher ist und nichts am eigenen System \u00e4ndert, wird hier kurz dieser Weg vorgestellt.
\ndocker run -it -p 1337:1337 -v `pwd`\/<PROJEKT ORDNER>:\/srv\/app strapi\/strapi --rm<\/code>
\nDamit startet sich ein Docker Container in dem Strapi l\u00e4uft und die Daten in ihrer SQLite Datenbank speichert. Die Inhalte von Strapi werden dann in dem angebenden Projektordner abgelegt. Sobald der Server l\u00e4uft kann Strapi \u00fcber folgende Adresse aufgerufen werden:
\nhttp:\/\/localhost:1337<\/code>
\nMan wird dann durch die Ersten Schritte zum Anlegen eines Admins geleitet.<\/p>\nEinen Content-Type<\/strong>\u00a0anlegen<\/h2>\n
Hat man Strapi erfolgreich installiert und einen Administrator eingerichtet kann man \u00fcber den Content-Types Builder Datentypen anlegen. Daf\u00fcr ruft man den Content-Types Builder in der linken Seite auf, hier kann man sich dann entscheiden welche Art von Content-Type man anlegen m\u00f6chte. Collection-Types bieten sich f\u00fcr alles an, was mehrfach vorkommt und Single-Types nur f\u00fcr einmalige Datentypen.<\/p>\n
Legt man einen neuen Typ an, wird man zun\u00e4chst nach dem Namen gefragt, welcher auch die Adresse \u00fcber die der Typ abrufbar ist bestimmt. Hat man sich f\u00fcr einen Namen entschieden kann man den Typen um die verschiednen Eigenschaften erweitern die er besitzen soll. Hat man den Typ erfolgreich angelegt, taucht er in der linken Spalte auf und kann dort ausgew\u00e4hlt werden, um ihn mit Inhalten zu bef\u00fcllen. Der Super Admin ist in der Lage den Datentyp sp\u00e4ter noch mal anzupassen und auch seine Bearbeitungsoberfl\u00e4che zu ver\u00e4ndern.<\/p>\n
M\u00f6chte man einen Typ von au\u00dfen f\u00fcr die \u00d6ffentlichkeit zug\u00e4nglich machen, so muss man diesen in den Einstellungen freigeben. In den Einstellungen findet sich unter „Users & Permissions Plugin“ der Punkt „Rollen“. Hier muss „Public“ ausgew\u00e4hlt werden. Unter diesem Punkt lassen sich alle Typen f\u00fcr „Public“ freigeben und auch bestimmen, welche Operationen „Public“ nutzen darf. Die Abbildung zeigt, wie f\u00fcr den Content-Type „Gallery“ eine Freigabe f\u00fcr die Gruppe „Public“ erteilt wurde. Diese bestimmt, dass die Gallery-Eintr\u00e4ge von au\u00dfen aufrufbar sind.<\/p>\n
![\"Strapi](\"https:\/\/informatik.htwk-leipzig.de\/seminar\/wp-content\/uploads\/2021\/01\/Screenshot_2021-01-11_Einstellungen.png\")
<\/p>\nDie API nutzen<\/h2>\n
Ist ein Type f\u00fcr „Public“ angelegt und freigeben kann er \u00fcber die REST API aufgerufen werden. Dabei gibt Strapi die Inhalte des Typen als JSON zur\u00fcck. Das JSON kann dann beim Client verarbeitet und dargestellt werden. F\u00fcr einen Collection-Type sind die Aufrufe wie folgt:<\/p>\n