mirror of
https://github.com/pretix/pretix.git
synced 2026-05-05 15:14:04 +00:00
92 lines
4.4 KiB
ReStructuredText
92 lines
4.4 KiB
ReStructuredText
Organizer accounts and teams
|
||
============================
|
||
|
||
Organizer account
|
||
-----------------
|
||
|
||
The basis of all your operations within pretix is your organizer account. It represents an entity that is running
|
||
events, for example a company, yourself or any other institution.
|
||
Every event belongs to one organizer account and events within the same organizer account are assumed to belong together
|
||
in some sense, whereas events in different organizer accounts are completely isolated.
|
||
|
||
If you want to use the hosted pretix service, you can create an organizer account on our `Get started`_ page. Otherwise,
|
||
ask your pretix administrator for access to an organizer account.
|
||
|
||
You can find out all organizer accounts you have access to by going to your global dashboard (click on the pretix logo
|
||
in the top-left corner) and then select "Organizers" from the navigation bar on the left side. Then, choose one of the
|
||
organizer accounts presented, if there are multiple of them:
|
||
|
||
.. thumbnail:: ../../screens/organizer/list.png
|
||
:align: center
|
||
:class: screenshot
|
||
|
||
This overview shows you all event that belong to the organizer and you have access to:
|
||
|
||
.. thumbnail:: ../../screens/organizer/event_list.png
|
||
:align: center
|
||
:class: screenshot
|
||
|
||
With the "Edit" button at the top, next to the organizer account name, you can modify properties of the organizer
|
||
account such as its name and display settings for the public profile page of the organizer account:
|
||
|
||
.. thumbnail:: ../../screens/organizer/edit.png
|
||
:align: center
|
||
:class: screenshot
|
||
|
||
.. tip::
|
||
|
||
The profile page will be shown as ``https://pretix.eu/slug/`` where ``slug`` is to be replaced by the short form of
|
||
the organizer name that you entered during account creation and ``pretix.eu`` is to be replaced by your
|
||
installation's domain name if you are not using our hosted service.
|
||
|
||
Instead, you can also use a custom domain for the profile page and your events, for example
|
||
``https://tickets.example.com/`` if ``example.com`` is a domain that you own. In this case, please contact the pretix
|
||
hosted support or your system administrator to set up the custom domain.
|
||
|
||
Teams
|
||
-----
|
||
|
||
We don't expect you to work on your events all by yourself and therefore, pretix comes with ways to invite your fellow
|
||
team members to access your pretix organizer account. To manage teams, click on the "Teams" link on your organizer
|
||
settings page (see above how to find it). This shows you a list of teams that should contain at least one team already:
|
||
|
||
.. thumbnail:: ../../screens/organizer/team_list.png
|
||
:align: center
|
||
:class: screenshot
|
||
|
||
If you click on a team name, you get to a page that shows you the current members of the team:
|
||
|
||
.. thumbnail:: ../../screens/organizer/team_detail.png
|
||
:align: center
|
||
:class: screenshot
|
||
|
||
You see that there is a list of pretix user accounts (i.e. email addresses), who are part of the team. To add a user to
|
||
the team, just enter their email address in the text box next to the "Add" button. If the user already has an account
|
||
in the pretix system they will instantly get access to the team. Otherwise, they will be sent an email with an invitation
|
||
link that can be used to create an account. This account will then instantly have access to the team. Users can be part
|
||
of as many teams as you want.
|
||
|
||
In the section below, you can also create access tokens for our :ref:`rest-api`. You can read more on this topic in the
|
||
section :ref:`rest-auth` of the API documentation.
|
||
|
||
Next to the team name, you again see a button called "Edit" that allows you to modify the permissions of the team.
|
||
Permissions separate into two areas:
|
||
|
||
* **Organizer permissions** allow actions on the level of an organizer account, in particular:
|
||
|
||
* Can create events – To create a new event under this organizer account, users need to have this permission
|
||
|
||
* Can change teams and permissions – This permission is required to perform the kind of action you are doing right now.
|
||
Anyone with this permission can assign arbitrary other permissions to themselves, so this is the most powerful
|
||
permission there is to give.
|
||
|
||
* Can change organizer settings – This permission is required to perform changes to the settings of the organizer
|
||
account, e.g. its name or display settings.
|
||
|
||
* **Event permissions** allow actions on the level of an event. You can give the team access to all events
|
||
|
||
.. thumbnail:: ../../screens/organizer/team_edit.png
|
||
:align: center
|
||
:class: screenshot
|
||
|
||
.. _Get started: https://pretix.eu/about/en/setup |