Document the default customer notifications (2.x) - #51
Open
glennjacobs wants to merge 1 commit into
Open
glennjacobs wants to merge 1 commit into
glennjacobs wants to merge 1 commit into
Conversation
Cover the branded lifecycle emails core now ships (lunarphp/lunar#2724): the default set and what each contains, the trigger rules (placed-order gate, the refund-issued key, per-fulfilment states only), and the four layers for customizing them (laravel-mail layout, lunar.views templates, lunar.translation copy, re-registering a key). Cross-reference from the fulfilments, orders and payment-driver pages, and add an upgrade-guide checklist item for stores migrating their v1 notification config. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
10 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Companion to lunarphp/lunar#2724, which ships nine branded, overridable default customer notifications for the order lifecycle in 2.x.
2.x/reference/notifications.mdx(rewritten): the default set and what each email contains; the trigger rules (rollup emails only for placed orders, therefund-issuedkey, per-fulfilment states only, which states stay silent, thenotifyflags); a "Customizing the default emails" section covering the four layers in the consuming app (laravel-maillayout,lunar.viewstemplates with the view data each receives and the shared partials,lunar.translationcopy, re-registering or forgetting a key); routing and queueing notes for the defaults; the admin dropdown contents. The manifest, manual send and routing sections are kept and updated.2.x/reference/fulfilments.mdx: names the four fulfilment-state defaults in the "Notifications on fulfilment events" section.2.x/reference/orders.mdx: "Notifying the customer" now mentions the shipped defaults.2.x/extending/payments.mdx: a warning that a driver placing the order insideauthorize()must record the capture before stampingplaced_at, and why.2.x/getting-started/overview/upgrade-guide.mdx: a manual-checklist item for stores coming from the v1lunar.orders.notificationsconfig, including therefund-issuedkey.No
docs.jsonchange: the notifications page already exists in the 2.x Reference navigation.Notes
next. The repo'sCLAUDE.mdsays v2 content targets a2.xbranch, but no such branch exists on origin and the2.x/folder is maintained onnext, so this follows the folder rather than the note. Happy to retarget if a2.xbranch is preferred.🤖 Generated with Claude Code