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