doc/de/Settings.md

   1 # Settings
   2
   3 Wenn du der Administrator einer Friendica Instanz bist, hast du Zugriff auf das so genannte **Admin Panel** in dem du die Friendica Instanz konfigurieren kannst,
   4
   5 Auf der Startseite des Admin Panels werden die Informationen zu der Instanz zusammengefasst.
   6 Diese Informationen beinhalten die Anzahl der Nachrichten, die sich aktuell in den Warteschlangen befinden.
   7 Hierbei ist die erste Zahl die Zahl der Nachrichten die gerade aktiv verteilt werden.
   8 Diese Zahl sollte sich relativ schnell sinken.
   9 Die zweite Zahl gibt die Anzahl von Nachrichten an, die nicht zugestellt werden konnten.
  10 Die Zustellung wird zu einem späteren Zeitpunkt noch einmal versucht.
  11 Unter dem Punkt "Warteschlange Inspizieren" kannst du einen schnellen Blick auf die zweite Warteschlange werfen.
  12 Des weiteren findest du eine Übersicht über die Accounts auf dem Friendica Knoten, die unter dem Punkt "Nutzer" moderiert werden können.
  13 Sowie eine Liste der derzeit aktivierten Addons.
  14 Diese Liste ist verlinkt, so dass du schnellen Zugriff auf die Informationsseiten der einzelnen Addons hast.
  15 Abschließend findest du auf der Startseite des Admin Panels die installierte Version von Friendica.
  16 Wenn du in Kontakt mit den Entwicklern trittst und Probleme oder Fehler zu schildern, gib diese Version bitte immer mit an.
  17
  18 Die Unterabschnitte des Admin Panels kannst du in der Seitenleiste auswählen.
  19
  20 ## Seite
  21
  22 In diesem Bereich des Admin Panels findest du die Hauptkonfiguration deiner Friendica Instanz.
  23 Er ist in mehrere Unterabschnitte aufgeteilt, wobei die Grundeinstellungen oben auf der Seite zu finden sind.
  24
  25 Da die meisten Konfigurationsoptionen einen Hilfstext im Admin Panel haben, kann und will dieser Artikel nicht alle Einstellungen abdecken.
  26
  27 ### Grundeinstellungen
  28
  29 #### Banner/Logo
  30
  31 Hiermit legst du das Banner der Seite fest. Standardmäßig ist das Friendica-Logo und der Name festgelegt.
  32 Du kannst hierfür HTML/CSS nutzen, um den Inhalt zu gestalten und/oder die Position zu ändern, wenn es nicht bereits voreingestellt ist.
  33
  34 #### Systensprache
  35
  36 Diese Einstellung legt die Standardsprache der Instanz fest.
  37 Sie wird verwendet, wenn es Friendica nicht gelingt die Spracheinstellungen des Besuchers zu erkennen oder diese nicht unterstützt wird.
  38 Nutzer können diese Auswahl in den Einstellungen des Benutzerkontos überschreiben.
  39
  40 Die Friendica Gemeinschaft bietet einige Übersetzungen an, von denen einige mehr andere weniger komplett sind.
  41 Mehr Informationen zum Übersetzungsprozess von Friendica findest du [auf dieser Seite](/help/translations) der Dokumentation.
  42
  43 #### Systemweites Theme
  44
  45 Hier kann das Theme bestimmt werden, welches standardmäßig zum Anzeigen der Seite verwendet werden soll.
  46 Nutzer können in ihren Einstellungen andere Themes wählen.
  47 Derzeit ist das "duepunto zero" Theme das vorausgewählte Theme.
  48
  49 Für mobile Geräte kannst du ein spezielles Theme wählen, wenn das Standardtheme ungeeignet für mobile Geräte sein sollte.
  50 Das `vier` Theme z.B. unterstützt kleine Anzeigen und benötigt kein zusätzliches mobiles Theme.
  51
  52 ### Registrierung
  53
  54 #### Namen auf Vollständigkeit überprüfen
  55
  56 Es kann vorkommen, dass viele Spammer versuchen, sich auf deiner Seite zu registrieren.
  57 In Testphasen haben wir festgestellt, dass diese automatischen Registrierungen das Feld "Vollständiger Name" oft nur mit Namen ausfüllen, die kein Leerzeichen beinhalten.
  58 Wenn du Leuten erlauben willst, sich nur mit einem Namen anzumelden, dann setze die Einstellung auf "true".
  59 Die Standardeinstellung ist auf "false" gesetzt.
  60
  61 #### OpenID Unterstützung
  62
  63 Standardmäßig wird OpenID für die Registrierung und für Logins genutzt.
  64 Wenn du nicht willst, dass OpenID-Strukturen für dein System übernommen werden, dann setze "no_openid" auf "true".
  65 Standardmäßig ist hier "false" gesetzt.
  66
  67 #### Unterbinde Mehrfachregistrierung
  68
  69 Um mehrfache Seiten zu erstellen, muss sich eine Person mehrfach registrieren können.
  70 Deine Seiteneinstellung kann Registrierungen komplett blockieren oder an Bedingungen knüpfen.
  71 Standardmäßig können eingeloggte Nutzer weitere Accounts für die Seitenerstellung registrieren.
  72 Hier ist weiterhin eine Bestätigung notwendig, wenn "REGISTER_APPROVE" ausgewählt ist.
  73 Wenn du die Erstellung weiterer Accounts blockieren willst, dann setze die Einstellung "block_extended_register" auf "true".
  74 Standardmäßig ist hier "false" gesetzt.
  75
  76 ### Datei hochladen
  77
  78 #### Maximale Bildgröße
  79
  80 Maximale Bild-Dateigröße in Byte. Standardmäßig ist 0 gesetzt, was bedeutet, dass kein Limit gesetzt ist.
  81
  82 ### Regeln
  83
  84 #### URL des weltweiten Verzeichnisses
  85
  86 Mit diesem Befehl wird die URL eingestellt, die zum Update des globalen Verzeichnisses genutzt wird.
  87 Dieser Befehl ist in der Standardkonfiguration enthalten.
  88 Der nicht dokumentierte Teil dieser Einstellung ist, dass das globale Verzeichnis gar nicht verfügbar ist, wenn diese Einstellung nicht gesetzt wird.
  89 Dies erlaubt eine private Kommunikation, die komplett vom globalen Verzeichnis isoliert ist.
  90
  91 #### Erzwinge Veröffentlichung
  92
  93 Standardmäßig können Nutzer selbst auswählen, ob ihr Profil im Seitenverzeichnis erscheint.
  94 Diese Einstellung zwingt alle Nutzer dazu, im Verzeichnis zu erscheinen.
  95 Diese Einstellung kann vom Nutzer nicht deaktiviert werden. Die Standardeinstellung steht auf "false".
  96
  97 #### Öffentlichen Zugriff blockieren
  98
  99 Aktiviere diese Einstellung um den öffentlichen Zugriff auf alle Seiten zu sperren, solange man nicht eingeloggt ist.
 100 Das blockiert die Ansicht von Profilen, Freunden, Fotos, vom Verzeichnis und den Suchseiten.
 101 Ein Nebeneffekt ist, dass Einträge dieser Seite nicht im globalen Verzeichnis erscheinen.
 102 Wir empfehlen, speziell diese Einstellung auszuschalten (die Einstellung ist an anderer Stelle auf dieser Seite erklärt).
 103 Beachte: das ist speziell für Seiten, die beabsichtigen, von anderen Friendica-Netzwerken abgeschottet zu sein.
 104 Unautorisierte Personen haben ebenfalls nicht die Möglichkeit, Freundschaftsanfragen von Seitennutzern zu beantworten.
 105 Die Standardeinstellung ist deaktiviert.
 106 Verfügbar in Version 2.2 und höher.
 107
 108 #### Erlaubte Domains für Kontakte
 109
 110 Kommagetrennte Liste von Domains, welche eine Freundschaft mit dieser Seite eingehen dürfen.
 111 Wildcards werden akzeptiert (Wildcard-Unterstützung unter Windows benötigt PHP5.3) Standardmäßig sind alle gültigen Domains erlaubt.
 112
 113 Mit dieser Option kann man einfach geschlossene Netzwerke, z.B. im schulischen Bereich aufbauen, aus denen nicht mit dem Rest des Netzwerks kommuniziert werden soll.
 114
 115 #### Erlaubte Domains für E-Mails
 116
 117 Kommagetrennte Liste von Domains, welche bei der Registrierung als Part der Email-Adresse erlaubt sind.
 118 Das grenzt Leute aus, die nicht Teil der Gruppe oder Organisation sind.
 119 Wildcards werden akzeptiert (Wildcard-Unterstützung unter Windows benötigt PHP5.3) Standardmäßig sind alle gültigen Email-Adressen erlaubt.
 120
 121 #### Nutzern erlauben das remote_self Flag zu setzen
 122
 123 Webb du die Option `Nutzern erlauben das remote_self Flag zu setzen` aktivierst, können alle Nutzer Atom Feeds in den erweiterten Einstellungen des Kontakts als "Entferntes Konto" markieren.
 124 Dadurch werden automatisch alle Beiträge dieser Feeds für diesen Nutzer gespiegelt und an die Kontakte bei Friendica verteilt.
 125
 126 Als Administrator der Friendica Instanz kannst du diese Einstellungen ansonsten nur direkt in der Datenbank vornehmen.
 127 Bevor du das tust solltest du sicherstellen, dass du ein Backup der Datenbank hast und genau weißt was die Änderungen an der Datenbank bewirken, die du vornehmen willst.
 128
 129 ### Erweitert
 130
 131 #### Proxy Einstellungen
 132
 133 Wenn deine Seite eine Proxy-Einstellung nutzt, musst du diese Einstellungen vornehmen, um mit anderen Seiten im Internet zu kommunizieren.
 134
 135 #### Netzwerk Wartezeit
 136
 137 Legt fest, wie lange das Netzwerk warten soll, bevor ein Timeout eintritt.
 138 Der Wert wird in Sekunden angegeben. Standardmäßig ist 60 eingestellt; 0 steht für "unbegrenzt" (nicht empfohlen).
 139
 140 #### UTF-8 Reguläre Ausdrücke
 141
 142 Während der Registrierung werden die Namen daraufhin geprüft, ob sie reguläre UTF-8-Ausdrücke nutzen.
 143 Hierfür wird PHP benötigt, um mit einer speziellen Einstellung kompiliert zu werden, die UTF-8-Ausdrücke benutzt.
 144 Wenn du absolut keine Möglichkeit hast, Accounts zu registrieren, setze diesen Wert auf ja.
 145
 146 #### SSL Überprüfen
 147
 148 Standardmäßig erlaubt Friendica SSL-Kommunikation von Seiten, die "selbst unterzeichnete" SSL-Zertifikate nutzen.
 149 Um eine weitreichende Kompatibilität mit anderen Netzwerken und Browsern zu gewährleisten, empfehlen wir, selbst unterzeichnete Zertifikate **nicht** zu nutzen.
 150 Aber wir halten dich nicht davon ab, solche zu nutzen. SSL verschlüsselt alle Daten zwischen den Webseiten (und für deinen Browser), was dir eine komplett verschlüsselte Kommunikation erlaubt.
 151 Auch schützt es deine Login-Daten vor Datendiebstahl. Selbst unterzeichnete Zertifikate können kostenlos erstellt werden.
 152 Diese Zertifikate können allerdings Opfer eines sogenannten ["man-in-the-middle"-Angriffs](http://de.wikipedia.org/wiki/Man-in-the-middle-Angriff) werden, und sind daher weniger bevorzugt.
 153 Wenn du es wünscht, kannst du eine strikte Zertifikatabfrage einstellen.
 154 Das führt dazu, dass du keinerlei Verbindung zu einer selbst unterzeichneten SSL-Seite erstellen kannst
 155
 156 ### Automatisch ein Kontaktverzeichnis erstellen
 157
 158 ### Performance
 159
 160 ### Worker
 161
 162 ### Umsiedeln
 163
 164 ## Nutzer
 165
 166 In diesem Abschnitt des Admin Panels kannst du die Nutzer deiner Friendica Instanz moderieren.
 167
 168 Solltest du für **Registrierungsmethode** die Einstellung "Bedarf Zustimmung" gewählt haben, werden hier zu Beginn der Seite neue Registrationen aufgelistet.
 169 Als Administrator kannst du hier die Registration akzeptieren oder ablehnen.
 170
 171 Unter dem Abschnitt mit den Registrationen werden die aktuell auf der Instanz registrierten Nutzer aufgelistet.
 172 Die Liste kann nach Namen, E-Mail Adresse, Datum der Registration, der letzten Anmeldung oder dem letzten Beitrag und dem Account Typ sortiert werden.
 173 An dieser Stelle kannst du existierende Accounts vom Zugriff auf die Instanz blockieren, sie wieder frei geben oder Accounts endgültig löschen.
 174
 175 Im letzten Bereich auf der Seite kannst du als Administrator neue Accounts anlegen.
 176 Das Passwort für so eingerichtete Accounts werden per E-Mail an die Nutzer geschickt.
 177
 178 ## Plugins
 179
 180 Dieser Bereich des Admin Panels dient der Auswahl und Konfiguration der Erweiterungen von Friendica.
 181 Sie müssen in das `/addon` Verzeichnis kopiert werden.
 182 Auf der Seite wird eine Liste der verfügbaren Erweiterungen angezeigt.
 183 Neben den Namen der Erweiterungen wird ein Indikator angezeigt, der anzeigt ob das Addon gerade aktiviert ist oder nicht.
 184
 185 Wenn du die Erweiterungen aktualisiert die du auf deiner Friendica Instanz nutzt könnte es sein, dass sie neu geladen werden müssen, damit die Änderungen aktiviert werden.
 186 Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Plugins neu zu laden.
 187
 188 ## Themen
 189
 190 Der Bereich zur Kontrolle der auf der Friendica Instanz verfügbaren Themen funktioniert analog zum Plugins Bereich.
 191 Jedes Theme hat eine extra Seite auf der der aktuelle Status, ein Bildschirmfoto des Themes, zusätzliche Informationen und eventuelle Einstellungen des Themes zu finden sind.
 192 Genau wie Erweiterungen können Themes in der Übersichtsliste oder der Theme-Seite aktiviert bzw. deaktiviert werden.
 193 Um ein Standardtheme für die Instanz zu wählen, benutze bitte die *Seiten* Bereich des Admin Panels.
 194
 195 ## Zusätzliche Features
 196
 197 Es gibt einige optionale Features in Friendica, die Nutzer benutzen können oder halt nicht.
 198 Zum Beispiel den *dislike* Button oder den *Webeditor* beim Erstellen von neuen Beiträgen.
 199 In diesem Bereich des Admin Panels kannst du die Grundeinstellungen für diese Features festlegen und gegebenenfalls die Entscheidung treffen, dass Nutzer deiner Instanz diese auch nicht mehr ändern können.
 200
 201 ## DB Updates
 202
 203 Wenn sich die Datenbankstruktur Friendicas ändert werden die Änderungen automatisch angewandt.
 204 Solltest du den Verdacht haben, das eine Aktualisierung fehlgeschlagen ist, kannst du in diesem Bereich des Admin Panels den Status der Aktualisierungen überprüfen.
 205
 206 ## Warteschlange Inspizieren
 207
 208 Auf der Eingangsseite des Admin Panels werden zwei Zahlen fpr die Warteschlangen angegeben.
 209 Die zweite Zahl steht für die Beiträge, die initial nicht zugestellt werden konnten und später nochmal zugestellt werden sollen.
 210 Sollte diese Zahl durch die Decke brechen, solltest du nachsehen an welchen Kontakt die Zustellung der Beiträge nicht funktioniert.
 211
 212 Unter dem Menüpunkt "Warteschlange Inspizieren" findest du eine Liste dieser nicht zustellbaren Beiträge.
 213 Diese Liste ist nach dem Empfänger sortiert.
 214 Die Kommunikation zu dem Empfänger kann aus unterschiedlichen Gründen gestört sein.
 215 Der andere Server könnte offline sein, oder gerade einfach nur eine hohe Systemlast aufweisen.
 216
 217 Aber keine Panik!
 218 Friendica wird die Beiträge nicht für alle Zeiten in der Warteschlange behalten.
 219 Nach einiger Zeit werden Knoten als inaktiv identifiziert und Nachrichten an Nutzer dieser Knoten aus der Warteschlange gelöscht.
 220
 221 ## Federation Statistik
 222
 223 Deine Instanz ist ein Teil eines Netzwerks von Servern dezentraler sozialer Netzwerke, der sogenannten **Federation**.
 224 In diesem Bereich des Admin Panels findest du ein paar Zahlen zu dem Teil der Federation, die deine Instanz kennt.
 225
 226 ## Plugin Features
 227
 228 Einige der Erweiterungen von Friendica benötigen global gültige Einstellungen, die der Administrator vornehmen muss.
 229 Diese Erweiterungen sind hier aufgelistet, damit du die Einstellungen schneller findest.
 230
 231 ## Protokolle
 232
 233 Dieser Bereich des Admin Panels ist auf zwei Seiten verteilt.
 234 Die eine Seite dient der Konfiguration, die andere dem Anzeigen der Logs.
 235
 236 Du solltest die Logdatei nicht in einem Verzeichnis anlegen, auf das man vom Internet aus zugreifen kann.
 237 Wenn du das dennoch tun musste und die Standardeinstellungen des Apache Servers verwendest, dann solltest du darauf achten, dass die Logdateien mit der Endung `.log` oder `.out` enden.
 238 Solltest du einen anderen Webserver verwenden, solltest du sicherstellen, dass der Zugrif zu Dateien mit diesen Endungen nicht möglich ist.
 239
 240 Es gibt fünf Level der Ausführlichkeit mit denen Friendica arbeitet: Normal, Trace, Debug, Data und All.
 241 Normalerweise solltest du für den Betrieb deiner Friendica Instanz keine Logs benötigen.
 242 Wenn du versuchst einem Problem auf den Grund zu gehen, solltest du das "DEBUG" Level wählen.
 243 Mit dem "All" Level schreibt Friendica alles in die Logdatei.
 244 Die Datenmenge der geloggten Daten kann relativ schnell anwachsen, deshalb empfehlen wir das Anlegen von Protokollen nur zu aktivieren wenn es unbedingt nötig ist.
 245
 246 **Die Größe der Logdateien kann schnell anwachsen**.
 247 Du solltest deshalb einen Dienst zur [log rotation](https://en.wikipedia.org/wiki/Log_rotation) einrichten.
 248
 249 **Bekannte Probleme**: Der Dateiname `friendica.log` kann bei speziellen Server Konfigurationen zu Problemen führen (siehe [issue 2209](https://github.com/friendica/friendica/issues/2209)).
 250
 251 Normalerweise werden Fehler- und Warnmeldungen von PHP unterdrückt.
 252 Wenn du sie aktivieren willst, musst du folgendes in der `.htconfig.php` Datei eintragen um die Meldungen in die Datei `php.out` zu speichern
 253
 254         error_reporting(E_ERROR | E_WARNING | E_PARSE );
 255         ini_set('error_log','php.out');
 256         ini_set('log_errors','1');
 257         ini_set('display_errors', '0');
 258
 259 Die Datei `php.out` muss vom Webserver schreibbar sein und sollte ebenfalls außerhalb der Webverzeichnisse liegen.
 260 Es kommt gelegentlich vor, dass nicht deklarierte Variablen referenziert werden, dehalb raten wir davon ab `E_NOTICE` oder `E_ALL` zu verwenden.
 261 Die überwiegende Mehrzahl der auf diesen Stufen dokumentierten Fehler sind absolut harmlos.
 262 Solltest du mit den oben empfohlenen  Einstellungen Fehler finden, teile sie bitte den Entwicklern mit.
 263 Im Allgemeinen sind dies Fehler, die behoben werden sollten.
 264
 265 Solltest du eine leere (weiße) Seite vorfinden, während du Friendica nutzt, werfe bitte einen Blick in die PHP Logs.
 266 Solche *White Screens* sind so gut wie immer ein Zeichen dafür, dass ein Fehler aufgetreten ist.
 267
 268 ## Diagnose
 269
 270 In diesem Bereich des Admin Panels findest du zwei Werkzeuge mit der du untersuchen kannst, wie Friendica bestimmte Ressourcen einschätzt.
 271 Diese Werkzeuge sind insbesondere bei der Analyse von Kommunikationsproblemen hilfreich.
 272
 273 "Adresse untersuchen" zeigt Informationen zu einer URL an, wie Friendica sie wahrnimmt.
 274
 275 Mit dem zweiten Werkzeug "Webfinger überprüfen" kannst du Informationen zu einem Ding anfordern, das über einen Webfinger ( jemand@example.com ) identifiziert wird.
 276
 277 # Die Ausnahmen der Regel
 278
 279 Für die oben genannte Regel gibt es vier Ausnahmen, deren Konfiguration nicht über das Admin Panel vorgenommen werden kann.
 280 Dies sind die Datenbank Einstellungen, die Administrator Accounts, der PHP Pfad und die Konfiguration einer eventuellen Installation in ein Unterverzeichnis unterhalb der Hauptdomain.
 281
 282 ## Datenbank Einstellungen
 283
 284 Mit den folgenden Einstellungen kannst du die Zugriffsdaten für den Datenbank Server festlegen.
 285
 286     $db_host = 'your.db.host';
 287     $db_user = 'db_username';
 288     $db_pass = 'db_password';
 289     $db_data = 'database_name';
 290
 291 ## Administratoren
 292
 293 Du kannst einen, oder mehrere Accounts, zu Administratoren machen.
 294 Normalerweise trifft dies auf den ersten Account zu, der nach der Installation angelegt wird.
 295 Die Liste der E-Mail Adressen kann aber einfach erweitert werden.
 296 Mit keiner der angegebenen E-Mail Adressen können weitere Accounts registriert werden.
 297
 298     $a->config['admin_email'] = 'you@example.com, buddy@example.com';
 299
 300 ## PHP Pfad
 301
 302 Einige Prozesse von Friendica laufen im Hintergrund.
 303 Für diese Prozesse muss der Pfad zu der PHP Version gesetzt sein, die verwendet werden soll.
 304
 305     $a->config['php_path'] = '/pfad/zur/php-version';
 306
 307 ## Unterverzeichnis Konfiguration
 308
 309 Man kann Friendica in ein Unterverzeichnis des Webservers installieren.
 310 Wir raten allerdings dringen davon ab, da es die Interoperabilität mit anderen Netzwerken (z.B. Diaspora, GNU Social, Hubzilla) verhindert.
 311 Mal angenommen, du hast ein Unterverzeichnis tests und willst Friendica in ein weiteres Unterverzeichnis installieren, dann lautet die Konfiguration hierfür:
 312
 313     $a->path = 'tests/friendica';
 314
 315 ## Weitere Ausnahmen
 316
 317 Es gibt noch einige experimentelle Einstellungen, die nur in der ``.htconfig.php`` Datei konfiguriert werden können.
 318 Im [Konfigurationswerte, die nur in der .htconfig.php gesetzt werden können (EN)](help/htconfig) Artikel kannst du mehr darüber erfahren.