README

Edit the customer email address on a placed Magento order. Fix typos, handle customer-service requests, keep a complete audit trail of every change. Admin-only. Hyvä-safe by design.

Commercial eTechFlow module. Per-domain HMAC license or eTechFlow bundle key activates the module on your production host. Dev / staging / *.magento.cloud / localhost etc. auto-detect and bypass licensing.

What it adds

Edit Email button on every admin order detail page (Order & Account Information panel)
A modal: current email shown, new email input, "also update the linked customer account" checkbox
Email Change History grid at Sales → Operations → Order Email Change History — every change with admin user, IP, timestamp
Atomic DB update of every place Magento stores the email (order, addresses, all 4 grid tables, optional customer record, defensive quote sync)

Features


Edit misspelled email on a placed order	✓
Update billing + shipping address rows on the order	✓
Auto-reindex Magento's order/invoice/shipment/creditmemo grid tables	✓
Optionally update the linked `customer_entity.email`	✓ (disabled for guest orders)
Defensive quote-table sync if the original quote still exists	✓
Full audit log with admin user, IP, timestamp	✓
Standard Magento ACL — granular per-role permissions	✓
Per-domain HMAC licensing + bundle key support	✓
Tideways span instrumentation (`ETechFlow_OEE_UpdateOrderEmail`)	✓
Verify CLI (`etechflow:oee:verify`)	✓
No frontend dependencies (admin-only module)	✓

Compatibility

Platform	Status
Magento Open Source 2.4.4 – 2.4.8	✓
Adobe Commerce 2.4.4 – 2.4.8	✓
Hyvä themes (any version)	✓ (admin-only — Hyvä re-skins the storefront only)
PHP 8.1 / 8.2 / 8.3 / 8.4	✓
MySQL 8 / MariaDB 10.6+	✓

Installation

# Option A — Composer
composer require etechflow/module-order-email-editor:^1.0
bin/magento module:enable ETechFlow_OrderEmailEditor
bin/magento setup:upgrade
bin/magento setup:di:compile      # production mode only
bin/magento setup:static-content:deploy -f en_GB  # production mode only
bin/magento cache:flush

# Option B — Manual drop-in
cp -r ETechFlow/OrderEmailEditor app/code/ETechFlow/OrderEmailEditor
bin/magento module:enable ETechFlow_OrderEmailEditor
bin/magento setup:upgrade
bin/magento setup:di:compile      # production mode only
bin/magento cache:flush

The setup:upgrade step creates one new database table: etechflow_email_change_history.

Licensing

Admin → Stores → Configuration → eTechFlow → Order Email Editor → License

Field	Default	What it does
Production Environment	Yes	Yes = check the license key against the current domain. No = run at full features without a key (use on dev/staging on non-standard domains).
License Key	(empty)	Paste the per-domain key from your purchase email.

If you bought the eTechFlow bundle, enter the bundle key under any module's License section — it activates all eTechFlow modules at once.

Permissions (ACL)

Three new resources appear under System → Permissions → User Roles → Role Resources:

ETechFlow_OrderEmailEditor::edit_email — required to use the modal & POST to the update endpoint
ETechFlow_OrderEmailEditor::view_history — required to view the history grid
ETechFlow_OrderEmailEditor::config — required to view the admin config section

By default all three are granted to Administrators. Assign granularly to limited roles as needed.

Usage

Admin → Sales → Orders → pick any order
In the Order & Account Information panel you'll see an Edit Email button under the existing email
Click it. A modal opens with:
- Current email shown for confirmation
- New email input
- "Also update the linked customer account" checkbox (hidden for guest orders)
Submit. The modal returns a success message, the email on the page updates inline, and a new row is written to etechflow_email_change_history

Viewing change history

Admin → Sales → Operations → Order Email Change History (or the URL /admin/order_email_editor/history/index)

Standard Magento UI Component grid with filterable columns: increment ID, old email, new email, admin who changed it, customer-record-updated flag, IP, timestamp.

Smoke test

After installing, confirm the module is healthy:

bin/magento etechflow:oee:verify

Should print ✅ ALL CHECKS PASSED. v1.0.0 verified.

What this module touches in the database

When the Change Email button is clicked, the module updates these tables in a single transaction:

Table	Column	How
`sales_order`	`customer_email`	via `OrderRepository::save()`
`sales_order_address`	`email` (both billing + shipping rows)	via `OrderRepository::save()`
`sales_order_grid`	`customer_email`	auto (Magento's `sales_order_save_after` observer reindexes)
`sales_invoice_grid`	`customer_email`	auto, same observer
`sales_creditmemo_grid`	`customer_email`	auto, same observer
`sales_shipment_grid`	`customer_email`	auto, same observer
`customer_entity`	`email`	only if checkbox is on AND `sales_order.customer_id` is set
`quote` + `quote_address`	`customer_email` / `email`	defensive — only if the original quote row still exists
`etechflow_email_change_history`	new row	inserted with old/new email, admin info, IP

Uninstall

bin/magento module:disable ETechFlow_OrderEmailEditor
# Optionally drop the history table:
mysql -e "DROP TABLE IF EXISTS etechflow_email_change_history" $DB
# If installed via Composer:
composer remove etechflow/module-order-email-editor
rm -rf app/code/ETechFlow/OrderEmailEditor   # if installed manually
bin/magento setup:upgrade
bin/magento cache:flush

License

Proprietary — see LICENSE.txt. Commercial licenses available at https://etechflow.com.

etechflow / module-order-email-editor

Maintainers

Package info

Statistics

Security