doc/de/Installing-Connectors.md

   1 Konnektoren installieren (Twitter/GNU Social)
   2 ==================================================
   3
   4 * [Zur Startseite der Hilfe](help)
   5
   6 Friendica nutzt Erweiterung, um die Verbindung zu anderen Netzwerken wie Twitter oder App.net zu gewährleisten.
   7
   8 Es gibt außerdem ein Erweiterung, um über einen bestehenden GNU Social-Account diesen Service zu nutzen.
   9 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.
  10
  11 Alle drei Erweiterung benötigen einen Account im gewünschten Netzwerk.
  12 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.
  13
  14
  15 **Seitenkonfiguration**
  16
  17 Erweiterung müssen vom Administrator installiert werden, bevor sie genutzt werden können.
  18 Dieses kann über das Administrationsmenü erstellt werden.
  19
  20 Jeder der Konnektoren benötigt zudem einen API-Schlüssel vom Service, der verbunden werden soll.
  21 Einige Erweiterung erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei "config/local.ini.php" erfordern.
  22 Der Weg, um diese Schlüssel zu erhalten, variiert stark, jedoch brauchen fast alle einen bestehenden Account im gewünschten Service.
  23 Einmal installiert, können diese Schlüssel von allen Seitennutzern genutzt werden.
  24
  25 Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Erweiterung):
  26
  27
  28 **Twitter Erweiterung für Friendica**
  29
  30 * Author: Tobias Diekershoff
  31 * tobias.diekershoff@gmx.net
  32
  33 * License:3-clause BSD license
  34
  35 Konfiguration:
  36 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
  37
  38 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.
  39
  40 Trage dieses Schlüsselpaar in deine globale "config/local.ini.php"-Datei ein.
  41
  42 ```
  43 [twitter]
  44 consumerkey = your consumer_key here
  45 consumersecret = your consumer_secret here
  46 ```
  47
  48 Anschließend kann der Nutzer deiner Seite die Twitter-Einstellungen selbst eintragen: "Einstellungen -> Connector Einstellungen".
  49
  50
  51 **GNU Social Erweiterung für Friendica**
  52
  53 * Author: Tobias Diekershoff
  54 * tobias.diekershoff@gmx.net
  55
  56 * License:3-clause BSD license
  57
  58 Konfiguration
  59
  60 Wenn das Addon aktiv ist, muss der Nutzer die folgenden Einstellungen vornehmen, um sich mit dem GNU Social-Account seiner Wahl zu verbinden.
  61
  62 * Die Basis-URL des GNU Social-API; für quitter.se ist es https://quitter.se/api/
  63 * OAuth Consumer key & Geheimnis
  64
  65 Um das OAuth-Schlüsselpaar zu erhalten, muss der Nutzer
  66
  67 (a) seinen Friendica-Admin fragen, ob bereits ein Schlüsselpaar existiert oder
  68 (b) einen Friendica-Server als Anwendung auf dem GNU Social-Server anmelden.
  69
  70 Dies kann über Einstellungen --> Connections --> "Register an OAuth client application" -> "Register a new application" auf dem GNU Social-Server durchgeführt werden.
  71
  72 Während der Registrierung des OAuth-Clients ist Folgendes zu beachten:
  73
  74 * 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.
  75 * es gibt keine Callback-URL
  76 * Registriere einen Desktop-Client
  77 * stelle Lese- und Schreibrechte ein
  78 * die Quell-URL sollte die URL deines Friendica-Servers sein
  79
  80 Sobald die benötigten Daten gespeichert sind, musst du deinen Friendica-Account mit GNU Social verbinden.
  81 Das kannst du über Einstellungen --> Connector-Einstellungen durchführen.
  82 Folge dem "Einloggen mit GNU Social"-Button, erlaube den Zugriff und kopiere den Sicherheitscode in die entsprechende Box.
  83 Friendica wird dann versuchen, die abschließende OAuth-Einstellungen über die API zu beziehen.
  84
  85 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)