Knowledgebase:SocialSharing

From Cloudrexx Development Wiki
Jump to: navigation, search

Grundfunktionalität des Modules

Das Modul dient dazu neu erstellte Einträge auf sozialen Netzwerken zu teilen.

Dieses Modul ist noch nicht veröffentlicht!

Unterstützte Module

  • News-Modul
  • Jobs-Modul

Inhalte die geteilt werden

Auf den Plattformen werden jeweils ein Titel, ein Bild und ein Link geteilt. Diese Inhalte werden je nach Modul anders ausgelesen.

Zusammenstellung der Inhalte

News-Modul

Die Inhalte werden aus dem eben erstellten News-Eintrag ausgelesen.

  • Titel: Titel der Newsmeldung
  • Bild: Headline-Bild oder das erste Bild im Inhalt. Keines, wenn beiden Orten keines vorhanden
  • Link: Die Weiterleitung der Newsmeldung oder dynamisch generierter Link zur Detailansicht des Eintrages

Jobs-Modul

Die Inhalte werden aus dem eben erstellten Jobs-Eintrag ausgelesen.

  • Titel: Titel des Jobinserates
  • Bild: Erstes Bild in der Stellenbeschreibung. Keines, wenn keines vorhanden.
  • Link: Dynamisch generierter Link zur Detailansicht des Eintrages

Konfiguration des Modules

Das Modul kann im Backend unter "Administration->Social Sharing" verwaltet werden. Hier werden die Zugangsdaten zu den benötigten Apps der Sozialen Netzwerke hinterlegt. Diese werden benötigt um mit den sozialen Netzwerken zu kommunizieren. Wie man eine solche App erstell wird unter Apps erstellen und konfigurieren erklärt.

Apps erstellen und konfigurieren

Eine Plattform in nur 10 Schritten konfigurieren‏:

Facebook

  1. Loggen Sie sich mit dem Account ein, auf welchem Sie die Inhalte teilen möchten. Dies ist wichtig, da die App an den Benutzer gebunden ist.
  2. Gehen Sie auf https://developers.facebook.com/
  3. Wählen Sie "Apps -> Eine neue App erstellen" und geben Sie die geforderten Informationen an.
  4. Wenn Sie nun die App verwalten, sehen Sie unter "Konsole" die "App-ID" und "Anwendungs-Geheimcode". Kopieren Sie diese und tragen Sie diese in den Einstellungen des Social Sharing Modules unter "Anwendungs-Id" und "Anwendungs-Secret" ein und speichern Sie die Einstellungen.
  5. Gehen Sie zurück zur Verwaltung Ihrer App in den Menupunkt "Einstellungen".
  6. Geben Sie unter "App Domains" die Domain Ihrer Webseite an.
  7. Geben Sie unter "Deine E-Mail-Adresse" Ihre E-Mail-Adresse an.
  8. Klicken Sie auf "+ Plattform hinzufügen" und wählen Sie "Webseite".
  9. Geben Sie bei "Site URL" und "Mobile Site URL" jeweils den URL-Pfad zum Contrexx Backend Ihrer Installation an. ZB. http://meinedomain.ch/cadmin/
  10. Gehen Sie unter den Menupunkt "Status & Review" und schalten Sie die App auf publik.

Nun können Sie über Contrexx die neuen Inhalte auf Facebook teilen.

Twitter

  1. Gehen Sie auf https://apps.twitter.com/
  2. Loggen Sie sich mit dem Account ein, auf welchem Sie die Inhalte teilen möchten. Dies ist wichtig, da die App an den Benutzer gebunden ist.
  3. Wählen Sie "Create New App" und geben Sie Name und Beschreibung der App ein
  4. Geben Sie unter "Website" die URL Ihrer Webseite an. ZB. http://meinedomain.ch/
  5. Geben Sie unter "Callback URL" den URL-Pfad zum Contrexx Backend Ihrer Installation an. ZB. http://meinedomain.ch/cadmin/
  6. Bestätigen Sie die "Developer Rules of the Road" und erstellen Sie die App
  7. Gehen Sie in der Verwaltung Ihrer App unter "API Key".
  8. Tragen Sie den dort aufgelisteten "API key" und den "API secret" in den Einstellungen des Social Sharing Modules unter "Anwendungs-Key" und "Anwendungs-Secret" ein.
  9. Gehen Sie in die Einstellungen der App zurück und öffnen Sie den Menupunkt "Permissions".
  10. Geben Sie der App die Rechte für "Read and Write". Fals Ihnen dies nicht möglich ist, weil Sie in Ihrem Profiel keine Mobilnummer hinterlegen können, können Sie den Twitter-Support unter https://support.twitter.com/forms/profile kontaktieren. Dieser wird Ihnen gerne die nötigen Berechtigungen erteilen.

Nun können Sie über Contrexx die neuen Inhalte auf Twitter teilen.

Vorgang des Teilens

Sobald in den Einstellungen mindestens eine Plattform konfiguriert ist, wird sich beim Erfassen eines neuen Eintrages in einem unterstützen Modul ein Popup öffnen. In diesem Popup können die Plattformen ausgewählt werden, auf welchen das Modul die Neuigkeit teilen soll. Wenn Sie den Inhalt nicht teilen möchten, wählen Sie keine Plattform aus.