From 96c8ce961e6757d8497bd712dd261c0d90e16423 Mon Sep 17 00:00:00 2001 From: wakqasahmed Date: Fri, 28 Aug 2026 09:12:47 +0200 Subject: [PATCH] docs(orders): clarify notifications config key has no effect The Order Notifications section described mailers and notifications as if both were dispatched the same way, but only mailers are wired up anywhere in Lunar core - the notifications array is read nowhere. Fixes #2359. --- 1.x/reference/orders.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/1.x/reference/orders.mdx b/1.x/reference/orders.mdx index 8d2a541..2b60e9f 100644 --- a/1.x/reference/orders.mdx +++ b/1.x/reference/orders.mdx @@ -468,7 +468,7 @@ The key factor for an order is whether the `placed_at` column is populated. Ever ## Order Notifications -Lunar allows specifying which Laravel mailers and notifications should be available when updating an order's status. These are configured in `config/lunar/orders.php`: +Lunar allows specifying which Laravel mailers should be available when updating an order's status. These are configured in `config/lunar/orders.php`: ```php 'statuses' => [ @@ -493,6 +493,10 @@ Lunar stores a render of the sent email in the activity log, providing a clear h These email notifications are not sent automatically when updating the status programmatically outside of the admin panel. + +The `notifications` key is present in the default config but is not currently read anywhere in Lunar — defining notifications here has no effect. Only `mailers` are dispatched. If you need to notify someone (staff, customer, a Slack channel, etc.) when an order's status changes outside the admin panel, listen for the update yourself, for example by observing the `Order` model's `updated` event and checking `$order->wasChanged('status')`. + + ### Mailer Template When building a mailer template, the `$order` model is available in the view data. When the status is updated, the order is passed through along with any additional content entered. Since additional content may not always be present, check for its existence first.