App Event Test Emails

Editing notification emails blind is frustrating — you save, trigger a real event, check your inbox, repeat. This function adds a Send test email button to every notification on Voxel's App Events screen, so you can preview any email instantly.

Overview

On Voxel → App Events, each notification's email panel gets a test row: an email address input (prefilled with your own) and a Send test email button. The test renders the email through the exact same pipeline as a real notification — dynamic tags filled with sample data ("Sample Post Title", "Sam Sample"), wrapped in Voxel's email template — and sends it with a [Test] subject prefix.

Key Features

• Test button on every notification, for every app event
• Tests unsaved edits — preview your template before saving it
• Dynamic tags render with readable sample data
• Uses Voxel's real email template and from-address, so tests look exactly like production
• Send to any address — your own by default
• [Test] subject prefix so tests are never mistaken for real notifications

Setup Instructions

1. Navigate to Voxel Toolkit → Functions and enable App Event Test Emails
2. Go to Voxel → App Events
3. Open any event and pick a notification tab with Send email notification switched on
4. The Send test email row appears under the message editor
5. Click send and check your inbox

How It Works

1. The button grabs the subject and message currently in the editor — including edits you haven't saved
2. Empty fields fall back to your saved configuration, then to Voxel's defaults
3. Dynamic tags are rendered with Voxel's own mock data, upgraded with friendly sample values
4. The email is wrapped in Voxel's email template and sent via your normal mail configuration

Use Cases

Template Design

Iterate on email layout and copy with instant feedback — no real events needed.

Deliverability Checks

Confirm your SMTP configuration delivers Voxel notifications correctly.

Client Previews

Send styled samples to a client's inbox before launch.

Troubleshooting

The test button doesn't appear

• The button only shows when Send email notification is enabled on that notification
• Hard-refresh the App Events screen after enabling the function

Test email never arrives

• Check your site's email/SMTP configuration — the test uses the same wp_mail() path as real notifications
• Check spam folders; the [Test] prefix can trip some filters

Some tags render empty

• Complex events (orders, bookings) may render some tags as blanks in test mode — the same fidelity as Voxel's dynamic tag preview. Layout and copy still preview accurately.