qwe987299/flarum-auto-ban-spam

自動偵測違規關鍵字，立即無限期停權帳號、改暱稱為 Banned、清空簡介與頭像，並依照所設定的處置方式進行處理。Auto detect keywords to ban user indefinitely, reset nickname to Banned, wipe profile, and handle content according to configured strategy.

Maintainers

Package info

github.com/qwe987299/flarum-auto-ban-spam

Homepage

Type:flarum-extension

pkg:composer/qwe987299/flarum-auto-ban-spam

Transparency log

Statistics

Installs: 13

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.6 2026-07-30 12:22 UTC

Requires

MIT de3b874688b113f2cb114c8e8f1fd343db8bbffe

securityspambanflarum

Published on Packagist.org on 2026-07-30 12:22 UTC

This package is auto-updated.

Last update: 2026-07-30 12:22:30 UTC

README

Flarum Extension License

當系統偵測到使用者名稱、暱稱、簡介/簽名檔（Bio）、主題標題或留言內文包含後台設定的違規關鍵字時，自動執行安全防護處置：

  • 無限期停權：自動將該帳號停權至 2099-12-31。
  • 手動無限期停權按鈕：支援於前台使用者選單（User Controls）手動觸發一鍵停權與資料清理，並彈出二階段確認視窗。
  • 變更顯示暱稱：統一變更顯示暱稱（Nickname）為 Banned（username 保持不變）。
  • 清空個人資料與實體檔案：自動清空與實體刪除使用者頭像圖檔、個人頁面背景圖與縮圖檔案 (Profile Cover，支援 sycho/flarum-profile-cover)、個人簡介/簽名檔 (Bio，支援 fof/user-bio)，以及社群網路按鈕連結 (Social Profile Buttons，支援 fof/socialprofile)。
  • 註冊天數過濾 (僅檢測註冊 X 天內的帳號)：可自訂防護天數（例如設定 30 代表僅對註冊 30 天內的新會員進行關鍵字自動檢測；設定 0 代表適用於所有會員）。（手動停權按鈕不受此天數限制影響）
  • 豁免權限群組 (不受影響的群組)：支援於 Flarum 權限矩陣中勾選豁免群組與允許手動執行停權的權限群組（管理員預設豁免與具備權限）。
  • 隱密安全提示：觸發封鎖時不會向使用者透露具體被比對成功的關鍵字，防止機器人測試邊界。
  • 使用者違規處置方式 (軟刪除 / 硬刪除)：
    • 軟刪除 (Soft Delete)：將該使用者過往發佈的所有主題（Discussions）與留言（Posts）執行隱藏 / 移入審核佇列，完整保留原始內文，並自動刷新討論區與個人資料統計頁。
    • 硬刪除 (Hard Delete)：從資料庫與實體儲存區中永久徹底刪除該帳號發佈的所有主題、留言，以及透過 FoF Upload (fof/upload) 上傳的所有圖片與檔案（僅限有啟用 FoF Upload 時自動清理）。
  • 後台管理介面：管理員可自訂違規關鍵字清單並切換使用者違規處置方式（軟刪除或硬刪除）。

👨‍💻 作者資訊 (Author)

🚀 安裝說明 (Installation)

於 Flarum 根目錄執行：

composer require qwe987299/flarum-auto-ban-spam
php flarum extension:enable qwe987299-auto-ban-spam

⚙️ 後台設定 (Configuration)

  1. 登入 Flarum 管理員後台。
  2. 前往 擴充套件 (Extensions) -> Auto Ban Spam Keywords：
    • 違規關鍵字清單：輸入要攔截的關鍵字（多個關鍵字可用換行、半形逗號「,」或全形逗號「，」分隔）。
    • 使用者違規處置方式：可選擇 軟刪除（隱藏 / 等候審核） 或 硬刪除（永久刪除主題、留言與 FoF Upload 上傳的檔案）。
    • 僅檢測註冊 X 天內的帳號：輸入天數數字（例如輸入 30 代表僅對註冊天數 30 天內的新會員進行關鍵字自動檢測；輸入 0 代表適用於所有會員）。
  3. 前往 權限 (Permissions) 頁面：
    • 於 Auto Ban Spam Keywords 區塊下設定：
      • 不受影響的群組：豁免關鍵字自動封鎖檢查的使用者群組。
      • 手動執行無限期停權：允許於前台使用者選單點擊按鈕對他人執行無限期停權的權限群組（如版主）。