{"id":50732689,"url":"https://github.com/etechflow/module-order-email-editor","last_synced_at":"2026-06-10T10:30:38.495Z","repository":{"id":362922020,"uuid":"1244604954","full_name":"etechflow/module-order-email-editor","owner":"etechflow","description":"Edit the customer email on a placed order, optionally sync to the linked customer account, keep an audit trail of every change. Admin-only, Hyvä-safe. Magento Open Source + Adobe Commerce compatible.","archived":false,"fork":false,"pushed_at":"2026-06-06T14:14:52.000Z","size":59,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-06T16:03:01.044Z","etag":null,"topics":["admin","audit-log","customer-service","ecommerce","etechflow","hyva","hyva-compatible","magento-2","magento-module","magento2","magento2-module","orders","php"],"latest_commit_sha":null,"homepage":"https://etechflow.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/etechflow.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T12:25:40.000Z","updated_at":"2026-06-06T14:14:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/etechflow/module-order-email-editor","commit_stats":null,"previous_names":["etechflow/module-order-email-editor"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/etechflow/module-order-email-editor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etechflow%2Fmodule-order-email-editor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etechflow%2Fmodule-order-email-editor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etechflow%2Fmodule-order-email-editor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etechflow%2Fmodule-order-email-editor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/etechflow","download_url":"https://codeload.github.com/etechflow/module-order-email-editor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/etechflow%2Fmodule-order-email-editor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34149132,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","audit-log","customer-service","ecommerce","etechflow","hyva","hyva-compatible","magento-2","magento-module","magento2","magento2-module","orders","php"],"created_at":"2026-06-10T10:30:37.665Z","updated_at":"2026-06-10T10:30:38.481Z","avatar_url":"https://github.com/etechflow.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ETechFlow_OrderEmailEditor\n\nEdit 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.\n\nCommercial 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.\n\n## What it adds\n\n- **Edit Email button** on every admin order detail page (Order \u0026 Account Information panel)\n- A modal: current email shown, new email input, \"also update the linked customer account\" checkbox\n- **Email Change History grid** at *Sales → Operations → Order Email Change History* — every change with admin user, IP, timestamp\n- Atomic DB update of every place Magento stores the email (order, addresses, all 4 grid tables, optional customer record, defensive quote sync)\n\n## Features\n\n| | |\n|---|---|\n| Edit misspelled email on a placed order | ✓ |\n| Update billing + shipping address rows on the order | ✓ |\n| Auto-reindex Magento's order/invoice/shipment/creditmemo grid tables | ✓ |\n| Optionally update the linked `customer_entity.email` | ✓ (disabled for guest orders) |\n| Defensive quote-table sync if the original quote still exists | ✓ |\n| Full audit log with admin user, IP, timestamp | ✓ |\n| Standard Magento ACL — granular per-role permissions | ✓ |\n| Per-domain HMAC licensing + bundle key support | ✓ |\n| Tideways span instrumentation (`ETechFlow_OEE_UpdateOrderEmail`) | ✓ |\n| Verify CLI (`etechflow:oee:verify`) | ✓ |\n| No frontend dependencies (admin-only module) | ✓ |\n\n## Compatibility\n\n| Platform | Status |\n|---|---|\n| Magento Open Source 2.4.4 – 2.4.8 | ✓ |\n| Adobe Commerce 2.4.4 – 2.4.8 | ✓ |\n| Hyvä themes (any version) | ✓ (admin-only — Hyvä re-skins the storefront only) |\n| PHP 8.1 / 8.2 / 8.3 / 8.4 | ✓ |\n| MySQL 8 / MariaDB 10.6+ | ✓ |\n\n## Installation\n\n```bash\n# Option A — Composer\ncomposer require etechflow/module-order-email-editor:^1.0\nbin/magento module:enable ETechFlow_OrderEmailEditor\nbin/magento setup:upgrade\nbin/magento setup:di:compile      # production mode only\nbin/magento setup:static-content:deploy -f en_GB  # production mode only\nbin/magento cache:flush\n\n# Option B — Manual drop-in\ncp -r ETechFlow/OrderEmailEditor app/code/ETechFlow/OrderEmailEditor\nbin/magento module:enable ETechFlow_OrderEmailEditor\nbin/magento setup:upgrade\nbin/magento setup:di:compile      # production mode only\nbin/magento cache:flush\n```\n\nThe `setup:upgrade` step creates one new database table: `etechflow_email_change_history`.\n\n## Licensing\n\n**Admin → Stores → Configuration → eTechFlow → Order Email Editor → License**\n\n| Field | Default | What it does |\n|---|---|---|\n| **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). |\n| **License Key** | (empty) | Paste the per-domain key from your purchase email. |\n\nIf you bought the eTechFlow bundle, enter the bundle key under any module's *License* section — it activates all eTechFlow modules at once.\n\n## Permissions (ACL)\n\nThree new resources appear under **System → Permissions → User Roles → Role Resources**:\n\n- `ETechFlow_OrderEmailEditor::edit_email` — required to use the modal \u0026 POST to the update endpoint\n- `ETechFlow_OrderEmailEditor::view_history` — required to view the history grid\n- `ETechFlow_OrderEmailEditor::config` — required to view the admin config section\n\nBy default all three are granted to *Administrators*. Assign granularly to limited roles as needed.\n\n## Usage\n\n1. **Admin → Sales → Orders → pick any order**\n2. In the **Order \u0026 Account Information** panel you'll see an **Edit Email** button under the existing email\n3. Click it. A modal opens with:\n   - Current email shown for confirmation\n   - New email input\n   - \"Also update the linked customer account\" checkbox (hidden for guest orders)\n4. 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`\n\n### Viewing change history\n\n**Admin → Sales → Operations → Order Email Change History** (or the URL `/admin/order_email_editor/history/index`)\n\nStandard Magento UI Component grid with filterable columns: increment ID, old email, new email, admin who changed it, customer-record-updated flag, IP, timestamp.\n\n## Smoke test\n\nAfter installing, confirm the module is healthy:\n\n```bash\nbin/magento etechflow:oee:verify\n```\n\nShould print `✅ ALL CHECKS PASSED. v1.0.0 verified.`\n\n## What this module touches in the database\n\nWhen the **Change Email** button is clicked, the module updates these tables in a single transaction:\n\n| Table | Column | How |\n|---|---|---|\n| `sales_order` | `customer_email` | via `OrderRepository::save()` |\n| `sales_order_address` | `email` (both billing + shipping rows) | via `OrderRepository::save()` |\n| `sales_order_grid` | `customer_email` | **auto** (Magento's `sales_order_save_after` observer reindexes) |\n| `sales_invoice_grid` | `customer_email` | auto, same observer |\n| `sales_creditmemo_grid` | `customer_email` | auto, same observer |\n| `sales_shipment_grid` | `customer_email` | auto, same observer |\n| `customer_entity` | `email` | **only if** checkbox is on AND `sales_order.customer_id` is set |\n| `quote` + `quote_address` | `customer_email` / `email` | defensive — only if the original quote row still exists |\n| `etechflow_email_change_history` | new row | inserted with old/new email, admin info, IP |\n\n## Uninstall\n\n```bash\nbin/magento module:disable ETechFlow_OrderEmailEditor\n# Optionally drop the history table:\nmysql -e \"DROP TABLE IF EXISTS etechflow_email_change_history\" $DB\n# If installed via Composer:\ncomposer remove etechflow/module-order-email-editor\nrm -rf app/code/ETechFlow/OrderEmailEditor   # if installed manually\nbin/magento setup:upgrade\nbin/magento cache:flush\n```\n\n## License\n\nProprietary — see `LICENSE.txt`. Commercial licenses available at \u003chttps://etechflow.com\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fetechflow%2Fmodule-order-email-editor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fetechflow%2Fmodule-order-email-editor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fetechflow%2Fmodule-order-email-editor/lists"}