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.