Implement a command to dismiss a notice.

Implement and use an API endpoint to dismiss a notice.

Author: Cyperghost

ts/WoltLabSuite/Core/Api/Notices/DismissNotice.ts

@@ -0,0 +1,22 @@
+/**
+ * Dismiss a notice.
+ *
+ * @author Olaf Braun
+ * @copyright 2001-2025 WoltLab GmbH
+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @since 6.3
+ * @woltlabExcludeBundle tiny
+ */
+
+import { prepareRequest } from "WoltLabSuite/Core/Ajax/Backend";
+import { ApiResult, apiResultFromError, apiResultFromValue } from "../Result";
+
+export async function dismissNotice(noticeId: number): Promise<ApiResult<[]>> {
+  try {
+    await prepareRequest(`${window.WSC_RPC_API_URL}core/notices/${noticeId}/dismiss`).post().fetchAsJson();
+  } catch (e) {
+    return apiResultFromError(e);
+  }
+
+  return apiResultFromValue([]);
+}

ts/WoltLabSuite/Core/Controller/Notice/Dismiss.ts

@@ -7,31 +7,26 @@
  * @woltlabExcludeBundle tiny
  */
 
-import * as Ajax from "../../Ajax";
+import { dismissNotice } from "WoltLabSuite/Core/Api/Notices/DismissNotice";
+import { promiseMutex } from "WoltLabSuite/Core/Helper/PromiseMutex";
 
 /**
  * Initializes dismiss buttons.
  */
 export function setup(): void {
-  document.querySelectorAll(".jsDismissNoticeButton").forEach((button) => {
-    button.addEventListener("click", (ev) => click(ev));
+  document.querySelectorAll<HTMLElement>(".jsDismissNoticeButton").forEach((button) => {
+    button.addEventListener(
+      "click",
+      promiseMutex(() => click(button)),
+    );
   });
 }
 
 /**
  * Sends a request to dismiss a notice and removes it afterwards.
  */
-function click(event: Event): void {
-  const button = event.currentTarget as HTMLElement;
+async function click(button: HTMLElement): Promise<void> {
+  await dismissNotice(parseInt(button.dataset.objectId!, 10));
 
-  Ajax.apiOnce({
-    data: {
-      actionName: "dismiss",
-      className: "wcf\\data\\notice\\NoticeAction",
-      objectIDs: [button.dataset.objectId!],
-    },
-    success: () => {
-      button.parentElement!.remove();
-    },
-  });
+  button.parentElement!.remove();
 }

wcfsetup/install/files/js/WoltLabSuite/Core/Api/Notices/DismissNotice.js

@@ -241,6 +241,7 @@ static function (\wcf\event\endpoint\ControllerCollecting $event) {
             $event->register(new \wcf\system\endpoint\controller\core\notices\DeleteNotice());
             $event->register(new \wcf\system\endpoint\controller\core\notices\GetShowOrder());
             $event->register(new \wcf\system\endpoint\controller\core\notices\ChangeShowOrder());
+            $event->register(new \wcf\system\endpoint\controller\core\notices\DismissNotice());
             $event->register(new \wcf\system\endpoint\controller\core\reactions\types\EnableType());
             $event->register(new \wcf\system\endpoint\controller\core\reactions\types\DisableType());
             $event->register(new \wcf\system\endpoint\controller\core\reactions\types\DeleteType());

wcfsetup/install/files/js/WoltLabSuite/Core/Controller/Notice/Dismiss.js

@@ -0,0 +1,63 @@
+<?php
+
+namespace wcf\command\notice;
+
+use wcf\data\notice\Notice;
+use wcf\event\notice\NoticeDismissed;
+use wcf\system\event\EventHandler;
+use wcf\system\user\storage\UserStorageHandler;
+use wcf\system\WCF;
+
+/**
+ * Dismisses a notice for the current user.
+ *
+ * @author Olaf Braun
+ * @copyright 2001-2025 WoltLab GmbH
+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @since 6.3
+ */
+final class DismissNotice
+{
+    public function __construct(
+        private readonly Notice $notice,
+    ) {}
+
+    public function __invoke(): void
+    {
+        if (!$this->notice->isDismissible) {
+            return;
+        }
+
+        if (WCF::getUser()->userID) {
+            $this->dismissForUser($this->notice, WCF::getUser()->userID);
+        } else {
+            $this->dismissForGuest($this->notice);
+        }
+
+        $event = new NoticeDismissed($this->notice);
+        EventHandler::getInstance()->fire($event);
+    }
+
+    private function dismissForUser(Notice $notice, int $userID): void
+    {
+        $sql = "INSERT IGNORE INTO  wcf1_notice_dismissed
+                                    (noticeID, userID)
+                VALUES              (?, ?)";
+        $statement = WCF::getDB()->prepare($sql);
+        $statement->execute([
+            $notice->noticeID,
+            $userID,
+        ]);
+
+        UserStorageHandler::getInstance()->reset([WCF::getUser()->userID], 'dismissedNotices');
+    }
+
+    private function dismissForGuest(Notice $notice): void
+    {
+        $sessionVar = WCF::getSession()->getVar('dismissedNotices') ?? '';
+        $dismissedNotices = @\unserialize($sessionVar) ?: [];
+        $dismissedNotices[] = $notice->noticeID;
+
+        WCF::getSession()->register('dismissedNotices', \serialize($dismissedNotices));
+    }
+}

wcfsetup/install/files/lib/bootstrap/com.woltlab.wcf.php

@@ -2,12 +2,11 @@
 
 namespace wcf\data\notice;
 
+use wcf\command\notice\DismissNotice;
 use wcf\data\AbstractDatabaseObjectAction;
 use wcf\data\IToggleAction;
 use wcf\data\TDatabaseObjectToggle;
 use wcf\system\condition\ConditionHandler;
-use wcf\system\user\storage\UserStorageHandler;
-use wcf\system\WCF;
 
 /**
  * Executes notice-related actions.
@@ -76,33 +75,14 @@ public function delete()
      * Dismisses a certain notice.
      *
      * @return  int[]
+     *
+     * @deprecated 6.3 Use the `DismissNotice` command instead.
      */
     public function dismiss()
     {
-        if (WCF::getUser()->userID) {
-            $sql = "INSERT IGNORE INTO  wcf1_notice_dismissed
-                                        (noticeID, userID)
-                    VALUES              (?, ?)";
-            $statement = WCF::getDB()->prepare($sql);
-            $statement->execute([
-                \reset($this->objectIDs),
-                WCF::getUser()->userID,
-            ]);
-
-            UserStorageHandler::getInstance()->reset([WCF::getUser()->userID], 'dismissedNotices');
-        } else {
-            $dismissedNotices = WCF::getSession()->getVar('dismissedNotices');
-            if ($dismissedNotices !== null) {
-                $dismissedNotices = @\unserialize($dismissedNotices);
-                $dismissedNotices[] = \reset($this->objectIDs);
-            } else {
-                $dismissedNotices = [
-                    \reset($this->objectIDs),
-                ];
-            }
-
-            WCF::getSession()->register('dismissedNotices', \serialize($dismissedNotices));
-        }
+        $editor = $this->getSingleObject();
+
+        (new DismissNotice($editor->getDecoratedObject()))();
 
         return [
             'noticeID' => \reset($this->objectIDs),
@@ -113,6 +93,8 @@ public function dismiss()
      * Validates the 'dismiss' action.
      *
      * @return void
+     *
+     * @deprecated 6.3
      */
     public function validateDismiss()
     {

wcfsetup/install/files/lib/command/notice/DismissNotice.class.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace wcf\event\notice;
+
+use wcf\data\notice\Notice;
+use wcf\event\IPsr14Event;
+
+/**
+ * Indicates that a notice has been dismissed by the current user.
+ *
+ * @author Olaf Braun
+ * @copyright 2001-2025 WoltLab GmbH
+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @since 6.3
+ */
+final class NoticeDismissed implements IPsr14Event
+{
+    public function __construct(public readonly Notice $notice) {}
+}

wcfsetup/install/files/lib/data/notice/NoticeAction.class.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace wcf\system\endpoint\controller\core\notices;
+
+use Laminas\Diactoros\Response\JsonResponse;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use wcf\data\notice\Notice;
+use wcf\http\Helper;
+use wcf\system\endpoint\IController;
+use wcf\system\endpoint\PostRequest;
+use wcf\system\exception\PermissionDeniedException;
+
+/**
+ * API endpoint to dismiss a notice for the current user.
+ *
+ * @author Olaf Braun
+ * @copyright 2001-2025 WoltLab GmbH
+ * @license GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
+ * @since 6.3
+ */
+#[PostRequest('/core/notices/{id:\d+}/dismiss')]
+final class DismissNotice implements IController
+{
+    public function __invoke(ServerRequestInterface $request, array $variables): ResponseInterface
+    {
+        $notice = Helper::fetchObjectFromRequestParameter($variables['id'], Notice::class);
+
+        $this->assertNoticeCanBeDismissed($notice);
+
+        (new \wcf\command\notice\DismissNotice($notice))();
+
+        return new JsonResponse([]);
+    }
+
+    private function assertNoticeCanBeDismissed(Notice $notice): void
+    {
+        if (!$notice->isDismissible) {
+            throw new PermissionDeniedException();
+        }
+    }
+}