| name | poocommerce-email-editor |
| description | Setup and develop the PooCommerce block email editor. Use when working on email templates, transactional emails, or the email editor feature. |
PooCommerce Email Editor Development
This skill provides guidance for developing the PooCommerce block email editor.
When to Use This Skill
Invoke this skill when:
- Setting up local development for the email editor
- Working on email templates or transactional emails
- Modifying the email editor PHP or JS packages
- Testing email sending functionality
Development Environment Setup
1. Start PooCommerce wp-env
pnpm --filter=@poocommerce/plugin-poocommerce -- wp-env start
Site runs at http://localhost:8888 by default. If port 8888 is unavailable, wp-env assigns a different port. Check the startup output or run wp-env info to see your actual URL.
2. Start the watcher
Watches and builds admin JS files (including the email editor JS package) and syncs Email Editor PHP package changes:
pnpm --filter=@poocommerce/plugin-poocommerce watch:build:admin
3. Enable the block email editor feature
Visit http://localhost:8888/wp-admin/admin.php?page=wc-settings&tab=advanced§ion=features and enable the block email editor.
4. Edit transactional emails
Visit http://localhost:8888/wp-admin/admin.php?page=wc-settings&tab=email
Email Testing with Mailpit
To test email sending locally, use Mailpit as a local SMTP server.
Configure SMTP
Add to plugins/poocommerce/.wp-env.override.json: