# All-in-One Communication System V16.7

V16.7 refines the Email Theme Creator into a cleaner, more professional studio with a calmer three-zone layout, a tabbed design/block/preview workspace, better block context, and a separated template library so the builder feels more premium and less cluttered.

## New in V16.7
- Reorganizes the Template Creator into a more professional block library, canvas, and studio-tab layout
- Moves preview into its own tab with desktop and narrow preview modes for a calmer editing experience
- Adds workflow guidance, selected-block context, block counts, and a cleaner save bar
- Separates the saved template library from the main builder so the canvas stays focused
- No database migration is required for V16.7 because this is a UI and editor-experience refinement only




V16.7 refines the Email Theme Creator into a cleaner, more premium studio experience with a calmer left rail, larger center artboard, focused right-side inspector, and collapsible advanced code tools so the builder feels more professional instead of jumbled.

## New in V16.7
- Cleans up the Email Theme Creator into a more professional studio layout with a larger artboard and less visual crowding
- Keeps the drag-and-drop block rail on the left while giving the canvas more space and clearer placement guides
- Moves advanced HTML and CSS tools into a collapsible power-tools panel so day-to-day editing stays cleaner
- Improves the right-side settings and block inspector into a more focused editing column with live preview underneath
- Adds live block-count and selected-block status badges for better builder feedback
- No database migration is required for V16.7 because this is a UI and editor-layout cleanup only

V16.6 rebuilds the Email Theme Creator into a true drag-and-drop template canvas with a block library, reorderable layout surface, live block inspector, and saved HTML/CSS output so theme creation behaves more like a real commercial email designer.

## New in V16.6
- Rebuilds the Templates editor into a true drag-and-drop Email Theme Creator with a visual block library and canvas
- Adds click-or-drag block insertion for Hero, Text, Image, Two Column, CTA, Divider, and Footer sections
- Adds draggable canvas reordering plus duplicate and remove controls directly on each block
- Adds a dedicated block inspector so section content can be edited without hunting through raw HTML
- Keeps direct HTML and CSS editing with live preview for advanced users
- No database migration is required for V16.6 because the builder continues storing its metadata inside the saved template body

V16.5 adds a built-in Email Theme Creator so teams can design reusable commercial email layouts with preset sections, live preview, direct HTML/CSS editing, and saved template library support without leaving the app.

## New in V16.5
- Adds a built-in **Email Theme Creator** inside Templates with preset newsletter, announcement, promotion, event, retention, and custom starting points
- Adds a visual section builder for hero, text, image, two-column, CTA, divider, and footer blocks
- Adds direct **HTML** and **CSS** editors with live preview so advanced users can fine-tune email markup before saving
- Saves email themes as reusable templates that remain compatible with Campaign Studio, Mail Center, one-to-one email sends, and canned email template pickers
- Adds quick access to the Email Theme Creator from Campaign Studio and refreshes the Templates navigation copy to surface the new builder
- Stores theme editor metadata inside the saved template body, so **no database migration is required** for V16.5

V16.4.1 fixes Mail Center Outbox drift by marking failed email sends correctly, releasing status-managed folder overrides, and preventing manual moves into computed folders like Outbox and Sent while keeping the broader V16.4 commercial campaign roadmap intact.

## New in V16.4.1
- Fixes outbound email failures so manual sends, replies, campaign sends, and campaign test sends are marked `failed` instead of staying `queued`
- Adds a repair pass that clears old `mail_conversations.folder_key` overrides for `outbox` and `sent` and converts stale queued outbound email rows into `failed`
- Prevents manual folder moves and mailbox rules from targeting computed system folders like Outbox and Sent

## New in V16.4
- Adds a new **Commercial Campaign Command Center** under Campaigns for deliverability, automation, observability, governance, AI assist, and marketplace controls
- Adds a deliverability and compliance suite with DNS planning for SPF, DKIM, DMARC, BIMI, one-click unsubscribe, warm-up, safe-launch, holdback, seed-list, and provider failover settings
- Adds database-backed **automation rules** that can react to inbound messages and webhook events to move conversations, apply labels, assign owners, route to shared mailboxes, pause campaigns, force queue, switch mail transport, and create follow-up tasks
- Adds **reputation snapshots** to track inbox rate, spam rate, bounce rate, complaint rate, and reputation score by provider/domain over time
- Adds **event webhook logging** for Twilio and SendGrid-style event capture so diagnostics can show replayable webhook observability data
- Adds **connector marketplace** records for Google Workspace, Microsoft 365, Stripe, CRM/webhooks, and Zapier/Make style integrations
- Adds **sender profiles** for alias-based outbound identity management
- Extends Mail Center with **saved views**, **pin**, **mute**, **claim ownership**, conversation **sensitivity** levels, and an **AI assist** panel
- Extends Settings with connector and sender-profile management, plus Diagnostics with a webhook observability panel
- Adds migration support for the new V16.4 tables and mail-conversation fields

V16.3 cleans up Mail Center into an Outlook-style layout with a lighter command bar, cleaner folder rail, Roomy/Cozy/Compact density controls, Right/Bottom/Focus reading-pane modes, a more scannable conversation list, and a single tabbed insights panel for workflow, CRM, campaigns, and notes.

## New in V16.3
- Outlook-style Mail Center cleanup with a compact command header and cleaner search/filter row
- Density controls for Roomy, Cozy, and Compact list spacing
- Reading pane controls for Right, Bottom, and Focus modes
- Simplified folder rail with system folders, custom folders, labels, mailbox organization, and rules grouped more cleanly
- Conversation list redesigned to read more like Outlook on the web with clearer sender / subject / preview / received columns
- Tabbed insights panel replaces stacked CRM, workflow, campaign, and note cards to reduce visual clutter

## What is new in V15
- Drag-and-drop email builder for campaign composition
- Advanced analytics charts for delivery, opens, clicks, bounces, and channel volume
- System Health + Deliverability Center with provider readiness, queue pressure, bounce watch, suppression trends, and recovery visibility
- Multi-variant testing for control, Variant A, and Variant B campaign comparisons
- Campaign preflight checks to catch provider, audience, subject, content, and list/channel issues before launch
- Manual **Add to List** field under **Add Contact** so a new client can be saved directly into an existing imported list

## New in V15.2
- More spacious, less clustered contact management layout with better section spacing and responsive table wrappers
- Contacts list pagination now uses a compact page slider with Previous/Next controls instead of a long page-number strip
- Duplicate-safe contact creation and CSV import based on existing **email or phone number** matches
- Existing contact records are reused and lightly refreshed with missing details instead of creating duplicates
- List imports now report how many rows were new, reused, or skipped

## New in V15.3
- Fixes the provider test crash shown as:

  `flash(): Argument #2 ($message) must be of type ?string, array given`

  The flash helper now accepts structured payloads, so provider diagnostics no longer break app startup after live connection tests.
- Splits the former **Inbox & Campaigns** navigation into separate menu groups:
  - **Inbox -> SMS/MMS** for individual SMS/MMS sending, conversation workflow, threaded view, and canned replies
  - **Inbox -> Email** for individual email sending, conversation workflow, threaded view, and canned replies
  - **Campaigns -> Campaign Dashboard** for delivery rate, bounce rate, queue backlog, suppressed, System Health + Deliverability Center, deliverability trend, channel volume + failures, campaign comparison, template performance, segment performance, and recent suppression watchlist
  - **Campaigns -> Campaign Studio** for designing campaigns
  - **Campaigns -> Campaign Reports** for recovery queue, campaign queue, and report access
- Keeps backward compatibility by redirecting the old `messages/index` entry point into the new dedicated pages

## New in V15.4
- Rebuilds the sidebar into larger grouped navigation cards so links are easier to click and scan
- Adds clearer sectioning for **Workspace**, **Inbox**, **Campaigns**, and **Admin**
- Increases sidebar width, link padding, and active-state contrast for better usability
- Improves mid-size and mobile behavior by keeping navigation available in a cleaner stacked layout instead of hiding it entirely
- Adds short helper text under each menu item so users can understand where each link goes before clicking

## New in V15.5
- Expands the **Commercial Campaign** workspace so **Studio Readiness** now lives inside the main commercial campaign panel instead of as a detached side card
- Keeps campaign design, readiness metrics, deliverability alerts, and launch guidance together in one easier-to-scan commercial campaign area
- Hardens SMTP test-email sending so TLS and certificate warnings no longer dump raw PHP warnings to the browser or break redirects
- Adds safer SMTP diagnostics with clearer messages when the remote certificate does not match the configured host
- Adds an automatic **SendGrid fallback** from SSL/465 to TLS/587 during app SMTP connections when the configured SendGrid SSL endpoint fails
- Adds in-app SMTP guidance that recommends **TLS on port 587** for SendGrid

## New in V15.6
- Adds a selectable **Mail Transport** setting with support for **SendGrid API**, **SMTP**, and **PHP mail()**
- Adds direct SendGrid v3 Mail Send delivery using a Bearer-authenticated API key, bypassing host SMTP proxies and certificate mismatch issues
- Adds SendGrid sandbox validation to the Provider Status panel so admins can test the integration without delivering a live email
- Adds SendGrid Event Webhook support using the existing `webhook/emailEvent` route with an optional shared webhook token guard
- Surfaces SendGrid endpoint, masked API key, and webhook URL details in Provider Status
- Keeps SMTP available for environments where direct SendGrid API usage is not preferred

## New in V15.7
- Adds operator controls for currently running or queued campaigns: **Start**, **Pause**, **Stop**, **Restart**, and **Force Queue**
- **Pause** halts processing while keeping unsent recipients in the queue for later resume
- **Stop** halts a run until an operator explicitly restarts or force-queues it again
- **Restart** returns failed campaign recipients to the queue and launches a fresh processing pass
- **Force Queue** immediately pulls a campaign back into the processing queue after SMTP, provider, or deliverability settings are changed
- Campaign processing now respects pause/stop controls mid-run instead of continuing to send until the batch finishes
- Queue seeding now deduplicates pending `campaign_process` jobs so cron and manual actions do not stack duplicate campaign workers
- Finished runs with failed recipients are now marked **failed** instead of being mislabeled as fully **sent**

## New in V16.0
- Adds a Gmail-style **Mail Center** module inside Inbox
- Keeps campaign delete controls available for campaigns created by mistake before any send activity starts
- Includes **Inbox**, **Outbox**, **Sent**, **Junk**, and **Trash** views for internal email management
- Adds **custom folders** that can be created from the browser with no schema migration
- Lets users move an email conversation into any system or custom folder
- Keeps threaded email review, compose, reply, templates, and canned replies in the same module

## New in V16.2
- Completes the Mail Center Phase 2, Phase 3, and Phase 4 redesign work on top of V16.0
- Adds database-backed **folders and subfolders** with legacy custom-folder import compatibility
- Adds database-backed **labels** and multi-label assignment for email conversations
- Adds simple mailbox **rules** to classify conversations into folders and labels using from/subject/body matching
- Adds **Focused / Other**, **star**, **archive**, and **snooze** organization controls to the 3-pane Mail Center
- Adds a slide-over **compose drawer** plus **autosave drafts** for compose and inline reply
- Improves threaded reading with attachment previews, message cards, and richer conversation metadata
- Adds a business mailbox sidebar with **CRM context**, **campaign linkage**, **shared mailboxes**, **assignment**, **internal notes**, **SLA state**, and **approval workflow** controls
- Keeps the prior V16.0 Mail Center, custom folders, threaded email, canned replies, and delete-campaign safeguards

## Import/list fix included
This build keeps the list import SQL fix for:

`SQLSTATE[23000]: Integrity constraint violation: 1052 Column 'email' in WHERE is ambiguous`

The contact and list queries fully qualify joined columns such as `email`, `id`, and `created_at`, which resolves ambiguous-column failures during imports and related contact lookups.

## Key files updated in V16.2
- `README.md`
- `VERSION`
- `app/controllers/MessagesController.php`
- `app/controllers/SettingsController.php`
- `app/controllers/WebhookController.php`
- `app/helpers/functions.php`
- `app/services.php`
- `app/views/messages/campaign_dashboard.php`
- `app/views/messages/campaign_studio.php`
- `app/views/messages/index.php`
- `app/views/messages/report.php`
- `app/views/settings/index.php`
- `app/views/settings/profile.php`
- `app/views/settings/provider_status.php`
- `config/config.example.php`

## Browser-based deployment
- `public/install.php` includes an **Update Center** for admin-run, browser-based update package uploads
- Update packages are applied with automatic file backups under `storage/updates/backups/`
- A standalone browser updater can still be used for one-time deployments when shell access is unavailable

## Notes
- Database repair / migration is required for the V16.2 mailbox tables, and the browser Update Center will run it automatically after applying the package
- Duplicate prevention is still active for manual adds plus both CSV import flows
- Existing saved lists can still be reused directly from the Add Contact form
- For SendGrid API, create an API key with Mail Send permission and use `https://api.sendgrid.com` unless you specifically need the EU regional base URL
- For SendGrid SMTP, the preferred fallback configuration in this app remains **smtp.sendgrid.net + TLS + port 587**

## New in V16.5
- Adds a built-in **Email Theme Creator** inside Templates with preset starts, reusable sections, live preview, and saved theme support
- Keeps full **HTML** and **CSS** editing available so email layouts can still be tuned by hand after the visual builder generates the base markup
- Makes saved email themes reusable in Campaign Studio, Mail Center, and one-to-one email workflows

## New in V16.6
- Rebuilds the Email Theme Creator into a true **drag-and-drop template canvas** instead of a simple section form
- Fixes the **+ Hero**, **+ Text**, and other block actions so they add sections reliably through more defensive event wiring
- Adds a draggable **block palette** for Hero, Text, Image, Two Column, CTA, Divider, and Footer sections
- Lets existing sections be **reordered by drag-and-drop**, duplicated, cleared, reset from the active preset, or removed inline
- Keeps the generated **HTML**, custom **CSS**, and live preview synchronized with the builder canvas for advanced editing
- Improves the Template Creator layout so the palette, canvas, and preview/editor are easier to use like a real email design tool

## New in V16.7
- Refines the Email Theme Creator into a cleaner **elite studio** layout so the builder no longer feels clustered or jumbled
- Splits the workspace into a focused **left setup rail**, **center design stage**, and **right inspection / preview rail** for a more professional design workflow
- Adds a **structure outline** so blocks can be selected quickly without hunting through the canvas
- Tucks the raw **HTML + CSS editor** behind an advanced panel so code tools stay available without crowding the visual builder
- Improves builder hierarchy with stronger command bars, block counts, preset status, and cleaner canvas cards
- Adds **desktop / mobile preview toggles** for a more polished review experience while keeping saved template compatibility unchanged
