Metadata-Version: 2.4
Name: entirius-django-contact-forms
Version: 3.0.0
Summary: Forms Django module for Volkanos — contact forms, bookings, leads, ad-conversion uploads
Project-URL: Repository, https://github.com/entirius/entirius-django-contact-forms
Author: Entirius
Maintainer-email: Piotr Brzozowski <piotrb@entirius.com>, Paweł Kiełt <cptshooter12@gmail.com>, Mateusz Baran <mateuszbaranpv@gmail.com>, Michał Kloczkowski <michal@kloczkowski.pl>
License-Expression: MPL-2.0
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: amqp>=5.0
Requires-Dist: celery>=5.0
Requires-Dist: cryptography>=44.0
Requires-Dist: django>=4.0.0
Requires-Dist: djangorestframework-simplejwt>=5.3
Requires-Dist: djangorestframework>=3.14
Requires-Dist: drf-spectacular>=0.27
Requires-Dist: entirius-django-regional>=2.0.1
Requires-Dist: entirius-django-utils>=2.0.0
Requires-Dist: entirius-py-idx-normalizator>=2.0.0
Requires-Dist: entirius-py-process-logger>=2.0.0
Requires-Dist: marshmallow-dataclass>=8.5.3
Requires-Dist: marshmallow<4,>=3.15
Requires-Dist: pydantic[email]>=2.0
Provides-Extra: bookings
Requires-Dist: entirius-py-google-calendar-sdk>=2.0.0; extra == 'bookings'
Provides-Extra: dev
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: email
Requires-Dist: entirius-django-email>=4.0.1; extra == 'email'
Provides-Extra: google-ads
Requires-Dist: entirius-py-google-ads-sdk>=2.0.0; extra == 'google-ads'
Provides-Extra: test
Requires-Dist: dj-database-url; extra == 'test'
Requires-Dist: factory-boy; extra == 'test'
Requires-Dist: psycopg[binary]; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-django; extra == 'test'
Description-Content-Type: text/markdown

# Contact Forms

Forms Django module for Volkanos — channel-scoped contact form submissions with attachments,
per-type notification routing, booking calendar (optional Google Calendar backend), lead tracking
and Google Ads offline-conversion uploads.

## Install

```bash
uv pip install entirius-django-contact-forms
```

Optional extras:

```toml
"entirius-django-contact-forms[bookings,google-ads,email]>=3.0.0"
```

- `bookings` — Google Calendar backend for the booking endpoint.
- `google-ads` — click-conversion uploads for leads.
- `email` — branded notification e-mails via `entirius-django-email` (no-op fallback without it).

Add `django_contact_forms` to `INSTALLED_APPS` (requires `django_regional`); set `PRIVATE_DIR`.
Full settings reference and architecture: [AGENTS.md](AGENTS.md).

## Development and testing

```bash
make install   # uv sync, incl. extras
make check     # ruff lint + format-check
make test      # pytest (postgres via DATABASE_URL)
```
