# Black Bean Forms — Features

Advanced form builder for WordPress — submissions land in **Black Bean Tables**, with email, spam protection, CRM routing, and analytics.

Current release: **v0.3.1**

Related: [GETTING-STARTED.md](./GETTING-STARTED.md) · [PRODUCT.md](./PRODUCT.md) · [CHANGELOG.md](../CHANGELOG.md)

---

## Builder & fields

| Feature | Notes |
|---------|--------|
| Form registry | Stored in WP options; entry tables provisioned per form |
| Field types | text, textarea, email, phone, number, url, select, checkbox, consent, file |
| Conditional logic | Show/hide fields |
| Multi-step | Wizard-style forms |
| Styling presets | default, compact, card |

## Submissions

| Feature | Notes |
|---------|--------|
| AJAX + POST fallback | Front-end shortcode / block |
| Spam | Honeypot + rate limit; optional reCAPTCHA v3 |
| Email | Admin notification + optional auto-reply |
| Webhooks | JSON payload, optional HMAC |
| CSV export | Entries inbox |

## Work OS (v0.3+)

| Feature | Notes |
|---------|--------|
| Board routing | Insert into CRM / Kanban board on submit |
| Automations | Fired via Tables `bb_tables_row_created` |
| Portal | `[blackbean_forms_portal id="…"]` for logged-in users |
| Analytics | Views, submissions, conversion, spam rate |

## Embedding

```
[blackbean_forms id="contact"]
[blackbean_forms_portal id="contact"]
```

Gutenberg block: `blackbean/forms`

## Requirements

- WordPress **6.0+**, PHP **8.1+**
- **Black Bean Tables** active