Merge pull request #1677 from pretix/timeslot-docs

doc/user/events/guides/timeslots.rst

@@ -0,0 +1,89 @@
+.. _timeslots:
+
+Use case: Time slots
+====================
+
+A more advanced use case of pretix is using pretix for time-slot-based access to an area with a limited visitor
+capacity, such as a museum or other attraction. This guide will show you the quickest way to set up such an event
+with pretix.
+
+First of all, when creating your event, you need to select that your event represents an "event series":
+
+
+.. thumbnail:: ../../../screens/event/create_step1.png
+   :align: center
+   :class: screenshot
+
+You can click :ref:`here <subevents>` for a more general description of event series with pretix, but everything you
+need to know is in this chapter as well.
+
+Creating slots
+--------------
+
+To create the time slots, you need to create a number of "dates" in the event series. Select "Dates" in the navigation
+menu on the left side and click "Create many new dates". Then, first enter the pattern of your opening days. In the
+example, the museum is open week Tuesday to Sunday. We recommend to create the slots for a few weeks at a time, but not
+e.g. for a full year, since it will be more complicated to change things later.
+
+.. thumbnail:: ../../../screens/event/timeslots_create.png
+   :align: center
+   :class: screenshot
+
+Then, scroll to the times section and create your time slots. You can do any interval you like. If you have different
+opening times on different week days, you will need to go through the creation process multiple times.
+
+.. thumbnail:: ../../../screens/event/timeslots_create_2.png
+   :align: center
+   :class: screenshot
+
+Scroll further down and create one or multiple quotas that define how many people can book a ticket for that time slot.
+In this example, 50 people in total are allowed to enter within every slot:
+
+.. thumbnail:: ../../../screens/event/timeslots_create_3.png
+   :align: center
+   :class: screenshot
+
+Do **not** create a check-in list at this point. We will deal with this further below in the guide.
+Now, press "Save" to create your slots.
+
+.. warning:: If you create a lot of time slots at once, the server might need a few minutes to create them all in our
+             system. If you receive an error page because it took too long, please do not try again immediately but wait
+             for a few minutes. Most likely, the slots will be created successfully even though you saw an error.
+
+Event settings
+--------------
+
+We recommend that you navigate to "Settings" > "General" > "Display" and set the settings "Default overview style"
+to "Week calendar":
+
+.. thumbnail:: ../../../screens/event/timeslots_settings_1.png
+   :align: center
+   :class: screenshot
+
+Now, your ticket shop should give users a nice weekly overview over all time slots and their availability:
+
+.. thumbnail:: ../../../screens/event/timeslots_presale.png
+   :align: center
+   :class: screenshot
+
+Check-in
+--------
+
+If you want to scan people at the entrance of your event and only admit them at their designated time, we recommend
+the following setup: Go to "Check-in" in the main navigation on the left and create a new check-in list. Give it a name
+and do *not* choose a specific data. We will use one check-in list for all dates. Then, go to the "Advanced" tab at
+the top and set up two restrictions to make sure people can only get in during the time slot they registered for.
+You can create the rules exactly like shown in the following screenshot:
+
+.. thumbnail:: ../../../screens/event/timeslots_checkinlists.png
+   :align: center
+   :class: screenshot
+
+If you want, you can enter a tolerance of e.g. "10" if you want to be a little bit more relaxed and admit people up to
+10 minutes before or after their time slot.
+
+Now, download our `Android or Desktop app`_ and register it to your account. The app will ask you to select one the
+time slots, but it does not matter, you can select any one of them and then select your newly created check-in list.
+That's it, you're good to go!
+
+.. _Android or Desktop app: https://pretix.eu/about/en/scan

doc/user/events/structureguide.rst

@@ -344,3 +344,13 @@ In addition to your normal conference quota, you need to create an unlimited quo
 Then, head to the **Bundled products** tab of the "conference ticket" and add the "conference food" as a bundled product with a **designated price** of € 150.
 
 Once a customer tries to buy the € 450 conference ticket, a sub-product will be added and the price will automatically be split into the two components, leading to a correct computation of taxes.
+
+You can find more use cases in these specialized guides:
+
+More use cases
+--------------
+
+.. toctree::
+   :maxdepth: 1
+
+   guides/timeslots

doc/user/payments/settings.rst

@@ -1,8 +1,8 @@
 General settings
 ================
 
-At "Settings" → "Payment", you can configure every aspect related to the payments you want to accept. The upper part
-of the page shows a number of general settings that affect all payment methods:
+At "Settings" → "Payment", you can configure every aspect related to the payments you want to accept. The "Deadline"
+and "Advanced" tabs of the page show a number of general settings that affect all payment methods:
 
 .. thumbnail:: ../../screens/event/settings_payment.png
    :align: center