CGM_Public/pretix_original
2
0
Fork 1
mirror of https://github.com/pretix/pretix.git synced 2026-05-05 15:14:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

describe new category options in docs

Browse Source
This commit is contained in:
Mira Weller
2024-10-02 09:29:05 +02:00
parent bef88bf0d0
commit d4f997c345
1 changed files with 35 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
doc/api/resources/categories.rst
View File

@@ -23,6 +23,21 @@ position integer An integer, use
is_addon boolean If ``true``, items within this category are not on sale is_addon boolean If ``true``, items within this category are not on sale
on their own but the category provides a source for on their own but the category provides a source for
defining add-ons for other products. defining add-ons for other products.
cross_selling_mode string If ``null``, cross-selling is disabled for this category.
If ``"only"``, it is only visible in the cross-selling
step.
If ``"both"``, it is visible on the normal index page
as well.
cross_selling_condition string Only relevant if ``cross_selling_mode`` is not ``null``.
If ``"always"``, Always show in cross-selling step.
If ``"products"``, Only if the cart contains one of
these products.
If ``"discounts"``, Only show products affected by
discount rules.
cross_selling_match_products list of integer Only relevant if ``cross_selling_condition`` is
``"products"``. Internal ID of the items of which at
least one needs to be in the cart for this category to
be shown.
===================================== ========================== ======================================================= ===================================== ========================== =======================================================
@@ -60,7 +75,10 @@ Endpoints
"internal_name": "", "internal_name": "",
"description": {"en": "Tickets are what you need to get in."}, "description": {"en": "Tickets are what you need to get in."},
"position": 1, "position": 1,
"is_addon": false "is_addon": false,
"cross_selling_mode": null,
"cross_selling_condition": null,
"cross_selling_match_products": []
} }
] ]
} }
@@ -102,7 +120,10 @@ Endpoints
"internal_name": "", "internal_name": "",
"description": {"en": "Tickets are what you need to get in."}, "description": {"en": "Tickets are what you need to get in."},
"position": 1, "position": 1,
"is_addon": false "is_addon": false,
"cross_selling_mode": null,
"cross_selling_condition": null,
"cross_selling_match_products": []
} }
:param organizer: The ``slug`` field of the organizer to fetch :param organizer: The ``slug`` field of the organizer to fetch
@@ -130,7 +151,10 @@ Endpoints
"internal_name": "", "internal_name": "",
"description": {"en": "Tickets are what you need to get in."}, "description": {"en": "Tickets are what you need to get in."},
"position": 1, "position": 1,
"is_addon": false "is_addon": false,
"cross_selling_mode": null,
"cross_selling_condition": null,
"cross_selling_match_products": []
} }
**Example response**: **Example response**:
@@ -147,7 +171,10 @@ Endpoints
"internal_name": "", "internal_name": "",
"description": {"en": "Tickets are what you need to get in."}, "description": {"en": "Tickets are what you need to get in."},
"position": 1, "position": 1,
"is_addon": false "is_addon": false,
"cross_selling_mode": null,
"cross_selling_condition": null,
"cross_selling_match_products": []
} }
:param organizer: The ``slug`` field of the organizer of the event to create a category for :param organizer: The ``slug`` field of the organizer of the event to create a category for
@@ -193,7 +220,10 @@ Endpoints
"internal_name": "", "internal_name": "",
"description": {"en": "Tickets are what you need to get in."}, "description": {"en": "Tickets are what you need to get in."},
"position": 1, "position": 1,
"is_addon": true "is_addon": true,
"cross_selling_mode": null,
"cross_selling_condition": null,
"cross_selling_match_products": []
} }
:param organizer: The ``slug`` field of the organizer to modify :param organizer: The ``slug`` field of the organizer to modify