# WordPress.org Plugin Directory — Listing Kit

Use this when submitting **Black Bean Tables** to the Plugin Directory.

## Short description (max ~150 chars)

> Work OS for WordPress — boards, Kanban, workflows, automations, and REST API. Monday-style apps from your data.

## Tags (suggested)

`project-management`, `crm`, `kanban`, `database`, `api`, `workflow`, `automation`, `tables`

## Screenshots to capture

Save as `assets/screenshots/screenshot-N.png` (1280×720 or 1200×900 recommended).

| # | Filename | Screen | What to show |
|---|----------|--------|--------------|
| 1 | screenshot-1.png | Dashboard | Boards list, stats, template cards, onboarding hero (empty site) |
| 2 | screenshot-2.png | Board Grid | Grid with filters, inline status, item panel open |
| 3 | screenshot-3.png | Kanban | Drag columns, cards with assignee/status |
| 4 | screenshot-4.png | Workflows | Workflow builder + **Pending approvals** queue |
| 5 | screenshot-5.png | Inbox | Notifications filtered by workflow type |
| 6 | screenshot-6.png | Integrations | API keys, OAuth, workflow notifications toggle |
| 7 | screenshot-7.png | Automations | Trigger + action builder |
| 8 | screenshot-8.png | Calendar | Month view with bulk status badges |

### Capture tips

- Use a clean Laragon site (`blackbean.test`) with **Projects** template installed
- Hide browser UI; use WP admin with default theme or a neutral admin-only crop
- Blur or fake any personal email in inbox screenshots

## FAQ (also in readme.txt)

**Does this require Monday.com?**  
No. Self-hosted on your WordPress site.

**Does it replace ACF or custom post types?**  
It complements them. Black Bean Tables adds app-style boards, views, and API on dedicated SQL tables.

**Is multisite supported?**  
Single-site is fully supported. Multisite has not been formally tested.

**Can I expose data via API?**  
Yes. REST under `/wp-json/blackbean-tables-schemas/v1/` with API keys or OAuth.

## Support & links

- **Docs:** `docs/GETTING-STARTED.md`
- **Issues:** https://github.com/vinhnxab/blackbean-tables/issues
- **Repo:** https://github.com/vinhnxab/blackbean-tables

## Submission checklist

- [ ] `readme.txt` stable tag matches plugin header version
- [ ] GPL-compatible `license.txt` or readme license line
- [ ] No bundled credentials or `.env` in zip
- [ ] 5–8 screenshots uploaded to SVN `assets/` branch
- [ ] `npm run build` run before packaging (compiled CSS in repo)
- [ ] Smoke: `npm run test:all`

## Social copy (EN)

**Twitter / LinkedIn (short)**  
Shipped Black Bean Tables v4.63.0 — a self-hosted Work OS for WordPress: boards, Kanban, workflow approvals, automations, REST API. No SaaS lock-in. #WordPress #OpenSource

**Twitter / LinkedIn (long)**  
We just hit v4.63.0 on Black Bean Tables — Monday-style project boards inside WordPress. Grid & Kanban views, workflow approvals with inbox notifications, automations, OAuth/API keys, and row-level permissions. Built for agencies and teams who want data ownership. Try it: github.com/vinhnxab/blackbean-tables

## Social copy (VI)

**Ngắn**  
Black Bean Tables v4.63.0 — Work OS trên WordPress: board, Kanban, workflow phê duyệt, automation, REST API. Self-hosted, không phụ thuộc SaaS.

**Dài**  
v4.63.0 đã sẵn sàng pilot production: quản lý dự án kiểu Monday ngay trong WordPress — grid/kanban, phê duyệt chuyển status lùi, inbox thông báo, API OAuth, phân quyền theo assignee. Phù hợp agency và team cần làm chủ dữ liệu.