-Konfigurationen
-==============
+# Settings
-* [Zur Startseite der Hilfe](help)
+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,
-Hier findest du einige eingebaute Features, welche kein graphisches Interface haben oder nicht dokumentiert sind.
-Konfigurationseinstellungen sind in der Datei ".htconfig.php" gespeichert.
-Bearbeite diese Datei, indem du sie z.B. mit einem Texteditor öffnest.
-Verschiedene Systemeinstellungen sind bereits in dieser Datei dokumentiert und werden hier nicht weiter erklärt.
+Auf der Startseite des Admin Panels werden die Informationen zu der Instanz zusammen gefasst.
+Diese Informationen beinhalten die Anzahl der Nachrichten, die sich aktuell in den Warteschlangen befinden.
+Hierbei ist die erste Zahl die Zahl der Nachrichten die gerade aktiv verteilt werden.
+Diese Zahl sollte sich relativ schnell sinken.
+Die Zweite Zahl gibt die Anzahl von Nachrichten an, die nicht zugestellt werden konnten.
+Die Zustellung wird zu einem späteren Zeitpunkt noch einmal versucht.
+Unter dem Punkt "Warteschlange Inspizieren" kannst du einen schnellen Blick auf die zweite Warteschlange werfen.
+Des weiteren findest du eine Übersicht über die Accounts auf dem Friendica Knoten, die unter dem Punkt "Nutzer" moderiert werden können.
+Sowie eine Liste der derzeit aktivierten Addons.
+Diese Liste ist verlinkt, so dass du schnellen Zugriff auf die Informationsseiten der einzelnen Addons hast.
+Abschließend findest du auf der Startseite des Admin Panels die installierte Version von Friendica.
+Wenn du in Kontakt mit den Entwicklern trittst und Probleme oder Fehler zu schildern, gib diese Version bitte immer mit an.
-**Tastaturbefehle**
+Die Unterabschnitte des Admin Panels kannst du in der Seitenleiste auswählen.
-Friendica erfasst die folgenden Tastaturbefehle:
+## Seite
-* [Pause] - Pausiert die Update-Aktivität via "Ajax". Das ist ein Prozess, der Updates durchführt, ohne die Seite neu zu laden. Du kannst diesen Prozess pausieren, um deine Netzwerkauslastung zu reduzieren und/oder um es in der Javascript-Programmierung zum Debuggen zu nutzen. Ein Pausenzeichen erscheint unten links im Fenster. Klicke die [Pause]-Taste ein weiteres Mal, um die Pause zu beenden.
+In diesem Bereich des Admin Panels findest du die Hauptkonfiguration deiner Friendica Instanz.
+Er ist in mehrere Unterabschnitte aufgeteilt, wobei die Grundeinstellungen oben auf der Seite zu finden sind.
-**Geburtstagsbenachrichtigung**
+Da die meisten Konfigurationsoptionen einen Hilfstext im Admin Panel haben, kann und will dieser Artikel nicht alle Einstellungen abdecken.
-Geburtstage erscheinen auf deiner Startseite für alle Freunde, die in den nächsten 6 Tagen Geburtstag haben.
-Um deinen Geburtstag für alle sichtbar zu machen, musst du deinen Geburtstag (zumindest Tag und Monat) in dein Standardprofil eintragen.
-Es ist nicht notwendig, das Jahr einzutragen.
+### Grundeinstellungen
-**Konfigurationseinstellungen**
+#### Banner/Logo
+Hiermit legst du das Banner der Seite fest. Standardmäßig ist das Friendica-Logo und der Name festgelegt.
+Du kannst hierfür HTML/CSS nutzen, um den Inhalt zu gestalten und/oder die Position zu ändern, wenn es nicht bereits voreingestellt ist.
-**Sprache**
+#### Systensprache
-Systemeinstellung
+Diese Einstellung legt die Standartsprache der Instanz fest.
+Sie wird verwendet, wenn es Friendica nicht gelingt die Spracheinstellungen des Besuchers zu erkennen oder diese nicht unterstützt wird.
+Nutzer können diese Auswahl in den Einstellungen des Benutzerkontos überschreiben.
-Bitte schau dir die Datei util/README an, um Informationen zur Erstellung einer Übersetzung zu erhalten.
+Die Friendica Gemeinschaft bietet einige Übersetzungen an, von denen einige mehr andere weniger komplett sind.
+Mehr Informationen zum Übersetzungsprozess von Friendica findest du [auf dieser Seite](/help/translations) der Dokumentation.
-Konfiguriere:
-```
-$a->config['system']['language'] = 'name';
-```
+#### Systemweites Theme
+Hier kann das Theme bestimmt werden, welches standardmäßig zum Anzeigen der Seite verwendet werden soll.
+Nutzer können in ihren Einstellungen andere Themes wählen.
+Derzeit ist das "duepunto zero" Theme das vorausgewählte Theme.
-**System-Thema (Design)**
+Für mobile Geräte kannst du ein spezielles Theme wählen, wenn das Standardtheme ungeeignet für mobile Geräte sein sollte.
+Das `vier` Theme z.B. unterstützt kleine Anzeigen und benötigt kein zusätzliches mobiles Theme.
-Systemeinstellung
+### Registrierung
-Wähle ein Thema als Standardsystemdesign (welches vom Nutzer überschrieben werden kann). Das Standarddesign ist "default".
+#### Namen auf Vollständigkeit überprüfen
-Konfiguriere:
-```
-$a->config['system']['theme'] = 'theme-name';
-```
+Es kann vorkommen, dass viele Spammer versuchen, sich auf deiner Seite zu registrieren.
+In Testphasen haben wir festgestellt, dass diese automatischen Registrierungen das Feld "Vollständiger Name" oft nur mit Namen ausfüllen, die kein Leerzeichen beinhalten.
+Wenn du Leuten erlauben willst, sich nur mit einem Namen anzumelden, dann setze die Einstellung auf "true".
+Die Standardeinstellung ist auf "false" gesetzt.
+
+#### OpenID Unterstützung
+Standardmäßig wird OpenID für die Registrierung und für Logins genutzt.
+Wenn du nicht willst, dass OpenID-Strukturen für dein System übernommen werden, dann setze "no_openid" auf "true".
+Standardmäßig ist hier "false" gesetzt.
-**Verifiziere SSL-Zertifikate**
+#### Unterbinde Mehrfachregistrierung
-Sicherheitseinstellungen
+Um mehrfache Seiten zu erstellen, muss sich eine Person mehrfach registrieren können.
+Deine Seiteneinstellung kann Registrierungen komplett blockieren oder an Bedingungen knüpfen.
+Standardmäßig können eingeloggte Nutzer weitere Accounts für die Seitenerstellung registrieren.
+Hier ist weiterhin eine Bestätigung notwendig, wenn "REGISTER_APPROVE" ausgewählt ist.
+Wenn du die Erstellung weiterer Accounts blockieren willst, dann setze die Einstellung "block_extended_register" auf "true".
+Standardmäßig ist hier "false" gesetzt.
+
+### Datei hochladen
-Standardmäßig erlaubt Friendica SSL-Kommunikation von Seiten, die "selbstunterzeichnete" SSL-Zertifikate nutzen.
-Um eine weitreichende Kompatibilität mit anderen Netzwerken und Browsern zu gewährleisten, empfehlen wir, selbstunterzeichnete Zertifikate **nicht** zu nutzen.
-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.
-Auch schützt es deine Login-Daten vor Datendiebstahl. Selbstunterzeichnete Zertifikate können kostenlos erstellt werden.
-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.
-Wenn du es wünscht, kannst du eine strikte Zertifikatabfrage einstellen.
-Das führt dazu, dass du keinerlei Verbindung zu einer selbstunterzeichneten SSL-Seite erstellen kannst
+#### Maximale Bildgröße
+
+Maximale Bild-Dateigröße in Byte. Standardmäßig ist 0 gesetzt, was bedeutet, dass kein Limit gesetzt ist.
+
+### Regeln
-Konfiguriere:
-```
-$a->config['system']['verifyssl'] = true;
-```
+#### URL des weltweiten Verzeichnisses
+Mit diesem Befehl wird die URL eingestellt, die zum Update des globalen Verzeichnisses genutzt wird.
+Dieser Befehl ist in der Standardkonfiguration enthalten.
+Der nicht dokumentierte Teil dieser Einstellung ist, dass das globale Verzeichnis gar nicht verfügbar ist, wenn diese Einstellung nicht gesetzt wird.
+Dies erlaubt eine private Kommunikation, die komplett vom globalen Verzeichnis isoliert ist.
-**Erlaubte Freunde-Domains**
+#### Erzwinge Veröffentlichung
-Kooperationen/Gemeinschaften/Bildung Erweiterung
+Standardmäßig können Nutzer selbst auswählen, ob ihr Profil im Seitenverzeichnis erscheint.
+Diese Einstellung zwingt alle Nutzer dazu, im Verzeichnis zu erscheinen.
+Diese Einstellung kann vom Nutzer nicht deaktiviert werden. Die Standardeinstellung steht auf "false".
-Kommagetrennte Liste von Domains, welche eine Freundschaft mit dieser Seite eingehen dürfen.
-Wildcards werden akzeptiert (Wildcard-Unterstützung unter Windows benötigt PHP5.3) Standardmäßig sind alle gültigen Domains erlaubt.
+#### Öffentlichen Zugriff blockieren
-Konfiguriere:
-```
-$a->config['system']['allowed_sites'] = "sitea.com, *siteb.com";
-```
+Aktiviere diese Einstellung um den öffentlichen Zugriff auf alle Seiten zu sperren, solange man nicht eingeloggt ist.
+Das blockiert die Ansicht von Profilen, Freunden, Fotos, vom Verzeichnis und den Suchseiten.
+Ein Nebeneffekt ist, dass Einträge dieser Seite nicht im globalen Verzeichnis erscheinen.
+Wir empfehlen, speziell diese Einstellung auszuschalten (die Einstellung ist an anderer Stelle auf dieser Seite erklärt).
+Beachte: das ist speziell für Seiten, die beabsichtigen, von anderen Friendica-Netzwerken abgeschottet zu sein.
+Unautorisierte Personen haben ebenfalls nicht die Möglichkeit, Freundschaftsanfragen von Seitennutzern zu beantworten.
+Die Standardeinstellung ist deaktiviert.
+Verfügbar in Version 2.2 und höher.
+
+#### Erlaubte Domains für Kontakte
+Kommagetrennte Liste von Domains, welche eine Freundschaft mit dieser Seite eingehen dürfen.
+Wildcards werden akzeptiert (Wildcard-Unterstützung unter Windows benötigt PHP5.3) Standardmäßig sind alle gültigen Domains erlaubt.
-**Erlaubte Email-Domains**
+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.
-Kooperationen/Gemeinschaften/Bildung Erweiterung
+#### Erlaubte Domains für E-Mails
Kommagetrennte Liste von Domains, welche bei der Registrierung als Part der Email-Adresse erlaubt sind.
Das grenzt Leute aus, die nicht Teil der Gruppe oder Organisation sind.
Wildcards werden akzeptiert (Wildcard-Unterstützung unter Windows benötigt PHP5.3) Standardmäßig sind alle gültigen Email-Adressen erlaubt.
-Konfiguriere:
-```
-$a->config['system']['allowed_email'] = "sitea.com, *siteb.com";
-```
+#### Nutzern erlauben das remote_self Flag zu setzen
-**Öffentlichkeit blockieren**
+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.
+Dadurch werden automatisch alle Beiträge dieser Feeds für diesen Nutzer gespiegelt und an die Kontakte bei Friendica verteilt.
-Kooperationen/Gemeinschaften/Bildung Erweiterung
+Als Administrator der Friendica Instanz kannst du diese Einstellungen ansonsten nur direkt in der Datenbank vornehmen.
+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.
-Setze diese Einstellung auf "true" und sperre den öffentlichen Zugriff auf alle Seiten, solange man nicht eingeloggt ist.
-Das blockiert die Ansicht von Profilen, Freunden, Fotos, vom Verzeichnis und den Suchseiten.
-Ein Nebeneffekt ist, dass Einträge dieser Seite nicht im globalen Verzeichnis erscheinen.
-Wir empfehlen, speziell diese Einstellung auszuschalten (die Einstellung ist an anderer Stelle auf dieser Seite erklärt).
-Beachte: das ist speziell für Seiten, die beabsichtigen, von anderen Friendica-Netzwerken abgeschottet zu sein.
-Unautorisierte Personen haben ebenfalls nicht die Möglichkeit, Freundschaftsanfragen von Seitennutzern zu beantworten.
-Die Standardeinstellung steht auf "false".
-Verfügbar in Version 2.2 und höher.
+### Erweitert
-Konfiguriere:
-```
-$a->config['system']['block_public'] = true;
-```
+#### Proxy Einstellungen
+Wenn deine Seite eine Proxy-Einstellung nutzt, musst du diese Einstellungen vornehmen, um mit anderen Seiten im Internet zu kommunizieren.
-**Veröffentlichung erzwingen**
+#### Netzwerk Wartezeit
-Kooperationen/Gemeinschaften/Bildung Erweiterung
+Legt fest, wie lange das Netzwerk warten soll, bevor ein Timeout eintritt.
+Der Wert wird in Sekunden angegeben. Standardmäßig ist 60 eingestellt; 0 steht für "unbegrenzt" (nicht empfohlen).
-Standardmäßig können Nutzer selbst auswählen, ob ihr Profil im Seitenverzeichnis erscheint.
-Diese Einstellung zwingt alle Nutzer dazu, im Verzeichnis zu erscheinen.
-Diese Einstellung kann vom Nutzer nicht deaktiviert werden. Die Standardeinstellung steht auf "false".
+#### UTF-8 Reguläre Ausdrücke
-Konfiguriere:
-```
-$a->config['system']['publish_all'] = true;
-```
+Während der Registrierung werden die Namen daraufhin geprüft, ob sie reguläre UTF-8-Ausdrücke nutzen.
+Hierfür wird PHP benötigt, um mit einer speziellen Einstellung kompiliert zu werden, die UTF-8-Ausdrücke benutzt.
+Wenn du absolut keine Möglichkeit hast, Accounts zu registrieren, setze diesen Wert auf ja.
+#### SSL Überprüfen
-**Globales Verzeichnis**
+Standardmäßig erlaubt Friendica SSL-Kommunikation von Seiten, die "selbst unterzeichnete" SSL-Zertifikate nutzen.
+Um eine weitreichende Kompatibilität mit anderen Netzwerken und Browsern zu gewährleisten, empfehlen wir, selbst unterzeichnete Zertifikate **nicht** zu nutzen.
+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.
+Auch schützt es deine Login-Daten vor Datendiebstahl. Selbst unterzeichnete Zertifikate können kostenlos erstellt werden.
+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.
+Wenn du es wünscht, kannst du eine strikte Zertifikatabfrage einstellen.
+Das führt dazu, dass du keinerlei Verbindung zu einer selbst unterzeichneten SSL-Seite erstellen kannst
-Kooperationen/Gemeinschaften/Bildung Erweiterung
+### Automatisch ein Kontaktverzeichnis erstellen
-Mit diesem Befehl wird die URL eingestellt, die zum Update des globalen Verzeichnisses genutzt wird.
-Dieser Befehl ist in der Standardkonfiguration enthalten.
-Der nichtdokumentierte Teil dieser Einstellung ist, dass das globale Verzeichnis gar nicht verfügbar ist, wenn diese Einstellung nicht gesetzt wird.
-Dies erlaubt eine private Kommunikation, die komplett vom globalen Verzeichnis isoliert ist.
+### Performance
-Konfiguriere:
-```
-$a->config['system']['directory'] = 'http://dir.friendi.ca';
-```
+### Worker
+### Umsiedeln
-**Proxy Konfigurationseinstellung**
+## Nutzer
-Wenn deine Seite eine Proxy-Einstellung nutzt, musst du diese Einstellungen vornehmen, um mit anderen Seiten im Internet zu kommunizieren.
+In diesem Abschnitt des Admin Panels kannst du die Nutzer deiner Friendica Instanz moderieren.
-Konfiguriere:
-```
-$a->config['system']['proxy'] = "http://proxyserver.domain:port";
-$a->config['system']['proxyuser'] = "username:password";
-```
+Solltest du für **Registrierungsmethode** die Einstellung "Bedarf Zustimmung" gewählt haben, werden hier zu Beginn der Seite neue Registrationen aufgelistet.
+Als Administrator kannst du hier die Registration akzeptieren oder ablehnen.
+Unter dem Abschnitt mit den Registrationen werden die aktuell auf der Instanz registrierten Nutzer aufgelistet.
+Die Liste kann nach Namen, E-Mail Adresse, Datum der Registration, der letzten Anmeldung oder dem letzten Beitrag und dem Account Typ sortiert werden.
+An dieser Stelle kannst du existierende Accounts vom Zugriff auf die Instanz blockieren, sie wieder frei geben oder Accounts endgültig löschen.
-**Netzwerk-Timeout**
+Im letzten Bereich auf der Seite kannst du als Administrator neue Accounts anlegen.
+Das Passwort für so eingerichtete Accounts werden per E-Mail an die Nutzer geschickt.
-Legt fest, wie lange das Netzwerk warten soll, bevor ein Timeout eintritt.
-Der Wert wird in Sekunden angegeben. Standardmäßig ist 60 eingestellt; 0 steht für "unbegrenzt" (nicht empfohlen).
+## Plugins
-Konfiguriere:
+Dieser Bereich des Admin Panels dient der Auswahl und Konfiguration der Erweiterungen von Friendica.
+Sie müssen in das `/addon` Verzeichnis kopiert werden.
+Auf der Seite wird eine Liste der verfügbaren Erweiterungen angezeigt.
+Neben den Namen der Erweiterungen wird ein Indikator angezeigt, der anzeigt ob das Addon gerade aktiviert ist oder nicht.
-```
-$a->config['system']['curl_timeout'] = 60;
-```
+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.
+Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Plugins neu zu laden.
+## Themen
-**Banner/Logo**
+Der Bereich zur Kontrolle der auf der Friendica Instanz verfügbaren Themen funktioniert analog zum Plugins Bereich.
+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.
+Genau wie Erweiterungen können Themes in der Übersichtsliste oder der Theme-Seite aktiviert bzw. deaktiviert werden.
+Um ein Standardtheme für die Instanz zu wählen, benutze bitte die *Seiten* Bereich des Admin Panels.
-Hiermit legst du das Banner der Seite fest. Standardmäßig ist das Friendica-Logo und der Name festgelegt.
-Du kannst hierfür HTML/CSS nutzen, um den Inhalt zu gestalten und/oder die Position zu ändern, wenn es nicht bereits voreingestellt ist.
+## Zusätzliche Features
-Konfiguriere:
+Es gibt einige optionale Features in Friendica, die Nutzer benutzen können oder halt nicht.
+Zum Beispiel den *dislike* Button oder den *Webeditor* beim Erstellen von neuen Beiträgen.
+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.
-```
-$a->config['system']['banner'] = '<span id="logo-text">Meine tolle Webseite</span>';
-```
+## DB Updates
+Wenn sich die Datenbankstruktur Friendicas ändert werden die Änderungen automatisch angewandt.
+Solltest du den Verdacht haben, das eine Aktualisierung fehlgeschlagen ist, kannst du in diesem Bereich des Admin Panels den Status der Aktualisierungen überprüfen.
-**Maximale Bildgröße**
+## Warteschlange Inspizieren
-Maximale Bild-Dateigröße in Byte. Standardmäßig ist 0 gesetzt, was bedeutet, dass kein Limit gesetzt ist.
+Auf der Eingangsseite des Admin Panels werden zwei Zahlen fpr die Warteschlangen angegeben.
+Die zweite Zahl steht für die Beiträge, die initial nicht zugestellt werden konnten und später nochmal zugestellt werden sollen.
+Sollte diese Zahl durch die Decke brechen, solltest du nachsehen an welchen Kontakt die Zustellung der Beiträge nicht funktioniert.
-Konfiguriere:
+Unter dem Menüpunkt "Warteschlange Inspizieren" findest du eine Liste dieser nicht zustellbaren Beiträge.
+Diese Liste ist nach dem Empfänger sortiert.
+Die Kommunikation zu dem Empfänger kann aus unterschiedlichen Gründen gestört sein.
+Der andere Server könnte offline sein, oder gerade einfach nur eine hohe Systemlast aufweisen.
-```
-$a->config['system']['maximagesize'] = 1000000;
-```
+Aber keine Panik!
+Friendica wird die Beiträge nicht für alle Zeiten in der Warteschlange behalten.
+Nach einiger Zeit werden Knoten als inaktiv identifiziert und Nachrichten an Nutzer dieser Knoten aus der Warteschlange gelöscht.
+## Federation Statistik
-**UTF-8 Reguläre Ausdrücke**
+Deine Instanz ist ein Teil eines Netzwerks von Servern dezentraler sozialer Netzwerke, der so genannten **Federation**.
+In diesem Bereich des Admin Panels findest du ein paar Zahlen zu dem Teil der Federation, die deine Instanz kennt.
-Während der Registrierung werden die Namen daraufhin geprüft, ob sie reguläre UTF-8-Ausdrücke nutzen.
-Hierfür wird PHP benötigt, um mit einer speziellen Einstellung kompiliert zu werden, die UTF-8-Ausdrücke benutzt.
-Wenn du absolut keine Möglichkeit hast, Accounts zu registrieren, setze den Wert von "no_utf" auf "true".
-Standardmäßig ist "false" eingestellt (das bedeutet, dass UTF-8-Ausdrücke unterstützt werden und funktionieren).
-
-Konfiguriere:
+## Plugin Features
-```
-$a->config['system']['no_utf'] = true;
-```
+Einige der Erweiterungen von Friendica benötigen global gültige Einstellungen, die der Administrator vornehmen muss.
+Diese Erweiterungen sind hier aufgelistet, damit du die Einstellungen schneller findest.
+## Protokolle
-**Prüfe vollständigen Namen**
+Dieser Bereich des Admin Panels ist auf zwei Seiten verteilt.
+Die eine Seite dient der Konfiguration, die andere dem Anzeigen der Logs.
-Es kann vorkommen, dass viele Spammer versuchen, sich auf deiner Seite zu registrieren.
-In Testphasen haben wir festgestellt, dass diese automatischen Registrierungen das Feld "Vollständiger Name" oft nur mit Namen ausfüllen, die kein Leerzeichen beinhalten.
-Wenn du Leuten erlauben willst, sich nur mit einem Namen anzumelden, dann setze die Einstellung auf "true".
-Die Standardeinstellung ist auf "false" gesetzt.
+Du solltest die Logdatei nicht in einem Verzeichnis anlegen, auf das man vom Internet aus zugreifen kann.
+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.
+Solltest du einen anderen Webserver verwenden, solltest du sicherstellen, dass der Zugrif zu Dateien mit diesen Endungen nicht möglich ist.
-Konfiguriere:
+Es gibt fünf Level der Ausführlichkeit mit denen Friendica arbeitet: Normal, Trace, Debug, Data und All.
+Normalerweise solltest du für den Betrieb deiner Friendica Instanz keine Logs benötigen.
+Wenn du versuchst einem Problem auf den Grund zu gehen, solltest du das "DEBUG" Level wählen.
+Mit dem "All" Level schreibt Friendica alles in die Logdatei.
+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.
-```
-$a->config['system']['no_regfullname'] = true;
-```
+**Die Größe der Logdateien kann schnell anwachsen**.
+Du solltest deshalb einen Dienst zur [log rotation](https://en.wikipedia.org/wiki/Log_rotation) einrichten.
+**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)).
-**OpenID**
+Normalerweise werden Fehler- und Warnmeldungen von PHP unterdrückt.
+Wenn du sie aktivieren willst, musst du folgendes in der `.htconfig.php` Datei eintragen um die Meldungen in die Datei `php.out` zu speichern
-Standardmäßig wird OpenID für die Registrierung und für Logins genutzt.
-Wenn du nicht willst, dass OpenID-Strukturen für dein System übernommen werden, dann setze "no_openid" auf "true".
-Standardmäßig ist hier "false" gesetzt.
+ error_reporting(E_ERROR | E_WARNING | E_PARSE );
+ ini_set('error_log','php.out');
+ ini_set('log_errors','1');
+ ini_set('display_errors', '0');
-Konfiguriere:
-```
-$a->config['system']['no_openid'] = true;
-```
+Die Datei `php.out` muss vom Webserver schreibbar sein und sollte ebenfalls außerhalb der Webverzeichnisse liegen.
+Es kommt gelegentlich vor, dass nicht deklarierte Variablen referenziert werden, dehalb raten wir davon ab `E_NOTICE` oder `E_ALL` zu verwenden.
+Die überwiegende Mehrzahl der auf diesen Stufen dokumentierten Fehler sind absolut harmlos.
+Solltest du mit den oben empfohlenen Einstellungen Fehler finden, teile sie bitte den Entwicklern mit.
+Im Allgemeinen sind dies Fehler, die behoben werden sollten.
+Solltest du eine leere (weiße) Seite vorfinden, während du Friendica nutzt, werfe bitte einen Blick in die PHP Logs.
+Solche *White Screens* sind so gut wie immer ein Zeichen dafür, dass ein Fehler aufgetreten ist.
-**Multiple Registrierungen**
+## Diagnose
-Um mehrfache Seiten zu erstellen, muss sich eine Person mehrfach registrieren können.
-Deine Seiteneinstellung kann Registrierungen komplett blockieren oder an Bedingungen knüpfen.
-Standardmäßig können eingeloggte Nutzer weitere Accounts für die Seitenerstellung registrieren.
-Hier ist weiterhin eine Bestätigung notwendig, wenn "REGISTER_APPROVE" ausgewählt ist.
-Wenn du die Erstellung weiterer Accounts blockieren willst, dann setze die Einstellung "block_extended_register" auf "true".
-Standardmäßig ist hier "false" gesetzt.
-
-Konfiguriere:
-```
-$a->config['system']['block_extended_register'] = true;
-```
+In diesem Bereich des Admin Panels findest du zwei Werkzeuge mit der du untersuchen kannst, wie Friendica bestimmte Ressourcen einschätzt.
+Diese Werkzeuge sind insbesondere bei der Analyse von Kommunikationsproblemen hilfreich.
+
+"Adresse untersuchen" zeigt Informationen zu einer URL an, wie Friendica sie wahrnimmt.
+
+Mit dem zweiten Werkzeug "Webfinger überprüfen" kannst du Informationen zu einem Ding anfordern, das über einen Webfinger ( jemand@example.com ) identifiziert wird.
+
+# Die Ausnahmen der Regel
+
+Für die oben genannte Regel gibt es vier Ausnahmen, deren Konfiguration nicht über das Admin Panel vorgenommen werden kann.
+Dies sind die Datenbank Einstellungen, die Administrator Accounts, der PHP Pfad und die Konfiguration einer eventuellen Installation in ein Unterverzeichnis unterhalb der Hauptdomain.
+
+## Datenbank Einstellungen
+
+Mit den folgenden Einstellungen kannst du die Zugriffsdaten für den Datenbank Server festlegen.
+
+ $db_host = 'your.db.host';
+ $db_user = 'db_username';
+ $db_pass = 'db_password';
+ $db_data = 'database_name';
+
+## Administratoren
+
+Du kannst einen, oder mehrere Accounts, zu Administratoren machen.
+Normalerweise trifft dies auf den ersten Account zu, der nach der Installation angelegt wird.
+Die Liste der E-Mail Adressen kann aber einfach erweitert werden.
+Mit keiner der angegebenen E-Mail Adressen können weitere Accounts registriert werden.
+ $a->config['admin_email'] = 'you@example.com, buddy@example.com';
-**Entwicklereinstellungen**
+## PHP Pfad
-Diese sind am nützlichsten, um Protokollprozesse zu debuggen oder andere Kommunikationsfehler einzugrenzen.
+Einige Prozesse von Friendica laufen im Hintergrund.
+Für diese Prozesse muss der Pfad zu der PHP Version gesetzt sein, die verwendet werden soll.
-Konfiguriere:
-```
-$a->config['system']['debugging'] = true;
-$a->config['system']['logfile'] = 'logfile.out';
-$a->config['system']['loglevel'] = LOGGER_DEBUG;
-```
-Erstellt detaillierte Debugging-Logfiles, die in der Datei "logfile.out" gespeichert werden (Datei muss auf dem Server mit Schreibrechten versehen sein). "LOGGER_DEBUG" zeigt eine Menge an Systeminformationen, enthält aber keine detaillierten Daten.
-Du kannst ebenfalls "LOGGER_ALL" auswählen, allerdings empfehlen wir dieses nur, wenn ein spezifisches Problem eingegrenzt werden soll.
-Andere Log-Level sind möglich, werden aber derzeit noch nicht genutzt.
+ $a->config['php_path'] = '/pfad/zur/php-version';
+## Unterverzeichnis Konfiguration
-**PHP-Fehler-Logging**
+Man kann Friendica in ein Unterverzeichnis des Webservers installieren.
+Wir raten allerdings dringen davon ab, da es die Interoperabilität mit anderen Netzwerken (z.B. Diaspora, GNU Social, Hubzilla) verhindert.
+Mal angenommen, du hast ein Unterverzeichnis tests und willst Friendica in ein weiteres Unterverzeichnis installieren, dann lautet die Konfiguration hierfür:
-Nutze die folgenden Einstellungen, um PHP-Fehler direkt in einer Datei zu erfassen.
+ $a->path = 'tests/friendica';
-Konfiguriere:
-```
-error_reporting(E_ERROR | E_WARNING | E_PARSE );
-ini_set('error_log','php.out');
-ini_set('log_errors','1');
-ini_set('display_errors', '0');
-```
+## Weitere Ausnahmen
-Diese Befehle erfassen alle PHP-Fehler in der Datei "php.out" (Datei muss auf dem Server mit Schreibrechten versehen sein).
-Nicht deklarierte Variablen werden manchmal mit einem Verweis versehen, weshalb wir empfehlen, "E_NOTICE" und "E_ALL" nicht zu nutzen.
-Die Menge an Fehlern, die auf diesem Level gemeldet werden, ist komplett harmlos.
-Bitte informiere die Entwickler über alle Fehler, die du in deinen Log-Dateien mit den oben genannten Einstellungen erhältst.
-Sie weisen generell auf Fehler in, die bearbeitet werden müssen.
-Wenn du eine leere (weiße) Seite erhältst, schau in die PHP-Log-Datei - dies deutet fast immer darauf hin, dass ein Fehler aufgetreten ist.
+Es gibt noch einige experimentelle Einstellungen, die nur in der ``.htconfig.php`` Datei konfiguriert werden können.
+Im [Konfigurationswerte, die nur in der .htconfig.php gesetzt werden können (EN)](help/htconfig) Artikel kannst du mehr darüber erfahren.
projects / friendica.git / commitdiff