DSSHOP 功能-消息通知

參數(shù)說明

• 參考
• 消息通知分為手動添加和添加觀察者，這里采用手動添加的方式
• 如發(fā)送的是小程序/公眾號/APP通知時，請確保參數(shù)包含?template?并配置了對應的模板ID
• 后臺消息通知接收需要關聯(lián)?user?用戶，通過配置?NOTIFICATION_ACCOUNT?實現(xiàn)，以逗號分割多個用戶
• 只有配置了小程序、微信公眾號、郵箱后，用戶開啟了對應的通知才會生效（小程序除外）

NOTIFICATION_ACCOUNT = "1,2"

示例代碼

$invoice = [
    'type' => InvoicePaid::NOTIFICATION_TYPE_DEAL,
    'title' => '恭喜您！購買的商品已支付成功，我們會盡快安排發(fā)貨哦！么么噠！~~',
    'list' => [
        [
            'keyword' => '訂單編號',
            'data' => $parameter['identification']
        ],
        [
            'keyword' => '商品名稱',
            'data' => $parameter['name']
        ],
        [
            'keyword' => '訂單總額',
            'data' => sprintf("%01.2f", $parameter['total'] / 100),
        ],
        [
            'keyword' => '支付方式',
            'data' => $parameter['type']
        ],
        [
            'keyword' => '訂單狀態(tài)',
            'data' => '已支付'
        ],
        [
            'keyword' => '下單時間',
            'data' => $parameter['time']
        ]
    ],
    'price' => $parameter['total'],
    'url' => '/pages/indent/detail?id=' . $parameter['id'],
    'parameter' => $parameter,
    'prefers' => ['database', 'mail', 'wechat']
];
$user = User::find($parameter['user_id']);
$user->notify(new InvoicePaid($invoice));

list的合法值

template 的合法值

使用：在env中配置對應的模板ID，模板ID通過微信公眾號中的模板消息中查找對應的"微信公眾號模版編號"進行添加，然后將得到的"模版ID"填入

WECHAT_SUBSCRIPTION_INFORMATION_FINISH_PAYMENT=
WECHAT_SUBSCRIPTION_INFORMATION_ORDER_CONFIRM_RECEIPT=
WECHAT_SUBSCRIPTION_INFORMATION_SHIPMENTS=
WECHAT_SUBSCRIPTION_INFORMATION_REFUND_SUCCESS=
WECHAT_SUBSCRIPTION_INFORMATION_ADMIN_ORDER_SEND_GOOD=
WECHAT_SUBSCRIPTION_INFORMATION_ADMIN_ORDER_COMPLETION=

prefers 的合法值

增加或刪除通知途徑

• 修改?Notifications/InvoicePaid.php?，?prefers?中添加或刪除通知途徑即可

增加新的通知模板

以下以微信公眾號通知為例

• 先去微信公眾平臺選擇自己想要的通知模板
• 添加配置常量

命名規(guī)則:以下劃線拼接，如是管理員通知，名稱前面加?admin_?，如?finish_payment?、?admin_subscribe?

#api\config\notification.php
'wechat'=>[ //微信公眾號
    'finish_payment'=>env('WECHAT_SUBSCRIPTION_INFORMATION_FINISH_PAYMENT',''),  //訂單支付成功通知
],

• 添加模板代碼

命名規(guī)則：根據上一步配置的常量名去掉下劃線，并采用駝峰命名法命名，如?finishPayment?、?adminSubscribe?

#api\app\Channels\WechatChannel.php
protected function finishPayment($notifiable, $message)
    {
        $data = [
            'template_id' => $this->information[$message['template']],
            'touser' => $notifiable->wechat,
            'data' => [
                'first' => '恭喜您！購買的商品已支付成功，我們會盡快安排發(fā)貨哦！么么噠！~~',
                'keyword1' => $message['identification'],
                'keyword2' => $message['name'],
                'keyword3' => sprintf("%01.2f", $message['total'] / 100),
                'keyword4' => '已支付',
                'keyword5' => $message['time'],
                'remark' => '歡迎您的到來！',
            ],
        ];
        if ($this->miniweixin) {
            $data['miniprogram'] = [
                'appid' => $this->miniweixin,
                'pagepath' => '/pages/indent/detail?id=' . $message['id'],
            ];
        } else {
            $data['url'] = request()->root() . '/h5/#/pages/indent/detail?id=' . $message['id'];
        }
        //發(fā)送記錄
        $send = $this->app->template_message->send($data);
        $NotificationLog = new NotificationLog();
        $NotificationLog->user_id = $message['user_id'];
        $NotificationLog->type = NotificationLog::NOTIFICATION_LOG_TYPE_MINIWEIXIN;
        $NotificationLog->msg = json_encode($data);
        $NotificationLog->feedback = json_encode($send);
        $NotificationLog->state = $send['errcode'] == 0 ? NotificationLog::NOTIFICATION_LOG_STATE_OK : NotificationLog::NOTIFICATION_LOG_STATE_ERROR;
        $NotificationLog->save();
    }

其他操作

• 訪問database通知

$user = App\User::find(1);
$user->notifications->toArray(); //所用該用戶下的通知
$user->unreadNotifications->toArray(); //所用該用戶下未讀的通知

• 將某條通知設為已讀

$user->unreadNotifications->where('id','8b9e0bc4-eb3f-4d36-aad9-2dce24a495c6')->markAsRead();   //對某個信息進行已讀標記
$user->unreadNotifications()->update(['read_at' => now()]);   //所有的通知標為已讀