Blog- und Forenbeiträge hinzufügen

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Mit dem Developer Services-Portal können Sie Blogs und Foren mit Unterhaltungsthreads erstellen:

  • Mit der Blog-Unterstützung können Nutzer Blogposts erstellen, bearbeiten und löschen. Außerdem kannst du mit rollenbasierten Berechtigungen Blogaktionen auf bestimmte Nutzertypen beschränken.
  • In Foren können Nutzer Unterhaltungsthreads mit rollenbasierter Moderation erstellen. Sie können dem Portal Foren hinzufügen, Foren in einer Hierarchie gruppieren und Nutzerrollen konfigurieren, um den Zugriff auf die Foren zu steuern.

Arbeiten mit Blogs

Über das Portal können Nutzer mit den erforderlichen Berechtigungen Blogposts erstellen, bearbeiten und löschen. Blogs bestehen aus einzelnen Posts, die mit einem Zeitstempel versehen sind und nach Datum angezeigt werden. Jeder, auch anonyme Nutzer, kann sich über den Navigationslink auf der Startseite des Portals die neuesten Blogeinträge ansehen.

Jeder Nutzer mit den erforderlichen Berechtigungen kann einen Blogpost kommentieren. Kommentare können sofort nach der Eingabe angezeigt werden. Alternativ können Sie das Entwicklerportal so konfigurieren, dass Kommentare vor der Anzeige moderiert werden müssen. Standardmäßig können anonyme Nutzer keine Kommentare posten.

Blogtypen

Das Portal unterstützt zwei Blogtypen, abhängig von Ihrer Version des Portals:

  • Der vom Modul Drupal Blog implementierte Standardblog wird standardmäßig in Releases des Portals vor Version 14.02.156.1 verwendet.
  • Der benutzerdefinierte Apigee-Blog mit einer benutzerdefinierten Ansicht von Posts, Unterstützung für Bild-, Audio- und Video-Inhaltstypen und einer "tumblr-ähnlichen" Bearbeitungs-Symbolleiste, wie durch benutzerdefinierte Apigee Drupal-Module implementiert. Version 14.02.156.1 und höher des Portals verwenden standardmäßig den benutzerdefinierten Apigee-Blog. Vorhandene Portale können im Rahmen des Upgrades auf Version 14.02.156.1 aktualisiert werden, um den neuen Blog zu verwenden.

Der maßgeschneiderte Blog wird durch drei benutzerdefinierte Drupal-Module definiert, die von Apigee bereitgestellt werden. In der folgenden Tabelle werden diese Module beschrieben:

Modul Definition
DevConnect-Blog Definiert die grundlegende Funktionalität des Blogs.
Menü zur Erstellung von Devconnct-Inhalten Definiert das Menü, mit dem Sie verschiedene Arten von Bloginhalten erstellen können.
Inhaltstypen in Devconnect-Blogs Definiert die speziellen Drupal-Inhaltstypen für den Blog: Bild, Audio und Video. Ohne dieses Modul können Sie nur Blogeinträge des Typs „Artikel“ erstellen.

So bestimmen Sie die Portalversion und die unterstützten Blogtypen:

Sie können die Portalversion mit dem folgenden cURL-Befehl ermitteln:

$ curl <portal url>/buildInfo

Wenn Sie den benutzerdefinierten Blog verwenden möchten, muss Ihre Version 14.02.156.1 oder höher sein.

Upgrade eines vorhandenen Portals zur Verwendung der benutzerdefinierten Blogging-Module von Apigee:

  1. Prüfen Sie, ob Ihr Portal auf Version 14.02.156.1 oder höher aktualisiert wurde.
  2. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  3. Wählen Sie im Drupal-Menü die Option Module (Module) aus.
  4. Deaktivieren Sie das Blog-Modul.
  5. Aktivieren Sie die folgenden drei benutzerdefinierten Apigee-Module:
    • DevConnect-Blog
    • Devconnct Menü zur Inhaltserstellung
    • Inhaltstypen in Devconnect-Blogs
  6. Speichern Sie die Konfiguration.

Blog ansehen

Auf der Blog-Seite werden im Entwicklerportal aktuelle Blogposts angezeigt. Die Blogeinträge werden in absteigender Reihenfolge nach Erstellungszeit angezeigt. Um die Blog-Seite anzuzeigen, wählen Sie im Hauptmenü des Entwicklerportals die Option Blog aus.

Darüber hinaus ist das Entwicklerportal anfangs so eingerichtet, dass aktuelle Blogposts auf der Startseite angezeigt werden. Die Einträge werden außerdem in absteigender Reihenfolge nach Erstellungszeit angezeigt.

Berechtigungen für den Blog festlegen

Als Administrator steuern Sie die Berechtigungen, die zum Ausführen von Aktionen im Blog erforderlich sind, z. B. zum Erstellen, Bearbeiten und Löschen von Blogposts.

Außerdem konfigurieren Sie die Berechtigungen zum Posten, Bearbeiten und Löschen von Blogkommentaren und legen fest, ob der Kommentar eines Nutzers moderiert werden muss. Wenn ein Kommentar nicht moderiert werden muss, wird er sofort angezeigt. Wenn der Kommentar moderiert werden muss, muss er von einem Portalnutzer mit der erforderlichen Berechtigung zum Moderieren von Kommentaren genehmigt werden.

So legst du Blogberechtigungen fest:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü Personen aus.
  3. Wählen Sie oben auf der Seite „Personen“ den Link Berechtigungen aus.
  4. Scrollen Sie auf der Seite zum Abschnitt Kommentar.
  5. Legen Sie im Bereich Kommentieren die folgenden Berechtigungen fest, um zu steuern, welche Nutzer Kommentare hinzufügen, ansehen, bearbeiten und genehmigen können:
    • Kommentare und Kommentareinstellungen verwalten
    • Kommentare ansehen
    • Kommentare zum Beitrag
    • Kommentargenehmigung überspringen
    • Eigene Kommentare bearbeiten
  6. Scrollen Sie auf der Seite nach unten zum Bereich Knoten.
  7. Legen Sie im Bereich Knoten fünf verschiedene Berechtigungen fest, mit denen festgelegt wird, welche Nutzer Blogposts hinzufügen, bearbeiten und löschen dürfen:
    • Blogbeitrag: Neue Inhalte erstellen
    • Blogeintrag: Eigene Inhalte bearbeiten
    • Blogeintrag: Beliebigen Content bearbeiten
    • Blogeintrag: Eigene Inhalte löschen
    • Blogeintrag: Inhalte löschen
  8. Speichern Sie Ihre Konfiguration.

Blogeintrag hinzufügen

Alle Nutzer mit den erforderlichen Berechtigungen können einen Blogeintrag erstellen. Du kannst Nutzerrollen aber auch so konfigurieren, dass ein Nutzer seinen eigenen Blogeintrag hinzufügen und bearbeiten, ihn aber nicht löschen kann. Sie können aber auch eigene Blogeinträge hinzufügen, bearbeiten und löschen, aber keine Blogeinträge anderer Nutzer bearbeiten.

Wenn Ihre Version des Portals das Drupal Blog-Modul verwendet, wird die folgende Schaltfläche angezeigt, mit der Sie einen Blogeintrag erstellen können:

Die standardmäßige Bearbeitungsseite des Blogs wird angezeigt:

Wenn Sie den benutzerdefinierten Apigee-Blog verwenden und die Unterstützung für alle Bloginhaltstypen aktiviert haben, können Sie über das folgende Menü verschiedene Blogeinträge erstellen:

Wählen Sie die Schaltfläche für den entsprechenden Inhaltstyp aus, um den neuen Blogeintrag zu erstellen. Abhängig vom ausgewählten Inhaltstyp wird der folgende Editor angezeigt:

Mit den Schaltflächen unten rechts können Sie Inhalte hinzufügen, die vom Bootstrap-Projekt definiert wurden, einschließlich Karussell, Featurette, Jumbotron und Trifold.

Im unteren Bereich können Sie die zugehörigen Medien hinzufügen. In der Abbildung oben für den Videoinhaltstyp können Sie dem Blogeintrag beispielsweise ein Video hinzufügen.

So fügen Sie einen Blogeintrag hinzu:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Navigationsmenü des Entwicklerportals die Option Blog aus.
  3. Wählen Sie Neuen Blogeintrag erstellen (Drupal Blog-Modul) oder den Inhaltstyp (Benutzerdefinierter Apigee-Blog) aus.
  4. Fügen Sie in den Abschnitten Titel und Text Inhalte hinzu.
  5. Klicken Sie gegebenenfalls auf Zusammenfassung bearbeiten, um eine Zusammenfassung hinzuzufügen.
  6. Geben Sie eine durch Kommas getrennte Liste von Keywords ein. Diese Schlüsselwörter werden in der Ansicht „Heiße Themen“ auf der Blogseite dargestellt. Du kannst die Ansicht „Angesagte Themen“ optional der Startseite oder einer beliebigen anderen Seite hinzufügen.
    Je nach Art des Blogeintrags musst du möglicherweise den Bereich Meta-Tags auf der Seite erweitern, um Suchbegriffe einzugeben.
  7. Klicken Sie auf Speichern.
    Der Blog wird auf der Startseite des Blogs veröffentlicht und auf der Startseite im Bereich „Neueste Blogposts“ aufgeführt.

Wenn du einen neuen Blogeintrag erstellst, zeichnet das Blogmodul grundlegende Informationen über den Inhalt auf, darunter die Autoren-ID, das Erstellungsdatum und den Inhaltstyp.

Blogkommentare moderieren

Nutzer des Entwicklerportals können Kommentare zu Blogeinträgen posten. Standardmäßig müssen Nutzer im Portal angemeldet sein, um einen Kommentar posten zu können. Ob ein Nutzer Kommentare ansehen, posten, bearbeiten und genehmigen kann, hängt von seinen Rollen und Berechtigungen ab (siehe oben).

So moderierst du einen Kommentar:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Kommentargenehmigungsberechtigung an.
  2. Wählen Sie im Drupal-Verwaltungsmenü Inhalt > Kommentare aus.
  3. Wähle entweder den Link Veröffentlichte Kommentare oder den Link Nicht genehmigte Kommentare aus.
  4. Auf dieser Seite kannst du Kommentare moderieren.

Anzeige der Blog-Seite konfigurieren

Das Entwicklerportal verwendet eine Drupal-Ansicht namens Als Bloginhalts-Ansicht getaggte Elemente, um die Anzeige von Blogeinträgen auf der Blogseite zu steuern. Blogeinträge werden standardmäßig in absteigender Reihenfolge nach Erstellungsdatum aufgelistet.

So konfigurieren Sie die Blogansicht:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Verwaltungsmenü Structure > Views (Struktur > Ansichten).
  3. Wählen Sie den Link Bearbeiten in der Zeile für die Ansicht Als Bloginhalts-Ansicht getaggte Elemente (Inhalt) aus. Daraufhin wird die folgende Seite angezeigt, auf der Sie die Ansicht konfigurieren können:

  4. Bearbeiten Sie die Ansicht.
  5. Speichern Sie die Änderungen.

Anzeige „Heiße Themen“ für Blogeinträge konfigurieren

Das Entwicklerportal verwendet eine Drupal-Ansicht namens Hot Topics, um die Anzeige der angesagten Themen bei Blogeinträgen auf der Blog-Seite zu steuern. Standardmäßig entsprechen die Elemente „Heiße Themen“ den Suchbegriffen, die Blogposts hinzugefügt wurden.

So konfigurierst du die Ansicht „Heiße Themen“:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Verwaltungsmenü Structure > Views (Struktur > Ansichten).
  3. Wähle in der Zeile der Ansicht Angesagte Themen (Inhalte) den Link Bearbeiten aus. Daraufhin wird die Seite angezeigt, auf der Sie die Ansicht konfigurieren können.
  4. Bearbeiten Sie die Ansicht.
  5. Speichern Sie die Änderungen.

Mit Foren arbeiten

In Foren können Nutzer mit den erforderlichen Berechtigungen Threads mit Diskussionen erstellen, die ähnlich funktionieren wie bei anderen Message-Board-Systemen. Ein Thema ist in einem Forum enthalten und jedes Forum kann viele verschiedene Themen enthalten. Themen können auch eigene URLs haben.

Nutzer posten neue Themen in einem Forum. Jedes Forumsthema besteht aus einem ersten Beitrag sowie Antworten oder Kommentaren. Abhängig von den Berechtigungen des Nutzers kann der Nutzer seine eigenen Beiträge bearbeiten und löschen sowie die Beiträge anderer Nutzer bearbeiten und löschen.

Standardmäßig können anonyme Nutzer Beiträge ansehen, aber keine Antworten posten. Nur authentifizierte Nutzer mit der erforderlichen Berechtigung können auf einen Beitrag antworten. Antworten werden angezeigt, sobald sie eingegeben wurden, sie werden also nicht moderiert.

Administratoren legen die Berechtigungen zum Posten, Bearbeiten vorhandener Beiträge und Löschen von Beiträgen fest. Administratoren können Forenbeiträge auch im Bereich für Forendiskussionen auf der Startseite aufwerten.

Bestimmen des von den Foren verwendeten Drupal-Moduls

Das Portal verwendet zwei Drupal-Module zur Implementierung von Foren:

  • Das Modul Drupal-Forum ist das zentrale Forumsmodul und wird standardmäßig von Releases des Portals vor Version 14.02.156.1 verwendet.
  • Das Modul Erweitertes Drupal-Forum erweitert das Forumsmodul um zusätzliche Funktionen, darunter ein verbesserter Stil, eine Schnellsuche nach aktiven Themen, unbeantwortete Themen, neue Themen und mehr. Version 14.02.156.1 und höher des Portals verwenden standardmäßig das Drupal Advance Forum-Modul.

So ermitteln Sie, welches Modul aktiv ist:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü die Option Module (Module) aus.
  3. Gib in der Filterliste oben auf der Seite „Module“ „forum“ ein.
    • Wenn das Modul Advanced Forum aufgeführt und aktiviert ist, verwenden Sie das Modul Advanced Forum.
    • Wenn das Modul Erweitertes Forum fehlt oder deaktiviert ist und das Modul Forum aktiviert ist, verwenden Sie das Hauptmodul Forum.

Alternativ können Sie die Portalversion mit dem folgenden cURL-Befehl ermitteln:

$ curl <portal url>/buildInfo

Modul für erweitertes Forum konfigurieren

Das Modul "Erweitertes Forum" verfügt über Konfigurationseinstellungen, mit denen die Forumsanzeige, Navigationspfade und andere visuelle Merkmale der Foren gesteuert werden.

So konfigurierst du das Modul „Erweiterte Foren“:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü Konfiguration > Inhaltserstellung > Erweitertes Forum aus. Die Seite für das erweiterte Forum wird angezeigt.
  3. Legen Sie die Anzeigeoptionen fest.
  4. Speichern Sie die Konfiguration.

Berechtigungen für die Foren festlegen

Als Administrator steuern Sie die Berechtigungen, die für Aktionen in den Foren erforderlich sind. Sie legen Berechtigungen fest, die sowohl von den Modulen für erweiterte Foren als auch von den Foren verwendet werden, sowie spezifische Berechtigungen für jedes Modul.

So legst du Forumsberechtigungen fest:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü Personen aus.
  3. Wählen Sie oben auf der Seite „Personen“ den Link Berechtigungen aus.
    • Wenn Sie das Modul Erweiterte Foren verwenden, scrollen Sie nach unten zum Bereich Erweiterte Foren und legen Sie die entsprechenden Berechtigungen fest.
    • Wenn du das Modul Foren verwendest, scrolle nach unten zum Bereich Foren und lege die entsprechenden Berechtigungen fest.
  4. Scrollen Sie auf der Seite nach unten zum Bereich Knoten.
  5. Legen Sie im Bereich Knoten fünf verschiedene Berechtigungen fest, mit denen festgelegt wird, welche Nutzer Forumsbeiträge hinzufügen, bearbeiten und löschen dürfen:
    • Forumsthema: Neue Inhalte erstellen
    • Forumsthema: Eigene Inhalte bearbeiten
    • Forumsthema: Beliebige Inhalte bearbeiten
    • Forumsthema: Eigene Inhalte löschen
    • Forumsthema: Inhalte löschen
  6. Speichern Sie Ihre Konfiguration.

Forum hinzufügen

Standardmäßig verfügt das Entwicklerportal über ein einziges Forum namens Allgemeine Diskussion. Sie können zusätzliche Foren hinzufügen, Foren verschachteln und Forencontainer erstellen, bei denen es sich um Gruppen von Foren handelt.

Mit einem Forencontainer können Sie eine Forensammlung erstellen. Ein Container ist jedoch kein Forum an sich, sondern definiert einfach eine Sammlung von Foren.

So fügen Sie ein Forum hinzu:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü Struktur > Foren aus, um die Liste der aktuellen Foren aufzurufen.
    Auf dieser Seite können Sie vorhandene Foren bearbeiten oder die Reihenfolge ändern, in der die Foren auf der Seite „Foren“ angezeigt werden.
  3. Wählen Sie +Forum hinzufügen aus.
  4. Fügen Sie Informationen über das neue Forum hinzu, einschließlich des übergeordneten Forums, wenn Sie das Forum verschachteln möchten.
  5. Klicken Sie auf Speichern.

So ordnest du die Foren neu an:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü Struktur > Foren aus, um die Liste der aktuellen Foren aufzurufen.
  3. Klicken Sie auf das Pluszeichen + vor einem Forumsnamen und ziehen Sie es an die gewünschte Stelle, um die Reihenfolge oder Verschachtelungsebene zu ändern.
  4. Speichern Sie die Änderungen.

So fügen Sie einen Forencontainer hinzu:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
  2. Wählen Sie im Drupal-Menü Struktur > Foren aus, um die Liste der aktuellen Foren aufzurufen.
  3. Wählen Sie + Hinzufügen aus.
  4. Fügen Sie Informationen zum neuen Container hinzu, einschließlich des übergeordneten Containers, wenn Sie ihn verschachteln möchten.
  5. Klicken Sie auf Speichern.
    Die Seite Foren wird geöffnet.
  6. Klicken Sie auf der Seite Foren auf das Pluszeichen (+) und ziehen Sie es vor einem Forumsnamen, um es dem neuen Container hinzuzufügen.
  7. Speichern Sie die Änderungen.

Werbung für ein Forumsthema auf der Startseite

Die standardmäßige Startseite enthält eine Drupal-Ansicht, die den Inhalt des Forumsdiskussionsbereichs der Startseite steuert. Damit ein Forumsthema im Bereich "Forendiskussionen" angezeigt wird, muss ein Administrator das Thema hochstufen.

So bewerben Sie ein Forumsthema:

  1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Kommentargenehmigungsberechtigung an.
  2. Wählen Sie im Verwaltungsmenü von Drupal Inhalte aus.
  3. Filtern Sie die Inhalte, indem Sie im Drop-down-Menü Typ die Option Forumsthema und dann Anwenden auswählen.
    In der Inhaltsliste werden nur Forenthemen angezeigt.
  4. Wählen Sie ein oder mehrere Forenthemen aus, die Sie bewerben möchten.
  5. Wählen Sie im Drop-down-Menü Vorgänge die Option Auf Titelseite hochstufen aus.
  6. Wählen Sie Ausführen aus.
    Alle ausgewählten Themen werden jetzt im Bereich „Forendiskussionen“ auf der Startseite angezeigt.

Alternativ können Sie einen einzelnen Forumsbeitrag bearbeiten und in den Veröffentlichungsoptionen für das Thema die Option Auf Titelseite hochstufen auswählen.