Teams update

docs/guides/teams.de.md

@@ -0,0 +1,89 @@
+# 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 selbst Administrator*innen-Rechte für das Veranstalterkonto.
+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).
+
+## How-To
+
+Navigieren Sie zu Ihrem :navpath:Veranstalterkonto →  :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 sehen, wenn Sie den Button :btn-icon:fa3-list:: rechts neben dem Teamnamen anklicken.
+Die Berechtigungen und Einstellungen für ein Team können Sie einsehen und ändern, wenn 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, müssen Sie ein neues Team anlegen und dafür die passenden Berechtigungen auswählen und dieses Team auf die gewünschten Veranstaltungen einschränken.
+
+Die Namenskonventionen für Ihre Teamnamen und die Berechtigungen hängen von Ihren individuellen Anforderungen ab.
+Die Namen und Berechtigungen können auch später noch jederzeit verändert werden.
+Es zahlt sich aber aus und Sie vermeiden zukünftige Probleme und Verwirrungen, wenn Sie hier ein wenig Zeit investieren und Ihre Anforderungen und Berechtigungen vorher festlegen, bevor Sie Kolleg*innen in die jeweiligen Teams einladen.
+Klicken Sie den Speichern Button, um das neu angelegte Team zu speichern.
+Danach werden Sie auf die Übersichtsseite der Team-Mitglieder weitergeleitet.
+
+!!! 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:Veranstalterkonto → :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 oder einfügen und rechts neben dem Eingabefeld auf 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 :fa3-shield: Symbol rechts neben der E-Mail-Adresse aufgelistet, abhängig davon, ob diese die Zwei-Faktor-Authentifizierung aktiviert haben 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 und die Nachricht "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 einschalten
+
+Sie können alle Team-Mitglieder dazu verpflichten, die Zwei-Faktor-Authentifizierung zu verwenden.
+Wählen Sie dazu ein bestehendes Team aus oder legen Sie ein neues an.
+Wählen Sie die Checkbox "Alle Mitglieder dieses Teams müssen Zwei-Faktor-Authentifizierung nutzen" an.
+Es kann ein paar Minuten dauern, bis dieses Setting für alle Mitglieder des Teams gilt.
+
+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 einrichten
+
+Wenn pretix Sie direkt nach dem Login zur Seite "Zwei-Faktor-Authentifizierung" weiterleitet, 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,19 +26,20 @@ 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.
+Under the "Organizer permissions" section you can either select the check box "All organizer permissions" and give it all permissions or grant the following individual organizer permissions:
+Set "Events" to "Access existing and create new events", "Gift cards" to "View and change", and "Customers" to "View and change".
 
-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".
-
-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.
 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".
+Again, this only applies to settings which are not controlled by any of the other checkboxes under "Event permissions" including plugin settings.
 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)".
 
 If you need to grant different permissions for other events, you need to create an additional team and use it to grant permissions for the other event.
@@ -49,8 +50,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")