ETechFlow_OrderEmailEditor

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

Compatibility

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

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

1. Admin → Sales → Orders → pick any order
2. In the Order & Account Information panel you'll see an Edit Email button under the existing email
3. 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)
4. 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:

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.

Changelog — ETechFlow Order Email Editor

All notable changes to this module. Adheres to Semantic Versioning.

[1.0.0] — 2026-05-19

Initial commercial release

Edit the customer email on a placed order. Fix typos, handle customer requests, keep an audit trail. Admin-only. Hyvä-safe by design.

Added

• Edit Email button on every order detail page (admin → Sales → Orders → pick order). Opens a modal: current email shown, new email input, optional "also update linked customer account" checkbox (hidden for guest orders).
• Email Change History grid at admin → Sales → Operations → Order Email Change History. Filterable Magento UI Component grid of every change made.
• Atomic DB update of all the places Magento stores the order email:
  • sales_order.customer_email
  • sales_order_address.email (both billing + shipping rows)
  • sales_order_grid + sales_invoice_grid + sales_creditmemo_grid + sales_shipment_grid (via Magento's core sales_order_save_after reindex)
  • customer_entity.email (if checkbox ticked + linked customer exists)
  • quote.customer_email + quote_address.email (defensive, only if quote still exists)
• Audit log in etechflow_email_change_history — admin id, admin name, old email, new email, customer-record-updated flag, IP, timestamp.
• Per-installation HMAC license with bundle-key support — same as every other eTechFlow module. Unlicensed installs silently hide the Edit Email button + history menu and reject the update endpoint with 403.
• Two ACL resources: edit_email (modal + update endpoint) and view_history (history grid). Granular per-role permissions.
• Profiler instrumentation — wraps the update path in an ETechFlow_OEE_UpdateOrderEmail Tideways span.
• Verify CLI — bin/magento etechflow:oee:verify checks DI resolution + DB table presence.
• Hyvä-safe — admin-only module with zero frontend assets. Hyvä themes never touch the admin.

Compatibility

• Magento Open Source 2.4.4 – 2.4.8
• Adobe Commerce 2.4.4 – 2.4.8
• PHP 8.1 / 8.2 / 8.3 / 8.4
• All Hyvä child themes