Teams update

docs/guides/teams.de.md

@@ -0,0 +1,92 @@
+# Teams
+
+Sie müssen nicht alle Events selbst managen.
+pretix erlaubt Ihnen, Kolleg*innen einzuladen und dafür unterschiedliche Teams mit unterschiedlichen Berechtigungen anzulegen.
+Dieser Artikel erklärt, wie Sie die "Teams"-Einstellungen nutzen, Teams anlegen, Team-Einladungen verschicken, eine solche Einladung selbst annehmen und wie Sie die Zwei-Faktor-Authentifizierung einschalten.
+
+## Voraussetzungen
+
+Um Teams anzulegen und die Berechtigungen zu verwalten, benötigen Sie in Ihrem Veranstalterkonto für "Teams" die Berechtigung "Lesen und ändern".
+Wenn Sie keinen Zugriff auf ein Veranstalterkonto haben, suchen Sie wahrscheinlich den Abschnitt, in dem erklärt wird, wie Sie eine Team-Einladung annehmen (LINK).
+
+## Anleitung
+
+Navigieren Sie zu :navpath:Ihr Veranstalter →  :fa3-users: Teams:.
+Diese Seite zeigt Ihnen sämtliche Teams Ihres Veranstalterkontos.
+Wenn Sie an dieser Stelle in Ihrem Veranstalterkonto noch keine Änderungen vorgenommen haben, wird hier nur ein Team mit dem Namen "Administratoren" gelistet.
+Dieses Team hat sämtliche Berechtigungen und enthält nur Ihr Benutzer*innenkonto.
+Sie können die Mitglieder eines Teams und die API-Tokens ansehen, indem Sie den Button :btn-icon:fa3-list:: rechts neben dem Teamnamen klicken.
+Die Berechtigungen und Einstellungen für ein Team können Sie einsehen und ändern, indem Sie den Button :btn-icon:fa3-edit:: anklicken.
+
+## Ein neues Team anlegen
+
+Wenn Sie in Ihrem Veranstalterkonto zu Teams navigieren, klicken Sie den Button :btn-icon:fa3-plus: Create a new team:, um ein neues Team anzulegen.
+
+Sie können den Namen und die Berechtigungen für das Team frei wählen.
+Das neue Team können Sie beispielsweise "Mitarbeiter*innen" nennen, um es vom Administratoren-Team zu unterscheiden.
+Sie können im Abschnitt "Veranstalter-Berechtigungen" entweder alle Berechtigungen vergeben, indem Sie die Checkbox "Alle Veranstalter-Berechtigungen" auswählen, oder beispielsweise die folgenden individuellen Veranstalter-Berechtigungen vergeben:
+"Veranstaltungen" auf "Zugang zu existieren Veranstaltungen und neue Veranstaltungen erstellen", "Wertgutscheine" auf "Lesen und ändern" und "Kunden" auf "Lesen und ändern" setzen.
+
+Die Option "Alle Veranstalter-Berechtigungen" bezieht sich auf sämtliche Einstellungen im Veranstalterkonto selbst, für die auf dieser Seite keine Optionen explizit aufgeführt sind.
+Wenn die URL der Einstellungs-Seite Ihres Veranstalterkontos /control/organizer/ enthält, dann wird die Berechtigung für die Optionen auf dieser Seite über die vorher genannte Option vergeben.
+Dies bezieht sich nur auf die Einstellungen, die nicht explizit auf dieser Seite unter "Veranstalter-Berechtigungen" auswählbar sind.
+
+Im Abschnitt "Veranstaltungs-Berechtigungen" können Sie entweder Zugriff auf alle Veranstaltungs-Berechtigungen vergeben, indem Sie die Option "Alle Veranstaltungs-Berechtigungen" auswählen.
+Wenn die URL der Einstellungs-Seite Ihrer Veranstaltung /control/event/ enthält, dann wird die Berechtigung für die Optionen auf dieser Seite über die vorher genannte Option vergeben.
+Dies bezieht sich nur auf die Einstellungen, die nicht explizit auf dieser Seite unter "Veranstaltungs-Berechtigungen" auswählbar sind.
+Oder Sie wählen beispielsweise die folgenden individuellen Berechtigungen aus: "Allgemeine Einstellungen" auf "Lesen und ändern", "Produkte, Kontingente und Fragen" auf "Lesen und ändern", "Bestellungen" auf "Alle lesen" und "Gutscheine" auf "Lesen und ändern" setzen.
+
+Wenn Sie unterschiedliche Berechtigungen für andere Veranstaltungen vergeben möchten, dann legen Sie ein neues Team an. 
+Wählen Sie die passenden Berechtigungen aus und schränken Sie das Team auf die gewünschten Veranstaltungen ein. 
+
+Der Namen und die genauen Berechtigungen, die Sie vergeben, hängen von Ihren individuellen Anforderungen ab.
+Sie können diese auch später noch jederzeit verändern.
+Sie können aber zukünftige Probleme und Verwirrung vermeiden, indem Sie Ihre Auswahl hier festlegen, bevor Sie Kolleg*innen in das Team einladen.
+Klicken Sie den Button :btn:Speichern:, um das neu angelegte Team zu speichern.
+Das leitet Sie auf eine Seite mit einer Übersicht der Team-Mitglieder weiter. 
+
+!!! Note
+  Wenn ein Team-Mitglied keine Berechtigung für einen Bereich des Systems hat, kann es eventuell trotzdem Daten dieses Bereichs einsehen, wenn dieser mit anderen Bereichen in pretix verknüpft ist.
+  Beispielsweise kann ein Team-Mitglied mit Berechtigung zum Zugriff auf die Bestellungen auch den Wertgutschein einsehen, der mit einer Bestellung angelegt oder zur Bezahlung einer Bestellung verwendet wurde.
+
+## Eine Person ins Team einladen
+
+Navigieren Sie zu :navpath:Ihr Veranstalter → :fa3-users: Teams: und wählen Sie das Team aus, für das Sie eine Einladung verschicken möchten.
+Sie können eine Person einladen, indem Sie die E-Mail-Adresse der Person in das Eingabefeld unterhalb der Mitgliederliste des Teams eingeben und rechts neben dem Eingabefeld den Button "Hinzufügen" klicken.
+Wenn die eingeladene Person bereits über ein pretix-Benutzerkonto verfügt und dieser die gleiche E-Mail-Adresse verwendet, wird die Person sofort dem Team hinzugefügt.
+In diesem Fall wird die Person nicht vom System benachrichtigt, weshalb Sie die Person darüber informieren sollten.
+Die Person wird entweder mit einem grauen oder grünen Schildsymbol :fa3-shield: rechts neben der E-Mail-Adresse aufgelistet, abhängig davon, ob diese die Zwei-Faktor-Authentifizierung aktiviert hat oder nicht.
+
+Wenn die eingeladene Person noch kein pretix-Benutzerkonto hat, erhält sie eine E-Mail mit einer Einladung, einen Account anzulegen.
+In diesem Fall erscheint rechts in der Mitglieder-Liste neben der E-Mail-Adresse ein :fa3-envelope-o: Symbol mit dem Status "eingeladen, Antwort ausstehend" und ein :btn-icon:fa3-rotate-right::-Button, um die Einladung erneut per E-Mail zu verschicken.
+
+!!! Note
+  Auf dieser Seite können Sie auch einen API-Token anlegen, der Zugriff auf die pretix-API erlaubt. 
+  Der API-Token erhält die gleichen Berechtigungen, die für die Mitglieder des Teams gelten. 
+  Weitere Informationen zu API-Tokens finden Sie in unserer [API-Dokumentation](https://docs.pretix.eu/en/latest/api/tokenauth.html).
+
+## Eine Einladung annehmen
+
+Wenn Sie zum Team eingeladen wurden und noch kein pretix-Benutzerkonto haben, erhalten Sie eine E-Mail wie oben auf dem Screenshot zu sehen.
+Wenn Sie den Link in der E-Mail anklicken, werden Sie zu pretix weitergeleitet und haben in dem Dialogfenster die Möglichkeit, ein Passwort anzugeben und den "Registrieren"-Button anzuklicken, um einen Account anzulegen.
+Sie werden daraufhin zum Dashboard weitergeleitet, das folgende Nachricht anzeigt: "Willkommen zu pretix! Sie sind nun Mitglied vom Team "Mitarbeiter*innen".
+Damit haben Sie Zugriff auf das Veranstalterkonto und die Veranstaltungen, so wie die Berechtigungen im Team "Mitarbeiter*innen" es vorsehen.
+
+Wenn Sie zu einem Team eingeladen wurden und bereits ein pretix-Benutzerkonto haben, können Sie sich in pretix einloggen und haben Zugriff auf das Veranstalterkonto und die Veranstaltungen, so wie die Berechtigungen im Team "Mitarbeiter*innen" es vorsehen.
+
+## Zwei-Faktor-Authentifizierung erfordern
+
+Sie können alle Mitglieder eines Teams dazu verpflichten, die Zwei-Faktor-Authentifizierung zu verwenden.
+Dazu bearbeiten Sie ein Team oder legen Sie ein neues an.
+Aktivieren Sie das Kontrollkästchen "Alle Mitglieder dieses Teams müssen Zwei-Faktor-Authentifizierung nutzen" und klicken Sie den Button :btn:Speichern:. 
+Es kann ein paar Minuten dauern, bis diese Einstellung wirksam wird.
+
+Wenn ein Team-Mitglied, das noch keine Zwei-Faktor-Authentifizierung verwendet, sich das nächste Mal in pretix einloggt, wird es auf die Seite "Zwei-Faktor-Authentifizierung" weitergeleitet.
+Es ist nicht möglich, diese Seite zu überspringen, bis die Zwei-Faktor-Authentifizierung aktiviert wurde.
+
+Wenn Sie mehr über die erhöhte Sicherheit erfahren möchten, welche die Zwei-Faktor-Authentifizierung mit sich bringt, und wie Sie diese für Ihr Benutzerkonto einschalten, lesen Sie unseren Artikel zur Zwei-Faktor-Authentifizierung (LINK).
+
+## Zwei-Faktor-Authentifizierung gemäß der Anforderung einrichten
+
+Wenn pretix Sie direkt nach dem Login zur Seite "Zwei-Faktor-Authentifizierung" weiterleitet und Sie keine andere Seite in pretix öffnen können, hat die Person, welche die Teams in Ihrem Veranstalterkonto verwaltet, die Option zur Verwendung der Zwei-Faktor-Authentifizierung verpflichtend für Ihr Benutzerkonto eingeschaltet.
+Um zu erfahren, wie Sie die Zwei-Faktor-Authentifizierung richtig einrichten, lesen Sie unseren Artikel zur Zwei-Faktor-Authentifizierung (LINK).

docs/guides/teams.md

@@ -26,17 +26,22 @@ You can view the settings and permissions by clicking the :btn-icon:fa3-edit:: b
 Having navigated to :navpath:Your organizer → :fa3-users: Teams:, click the :btn-icon:fa3-plus: Create a new team: button in order to create a new team.
 
 What you name your new team and which permissions you grant it is up to you.
-For example, you could name your team "Staff" to distinguish it from the administrators and give it the following organizer permissions:
-"Can create events", "Can manage gift cards", and "Can manage customer accounts".
+For example, you could name your team "Staff" to distinguish it from the administrators.
+If you want to give your team access to all organizer-level permissions, then, under the "Organizer permissions" heading, check the box next to "All organizer permissions". 
+If you want to give your team only some of those permissions, uncheck that box. 
 
-You could give the team access to "All events (including newly created ones)" and grant it the following event permissions:
-"Can change event settings", "Can change product settings", "Can view orders", "Can change orders", "Can view vouchers", and "Can change vouchers".
+A box will appear that allows you to set granular permissions for various aspects of the organizer account. 
+For instance, you could set "Events" to "Access existing and create new events", "Gift cards" to "View and change", and "Customers" to "View and change".
 
-The option "Can change organizer settings" applies to all settings which are nested under :navpath:Your organizer: and which are not controlled by any of the other options on this page.
+The option "Settings" applies to all settings which are nested under :navpath:Your organizer: and which are not controlled by any of the other options on this page.
 If the URL of the settings page for which you want to grant or revoke permissions includes `/control/organizer/`, then it is controlled by this option.
 Again, this only applies to settings which are not controlled by any of the other checkboxes under "Organizer permissions".
 
-The option "Can change event settings" applies to all settings which are nested under :navpath:Your event: and which are not controlled by any of the other options on this page.
+Under the "Event permissions" section you could give the team access to "All events (including newly created ones)" and either grant all event permissions or grant it the following permissions:
+"General settings" to "View and change", "Products quotas and questions" to "View and change", "Orders" to "View all", "Vouchers" to "View and change".
+
+The option "General settings" under event permissions applies to all settings which are nested under :navpath:Your event: and which are not controlled by any of the other options on this page.
+Among other things, it applies to plugin settings.
 If the URL of the settings page for which you want to grant or revoke permissions includes `/control/event/`, then it is controlled by this option.
 Again, this only applies to settings which are not controlled by any of the other checkboxes under "Event permissions".
 It also applies only to events you checked under "Limit to events", or to all events if you checked "All events (including newly created ones)".
@@ -49,8 +54,8 @@ Clicking the :btn:Save: button creates the team and takes you to an overview of
 
 !!! Note
     If a user does not have permission for one area of the system, they can still view some of the data of that area if it connects to other areas.
-    For example, a user with access to orders can see the gift card created or used in a specific order. 
-    This is still true if that user does not have permission for gift cards. 
+    For example, a user with access to orders can see the gift card created or used in a specific order.
+    This is still true if that user does not have permission for gift cards.
 ### Inviting someone to your team
 
 ![Page titled 'Team: Staff', listing three members, one of them has a mail icon next to their email address.](../assets/screens/teams/team-invite.png "Team: Staff screenshot")