doc/de/Installing-Connectors.md

   1 Konnektoren installieren (Facebook/Twitter/StatusNet)
   2 ==================================================
   3
   4 * [Zur Startseite der Hilfe](help)
   5
   6 Friendica nutzt Plugins, um die Verbindung zu anderen Netzwerken wie Facebook und Twitter zu gewährleisten.
   7
   8 Es gibt außerdem ein Plugin, um über einen bestehenden Status.Net-Account diesen Service zu nutzen. Du brauchst dieses Plugin aber nicht, um mit Status.Net-Mitgliedern von Friendica aus zu kommunizieren - es sei denn, du wünschst es, über einen existierenden Account einen Beitrag zu schreiben.
   9
  10 Alle drei Plugins benötigen einen Account im gewünschten Netzwerk. 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.
  11
  12
  13 **Seitenkonfiguration**
  14
  15 Plugins müssen vom Administrator installiert werden, bevor sie genutzt werden können. Dieses kann über das Administrationsmenü erstellt werden.
  16
  17 Jeder der Konnektoren benötigt zudem einen API-Schlüssel vom Service, der verbunden werden soll. Einige Plugins erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei ".htconfig.php" erfordern. Der Weg, um diese Schlüssel zu erhalten, variiert stark, jedoch brauchen fast alle einen bestehenden Account im gewünschten Service. Einmal installiert, können diese Schlüssel von allen Seitennutzern genutzt werden.
  18
  19 Im Folgenden findest du die Einstellungen für die verschiedenen Services (viele dieser Informationen kommen direkt aus den Quelldateien der Plugins):
  20
  21
  22 **Twitter Plugin für Friendica**
  23
  24 * Author: Tobias Diekershoff
  25 * tobias.diekershoff@gmx.net
  26
  27 * License:3-clause BSD license
  28
  29 Konfiguration:
  30 Um dieses Plugin 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
  31
  32 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.
  33
  34 Trage dieses Schlüsselpaar in deine globale ".htconfig.php"-Datei ein.
  35
  36 ```
  37 $a->config['twitter']['consumerkey'] = 'your consumer_key here';
  38 $a->config['twitter']['consumersecret'] = 'your consumer_secret here';
  39 ```
  40
  41 Anschließend kann der Nutzer deiner Seite die Twitter-Einstellungen selbst eintragen: "Einstellungen -> Connector Einstellungen".
  42
  43 Dokumentation: http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/Twitter_Plugin
  44
  45
  46 **StatusNet Plugin für Friendica**
  47
  48 * Author: Tobias Diekershoff
  49 * tobias.diekershoff@gmx.net
  50
  51 * License:3-clause BSD license
  52
  53 Konfiguration
  54
  55 Wenn das Addon aktiv ist, muss der Nutzer die folgenden Einstellungen vornehmen, um sich mit dem StatusNet-Account seiner Wahl zu verbinden.
  56
  57 * Die Basis-URL des StatusNet-API; für identi.ca ist es https://identi.ca/api/
  58 * OAuth Consumer key & Geheimnis
  59
  60 Um das OAuth-Schlüsselpaar zu erhalten, muss der Nutzer
  61
  62 (a) seinen Friendica-Admin fragen, ob bereits ein Schlüsselpaar existiert oder
  63 (b) einen Friendica-Server als Anwendung auf dem StatusNet-Server anmelden.
  64
  65 Dies kann über Einstellungen --> Connections --> "Register an OAuth client application" -> "Register a new application" auf dem StatusNet-Server durchgeführt werden.
  66
  67 Während der Registrierung des OAuth-Clients ist Folgendes zu beachten:
  68
  69 * Der Anwendungsname muss auf der StatusNet-Seite einzigartig sein, daher empfehlen wir einen Namen wie "friendica-nnnn", ersetze dabei "nnnn" mit einer frei gewählten Nummer oder deinem Webseitennamen.
  70 * es gibt keine Callback-URL
  71 * Registriere einen Desktop-Client
  72 * stelle Lese- und Schreibrechte ein
  73 * die Quell-URL sollte die URL deines Friendica-Servers sein
  74
  75 Sobald die benötigten Daten gespeichert sind, musst du deinen Friendica-Account mit StatusNet verbinden. Das kannst du über Einstellungen --> Connector-Einstellungen durchführen. Folge dem "Einloggen mit StatusNet"-Button, erlaube den Zugriff und kopiere den Sicherheitscode in die entsprechende Box. Friendica wird dann versuchen, die abschließende OAuth-Einstellungen über die API zu beziehen.
  76
  77 Wenn es geklappt hat, kannst du in den Einstellungen festlegen, ob deine öffentlichen Nachrichten automatisch in deinem StatusNet-Account erscheinen soll (achte hierbei auf das kleine Schloss-Symbol im Status-Editor)
  78
  79 Dokumentation: http://diekershoff.homeunix.net/redmine/wiki/friendikaplugin/StatusNet_Plugin
  80
  81
  82 **Installiere den Friendica/Facebook-Konnektor**
  83
  84 * Registriere einen API-Schlüssel für deine Seite auf [developer.facebook.com](Facebook).
  85
  86 Hierfür benötigst du einen Facebook-Account und ggf. weitere Authentifizierungen über eine Kreditkarten- oder Mobilfunknummer.
  87
  88 a. Wir würden uns sehr darüber freuen, wenn du "Friendica" in dem Anwendungsnamen eintragen würdest, um die Bekanntheit des Namens zu erhöhen. Das Friendica-Icon ist im Bildverzeichnis enthalten und kann als Anwendungs-Icon für die Facebook-App genutzt werden. Nutze [images/friendica-16.jpg](images/friendica-16.jpg) für das Icon und [images/friendica-128.jpg](images/friendica-128.jpg) für das Logo.
  89
  90 b. Die URL sollte deine Seite mit dem abschließenden Schrägstrich sein
  91
  92 Es **kann** notwendig sein, dass du eine "Privacy"- oder "Terms of service"-URL angeben musst.
  93
  94 c. Setze nun noch unter "App Domains" die URL auf deineSubdomain.deineDomain.de und bei "Website with Facebook Login" die URL zu deineDomain.de.
  95
  96 d. Installiere nun das Facebook-Plugin auf deiner Friendica-Seite über "admin/plugins". Du solltest links in der Sidebar einen Facebook-Link unter "Plugin Features" finden. Klicke diesen an.
  97
  98 e. Gib nun die App-ID und das App-Secret ein, die Facebook dir gegeben hat. Ändere die anderen Daten, wie es gewünscht ist.
  99
 100 Auf Friendica kann nun jeder Nutzer, der eine Verbindung zu Facebook wünscht, die Seite "Einstellungen -> Connector-Einstellungen" aufrufen und dort "Installiere Facebook-Connector" auswählen.
 101
 102 Wähle die gewünschten Einstellungen für deine Nutzungs- und Privatsphäreansprüche.
 103
 104 Hier meldest du dich bei Facebook an und gibst dem Plugin die nötigen Zugriffsrechte, um richtig zu funktionieren. Erlaube dieses.
 105
 106 Und fertig. Um es abzustellen, gehe wieder auf die Einstellungsseite und auf "Remove Facebook posting".
 107
 108 Videos und eingebetteter Code werden nicht gepostet, wenn sonst kein anderer Inhalt enthalten ist. Links und Bilder werden in ein Format übertragen, das von der Facebook-API verstanden wird. Lange Texte werden verkürzt und mit einem Link zum Originalbeitrag versehen.
 109
 110 Facebook-Kontakte können außerdem keine privaten Fotos sehen, da diese nicht richtig authentifiziert werden können, wenn sie deine Seite besuchen. Dieser Fehler wird zukünftig bearbeitet.