Metadata-Version: 2.4
Name: pretix-listmonk
Version: 1.0.0
Summary: Pretix plugin to subscribe attendees to a Listmonk newsletter list
Author-email: Valentin Gosselin <valentin@gosselin.pro>
License: MIT
Project-URL: Homepage, https://github.com/valentin-gosselin/pretix-listmonk
Project-URL: Repository, https://github.com/valentin-gosselin/pretix-listmonk
Project-URL: Issues, https://github.com/valentin-gosselin/pretix-listmonk/issues
Keywords: pretix,plugin,listmonk,newsletter
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0

# pretix-listmonk

A Pretix plugin that automatically subscribes attendees to a [Listmonk](https://listmonk.app) newsletter list when they opt in during checkout.

## Features

- Adds an optional newsletter consent checkbox to the Pretix checkout contact form
- Automatically subscribes consenting attendees to a configured Listmonk list via the API
- Skips re-subscription if the email is already subscribed
- Stores Pretix metadata (event slug, order code) as Listmonk subscriber attributes
- Async processing via Celery to avoid blocking order confirmation

## Configuration

In the Pretix organizer/event settings, configure:

- **Listmonk URL** – e.g. `https://newsletter.example.com`
- **Listmonk API username**
- **Listmonk API password/token**
- **Listmonk List ID** – the numeric ID of the target list
- **Checkbox label** – the consent text shown to the attendee

## Installation

```bash
pip install pretix-listmonk
```

Or in development:

```bash
pip install -e /path/to/pretix-listmonk
```

## License

MIT
