Metadata-Version: 2.4
Name: pretix-roomsharing
Version: 0.2.1
Summary: Pretix roomsharing allows attendees to setup with which people they'd like to share a room
Author-email: "Christiaan de Die le Clercq (techwolf12)" <contact@techwolf12.nl>
Maintainer-email: "Christiaan de Die le Clercq (techwolf12)" <contact@techwolf12.nl>
License-Expression: Apache-2.0
Project-URL: homepage, https://github.com/techwolf12/pretix-roomsharing
Keywords: pretix
Requires-Python: >=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
Dynamic: license-file

Roomsharing
==========================

This is a plugin for `pretix`_. 

Let attendees choose who they share a room with. Perfect for events with included accommodation, like conferences, camps, retreats and conventions.

During checkout, attendees with a room ticket create a room and share its name and password with their friends, who then join it. They can also ask to be assigned a random room. Attendees can change their room later from their order page.

Features
--------

* Choose which products, or individual product variations, include a room
* Set a maximum number of people per room for each product or variation. Full rooms can't be joined.
* Optionally only let people with the same ticket share a room, e.g. keep "Single" and "Double" rooms apart
* Decide whether attendees may be assigned a random room, or must create or join one
* Choose what roommates see about each other: order code, attendee name and/or answers to your own questions
* Manage rooms in the backend: see who is in which room and how full it is, move orders between rooms, and change or delete rooms
* Room statistics per product and date, with a metrics endpoint for monitoring
* Respects your order modification deadline, and works with event series

Requires pretix 2026.3 or newer.


Development setup
-----------------

1. Make sure that you have a working `pretix development setup`_.

2. Clone this repository.

3. Activate the virtual environment you use for pretix development.

4. Execute ``pip install -e .`` within this directory to register this application with pretix's plugin registry.

5. Execute ``make`` within this directory to compile translations.

6. Restart your local pretix server. You can now use the plugin from this repository for your events by enabling it in
   the 'plugins' tab in the settings.

This plugin has CI set up to enforce a few code style rules. To check locally, you need these packages installed::

    pip install flake8 isort black docformatter

To check your plugin for rule violations, run::

    docformatter --check -r .
    black --check .
    isort -c .
    flake8 .

You can auto-fix some of these issues by running::

    docformatter -r .
    isort .
    black .

To automatically check for these issues before you commit, you can run ``.install-hooks``.


License
-------


Copyright 2022-2026 Christiaan de Die le Clercq (techwolf12)

Released under the terms of the Apache License 2.0



.. _pretix: https://github.com/pretix/pretix
.. _pretix development setup: https://docs.pretix.eu/en/latest/development/setup.html
