diff --git a/doc/screens/organizer/edit_sysadmin.png b/doc/screens/organizer/edit_sysadmin.png new file mode 100644 index 0000000000..718775c255 Binary files /dev/null and b/doc/screens/organizer/edit_sysadmin.png differ diff --git a/doc/user/events/create.rst b/doc/user/events/create.rst index 3dc8ddef22..2fb7bf9820 100644 --- a/doc/user/events/create.rst +++ b/doc/user/events/create.rst @@ -1,3 +1,5 @@ +.. _event_create: + Creating an event ================= diff --git a/doc/user/events/taxes.rst b/doc/user/events/taxes.rst index 6a08f57291..fe5bd7b8e0 100644 --- a/doc/user/events/taxes.rst +++ b/doc/user/events/taxes.rst @@ -1,5 +1,5 @@ -Tax rules -========= +Configuring taxes +================= In most countries, you will be required to pay some form of sales tax for your event tickets. If you don't know about the exact rules, you should consult a professional tax consultant right now. diff --git a/doc/user/faq.rst b/doc/user/faq.rst new file mode 100644 index 0000000000..69b6bff051 --- /dev/null +++ b/doc/user/faq.rst @@ -0,0 +1,51 @@ +FAQ and Troubleshooting +======================= + +How can I test my shop before taking it live? +--------------------------------------------- + +There are multiple ways to do this. + +First, you could just create some orders in your real shop and cancel/refund them later. If you don't want to process +real payments for the tests, you can either use a "manual" payment method like bank transfer and just mark the orders +as paid with the button in the backend, or if you want to use e.g. Stripe, you can configure pretix to use your keys +for the Stripe test sytem and use their test credit cars. Read our :ref:`Stripe documentation ` for more +information. + +Second, you could create a separate event, just for testing. In the last step of the :ref:`event creation process `, +you can specify that you want to copy all settings from your real event, so you don't have to do all of it twice. + +We are planning to add a dedicated test mode in a later version of pretix. + +If you are using the hosted service at pretix.eu and want to get rid of the test orders completely, contact us at +support@pretix.eu and we can remove them for you. Please note that we only are able to do that *before* you have +received any real orders (i.e. taken the shop public). We won't charge any fees for test orders or test events. + +How do I delete an event? +------------------------- + +It is currently not possible to delete events, you can just disable the shop by clicking the first square on your event +dashboard. Events can't be deleted as they most likely contain information on financial transactions which legally +needs to be kept on record for multiple years in most countries. + +If you are using the hosted service at pretix.eu and want to get rid of an event that you only used for testing, contact +us at support@pretix.eu and we can remove it for you. + +Why doesn't my product show up in the ticket shop? +-------------------------------------------------- + +If you created a product and it doesn't show up, please follow the following steps to find out why: + +1. Check if the product's "active" checkbox is enabled. +2. Check if the product is in a category that has the "Products in this category are add-on products" checkbox enabled. + If this is the case, the product won't show up on the shop front page, but only in the first step of checkout when + a product in the cart allows to add add-on products from this category. +3. Check if the product's "Available from" or "Available until" settings restrict it to a date range. +4. Check if the product's checkbox "This product will only be shown if a voucher matching the product is redeemed." is + enabled. If this is the case, the product will only be shown if the customer redeems a voucher that *directly* matches + to this product. It will not be shown if the voucher only is configured to match a quota that contains the product. +5. Check that a quota exists that contains this product. If your product has variations, check that at least one + variation is contained in a quota. If your event is an event series, make sure that the product is contained in a + quota that is assigned to the series date that you access the shop for. +6. If the sale period has not started yet or is already over, check the "Show items outside presale period" setting of + your event. \ No newline at end of file diff --git a/doc/user/index.rst b/doc/user/index.rst index c5d16fe4d4..06d51e4781 100644 --- a/doc/user/index.rst +++ b/doc/user/index.rst @@ -12,3 +12,5 @@ wanting to use pretix to sell tickets. events/taxes payments/index events/widget + organizers/domain + faq \ No newline at end of file diff --git a/doc/user/organizers/domain.rst b/doc/user/organizers/domain.rst new file mode 100644 index 0000000000..b34305114a --- /dev/null +++ b/doc/user/organizers/domain.rst @@ -0,0 +1,52 @@ +Using a custom domain +===================== + +By default, event shops built with pretix are accessible at ``https://///``, where +```` is ``pretix.eu`` if you are using our hosted service and ```` and ```` are the short +form versions of your organizer account name and event name, respectively. + +However, you are also able to use a custom domain for your ticket shops! If you work for "Awesome Party Corporation" +and your website is ``awesomepartycorp.com``, you might want to sell your tickets at ``tickets.awesomepartycorp.com`` +and with pretix, you can do this. On this page, you find out the necessary steps to take. + +With the pretix.eu hosted service +--------------------------------- + +Step 1: DNS Configuration +######################### + +Go to the website of the provider you registered your domain name with. Look for the "DNS" settings page in their +interface. Unfortunately, we can't tell you exactly how that is named and how it looks, since it is different for every +domain provider. + +Use this interface to add a new subdomain record, e.g. ``tickets`` of the type ``CNAME`` (might also be called "alias"). +The value of the record should be ``www.pretix.eu``. + +Step 2: Wait for the DNS entry to propagate +########################################### + +Submit your changes and wait a bit, it can regularly take up to three hours for DNS changes to propagate to the caches +of all DNS servers. You can try checking by accessing your new subdomain, ``http://tickets.awesomepartycorp.com``. +If DNS was changed successfully, you should see a SSL certificate error. If you ignore the error and access the page +anyways, you should get a pretix-themed error page with the headline "Unknown domain". + +Step 3: Tell us +############### + +Write an email to support@pretix.eu, naming your new domain and your organizer account. We will then generate a SSL +certificate for you (for free!) and configure the domain. + + +With a custom pretix installation +--------------------------------- + +If you installed pretix on a server yourself, you can also use separate domains for separate organizers. +First of all, configure your webserver or reverse proxy to pass requests to the new domain to pretix as well. +Then, go to the organizer account in pretix and click the "Edit" button. Enter the new domain in the "Custom Domain" +field, then you're done! + +.. thumbnail:: ../../screens/organizer/edit_sysadmin.png + :align: center + :class: screenshot + +Note that this field only shows up if you are logged in as a system administrator of your pretix installation.