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.
   9 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.
  10
  11 Alle drei Plugins 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 Plugins 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 Plugins erlaube es, diese Informationen auf den Administrationsseiten einzustellen, wohingegen andere eine direkte Bearbeitung der Konfigurationsdatei ".htconfig.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 Plugins):
  26
  27
  28 **Twitter Plugin 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 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
  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 ".htconfig.php"-Datei ein.
  41
  42 ```
  43 $a->config['twitter']['consumerkey'] = 'your consumer_key here';
  44 $a->config['twitter']['consumersecret'] = 'your consumer_secret here';
  45 ```
  46
  47 Anschließend kann der Nutzer deiner Seite die Twitter-Einstellungen selbst eintragen: "Einstellungen -> Connector Einstellungen".
  48
  49
  50 **StatusNet Plugin für Friendica**
  51
  52 * Author: Tobias Diekershoff
  53 * tobias.diekershoff@gmx.net
  54
  55 * License:3-clause BSD license
  56
  57 Konfiguration
  58
  59 Wenn das Addon aktiv ist, muss der Nutzer die folgenden Einstellungen vornehmen, um sich mit dem StatusNet-Account seiner Wahl zu verbinden.
  60
  61 * Die Basis-URL des StatusNet-API; für identi.ca ist es https://identi.ca/api/
  62 * OAuth Consumer key & Geheimnis
  63
  64 Um das OAuth-Schlüsselpaar zu erhalten, muss der Nutzer
  65
  66 (a) seinen Friendica-Admin fragen, ob bereits ein Schlüsselpaar existiert oder
  67 (b) einen Friendica-Server als Anwendung auf dem StatusNet-Server anmelden.
  68
  69 Dies kann über Einstellungen --> Connections --> "Register an OAuth client application" -> "Register a new application" auf dem StatusNet-Server durchgeführt werden.
  70
  71 Während der Registrierung des OAuth-Clients ist Folgendes zu beachten:
  72
  73 * 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.
  74 * es gibt keine Callback-URL
  75 * Registriere einen Desktop-Client
  76 * stelle Lese- und Schreibrechte ein
  77 * die Quell-URL sollte die URL deines Friendica-Servers sein
  78
  79 Sobald die benötigten Daten gespeichert sind, musst du deinen Friendica-Account mit StatusNet verbinden.
  80 Das kannst du über Einstellungen --> Connector-Einstellungen durchführen.
  81 Folge dem "Einloggen mit StatusNet"-Button, erlaube den Zugriff und kopiere den Sicherheitscode in die entsprechende Box.
  82 Friendica wird dann versuchen, die abschließende OAuth-Einstellungen über die API zu beziehen.
  83
  84 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)
  85
  86
  87 **Installiere den Friendica/Facebook-Konnektor**
  88
  89 * Registriere einen API-Schlüssel für deine Seite auf [developer.facebook.com](Facebook).
  90
  91 Hierfür benötigst du einen Facebook-Account und ggf. weitere Authentifizierungen über eine Kreditkarten- oder Mobilfunknummer.
  92
  93 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.
  94
  95 b. Die URL sollte deine Seite mit dem abschließenden Schrägstrich sein
  96
  97 Es **kann** notwendig sein, dass du eine "Privacy"- oder "Terms of service"-URL angeben musst.
  98
  99 c. Setze nun noch unter "App Domains" die URL auf deineSubdomain.deineDomain.de und bei "Website with Facebook Login" die URL zu deineDomain.de.
 100
 101 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.
 102
 103 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.
 104
 105 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.
 106
 107 Wähle die gewünschten Einstellungen für deine Nutzungs- und Privatsphäreansprüche.
 108
 109 Hier meldest du dich bei Facebook an und gibst dem Plugin die nötigen Zugriffsrechte, um richtig zu funktionieren.
 110 Erlaube dieses.
 111
 112 Und fertig. Um es abzustellen, gehe wieder auf die Einstellungsseite und auf "Remove Facebook posting".
 113
 114 Videos und eingebetteter Code werden nicht gepostet, wenn sonst kein anderer Inhalt enthalten ist.
 115 Links und Bilder werden in ein Format übertragen, das von der Facebook-API verstanden wird.
 116 Lange Texte werden verkürzt und mit einem Link zum Originalbeitrag versehen.
 117
 118 Facebook-Kontakte können außerdem keine privaten Fotos sehen, da diese nicht richtig authentifiziert werden können, wenn sie deine Seite besuchen.
 119 Dieser Fehler wird zukünftig bearbeitet.