1. Startseite
  2. Bright Arboretum
  3. Arboretum installieren und konfigurieren

Bright Arboretum installieren und konfigurieren

Diese Anleitung enthält eine detaillierte Schritt-für-Schritt-Anleitung zur Einrichtung der Arboretum Sitemap App in Contentful. Da Arboretum vollständig auf deinen bestehenden Contentful-Daten basiert, ist deine Inhaltsstruktur entscheidend und erfordert möglicherweise kleinere Anpassungen während des Einrichtungsprozesses.

Installation der Arboretum Sitemap App

Um die Arboretum Sitemap App zu installieren, besuche den Contentful Marketplace. Während der Installation wirst du aufgefordert, den entsprechenden Space und die Umgebung als Zielort für Arboretum auszuwählen.

Sobald die App zu deinem Space hinzugefügt wurde, musst du einen Lizenzschlüssel angeben, den du kostenlos auf der Arboretum-Lizenzgenerator-Seite erhalten kannst. Nach dem Absenden des Formulars wird der Schlüssel an deine E-Mail-Adresse gesendet. Beachte, dass der Lizenzschlüssel für jeden Space und jede Umgebung spezifisch ist. Wenn du Arboretum in einer anderen Umgebung benötigst, musst du einen neuen Schlüssel generieren.

Nach der Überprüfung des Lizenzschlüssels gelangst du zum Einrichtungsbildschirm, wo du die App an deine Contentful-Umgebung anpassen kannst.

Arboretum kann sowohl in regulären als auch in Alias-Umgebungen ausgeführt werden, jedoch nicht gleichzeitig. Wenn du eine Lizenz für deine Master- (Alias-)Umgebung konfigurierst, funktioniert Arboretum nicht in der Zielumgebung für diesen Alias (und umgekehrt).

Installationsmodi

Arboretum bietet drei Installationsmodi. Diese Optionen sind darauf ausgelegt, Flexibilität zu gewährleisten, unabhängig davon, ob du ganz von vorne beginnst oder mit einer bestehenden Content-Konfiguration arbeitest.

Neben der Vorschau enthält jeder Sitemap-Knoten einen Link zum Bearbeiten des entsprechenden Eintrags. Wenn du Compose verwendest und möchtest, dass Arboretum Compose als deinen Eintragseditor öffnet, aktiviere bitte den Schalter „Compose verwenden“. Vergiss nach dem Vornehmen von Änderungen nicht, auf die Schaltfläche „Speichern“ in der oberen rechten Ecke zu klicken, um die Konfiguration zu speichern.

Startseite auswählen

Nachdem du die Arboretum-Konfiguration abgeschlossen hast, gibt es noch einen letzten Schritt: die Auswahl des Stamms (oder der Startseite) deiner Sitemap. Dazu fügst du einem deiner Seiteneinträge ein öffentliches Tag mit dem Namen „“ (oder ein anders benanntes Tag mit der Tag-ID ) hinzu. Dieses Tag zeigt Arboretum an, wo mit dem Aufbau der Sitemap-Struktur begonnen werden soll. Stelle sicher, dass nur einem Seiteneintrag dieses Tag zugewiesen ist.

Konfiguration der Sidebar-Erweiterung

Die Arboretum-Sidebar-Erweiterung ist besonders nützlich, wenn du deine Seiteneinträge in Contentful bearbeitest. Für einen ausgewählten Modus und eine Locale deiner Wahl erstellt sie einen Vorschau-Link, über den du schnell sehen kannst, wie die bearbeitete Seite aussieht. Um diese Erweiterung zu konfigurieren, gehe zum Seiten-Content-Typ, wähle „Sidebar“ aus und füge die Arboretum-App hinzu. Wenn du danach einen Eintrag dieses Typs bearbeitest, erscheint die Arboretum-Sidebar-App, über die du eine Vorschau öffnen kannst (vorausgesetzt, der Eintrag ist in der Sitemap vorhanden).

Auf der Suche nach Unterstützung mit Arboretum oder Contentful

Meldet euch bei uns, dann schauen wir gemeinsam, wie wir das Problem lösen können. Wir kennen Arboretum und Contentful in- und auswendig.

Termin buchen

Manuelle Installation:

Empfohlen für Produktionsumgebungen mit bereits vorhandenen Inhalten. Der manuelle Installationsmodus ermöglicht dir die vollständige Kontrolle über den Einrichtungsprozess. In diesem Modus greift Arboretum nicht auf dein Inhaltsmodell in Contentful zu. Du bist dafür verantwortlich, es (falls nötig) anzupassen und Arboretum zu konfigurieren. Wenn du diesen Installationstyp wählst, wirst du später im Prozess aufgefordert, mindestens ein Inhaltsmodell auszuwählen, das Seiten repräsentiert, damit die Sitemap darauf basierend generiert werden kann. Du musst angeben, welche Felder aus dem Inhaltsmodell für den Slug, den Seitentitel und die Struktur (entweder Unterseiten oder übergeordnete Seite) verwendet werden sollen.

Am besten geeignet für: Produktionsumgebungen, Umgebungen mit bestehenden, komplexen Seitenmodellen.

Halbautomatische Installation:

Dieser Installationsmodus ist ideal für Nicht-Produktionsumgebungen mit bestehenden Inhaltsmodellen. Im Gegensatz zur automatischen Installation erstellt die halbautomatische Option keine Beispielinhalte, sondern versucht, die bestehende Konfiguration automatisch anzupassen, um Arboretum in dein Projekt zu integrieren.

Am besten geeignet für: Nicht-Produktionsumgebungen mit bestehenden Inhalten.

Automatische Installation:

Dies ist der einfachste und effizienteste Installationsmodus, empfohlen für neue Umgebungen, die noch keine Inhalte (oder keine seitenbezogenen Inhalte) enthalten. Arboretum erstellt automatisch grundlegende Seiteninhaltsmodelle zusammen mit Beispielinhalten. Dadurch kannst du die Sitemap in der Arboretum-App unmittelbar nach der Installation einsehen.

Am besten geeignet für: Neue Projekte oder Umgebungen ohne bereits vorhandene Inhalte.

Beziehungen zwischen über- und untergeordneten Seiten

Die Arboretum-Sitemap-App hilft dir dabei, deine Website-Struktur mithilfe deiner Contentful-Daten zu verwalten. Damit dies funktioniert, müssen deine Inhalte die über- und untergeordnete Beziehung zwischen den Seiten kodieren. Es gibt zwei Hauptmethoden, um diese Beziehung herzustellen: Child-to-Parent-Verknüpfung (die untergeordnete Seite verlinkt auf ihre übergeordnete Seite) oder Parent-to-Children-Verknüpfung (die übergeordnete Seite verlinkt auf ihre untergeordneten Seiten).

Verlinkung von Tochter-zu-Elternseite (empfohlen)

Wenn eine neue Seite erstellt wird, kannst du ihr einfach eine Elternseite zuweisen und so die Beziehung herstellen, ohne die Elternseite anpassen oder neu veröffentlichen zu müssen. Für Arboretum-Nutzer bedeutet dies, dass die neue Seite automatisch zur Sitemap hinzugefügt wird, sobald die Elternseite festgelegt ist.

Nachteil: Du verlierst die Reihenfolge der Unterseiten in deinem Seitenbaum. Dies kann ein Problem sein, wenn deine Website auf eine bestimmte Reihenfolge der Seiten in einer Sitemap angewiesen ist (z. B. für die Anzeige der Navigation). Wir empfehlen dir, dich bei neu entwickeltem Code nicht auf die Reihenfolge der Knoten in einer Sitemap zu verlassen.

Wichtige Vorteile: Anwendungsfall: Ideal für die meisten Projekte, insbesondere solche, bei denen häufig neue Inhalte hinzugefügt werden. Es eignet sich auch gut für Szenarien, in denen Seiten automatisch durch die Synchronisierung von Daten aus Drittanbietersystemen erstellt werden.

  • Vereinfachte Seitenverwaltung: Um eine neue Seite hinzuzufügen, musst du lediglich das Feld „Übergeordnete Seite“ auf der untergeordneten Seite festlegen, wodurch die übergeordnete Seite unverändert bleibt und mehrere Aktualisierungen vermieden werden.

  • Schnellere Aktualisierungen: Da die übergeordnete Seite nicht geändert oder neu veröffentlicht werden muss, ist der Vorgang schneller und beeinträchtigt bestehende Inhalte weniger.

  • Skalierbarkeit: Diese Methode ermöglicht eine einfachere Verwaltung einzelner Seiten in großen Projekten, ohne die Gesamthierarchie zu stören.

Links von übergeordneten zu untergeordneten Seiten

Das Modell der Verknüpfungen von übergeordneter zu untergeordneter Seite ermöglicht es dir, die Beziehung zwischen übergeordneter und untergeordneter Seite von der übergeordneten Ebene aus zu verwalten. In dieser Konfiguration kannst du mehrere untergeordnete Seiten gleichzeitig auswählen und verknüpfen. Auf einer Startseite kannst du beispielsweise alle direkten untergeordneten Seiten in einem Schritt zuweisen. Die Möglichkeit, Verweise auf untergeordnete Seiten in einer Liste auf der übergeordneten Ebene zu führen, ermöglicht es dir zudem, die Reihenfolge der untergeordneten Seiten nach Bedarf zu steuern.

Nachteil: Dieses Modell erfordert eine manuelle Hierarchieverwaltung auf der übergeordneten Ebene. Jedes Mal, wenn eine neue Unterseite hinzugefügt wird, muss die übergeordnete Seite aktualisiert und neu veröffentlicht werden, damit die Änderungen in der Sitemap übernommen werden. Dies verursacht zusätzlichen Aufwand und kann Workflows erschweren, die eine Freigabe erfordern.

Wichtige Vorteile:Anwendungsfall: Nützlich für ältere Setups oder Projekte, bei denen die Reihenfolge der Inhaltsseiten in einer Sitemap entscheidend ist.

  • Vereinfachte Verwaltung von Unterseiten: Mehrere Unterseiten können gleichzeitig einer einzigen übergeordneten Seite zugewiesen werden.

  • Beibehaltung der Reihenfolge der Unterseiten: Da Unterseiten in einer Liste auf der übergeordneten Seite gespeichert werden, bleibt ihre Reihenfolge auf jeder Ebene der Sitemap erhalten.

Konfigurieren von Seitenbeziehungen in Arboretum

Bei der automatischen oder halbautomatischen Konfiguration wird das Inhaltsmodell entweder auf Basis des Beziehungsmodus Child-to-Parent oder Parent-to-Children erstellt oder angepasst. Du musst lediglich die gewünschte Option auswählen (wir empfehlen Child-to-Parent).

Bei der manuellen Konfiguration speichert Arboretum die von dir gewählte Methode zur Kodierung von Seitenbeziehungen, aber den Rest der Einrichtung musst du basierend auf dieser Wahl selbst vornehmen.

Solltest du jemals zwischen verschiedenen Methoden für Seitenbeziehungen wechseln müssen, musst du die Arboretum-App neu installieren, da das System derzeit kein Umschalten zwischen diesen Optionen unterstützt.

Arboretum-Konfiguration

Wenn du den automatischen Installationsmodus gewählt hast, musst du nur sicherstellen, dass die Konfiguration gespeichert wird (die Schaltfläche „Speichern“ befindet sich in der oberen rechten Ecke), und schon bist du startklar. Wenn du hingegen den halbautomatischen oder manuellen Installationsmodus gewählt hast, mache dich bitte mit den Konfigurationsoptionen vertraut, da die richtige Einrichtung entscheidend dafür ist, dass Arboretum eine Seitenstruktur für dich ableiten kann.

Seitenkonfiguration

In diesem Schritt legst du fest, welche Inhaltstypen in deiner Konfiguration Seiten darstellen. Du kannst mehrere Inhaltstypen als Seiten definieren, musst aber mindestens einen Inhaltstyp konfigurieren.

Sobald du deinen Seiten-Content-Typ hinzugefügt hast, erscheinen drei Dropdown-Menüs, über die du Felder aus deinem Content-Modell auswählen kannst, die Arboretum wie folgt verwenden wird: Alle genannten Felder können in deinem Content-Modell als lokalisierbar markiert werden, sodass du deine Content-Typen ganz nach deinen spezifischen Bedürfnissen gestalten kannst. Mit Arboretum kann deine Sitemap lokalisierte Pfade, Seitentitel und sogar die Gesamtstruktur enthalten. Die Lokalisierungseinstellungen können jederzeit geändert werden, und Arboretum übernimmt diese Aktualisierungen automatisch, wobei der Fallback-Mechanismus von Contentful beibehalten wird.

  • Slug: Dies stellt einen Teil eines Pfads dar, der eine bestimmte Seite identifiziert. Im Contentful-Modell sollte es als obligatorisches „Kurztext“-Feld definiert werden.

  • Seitentitel: Dies ist der für Menschen lesbare Text, der in der Arboretum-App angezeigt wird, um die Navigation und Identifizierung von Seiten zu erleichtern. Im Contentful-Modell sollte er als ein erforderliches „Kurztext“-Feld definiert werden.

  • Übergeordnete Seite (nur im Modus „Kind zu Elternteil“ für Seitenbeziehungen): Dies ist ein Feld, auf dessen Grundlage die Sitemap-Struktur erstellt wird. Es kodiert Beziehungen zwischen Seiten. Im Contentful-Modell sollte es als ein einzelnes „Referenz“-Feld definiert werden.

  • Untergeordnete Seiten (nur im Seitenbeziehungsmodus „Eltern-zu-Kindern“): Dient genau demselben Zweck der Seitenbeziehungen wie das oben beschriebene Feld Übergeordnete Seite. Im Contentful-Modell sollte es als ein mehrfaches „Referenz“-Feld definiert werden.

Konfiguration der Weiterleitungen (optional)

Die Konfiguration von Weiterleitungen ist optional und im Gegensatz zur Seitenkonfiguration kann nur ein Inhaltstyp konfiguriert werden. Der Ablauf ähnelt der Seitenkonfiguration: Sobald du einen Inhaltstyp ausgewählt hast, erscheinen zusätzliche Dropdown-Menüs, über die du Arboretum mitteilen kannst, welche Felder wie verwendet werden sollen: Genau wie bei Seiten-Inhaltstypen können Felder des Weiterleitungs-Inhaltstyps nach Bedarf lokalisiert werden.

  • Seite: Dies ist der Verweis auf die Seite, zu der die Weiterleitung führt. Im Contentful-Modell sollte dies als einzelnes „Reference“-Feld definiert werden.

  • Weiterleitungs-Titel: Dies stellt den für Menschen lesbaren Text dar, der in der Arboretum-App angezeigt wird. Im Contentful-Modell sollte dies als ein obligatorisches „Short text“-Feld definiert werden.

  • Pfad: Dies stellt den vollständigen Pfad der Weiterleitung dar. Im Contentful-Modell sollte dies als ein obligatorisches „Short text“-Feld definiert werden.

  • Typ: Sollte nur zwei Werte akzeptieren: „redirect“ oder „alias“. Wir empfehlen, dies in Contentful als Validierung festzulegen. Aus Sicht der Arboretum-App haben diese beiden Typen keine besonderen Auswirkungen, aber die Unterscheidung kann sich auf deiner Website widerspiegeln. Im Contentful-Modell sollte dies als Pflichtfeld vom Typ „Kurztext“ definiert werden.

Vorschau-Einrichtung (optional)

Neben der visuellen Darstellung einer Website-Struktur bietet die Arboretum-App zusätzliche Funktionen. Eine davon sind Links sowohl zur veröffentlichten als auch zur Vorschau-Version deiner Website. Um dies zu konfigurieren, musst du die URLs definieren, die als Präfixe dienen, anhand derer die Arboretum-App die richtigen Links generiert. Standardmäßig wird http://localhost:3000 verwendet.

Page: Home
pageHome

Konfiguration der Sprachversionen

Für jede in Contentful definierte Sprachversion erstellt Arboretum eine eigenständige Sitemap-Struktur. Je nach deiner Konfiguration können diese Sitemaps sehr ähnlich, identisch oder völlig unterschiedlich sein. Jede Contentful-Sprachversion hat einen eindeutigen Code, den Arboretum als Pfadpräfix verwendet. Beispielsweise haben Seiten in der Locale „en-US“ Pfade, die mit /en-US/ beginnen, und Seiten in der Locale „de“ haben Pfade, die mit /de/ beginnen.

Abschließende Gedanken

Wir hoffen, dass die Reise durch die tiefgehenden Details der Konfiguration der Arboretum Sitemap App nicht allzu überwältigend war. Denk daran: Wenn es dein Fall zulässt, kannst du jederzeit den automatischen Installationsmodus wählen und Arboretum sich selbst konfigurieren lassen!

Viel Spaß beim Erstellen von Sitemaps!

Bonus: Arboretum-Erweiterungen für mehr Komfort beim Bearbeiten

Neben der Hauptanwendung enthält die Arboretum Sitemap App zwei zusätzliche Erweiterungen, die dir das Leben beim Bearbeiten erleichtern können.

Konfiguration der Erweiterungen auf Feldebene

Die Arboretum App bietet Erweiterungen auf Feldebene, um das Erstellen von Verweisen auf Seiten in deinem Inhaltsmodell mithilfe einer visuellen Baumstruktur zu vereinfachen. Diese Erweiterungen können sowohl für Felder mit einem als auch mit mehreren Verweisen aktiviert werden. Um sie zu aktivieren, gehe zur Konfiguration des Inhaltsmodells, wähle ein Referenzfeld aus, klicke auf „Bearbeiten“, navigiere zum Abschnitt „Darstellung“ und wähle Arboretum aus. Wenn du danach eine Referenz erstellst, erscheint in einem Dialogfeld anstelle des nativen Eintragsauswahlfelds eine Sitemap-Baumstruktur, sodass du den gewünschten Knoten aus einer Sitemap statt aus einer flachen Liste von Seiten auswählen kannst.

Bright Global
  • Expertise
  • Referenzen
  • Unser Ansatz
  • Partner
Bright IT
  • Expertise Übersicht
  • Architecture Audits
  • Legacy Liberation
  • Enterprise Platforms
  • B2C Commerce
  • UX/UI Design
  • B2B Commerce
  • Integrationen & Middleware
  • AI & Automation
  • Continuous Operations
  • Referenzen & Branchen
  • HDI Global
  • Swarovski Optik
  • Mischek
  • Dachstein Salzkammergut
  • Salzburg AG
  • Tyrolit
  • Vaillant
  • Philosophie
  • Direct-to-Expert
  • Nearshoring 2.0
  • Security & Compliance
  • Partner Übersicht
  • Storyblok
  • Optimizely
  • Contentful
  • Shopify
  • Medusa
  • commercetools
  • Ecosystem Integrationen
Insights
Kontakt
Bright IT
Insights
  • Rechtliches
  • Datenschutz
  • Follow us on LinkedIn
© 2026

Partners