Merge branch 'documentation/fom' of github.com:mapbender/mapbender-documentation into documentation/fom

Author: rschwammborn

de/functions/backend/FOM/acl.rst

@@ -4,7 +4,7 @@
 Access Control Lists (ACL)
 ==========================
 
-Die Absicherung von Domain-Objekten wird in Mapbender über Access Control Lists implementiert. ACLs ermöglichen in Mapbender eine flexible Rechtezuweisung auf Applikationen, Dienste und die Benutzer- und Gruppenverwaltung selbst.
+Die Absicherung von Domain-Objekten wird in Mapbender über Access Control Lists (ACLs) implementiert. ACLs ermöglichen in Mapbender eine flexible Rechtezuweisung auf Applikationen, Dienste und die Benutzer- und Gruppenverwaltung selbst.
 
 Mapbender bietet zur Absicherung dieser Bereiche die folgenden Rechte- und Rollenzuweisungen an:
 

de/functions/backend/FOM/examples.rst

@@ -21,7 +21,7 @@ Der Befehl ``app/console fom:user:resetroot`` setzt den User mit der ID 1 zurüc
                 The root is now usable. Have fun!
 
 
-Neuen Benutzer anlegen
+Neue Benutzer anlegen
 ----------------------
 
 Der root Benutzer (ID 1) kann neue Benutzer anlegen. Dies ist auch für andere Benutzer möglich, wenn sie im ACL "Users" als Owner eingetragen sind. Diese Ausnahmeberechtigung wurde gewählt, damit nicht jeder Nutzer seinen Benutzernamen ändern kann.
@@ -30,24 +30,24 @@ Der root Benutzer (ID 1) kann neue Benutzer anlegen. Dies ist auch für andere B
 Neue Anwendungen anlegen
 ------------------------
 
-Ein Benutzer, der neue Anwendungen erzeugen soll, muss im ACL "Anwendungen" das Create Recht besitzen. Sobald er dieses Recht hat, kann er auch Anwendungen exportieren und importieren.
+Ein Benutzer, der neue Anwendungen erzeugen soll, muss im ACL "Anwendungen" das *Create* Recht besitzen. Sobald er dieses Recht hat, kann er auch Anwendungen exportieren und importieren.
 
 
 Datenquellen konfigurieren
 --------------------------
 
-Um den Aufruf auf den Tab ``Datenquellen`` zu erhalten und anschließend Dienste einbinden, konfigurieren oder aktualisieren zu können, muss ein Benutzer/eine Gruppe im ACL "Datenquellen" mindestens das Edit-Recht zugewiesen bekommen.
+Um den Aufruf auf den Tab ``Datenquellen`` zu erhalten und anschließend Dienste einbinden, konfigurieren oder aktualisieren zu können, muss ein Benutzer/eine Gruppe im ACL "Datenquellen" mindestens das *Edit* Recht zugewiesen bekommen.
 
 
 Anwendungen kopieren
 --------------------
 
-Ein Benutzer kann Anwendungen kopieren, wenn er im ACL ``Applications`` oder in der Anwendung mindestens das Edit Recht hat. Dabei überschreibt das individuelle Recht der Anwendung das globale ACL Recht.
+Ein Benutzer kann Anwendungen kopieren, wenn er im ACL ``Applications`` oder in der Anwendung selbst mindestens das *Edit* Recht hat. Dabei überschreibt das individuelle Recht der Anwendung das globale ACL Recht.
 
-Dabei wird der Benutzer automatisch Owner seiner kopierten Anwendung.
+Wenn ein Benutzer eine Anwendung kopiert, dann wird er automatisch ihr Owner.
 
 
 Anwendungen löschen
 -------------------
 
-Ein Benutzer kann Anwendungen löschen, wenn er im ACL ``Anwendungen`` oder er in der Anwendung mindestens das Delete Recht hat. Dabei überschreibt das individuelle Recht der Anwendung das globale ACL Recht.
+Ein Benutzer kann Anwendungen löschen, wenn er im ACL ``Anwendungen`` oder er in der Anwendung selbst mindestens das *Delete* Recht hat. Dabei überschreibt das individuelle Recht der Anwendung das globale ACL Recht.

de/functions/backend/FOM/index.rst

@@ -1,7 +1,7 @@
 .. _fom_de:
 
-FOMUserBundle - Benutzer und Absicherung
-========================================
+FOM UserBundle - Benutzer und Absicherung
+=========================================
 
 .. toctree::
    :maxdepth: 1

de/functions/backend/FOM/roles_groups.rst

@@ -3,11 +3,11 @@
 Rollen und Gruppen
 ==================
 
-Rollen können in Mapbender für globale Zugriffe auf Domänen-Objekte benutzt werden, wenn kein anderes Domänen-Objekt involviert ist.
+Rollen werden in Mapbender für globale Zugriffe auf Domänen-Objekte verwendet, wenn kein anderes Domänen-Objekt involviert ist.
 
 Die folgenden Rollen sind für eine übergreifende Rechtevergabe auf bestimmte Domänen-Objekte verfügbar:
 
 * Alle angemeldeten Benutzer: Rechtevergabe betrifft alle Benutzer mit einem Account und keinen individuellen Rechtezuschreibungen. 
 * Anonyme Nutzer: Rechtevergabe betrifft alle unangemeldeten Besucher von Mapbender-URLs.
 
-Im Gegensatz dazu sind Gruppen selbst erstellte Datenbank-Entitäten, die zu Benutzern auf einer individuellen Basis zugewiesen werden können. Gemeinsame Gruppenmitglieder besitzen diegleichen Rechte, sofern diese auf Domänen-Objekten zentral für die Gruppe konfiguriert werden.
+Gruppen sind im Gegensatz dazu selbst erstellte Datenbank-Entitäten. Benutzer können ihnen individuell zugewiesen werden. Gemeinsame Gruppenmitglieder besitzen die gleichen Rechte, sofern diese auf Domänen-Objekten zentral für die Gruppe konfiguriert wurden.

de/functions/backend/FOM/security.rst

@@ -3,7 +3,7 @@
 Sicherheitskonzepte
 ===================
 
-Sicherheit wird im FOMUserBundle bereitgestellt und basiert auf diesen Konzepten:
+Sicherheit wird im FOM User Bundle bereitgestellt und basiert auf diesen Konzepten:
 
 - :doc:`Benutzer <users>`
 - :doc:`Rollen und Gruppen <roles_groups>`
@@ -12,14 +12,15 @@ Sicherheit wird im FOMUserBundle bereitgestellt und basiert auf diesen Konzepten
 
 Rechte
 ========
+
 Mapbender bietet verschiedene Rechte an, die Sie vergeben können. Sie basieren auf :doc:`Access Control Lists (ACL) <acl>`.
 
 * view - anzeigen
 * edit - editieren
 * delete - löschen
 * operator - kann anzeigen, editieren und löschen
-* master - kann anzeigen, editieren und löschen und diese Rechte außerdem weitergeben.
-* owner - Besitzer, darf alles. Darf master und owner Recht vergeben.
+* master - kann anzeigen, editieren, löschen und diese Rechte außerdem weitergeben
+* owner - Besitzer, darf alles (inkl. Vergabe von master und owner Recht)
 
 Weisen Sie einem Benutzer über ``Benutzer --> Benutzer bearbeiten --> Sicherheit`` die gewünschten Rechte zu.
 
@@ -29,6 +30,7 @@ Weisen Sie einem Benutzer über ``Benutzer --> Benutzer bearbeiten --> Sicherhei
 
 Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe
 =======================================================
+
 #. Bearbeiten Sie Ihre Anwendung über ``Anwendungen --> Bearbeiten``.
 
 #. Wählen Sie ``Sicherheit``.
@@ -37,13 +39,14 @@ Zuweisen einer Anwendung zu einem Benutzer/einer Gruppe
 
 #. Fügen Sie für individuelle Einstellungen alternativ Benutzer oder Gruppen über den Plus-Button hinzu. Setzen Sie anschließend individuelle Berechtigungen über die Rechtetabelle. So weisen Sie eine Anwendung einem oder mehreren Benutzer(n)/Gruppe(n) zu.
 
-#. Melden Sie sich über ``Logout`` ab und unter der ausgewählten Benutzerbezeichnung an, um die Rechtevergabe zu testen.
+#. Melden Sie sich erneut unter der ausgewählten Benutzerbezeichnung an, um die Rechtevergabe zu testen.
 
 #. Alternativ können Sie auch unter ``Sicherheit --> Globale Zugriffssteuerungsliste (ACL) --> Anwendungen`` schnell Berechtigungen von Benutzern/Gruppen für alle Anwendungen festlegen.
 
 
 Zuweisen einzelner Elemente zu Benutzern/Gruppen
 ================================================
+
 Standardmäßig stehen alle Elemente den Benutzern/Gruppen zur Verfügung, die Zugriff auf eine Anwendung haben. Für einzelne Elemente kann der Zugriff noch genauer definiert werden, so dass diese nur bestimmten Benutzern/Gruppen zur Verfügung stehen.
 
 #. Bearbeiten Sie Ihre Anwendung über ``Anwendungen --> Bearbeiten``.
@@ -59,10 +62,11 @@ Standardmäßig stehen alle Elemente den Benutzern/Gruppen zur Verfügung, die Z
 
 Zuweisen von Benutzern zu einem Benutzer/einer Gruppe
 =====================================================
+
 #. Bearbeiten Sie Ihre Benutzer über ``Sicherheit --> Benutzer``.
 
 #. Wählen Sie ``Sicherheit``.
 
 #. Weisen Sie Benutzern/Gruppen individuelle Berechtigungen auf den individuellen Benutzer zu. Fügen Sie Benutzer oder Gruppen über den Plus-Button hinzu. Setzen Sie anschließend individuelle Berechtigungen über die Rechtetabelle. So weisen Sie Benutzer(n)/Gruppe(n) einen Benutzer zu.
 
-#. Melden Sie sich über ``Logout`` ab und unter dem Benutzer/Gruppe mit neuen Rechten an, um die Rechtevergabe zu testen. Je nach Konfiguration ist es so z.B. möglich, dass alle Teilnehmer einer Gruppe Berechtigungen über einen bestimmten Benutzer haben und dessen Account bearbeiten oder löschen können.
+#. Melden Sie sich unter dem Benutzer bzw. der Gruppe mit neuen Rechten an, um die Rechtevergabe zu testen. Je nach Konfiguration ist es so z.B. möglich, dass alle Teilnehmer einer Gruppe Berechtigungen über einen bestimmten Benutzer haben und dessen Account bearbeiten oder löschen können.

de/functions/backend/FOM/users.rst

@@ -5,11 +5,14 @@ Benutzer
 
 Benutzer werden als FOM\\UserBundle\\Entity\\User implementiert und im Datenbank Repository gespeichert. Die Entität hält nur die notwendigen Informationen über einen Nutzer vor.
 
-Das Bundle enthält alle Mittel, um Benutzer durch einen Administrator zu verwalten als auch das eigene Registrieren eines Nutzers sowie das Zurücksetzen des eigenen Passwortes.
+Das Bundle enthält Möglichkeiten für folgende Optionen:
 
-Der Benutzer mit der ID 1 ist besonders, da dieser Benutzer bei der Installation erstellt wird und immer alle Rechte hat. Falls alle Stricke reißen, können Sie mit diesem Benutzer alles verwalten. Und falls Sie gar die Anmeldedaten vergessen haben sollten, können Sie über ein app/console Kommando den Benutzer zurücksetzen: fom:user:resetroot.
+* Benutzerverwaltung durch einen Administrator
+* Registierung eines Benutzers
+* Zurücksetzung des eigenen Passworts
+
+Der Benutzer mit der ID 1 (root) ist besonders, da dieser Benutzer bei der Installation erstellt wird und immer alle Rechte hat. Falls alle Stricke reißen, können Sie mit diesem Benutzer alles verwalten. Und falls Sie gar die Anmeldedaten vergessen haben sollten, können Sie über ein app/console Kommando den Benutzer zurücksetzen: *fom:user:resetroot*.
 
-.. note:: **Hinweis:** Um die untenstehenden Funktionen nutzen zu können, muss der Symfony Swiftmailer korrekt eingerichtet sein. Bitte überprüfen Sie Ihre lokale Symfony-Version und nutzen Sie die offizielle Symfony-Dokumentation zur Einrichtung des Tools: https://symfony.com/doc/current/mailer.html
 
 Passwort vergessen
 ------------------
@@ -18,7 +21,7 @@ Falls ein Benutzer sein Passwort vergessen hat, kann er in der Login-Maske über
 
 .. image:: ../../../../de/functions/backend/FOM/user_forgot_password.png
 
-Danach bekommt der Benutzer eine E-Mail mit einem Link, die zu der Seite führt, um das Passwort zurückzusetzen. Der Link ist danach nicht mehr gültig. Der Text der Mail kann in der Datei /FOM/UserBundle/Resources/translations/messages.de.xlf angepasst werden.
+Danach bekommt der Benutzer eine E-Mail mit einem Link zur Zurücksetzung des Passworts. Der Link ist nach der Nutzung nicht mehr gültig. Der Text der Mail kann in der Datei /FOM/UserBundle/Resources/translations/messages.de.xlf angepasst werden.
 
 Die Funktionalität kann in der config.yml ausgeschaltet werden.
 
@@ -31,14 +34,14 @@ Die Funktionalität kann in der config.yml ausgeschaltet werden.
 Registrierung
 -------------
 
-Benutzer können sich an Mapbender selbst registrieren. Dafür stellt man in der config.yml die Einstellung fom_user:selfregister auf true.
+Benutzer können sich in Mapbender selbst registrieren. Dafür stellt man in der config.yml die Einstellung *fom_user:selfregister* auf true.
 
 .. code-block:: yaml
 
                 fom_user:
                     selfregister: false # true/false
 
-Im Login-Dialog erscheint der "Register" Link. Der Benutzer wird zu einer Maske geführt, in der er seinen Namen, sein Passwort und seine E-Mail Adresse angeben kann.
+Im Login-Dialog erscheint der "Register" Link. Der Benutzer wird zu einer Maske geführt, in der er Name, Passwort und E-Mail Adresse angeben kann.
 
 .. image:: ../../../../de/functions/backend/FOM/user_self_register.png
 
@@ -50,7 +53,7 @@ Die Texte der Bestätigungsmail können unter /FOM/UserBundle/Resources/translat
 Aktivieren von Nutzern
 ----------------------
 
-Benutzer können von Administratoren mit der ACL-Rolle "edit" aktiviert oder deaktiviert werden. Ein Benutzer mit Administrationsrechten kann sich selbst nicht aktivieren oder deaktivieren.
+Benutzer können von Administratoren mit der ACL-Rolle *edit* aktiviert oder deaktiviert werden. Ein Benutzer mit Administrationsrechten kann sich selbst nicht aktivieren oder deaktivieren.
 
 .. image:: ../../../../de/functions/backend/FOM/edit_user_activated.png
 
@@ -59,14 +62,14 @@ Ein Benutzer, der deaktiviert ist, kann sich so lange nicht mehr im Mapbender an
 Benutzer, die sich selbst registriert haben, aber die Freischaltungsmail noch nicht bestätigt haben, können so von einem Administrator per Hand freigeschaltet werden.
 
 
-Usermanagement über Sicherheitsschlüsselabfrage
+User-Management per Sicherheitsschlüsselabfrage
 -----------------------------------------------
 
-Innerhalb jeder Mapbender-Applikation besteht zusätzlich die Möglichkeit der Rechtevergabeanpassung. Im Tab "Layouts" findet sich diese Einstellung in Form eines Schlüssels neben jedem Element.
+Die Möglichkeit der Rechtevergabe kann in jeder Mapbender-Applikation anpasst werden. Im Tab "Layouts" findet sich diese Einstellung in Form eines Schlüssels neben jedem Element.
 
-Um anzupassen, ob jemand Zugriff auf ein individuelles Element innerhalb einer Anwendung hat, muss zunächst auf den Schlüssel geklickt werden. Im Anschluss kann ein Nutzer hinzugefügt werden. Dies geschieht über das "+"-Symbol.
+Mit einem Klick auf den Schlüssel wird der Benutzerzugriff auf ein Element angepasst. Im Anschluss kann ein Nutzer hinzugefügt werden. Dies geschieht über das "+"-Symbol.
 
-Ein gesetzter Haken neben dem entsprechenden Nutzeraccount erlaubt dem jeweiligen Nutzer den Zugriff. Der Schlüssel wird nach erfolgreicher Rechtevergabe rot. Wenn Sie nun den Cursor über den Schlüssel halten, sehen Sie die Namen der berechtigten Nutzer in einem Pop-Up Fenster.
+Ein gesetzter Haken neben dem entsprechenden Nutzer-Account erlaubt dem jeweiligen Nutzer den Zugriff. Der Schlüssel wird nach erfolgreicher Rechtevergabe rot. Wenn Sie nun den Cursor über den Schlüssel halten, sehen Sie die Namen der berechtigten Nutzer in einem Pop-Up Fenster.
 
 .. image:: ../../../../de/functions/backend/FOM/element_security_key_popup.png