Mô tả
Init Pulse For Discord gửi thông báo tự động đến kênh Discord của bạn mỗi khi một bài viết được xuất bản hoặc cập nhật.
Plugin này là một phần của Init Plugin Suite — bộ sưu tập các công cụ WordPress tối giản, nhanh, và hướng tới lập trình viên.
Kho GitHub: https://github.com/brokensmile2103/init-pulse-for-discord
Hoàn hảo cho:
- Thông báo blog / cộng đồng
- Quy trình biên tập nội bộ
- Cộng đồng vận hành bằng Discord
Cấu hình đơn giản:
- Dán URL webhook của bạn
- (Tùy chọn) Cấu hình ID role Discord — hoặc webhook riêng theo term — bên trong Chuyên mục hoặc Thẻ tag
- Xong — máy chủ của bạn nhận cập nhật ngay lập tức
Gọn gàng, tối giản, và được xây dựng vì hiệu năng — không cồng kềnh, không SDK bên ngoài.
Mục tiêu thiết kế chính:
- Thiết lập tối giản (Webhook + 1 trang cài đặt)
- Không gây rối cơ sở dữ liệu
- Không tốn thêm JS/CSS ở frontend
- Nhắc role thông minh thông qua danh mục phân loại
Tính năng
- Tự động gửi thông báo khi nội dung được xuất bản
- Thông báo tùy chọn khi nội dung được cập nhật
- Hỗ trợ Loại bài viết tùy chỉnh — chọn chính xác loại bài viết nào (bài viết, trang, sản phẩm, hoặc bất kỳ loại tùy chỉnh nào) sẽ kích hoạt thông báo
- Gắn thẻ role dựa trên Chuyên mục & Thẻ tag
Khi một bài viết thuộc danh mục phân loại đó, role đó sẽ được nhắc đến - Định tuyến Webhook theo Chuyên mục/Thẻ tag — tùy chọn gửi bài viết của một term đến webhook Discord riêng của nó (Username/Avatar riêng), với công tắc “Chỉ gửi đến webhook này” theo từng term để bỏ qua hoàn toàn webhook toàn cục
- Ô đánh dấu “Không gửi đến Discord” theo từng bài viết — cho phép một bài viết riêng lẻ bỏ khỏi mọi thông báo Discord (xuất bản/cập nhật và Hot Post Milestones), hiển thị khi bài viết chưa xuất bản, hoặc sau khi xuất bản nếu “Thông báo khi cập nhật” được bật
- Embed Discord phong phú — tiêu đề, mô tả, màu nhấn, chân trang, và dấu thời gian (kèm chế độ dự phòng dạng văn bản thuần)
- Nút Gửi tin nhắn thử trên màn hình cài đặt — kiểm tra webhook của bạn mà không cần xuất bản bài viết
- Nhật ký gửi tin — ảnh chụp nhanh xoay vòng của các lượt gửi gần đây nhất (thành công/lỗi) để khắc phục sự cố, được lưu nhẹ trong
wp_optionsvớiautoload = no - Mẫu tin nhắn tùy chỉnh với các placeholder:
{title}— tiêu đề bài viết{title_url}— tiêu đề dạng markdown liên kết đến URL{url}— URL bài viết{excerpt}— đoạn trích đã cắt gọn{site_name}— tên site của bạn{author}— tên hiển thị của tác giả bài viết{categories}— tên các chuyên mục, cách nhau bằng dấu phẩy{tags}— tên các thẻ tag, cách nhau bằng dấu phẩy{post_type}— nhãn loại bài viết{date}— ngày xuất bản (theo định dạng của site)
- Embed ảnh đại diện tùy chọn
- Logic thử lại & kiểm soát thời gian chờ
- Không loại bỏ action nào — tương thích tốt với mọi plugin khác
- Mã nguồn gọn gàng, hiện đại
- Hot Post Milestones (tùy chọn, yêu cầu Init View Count) — tự động thông báo cho Discord khi tổng lượt xem của một bài viết vượt qua ngưỡng đã cấu hình (ví dụ 1.000 / 10.000 / 100.000 lượt xem), với mẫu tin nhắn riêng và các placeholder
{views},{views_short},{milestone}. Mỗi mốc chỉ được gửi một lần cho mỗi bài viết. Tự động không hoạt động một cách mượt mà (kèm liên kết để cài đặt) khi Init View Count chưa được kích hoạt — không lỗi, không hỏng cài đặt.
Cách sử dụng
Điều hướng đến:
Settings Init Pulse For Discord
Các trường có sẵn:
Field
Purpose
Post Types
Which post types trigger a notification
Webhook URL
Where notifications are sent (with a Send Test Message button)
Username
Display name of your bot
Avatar URL
Custom bot avatar (optional)
Include Featured Image
Adds featured image as embed
Use Rich Embed
Toggle formatted embed vs. plain-text message
Embed Color
Accent color for the embed sidebar
Timeout / Retries
Reliability controls
Message Template
Markdown-ready content, used as the embed description or full message
Notify on View Milestones
Enable Discord alerts when a post’s view count crosses a threshold (requires Init View Count)
View Milestones
Comma-separated view counts (e.g. 1000, 5000, 10000)
Milestone Message Template
Separate template for milestone alerts, with {views}, {views_short}, {milestone} placeholders
Màn hình cài đặt cũng hiển thị Nhật ký gửi tin với kết quả của các thông báo gần đây nhất của bạn.
ID Role có thể được cấu hình trong:
- Posts Categories Edit
- Posts Tags Edit
Ví dụ kết quả nhắc role:
<@&123456789012345678> Bài viết mới đã được xuất bản!
Filter dành cho lập trình viên
init_plugin_suite_pulse_for_discord_payload
Chỉnh sửa payload webhook cuối cùng trước khi gửi.
Tham số: array $payload, int $post_id, string $context
init_plugin_suite_pulse_for_discord_milestone_payload
Chỉnh sửa payload webhook cho một thông báo mốc lượt xem trước khi gửi.
Tham số: array $payload, int $post_id, int $views, int $milestone
Ví dụ:
add_filter(‘init_plugin_suite_pulse_for_discord_payload’, function($payload) {
$payload[‘content’] .= “\nCustom footer”;
return $payload;
});
Giấy phép
Plugin này được cấp phép theo GPLv2 hoặc phiên bản mới hơn.
Bạn có toàn quyền sử dụng, chỉnh sửa, và phân phối lại theo cùng giấy phép.
Ảnh màn hình



Cài đặt
- Tải thư mục plugin lên
/wp-content/plugins/ - Kích hoạt qua Plugins Init Pulse For Discord
- Vào Settings Init Pulse For Discord và dán URL webhook của bạn
- Tùy chọn: Gán ID Role Discord cho chuyên mục & thẻ tag
Hỏi đáp
-
Plugin có hỗ trợ Loại bài viết tùy chỉnh (CPT) không?
-
Có. Vào Settings Init Pulse For Discord Post Types và đánh dấu bất kỳ loại bài viết công khai nào bạn muốn thông báo (bài viết thường, trang, sản phẩm WooCommerce, hoặc bất kỳ loại tùy chỉnh nào).
-
Tôi có thể kiểm tra webhook của mình mà không cần xuất bản bài viết không?
-
Có — dùng nút Gửi tin nhắn thử bên cạnh trường URL Webhook. Nút này gửi một tin nhắn mẫu dùng những gì hiện đang có trong form, ngay cả trước khi bạn lưu.
-
Tôi có thể xem ở đâu nếu một thông báo gửi thất bại?
-
Phần Nhật ký gửi tin ở cuối màn hình cài đặt hiển thị các lượt gửi gần đây nhất kèm trạng thái và chi tiết lỗi, nếu có.
-
Tôi có thể gửi tin nhắn khác nhau cho các chuyên mục khác nhau không?
-
Bản thân mẫu tin nhắn được dùng chung, nhưng bạn có thể tùy chỉnh việc nhắc role bằng cách gán các ID role khác nhau cho chuyên mục/thẻ tag, và định tuyến bài viết trong một chuyên mục/thẻ tag cụ thể sang một kênh Discord hoàn toàn khác — xem câu hỏi tiếp theo.
-
Tôi có thể gửi một chuyên mục đến một kênh Discord khác không?
-
Có. Mở Chuyên mục hoặc Thẻ tag đó và điền “Discord Webhook URL” riêng của nó (kèm tùy chọn ghi đè Username/Avatar). Theo mặc định, bài viết trong term đó sẽ được gửi đến webhook đó bên cạnh webhook toàn cục; bật “Chỉ gửi đến webhook này” trên term nếu bạn muốn chúng bỏ qua hoàn toàn webhook toàn cục. Một bài viết thuộc nhiều term có webhook riêng sẽ thông báo đến tất cả các webhook đó.
-
Tôi có thể dùng webhook mà không nhắc role không?
-
Có — chỉ cần để trống các trường Role ID.
-
Tôi có thể ngăn một bài viết cụ thể không gửi đến Discord không?
-
Có. Trên màn hình chỉnh sửa bài viết, đánh dấu “Không gửi bài viết này đến Discord” trong khung Thông báo Discord trước khi xuất bản. Tùy chọn này cũng bao gồm cả các cảnh báo Hot Post Milestones trong tương lai của bài viết đó. Sau khi bài viết được xuất bản, ô đánh dấu chỉ còn hiển thị nếu “Thông báo khi cập nhật bài viết” được bật — nếu không thì không còn gì để nó ngăn chặn nữa.
-
Plugin này có ghi đè hoặc loại bỏ các hook xuất bản không?
-
Không. Plugin không bao giờ loại bỏ action hay filter.
Mọi thứ đều chỉ được thêm vào và an toàn theo mặc định. -
“Hot Post Milestones” là gì và tôi có cần plugin khác cho nó không?
-
Đây là tính năng tùy chọn gửi cảnh báo Discord khi tổng lượt xem của một bài viết vượt qua ngưỡng bạn cấu hình (ví dụ 1.000 lượt xem). Tính năng này yêu cầu plugin miễn phí Init View Count phải được kích hoạt, vì đó là plugin thực sự đếm lượt xem. Nếu Init View Count chưa được cài đặt, cài đặt này đơn giản là không hoạt động (kèm liên kết để cài đặt) — không có gì bị hỏng, và không có tính năng nào khác của Init Pulse For Discord bị ảnh hưởng.
-
Tôi đã cài Init View Count sau khi cấu hình các mốc lượt xem — tôi có cần lưu lại cài đặt không?
-
Không. Kết nối được tự động kiểm tra ở mỗi lần tải trang, nên thông báo mốc lượt xem sẽ hoạt động ngay khi Init View Count được kích hoạt — không cần lưu lại.
Đánh giá
Người đóng góp & Lập trình viên
“Init Pulse For Discord – Webhooks, Roles, Instant” là mã nguồn mở. Những người sau đã đóng góp vào plugin này.
Những người đóng góp“Init Pulse For Discord – Webhooks, Roles, Instant” đã được dịch qua 1 ngôn ngữ. Cảm ơn những người tham gia dịch vì đóng góp của họ.
Dịch “Init Pulse For Discord – Webhooks, Roles, Instant” sang ngôn ngữ của bạn.
Muốn tham gia phát triển?
Duyệt code, check out SVN repository, hoặc theo dõi nhật ký phát triển qua RSS.
Nhật ký thay đổi
1.5 – 14 tháng 9, 2026
- Đã thêm: ô đánh dấu “Không gửi đến Discord” theo từng bài viết — cho phép một bài viết riêng lẻ bỏ khỏi mọi thông báo Discord (xuất bản/cập nhật, và mọi cảnh báo Hot Post Milestones trong tương lai) chỉ cho bài viết đó.
- Ô đánh dấu được hiển thị trên màn hình chỉnh sửa bài viết khi bài viết chưa được xuất bản; sau khi xuất bản, nó chỉ còn hiển thị nếu “Thông báo khi cập nhật bài viết” được bật, vì đó là thông báo duy nhất còn lại mà nó có thể ngăn chặn.
- Không có thay đổi phá vỡ tương thích — bài viết vẫn được thông báo chính xác như trước trừ khi ô đánh dấu này được chọn rõ ràng.
1.4 – 13 tháng 9, 2026
- Đã thêm: Webhook theo Chuyên mục/Thẻ tag — đặt URL Webhook Discord riêng (kèm ghi đè Username/Avatar riêng) trực tiếp trên bất kỳ màn hình chỉnh sửa Chuyên mục hoặc Thẻ tag nào.
- Đã thêm: công tắc “Chỉ gửi đến webhook này” theo từng term — khi bật, bài viết trong term đó sẽ bỏ qua webhook toàn cục và chỉ được gửi đến webhook riêng của term.
- Thay đổi: Một bài viết thuộc nhiều chuyên mục/thẻ tag có webhook riêng giờ sẽ thông báo đến từng webhook đó (loại trùng theo URL webhook), bên cạnh webhook toàn cục trừ khi một term khớp chọn bỏ qua nó.
- Thay đổi: Thông báo Hot Post Milestone giờ tuân theo cùng cách định tuyến webhook theo term như thông báo xuất bản/cập nhật.
- Thay đổi: Nhật ký gửi tin giờ ghi lại một mục riêng cho mỗi webhook đích khi một bài viết được định tuyến đến nhiều hơn một webhook, giúp việc khắc phục sự cố cho cấu hình nhiều webhook dễ dàng hơn.
- Không có thay đổi phá vỡ tương thích — các site không cấu hình webhook theo term nào vẫn tiếp tục gửi đến webhook toàn cục chính xác như trước.
1.3 – 1 tháng 9, 2026
- Đã sửa lỗi: bộ làm sạch dữ liệu cho ô đánh dấu dùng chung trước đây coi bất kỳ giá trị nào có mặt là đã bật, khiến mọi ô đánh dấu chưa chọn bị lưu thành
1ở lần lưu đầu tiên. Đã siết chặt để yêu cầu giá trị'1'rõ ràng trước khi coi một ô đánh dấu là đã bật.
1.2 – 4 tháng 8, 2026
- Đã thêm: Hot Post Milestones — tích hợp liên plugin tùy chọn với Init View Count. Gửi thông báo Discord (với mẫu tin nhắn riêng) khi tổng lượt xem của một bài viết được theo dõi vượt qua ngưỡng đã cấu hình. Mỗi mốc chỉ kích hoạt một lần cho mỗi bài viết.
- Chỉ là phụ thuộc mềm: được phát hiện qua
defined('INIT_PLUGIN_SUITE_VIEW_COUNT_VERSION')ởplugins_loaded(mức ưu tiên 20), nên thứ tự tải plugin không bao giờ quan trọng và không có gì bị lỗi nếu Init View Count chưa kích hoạt hoặc bị tắt sau đó. - Khi Init View Count chưa được kích hoạt, màn hình cài đặt hiển thị thông báo kèm liên kết đến plugin đó; các trường vẫn có thể cấu hình được và sẽ tự động có hiệu lực khi plugin được cài đặt.
- Chỉ là phụ thuộc mềm: được phát hiện qua
- Đã thêm: filter
init_plugin_suite_pulse_for_discord_milestone_payloadđể lập trình viên tùy chỉnh payload webhook cho mốc lượt xem.
1.1 – 14 tháng 7, 2026
- Đã thêm: Hỗ trợ Loại bài viết tùy chỉnh — chọn loại bài viết nào sẽ kích hoạt thông báo
- Đã thêm: Embed Discord phong phú (tiêu đề, mô tả, màu sắc, chân trang, dấu thời gian) kèm công tắc dự phòng dạng văn bản thuần
- Đã thêm: nút “Gửi tin nhắn thử” trên màn hình cài đặt
- Đã thêm: Nhật ký gửi tin — ảnh chụp nhanh xoay vòng của các lượt gửi gần đây, được lưu với
autoload = no - Đã thêm: các placeholder mẫu bổ sung —
{author},{categories},{tags},{post_type},{date} - Thay đổi: nhãn “Notify On” giờ mang tính chung chung (không còn viết cứng thành “post”)
- Không có thay đổi phá vỡ tương thích — cài đặt webhook, mẫu, và role hiện có được giữ nguyên
1.0 – 12 tháng 11, 2025
- Phát hành lần đầu
- Thông báo xuất bản/cập nhật
- Trường Role-ID cho chuyên mục & thẻ tag
- Placeholder mẫu:
{title},{title_url},{url},{excerpt},{site_name} - Hỗ trợ embed ảnh đại diện
- Logic thời gian chờ + thử lại (bao gồm xử lý 429 Retry-After)
- Nhỏ gọn, hiệu quả, và tránh ghi đè lõi/hook
