Mit dieser Erweiterung möchten wir eine Lücke in der Social Media Integration von TYPO3 schließen. Unser Ziel ist es, eine einfache und zeitsparende Möglichkeit der Integration und Interaktion mit gängigen Social Media Plattformen anzubieten. Unser Angebot mag nicht perfekt sein, aber wir arbeiten daran, diese Erweiterung so komfortabel wie möglich zu gestalten. Dazu brauchen wir Dein Feedback. Wenn Dir also etwas fehlt oder Du etwas anmerken möchtest, schreib einfach eine E-Mail an pb_social@plusb.de.
pb_social kann Feeds aus Social Media Netzwerken so anzeigen, wie Du es möchtest. Vielleicht willst Du Deine Facebook-Seiteninhalte auf Deiner TYPO3 Website darstellen? Kein Problem, richte Deine Facebook-Credentials und Facebook-UserId ein und schon ist pb_social startklar. Knifflige Authentifizierungsprozesse erledigt die TYPO3 Extension pb_social für Dich.
Manchmal musst Du einem Link folgen, um Zugangscodes für unser Plugin zu generieren, da die meisten sozialen Netzwerke OAuth2-Authentifizierung verwenden. Wir versichern, dass wir keinen Zugang zu Euren sensiblen Daten haben.
Wenn Du den Code der Extension nicht änderst, wird alles von der pb_social-Erweiterung in Deiner TYPO3-Datenbank und in Deinem TYPO3-Dateisystem gespeichert!
Mehr über OAuth erfährst Du hier.
Installiere die Erweiterung über [Composer](https://getcomposer.org/ „Mehr über composer erfahren“). In Deinem Composer-basierten TYPO3-Projektstamm den Befehl composer req plusb/pb_socialausführen.Die aktuelle Version hat ein Problem mit Composer. [View Issue].
Lade die Erweiterung herunter und installiere sie mit dem Erweiterungsmanager-Modul.
1. Gib alle verfügbaren Social Media-Kontendaten in die entsprechenden Eingabefelder ein. Wenn Du in diesem Bereich neu bist oder die Daten nicht hast, geben die folgenden Links eine grundlegende Orientierung, wo die Zugangsdaten generiert/erhalten werden können.
Möglicherweise müssen spezielle Berechtigungen erteilt und Benutzer zu Deiner Anwendung hinzufügt werden.
Alle Details sollten auf den obigen Seiten dokumentiert werden. Wenn Du auf Schwierigkeiten stoßen solltest, lies den Abschnitt FAQ oder kontaktiere uns unter pb_social@plusb.de. Mit der Version 1.2.7 kannst Du tx_news Beiträge in den Feed integrieren. Es ist möglich, Nachrichten nach Kategorien anzuzeigen. Das Plugin benötigt ein News-Plugin, um Detailansichtslinks zu generieren. Stelle sicher, dass tx_news installiert ist, läuft und Du einige Neuigkeiten anzeigen kannst.
Wenn der folgende Fehler im PHP-Fehlerprotokoll erscheint: „Fehler: SSL-Zertifikatsproblem: Lokales Ausstellerzertifikat kann nicht abgerufen werden“, geschieht dies aufgrund einer veralteten Root-Zertifizierungsstellen-Datei (cacert.pem).
Links für weitere Details:
Füge eine gültige cacert.pem-Datei zum php-Stammverzeichnis hinzu und ergänze folgende Zeile in dieser Datei php.ini`curl.cainfo="PATH TO\php\cacert.pem.
Für eine „quick and dirty“ Lösung haben wir in die Erweiterungskonfiguration ein Kontrollkästchen integriert, das die SSL-Verifizierung für alle pb_social-Anfragen deaktiviert. ACHTUNG: Die Aktivierung dieses Kontrollkästchens kann ein mögliches Sicherheitsrisiko darstellen!
Zum Testen kann der einzelne Befehl: ./typo3/cli_dispatch.phpsh extbase pbsocial:updatefeeddata oder ./vendor/bin/typo3 pb_social:pbsocial:updatefeeddata über die Kommandozeile ausgeführt werden.
Bei Problemen: typo3temp/var/logs/typo3_pb_social_*.log oder Syslog (SYSTEM/Log im TYPO3 Backend) überprüfen. Stelle sicher, dass die `$GLOBALS[‚TYPO3_CONF_VARS‘][‚SYS‘][’systemLogLevel‘]` in LocalConfiguration.php auf 0 gesetzt wurde, um Probleme und Erfolge zu sehen. Nicht vergessen: systemLogLevel im Produktivmodus auf einen höheren Wert zurückzusetzen.
https://developers.facebook.com/apps pb_social verwendet Facebook SDK für PHP v5.0.0.0 – dieses passt zu Facebook Api v3.2 (nicht v3.3).
Für das App Review Team benötigst Du ein TYPO3 Backend, um die Ausgabe zeigen zu können. Facebook benötigt dazu ebenso Zugriff auf die pb_social Plugin-Einstellungen. Bitte reiche eine TYPO3 Backend URL, einen Backend-User und das Passwort ein.
Du benötigst einen Screencast Deines Backends, der zeigt, wie Du auf form BE login klickst, um das Plugin auf der Registerkarte „facebook“ zu bearbeiten (stelle sicher, dass sie keine anderen Dinge in Deinem Backend tun können).
Gib folgenden Hinweis im Textfeld an:
Beispiel: Facebook-Search-ID get(‚/Typo3campBerlin/feed‘) oder get(‚/Typo3campBerlin/post‘) und die Reaktionen werden in regelmäßigen Abständen abgefragt. Diese Daten stammen nicht von unserer Seite, sondern werden mit der Such-ID von Facebook abgerufen.
Folgende Daten werden abgefragt: id,link,message,picture.
Der Typo3-Administrator installiert die TYPO3-Erweiterung pb_social, regisistriert diese Erweiterung als App in den Facebook Developer Tools (developers.facebook.com) und fügt die Facebook-Applikations-ID und das Facebook-App-Secret zu TYPO3 hinzu. Dann nennt er eine Facebook-Such-ID wie z.B. „Typo3campBerlin“ und wählt, ob die Beiträge oder Feeds geladen werden sollen. Auf der Startseite seiner Website werden die Artikel aus „Typo3campBerlin“ angezeigt: id,link,message,picture.
Eine Anmeldung bei Facebook findet nicht statt, es wird nur ein Access-Token generiert.
Diese Typo3-Erweiterung pb_social hat > 12.000 Downloads: https://extensions.typo3.org/extension/pb_social/
Anstatt eine Geschichte zu schreiben, kannst Du versuchen, einfach URL, BE-Benutzer und Passwort anzugeben.
Nach ein paar Tagen (2 Stunden war unser schnellster Versuch) werden dann die benötigen Rechte freigeschaltet.
Bitte setze nun den Status der Facebook-App unter (https://developers.facebook.com/apps) App Review auf „on“ in der oberen Menüzeile.
Generell: Ja! Wir gehen bei diesen Anpassungen von einem fundierten Wissen über TYPO3 aus.
In den TypoScript-Contants kann `plugin.tx_pbsocial.settings.facebook.requestParameterList` konfiguriert werden. Du kannst einen Parameter hinzufügen, indem Du „addToList()“ im TypoScript Setup verwendest, z.B.: plugin.tx_pbsocial.settings.facebook.requestParameterList := addToList(status_type).
Wenn TypoScript-Appending für Dich nicht funktionieren, kopiere die Standardzeichenfolge und füge die Parameter nach dieser Zeichenfolge durch klare Kommatrennung an. (Aber `addToList()`oben ist der coolste Weg, es zu tun). picture,comments.summary(total_count).limit(0).as(comments),created_time,full_picture,reactions.summary(total_count).limit(0).as(reactions),reactions.type(NONE).summary(total_count).limit(0).as(none),reactions.type(LIKE).summary(total_count).limit(0).as(like),reactions.type(LOVE).summary(total_count).limit(0).as(love),reactions.type(WOW).summary(total_count).limit(0).as(wow),reactions.type(HAHA).summary(total_count).limit(0).as(haha),reactions.type(SAD).summary(total_count).limit(0).as(sad),reactions.type(ANGRY).summary(total_count).limit(0).as(angry),reactions.type(THANKFUL).summary(total_count).limit(0).as(thankful) Wenn Du „Kommentare“ und „Reaktionen“ verwenden möchtest, müssen diese unter https://developers.facebook.com/apps „App Review“ (siehe oben) „user_likes“ angefordert werden.
Wichtig: „id“, „link“ und „message“ sind in der Liste php-weitig immer vorangestellt (also nicht wiederholen) und daher nicht in der obigen TypoScript-Konstanten-Zeichenkette zu finden.
Eigenen Parameter gemäß https://developers.facebook.com/docs/workplace/integrations/custom-integrations/reference/ aufrufen.
Bitte denke daran, auch das Extension Fluid-Template Partials\Feed\Provider-facebook.html zu ändern! Dein Anfrageparameter wird nur angezeigt, wenn Du ihn dort unten notierst:
Zum Anzeigen von Werten immer voranstellen „feed.raw“: {feed.raw.my_facebook_parameter_i_desire} z.B. {feed.raw.status_type}.
Um eine Fluid-Template zu ändern, kopiere dieses bitte in einen eigenen Konfigurationsbereich, damit da nach einem Update nichts überschrieben wird: Lies dazu auch: Extrabase-Erweiterung erweitern.
Instagram-Code: instagram.client.access_code Instagram-Code: Rufe den Code mit der folgenden URL ab (alle Zeichen nach „code“):
https://api.instagram.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=public_content
Instagram Access Token: instagram.client.access_token Rufe den Zugriffstoken mit der folgenden URL ab (alle Zeichen nach dem „Token“):
https://api.instagram.com/oauth/authorize/?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=token
Bemerkung: Es muss „Disable implicit OAuth“ bei Instagram aktiviert sein, um die Client-Webkonsole zu verwalten.
https://www.linkedin.com/developer/apps
Access Token: linkedin.access_token
Um LinkedIn Firmenbeiträge anzuzeigen, musst Du ein Administrator des Firmenprofils auf Linkedin sein. Im Entwickler-Backend müssen die Berechtigungen „r_basicprofile“ und „rw_company_admin“ festlegt werden.
Nachdem die Berechtigungen eingerichtet sind, fahre mit folgenden Schritten 1 bis 3 dieses Handbuchs fort: https://developer.linkedin.com/docs/oauth2 (wie üblich kann die Redirect-URL eine beliebige URL sein, da du nur die angegebenen Codes benötigst). Es ist wichtig, den in Schritt 2 erhaltenen Autorisierungscode sehr schnell gegen ein Zugriffstoken auszutauschen, da diese Codes nach ca. 20 Sekunden ablaufen. Tools wie Postman können dafür nützlich sein, sind aber nicht notwendig.
https://developers.pinterest.com/apps/
Instagram hat sein Zugriffstoken-Verfahren geändert. Anscheinend wird eine eingeloggte Browsersitzung benötigt, um das Zugriffstoken zu erhalten. Die automatische Generierung durch unseren Code wird also nicht mehr funktionieren. Um den Token zu erhalten, logge Dich bitte in Dein Instagram ein und lies die Informationen unter [instagram developer information](http://instagram.com/developer/clients/manage/).
Bitte beachte, für diese Zeit „Disable implicit OAuth:“ zu aktivieren (bitte nach erfolgreicher Durchführung deaktivieren).
Nachdem Du das Zugriffstoken erhalten hast, gib diese Zeichenkette in die Konfiguration der `pb_scoialen Erweiterung` im Tab `“Instagram“` / `“Instagram Zugriffstoken“` ein und klicke auf „Speichern“.