Friendica Communications Platform (please note that this is a clone of the repository at github, issues are handled there) https://friendi.ca
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

85 lines
4.3 KiB

  1. Konnektoren installieren (Twitter/GNU Social)
  2. ==================================================
  3. * [Zur Startseite der Hilfe](help)
  4. Friendica nutzt Erweiterung, um die Verbindung zu anderen Netzwerken wie Twitter oder App.net zu gewährleisten.
  5. Es gibt außerdem ein Erweiterung, um über einen bestehenden GNU Social-Account diesen Service zu nutzen.
  6. Du brauchst dieses Erweiterung aber nicht, um mit GNU Social-Mitgliedern von Friendica aus zu kommunizieren - es sei denn, du wünschst es, über einen existierenden Account einen Beitrag zu schreiben.
  7. Alle drei Erweiterung benötigen einen Account im gewünschten Netzwerk.
  8. Zusätzlich musst du (bzw. der Administrator der Seite) einen API-Schlüssel holen, um einen authentifizierten Zugriff zu deinem Friendica-Server herstellen zu lassen.
  9. **Seitenkonfiguration**
  10. Erweiterung müssen vom Administrator installiert werden, bevor sie genutzt werden können.
  11. Dieses kann über das Administrationsmenü erstellt werden.
  12. Jeder der Konnektoren benötigt zudem einen API-Schlüssel vom Service, der verbunden werden soll.
  13. Einige Erweiterung erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei "config/local.config.php" erfordern.
  14. Der Weg, um diese Schlüssel zu erhalten, variiert stark, jedoch brauchen fast alle einen bestehenden Account im gewünschten Service.
  15. Einmal installiert, können diese Schlüssel von allen Seitennutzern genutzt werden.
  16. Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Erweiterung):
  17. **Twitter Erweiterung für Friendica**
  18. * Author: Tobias Diekershoff
  19. * tobias.diekershoff@gmx.net
  20. * License:3-clause BSD license
  21. Konfiguration:
  22. Um dieses Erweiterung zu nutzen, benötigst du einen OAuth Consumer-Schlüsselpaar (Schlüssel und Geheimnis), das du auf der Seite [https://twitter.com/apps](https://twitter.com/apps) erhalten kannst
  23. Registriere deine Friendica-Seite als "Client"-Anwendung mit "Read&Write"-Zugriff. Wir benötigen "Twitter als Login" nicht. Sobald du deine Anwendung installiert hast, erhältst du das Schlüsselpaar für deine Seite.
  24. Trage dieses Schlüsselpaar in deine globale "config/local.config.php"-Datei ein.
  25. ```
  26. [twitter]
  27. consumerkey = your consumer_key here
  28. consumersecret = your consumer_secret here
  29. ```
  30. Anschließend kann der Nutzer deiner Seite die Twitter-Einstellungen selbst eintragen: "Einstellungen -> Connector Einstellungen".
  31. **GNU Social Erweiterung für Friendica**
  32. * Author: Tobias Diekershoff
  33. * tobias.diekershoff@gmx.net
  34. * License:3-clause BSD license
  35. Konfiguration
  36. Wenn das Addon aktiv ist, muss der Nutzer die folgenden Einstellungen vornehmen, um sich mit dem GNU Social-Account seiner Wahl zu verbinden.
  37. * Die Basis-URL des GNU Social-API; für quitter.se ist es https://quitter.se/api/
  38. * OAuth Consumer key & Geheimnis
  39. Um das OAuth-Schlüsselpaar zu erhalten, muss der Nutzer
  40. (a) seinen Friendica-Admin fragen, ob bereits ein Schlüsselpaar existiert oder
  41. (b) einen Friendica-Server als Anwendung auf dem GNU Social-Server anmelden.
  42. Dies kann über Einstellungen --> Connections --> "Register an OAuth client application" -> "Register a new application" auf dem GNU Social-Server durchgeführt werden.
  43. Während der Registrierung des OAuth-Clients ist Folgendes zu beachten:
  44. * Der Anwendungsname muss auf der GNU Social-Seite einzigartig sein, daher empfehlen wir einen Namen wie "friendica-nnnn", ersetze dabei "nnnn" mit einer frei gewählten Nummer oder deinem Webseitennamen.
  45. * es gibt keine Callback-URL
  46. * Registriere einen Desktop-Client
  47. * stelle Lese- und Schreibrechte ein
  48. * die Quell-URL sollte die URL deines Friendica-Servers sein
  49. Sobald die benötigten Daten gespeichert sind, musst du deinen Friendica-Account mit GNU Social verbinden.
  50. Das kannst du über Einstellungen --> Connector-Einstellungen durchführen.
  51. Folge dem "Einloggen mit GNU Social"-Button, erlaube den Zugriff und kopiere den Sicherheitscode in die entsprechende Box.
  52. Friendica wird dann versuchen, die abschließende OAuth-Einstellungen über die API zu beziehen.
  53. Wenn es geklappt hat, kannst du in den Einstellungen festlegen, ob deine öffentlichen Nachrichten automatisch in deinem GNU Social-Account erscheinen soll (achte hierbei auf das kleine Schloss-Symbol im Status-Editor)