doc/de/Settings.md

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