Dokumentation contentXXL CMS Version 5.3

 

 
 

Allgemein

Um Ihre Inhalte in verschiedene Social Media-Portale sharen zu können, bietet contentXXL das Modul "Social Media Publisher".
Aktuell steht der Social Media Publisher für Facebook zur Verfügung.

„Social Media Publisher“ - Warum?

Viele Unternehmen möchten bereits existierende Artikel oder auch neue Artikel in Social Media Portalen veröffentlichen.

Problemstellung

Das Problem hierbei ist, dass jeder Redakteur einen administrativen Zugang zum Social Media-Portal benötigt. Diese Problematik wirkt sich besonders in größeren Unternehmen aus, da keinerlei Kontrolle mehr vorhanden ist, welcher Mitarbeiter/Redakteur welchen Artikel veröffentlicht hat.

Vorteile

  • Workflow (optional)
  • Versionierung (optional)
  • Keine Weitergabe von Login-Daten der Social Media Portale an Mitarbeiter
  • Hinterlegung Rechte/Rollen
  • Zentralisierte Verwaltung
  • Veröffentlichung bereits bestehender contentXXL-Artikel
  • Veröffentlichung neuer Social Media Posts

Mechanismus: Workflow

Erstellt ein Mitarbeiter/Redakteur einen neuen Post für das entsprechende Social Media Portal, wird dieser nicht sofort auf dem entsprechenden Portal veröffentlicht, sondern zuerst zur Überprüfung an den zuständigen Verantwortlichen bzw. an die zuständige verantwortliche Rollen weitergeleitet.

Hierdurch bietet sich die Möglichkeit, Posts vor der Veröffentlichung im Social Media Portal von einer höheren Instanz überprüfen zu lassen. Diese kann den geschriebenen Post dann freigeben oder die Freigabe verweigern.

Freigabe erteilt

Der im System hinterlegte Post wird nun im Social Media-Portal veröffentlicht.

Freigabe verweigert

Der im System hinterlegte Post wird an den Ersteller weitergeleitet mit einem entsprechenden Kommentar der überprüfenden Instanz, z.B. „Text bitte kürzen und mehr Schlagworte in der Nachricht verwenden“. Der Ersteller hat nun die Möglichkeit, den Post selbst erneut zu bearbeiten oder seinerseits an eine Person weiterzuleiten, die diesen Post bearbeiten soll.

Nachdem der Post bearbeitet und erneut veröffentlicht wurde, startet der Workflow-Mechanismus von vorne.

Versionierung

Bei aktivierter Versionierung können Sie bereits veröffentlichte Posts erneut bearbeiten und als neue Variante in das entsprechende Social Media-Portal veröffentlichen.

Durch die hinterlegte Versionierung lässt sich nun nachvollziehen, was in welcher Version des Posts veröffentlicht wurde.
Zusätzlich kann das Veröffentlichungsdatum, der Autor des Posts u.v.m hierdurch nachvollzogen werden.

Die Versionierung kann zusätzlich mit dem Workflow gekoppelt werden. Jeder bearbeitete Post durchläuft dann, bevor er im Portal veröffentlicht wird, den Workflow-Mechanismus.

Keine Versionierung und Workflow

Wird keine Versionierung und kein Workflow für das Social Media Publisher-Modul hinterlegt, wird der angelegte Artikel sofort in dem jeweiligen Social Media Portal veröffentlicht.

Login-Daten für Benutzer?

Der Mitarbeiter/Redakteur benötigt keine Zugangsdaten zu den Social Media-Portalen, diese Daten werden von einem Administrator im Modul hinterlegt. Auf diese Daten haben nur freigegebene Mitarbeiter/Redakteure durch das Rechte/Rollen-Konzept Zugriff.

Passwort/Benutzer

Die Social Media Portale wie Facebook, Twitter oder Google+ arbeiten mit der OAuth-Protokoll.
Im Rahmen der OAuth-Methodik erhält man einen einmaligen Zugangscode. Mit diesem Zugangscode wird ein für längere zeit gültiges Autorisierungs-Token angefordert und im Modul hinterlegt. Unter Verwendung dieses Tokens werden alle Posts veröffentlicht.

Weitere Informationen zu OAuth unter: http://oauth.net/

Rechte/Rollen

Sie können, nachdem Sie ein Social Media Publisher-Modul angelegt haben, diesem Modul spezielle Rechte für Benutzer bzw. Rollen hinterlegen. Dadurch kann gesteuert werden, welche Rollen und/oder Benutzer Posts im entsprechenden Social Media-Portal veröffentlichen dürfen.

Veröffentlichung bereits bestehender contentXXL-Artikel

Dieser Mechanismus bietet Ihnen die Möglichkeit, bereits existierende contentXXL-Artikel in Social Media Portale zu veröffentlichen. Damit der Mitarbeiter/Redakteur wenig Arbeit hat, hinterlegt contentXXL die verschiedenen Felder des Posts mit denen des angelegten contentXXL-Artikels. Somit muss der Mitarbeiter/Redakteur nur noch überprüfen, wie viel er von dem gesamten Text veröffentlichen möchte.

Veröffentlichung neuer Social Media Posts

Neue Posts können in einem Social Media Publisher-Modul durch Klick auf die Schaltfläche "Neue Social Media Publikation" generiert werden.

 
 

Spezielle Einstellungen

Fogende Einstellungen können getroffen werden:

Abb.: Spezielle Einstellungen des Social Media Publisher-Moduls

  • Typ: Aktuell kann nur auf Facebook publiziert werden.
  • Einträge auf Benutzer-Pinnwand veröffentlichen: Wählen Sie diese Checkbox aus, um Einträge in Ihrem Benutzerprofil zu erstellen. Bei Aktivierung werden weitere Eingabefelder eingeblendet (sehen Sie hierzu bitte den Abschnitt "Veröffentlichungsplattform Facebook").
  • Einträge auf Seiten-Pinnwand veröffentlichen: Wählen Sie diese Checkbox aus, um Einträge auf einer Seite zu erstellen. Bei Aktivierung werden weitere Eingabefelder eingeblendet (sehen Sie hierzu bitte den Abschnitt "Veröffentlichungsplattform Facebook").

Hinweis: Sind beide Optionen aktiviert, werden Posts sowohl im Benutzerprofil als auch auf der Seite erstellt.

Wichtig: Für beide Optionen müssen Sie sich im weiteren Verlauf zur Generierung eines temporären Facebook-Codes an Ihrem Account anmelden. Mit dem temporären Code wird ein langfristig gültiges Autorisierungs-Token angefordert und gespeichert.

  • Erweiterte Einstellungen: Bei Aktivierung werden die für contentXXL-Module typischen Einstellungen eingeblendet (entsprechend z.B. dem Artikel-Modul). Durch Auswahl der entsprechenden Templates können Sie alle in diesem Modul veröffentlichten Posts auf Ihrer Webseite darstellen.  Dies kann z.B. interessant sein, um zu sehen, welche Posts auf Facebook veröffentlicht wurden und von wem.

 

 

 

 
 

Posts veröffentlichen:

Nachdem Sie eine Facebook-Anwendung erstellt, alle Daten im Modul eingetragen sowie gegebenenfalls Rechte/Rollen angepasst haben, können Sie nun Inhalte auf der eingestellten Social Media-Plattform veröffentlichen.

 

Existierendes contentXXL-Objekt auf Social Media-Portal veröffentlichen

Um ein existierendes contentXXL-Objekt auf einem Social Media-Portal veröffentlichen zu können, wählen Sie das gewünschte Objekt aus und gehen auf den Reiter „Veröffentlichen“.

In der Toolbarleiste finden Sie einen Button „Social Media Veröffentlichung“.


 
Klicken Sie auf diesen Button. Es erscheint ein Popup-Fenster.


 
Die Felder wie „Facebook Nachricht“ werden aus den vorhandenen Textdaten des Objekts befüllt. Der Linkname ist der hinterlegte Objekt-Titel aus den Basisdaten.
Falls bei Ihrem Objekt ein Vorschaubild hinterlegt wurde, wird dies unten in dem Feld „Link-Vorschaubild“ angezeigt. Hier können Sie bei Bedarf ein anderes Bild auswählen.
Sie können nun den Post nach Ihren Wünschen abändern. Die maximale Länge beträgt 1700 Zeichen (s.u.). Sind alle Änderungen erfolgt, klicken Sie auf „Veröffentlichen“.

 

Neuer Post

Um einen neuen Post erstellen zu können, legen Sie das Modul auf eine Seite, auf die der Mitarbeiter/Redakteur Zugriffsrechte besitzt. Wählen Sie dieses Modul aus.


 
Klicken Sie dann: „Neue Social Media Publikation“.

Es erscheint ein Popup-Fenster.


 
Die Eingabemaske beinhaltet zwei Felder:

  • Facebook Nachricht
  • Facebook Link

Eines dieser beiden Felder muss mindestens ausgefüllt sein, um einen Post auf Facebook zu erstellen. Beide Felder können auch gleichzeitig gefüllt sein.
Sobald Sie einen Link eintragen, werden Ihnen zusätzliche Felder angeboten:


 
Ein Post auf Facebook sieht dann in etwa so aus:


 
Falls Sie keinen Link mitgeben, wird nur die „Facebook Nachricht“ auf der Pinnwand angezeigt.
Falls Sie keine Nachricht mitgeben, wird nur der untere Teil nach „Facebook Nachricht“ auf der Pinnwand angezeigt.
Sie können nun den Post nach Ihren Wünschen gestalten. Sind alle Änderungen erfolgt, klicken Sie auf „Veröffentlichen“.

 

Allgemeine Informationen

Ein Post darf die Länge von 1700 Zeichen nicht überschreiten. Diese Länge setzt sich aus allen mitgegeben Feldern zusammen.
Dies bedeutet: Geben Sie z.B. nur eine „Facebook Nachricht“ mit, kann diese bis zu 1700 Zeichen beinhalten.
Geben Sie nur einen Link mit, ist die Länge die Summe aus dem Link, Linknamen, Linkuntertitel sowie Linkbeschreibung.
Füllen Sie alle Felder aus, werden diese zusammengezählt.

Fehlermeldungen oder Statusmeldungen werden Ihnen via Popup angezeigt.
Bei Fehlermeldungen wenden Sie sich bitte an den entsprechenden Administrator.

Unterstützte Objekttypen von contentXXL, die auf Facebook veröffentlicht werden können:

  • Artikel
  • SocialMediaPublisher
  • Links
  • Kontakte
  • Umfrage
  • Blogs
  • Dokumente
  • Veranstaltungen
  • Bildobjekte
  • Shop
 
 

Erstellung einer Facebook Applikation/Anwendung

Zum Veröffentlichen von Posts aus contentXXL heraus muss auf Facebook eine Applikation/Anwendung erstellt werden, mit der das Social Media Publisher-Modul kommunizieren kann.

Damit Sie eine solche Applikation erstellen können, müssen Sie sich unter http://developers.facebook.com/ mit Ihrem Facebook-Account anmelden, zusätzlich müssen Sie Ihren Account verifizieren: http://www.facebook.com/help/?faq=167551763306531

Falls Sie noch keinen Facebook-Account besitzen, können Sie sich unter http://www.facebook.com/ kostenlos registrieren.

Nachdem Sie sich angemeldet haben, gehen Sie nun auf die Seite: https://developers.facebook.com/apps

Falls Sie das erste Mal diese Seite besuchen, bekommen Sie einige Hilfestellungen angezeigt. Bei Bedarf können Sie sich diese durchlesen, ansonsten klicken Sie diese Hilfestellungen weg.
Danach sehen Sie einen Button „Neue Anwendung erstellen“, dies bestätigen Sie.

Es erscheint ein Popup:

Wichtig: Der ausgewählte App-Name wird später auf Ihrem Post angezeigt.

Wählen Sie daher Ihren Applikationsnamen sorgfältig aus, da dieser später den Autoren-Namen Ihres Posts darstellt. Für den Applikationsnamen empfiehlt sich z.B. der Unternehmensname in Kombination mit der Kommunikationsabteilung z. B. contentXXL_PR.
Die Bereiche „App-Namespace“ und „Web Hosting“ bleiben auf der „default-Einstellung“.

Nachdem Sie Ihren App Namen (Applikation/Anwendungs-Name) hinterlegt haben, klicken Sie auf "Weiter". Geben Sie die geforderten Daten ein und klicken auf „Absenden“.

Nachdem die Anwendung erstellt wurde, werden Sie weitergeleitet auf die Anwendungseinstellungen.

Klicken Sie auf den Bereich „Website“.

Hier müssen Sie die URL Ihrer Webseite hinterlegen, z.B.: http://www.futurexxl.com
Hinter dieser URL muss folgendes angehängt werden: /contentxxl/modules/SocialMediaPublisher/admin/SocialMediaRedirect.aspx

Die Adresse der Webseite würde somit so aussehen:

http://www.futurexxl.com/contentxxl/modules/SocialMediaPublisher/admin/SocialMediaRedirect.aspx

Nachdem Sie Ihre Adresse hinterlegt haben, klicken Sie auf „Änderungen speichern“.

Um weitere Einstellungen für diese Applikation/Anwendung zu treffen, wechseln Sie im linken Bereich zu „Auth-Dialog/Fortgeschritten“.
Unter dem Punkt „Auth-Dialog“ können Sie optional ein Logo-Bild für die Applikation sowie einen Untertitel hinterlegen.

Falls Sie diese Lösung für mehrere Unterportale oder auch Zweit/Dritt Kunden verwenden möchten, überprüfen Sie bitte den Punkt Datenschutzbestimmungen etc. und hinterlegen Sie hier bei Bedarf Ihre Daten.

Unter dem Punkt „Fortgeschritten“ ändern Sie den Applikationstyp nicht zu Nativ/Desktop, genauso bitte den Sandkasten-Modus bei „gesperrt“ belassen.

Falls Sie bestimmte Einstellungen wie „Stream post URL security“ ändern, kann es unter Umständen zu Fehlern kommen.

Nachdem alle notwendigen Einstellungen getroffen wurden, kehren Sie zu dem Punkt „Grundlegend“ zurück, hier sind die von unserem Social Media Publisher-Modul  benötigten Informationen nun hinterlegt.

 

Weiterführende Informationen zur angelegten Anwendung

Facebook verfolgt das Prinzip „do more, get more“. Dies bedeutet: umso öfter Sie einen Post auf Facebook veröffentlichen, umso mehr Posts dürfen Sie pro Tag/Stunde/Minute auf Facebook veröffentlichen.

Daher kann es am Anfang dazu kommen, dass Sie z.B. nur 20 Mitteilungen veröffentlichen dürfen und danach die Anwendung bis zum nächsten Tag gesperrt wird.

Dieses Limit wird nach einiger Zeit und bei regelmäßiger Benutzung immer weiter hochgehen.

Der Redakteur/Mitarbeiter bekommt in diesem Fall eine Fehlermeldung angezeigt.

Eine Übersicht über alle Facebook-Fehlermeldungen finden Sie unter: http://fbdevwiki.com/wiki/Error_codes

Achten Sie auch darauf,  nicht zu viele Posts auf Facebook gleichzeitig zu veröffentlichen, da dies sonst als Spam angesehen und die Anwendung für eine bestimmte Dauer gesperrt werden könnte.

Einen „Workaround“, um dennoch weiterhin neue Einträge posten zu können, wäre, eine zweite/dritte Anwendung anzulegen und diese als neues Modul in contentXXL verfügbar zu machen. Der Redakteur/Mitarbeiter kann dann bei seiner Veröffentlichung auswählen, über welches Modul er diesen Post veröffentlichen möchte.

 

Benötigte Daten für das Social Media Publisher Modul

Diese Daten finden Sie unter der Anwendungsverwaltung von Facebook. Um zu diesen Einstellungen zu kommen, gehen Sie auf: https://developers.facebook.com/apps und wählen Sie hier Ihre Applikation aus:

Die benötigten Daten:

  • App-ID: Social Media Publisher Modul -> Anwendungs-ID
  • Anwendungs-Geheimcode: Social Media Publisher Modul -> Anwendungs-Geheimcode:
  • Seitenadresse: Social Media Publisher Modul -> Weiterleitungsadresse:

Nachdem Sie die benötigten Daten in die contentXXL Social Media Publisher-Maske eingefügt haben, erscheint ein Button „Facebook Code generieren“.

Bei Klick auf den Button öffnet sich ein neues Fenster:


 
Falls Sie nicht angemeldet sind, melden Sie sich bitte mit dem entsprechenden Facebook-Account an.

Über diesen Account werden später alle Posts zu Facebook erstellt, zusätzlich muss dieser Benutzer als Administrator der gewünschten Seite angelegt sein (falls Sie auf eine Seite posten möchten).

Wenn Sie für den Post eine andere Privatsphären-Einstellung auswählen möchten, z.B. „Alle (Öffentlich)“, wählen Sie diese bitte in der unteren Dropdown-Liste aus. Diese Einstellung können Sie später über Ihr Account-Profil bei Bedarf jederzeit ändern.


 
contentXXL benötigt die obigen Genehmigungen, ansonsten können keine Posts erstellt werden.

Bitte wählen Sie hier „Zulassen“ aus, andernfalls würde dies zu einem Fehler führen.

Achtung: Falls die Anwendung mehr Genehmigungen benötigt, muss dies erneut von Ihnen freigegeben werden. Durch die neu angefragte Genehmigung wird nach Bestätigung der Autorisierungstoken ungültig. Führen Sie den Schritt „Facebook Code generieren“ in diesem Fall erneut aus.

Sie werden nun auf die hinterlegte Weiterleitungsadresse weitergeleitet.


 
Kopieren Sie bitte den kompletten Inhalt (Facebook Code) in das Social Publisher-Modulfeld: „Facebook Code“.


 
Nachdem Sie den Code hineinkopiert haben, speichern Sie das Modul ab.


 
Falls alle eingegebenen Daten korrekt waren, wird der nur einmalig benötigte Facebook Code gelöscht und in den Feldern "Autorisierungs-Token für Benutzer", sowie "Ablaufdatum für Autorisierungs-Token" die Zugangsdaten hinterlegt. Über den Autorisierungs-Token kann contentXXL nun Inhalte zu Facebook übermitteln.

 

Einträge auf Seiten-Pinnwand veröffentlichen

Hierzu werden zwei weitere Felder benötigt:

  • Facebook Seiten-ID
  • Autorisierungs-Token für Seite

Um auf die Pinnwand einer Seite posten zu können, müssen Sie wie auch bei der Benutzer-Pinnwand

  • Anwendungs-ID
  • Anwendungs-Geheimcode
  • Weiterleitungsadresse
  • Autorisierungs-Token für Benutzer
  • Ablaufdatum für Autorisierungs-Token

ausfüllen. Um diese Daten zu bekommen, gehen Sie wie oben beschrieben vor.

Nachdem der Autorisierungs-Token sowie das Ablaufdatum verfügbar sind, erscheinen in der Dropdown-Liste „Facebook Seiten-ID“ alle verfügbaren Seiten:  


 
Wählen Sie hier die von Ihnen gewünschte Seite aus (die Zahl hinter dem Seitennamen ist eine von Facebook generierte ID). Falls die Auswahl leer bleibt, wird keine Seite unterstützt.

Speichern Sie nun Ihre Moduleinstellungen. Es wird ein Autorisierungs-Token für die Facebook-Seite generiert, mit dem contentXXL nun auf der Pinnwand der Seite Einträge veröffentlichen kann.

 

Privatsphäre für Anwendung abändern

Falls Sie die Privatsphären Einstellung für Ihre Anwendung abändern möchten, melden Sie sich unter www.facebook.com mit Ihrem Facebook-Account an, den Sie bei „Facebook Code generieren“ benutzt haben.

Gehen Sie danach auf: Privatsphären-Einstellungen.


 
Wählen Sie unter „Werbeanzeigen, Anwendungen und Webseiten“ -> Einstellungen bearbeiten aus.


 
Hier werden Ihnen alle registrierten Anwendungen angezeigt. Wählen Sie „Einstellungen bearbeiten“ aus.

Wählen Sie danach die gewünschte Applikation aus:


 
Wählen Sie die gewünschte Privatsphäre unter „Beiträge in deinem Namen“ aus.

Klicken Sie auf das „Kreuz“, um das Fenster zu schließen.

Durch die Änderung der Privatsphäre müssen Sie keinen neuen Autorisierungs-Token erstellen (d.h. keinen neuen Facebook Code generieren).