WordPress

Plugin WordPress chính thức của CaptchaLa. Thêm xác minh CAPTCHA cho các biểu mẫu lõi của WordPress và các plugin biểu mẫu, thương mại điện tử, cộng đồng phổ biến nhất mà không cần viết bất kỳ dòng mã nào.

Phạm vi bảo vệ

Mỗi mục dưới đây là một hộp kiểm độc lập trong bảng cài đặt của plugin — bạn chỉ bật những điểm vào mà bạn thực sự muốn bảo vệ.

• Đăng nhập WordPress
• Đăng ký WordPress
• Bình luận WordPress
• Quên mật khẩu WordPress
• Thanh toán WooCommerce
• Tạo tài khoản WooCommerce
• Đăng nhập WooCommerce
• Contact Form 7
• Gravity Forms
• WPForms
• Elementor Forms
• BBPress (chủ đề và phản hồi)
• BuddyPress (đăng ký và hoạt động)

Nếu plugin biểu mẫu tương ứng chưa được cài đặt, toggle của nó sẽ bị ẩn — plugin phát hiện các tích hợp khả dụng khi khởi động.

Cài đặt

1. Cài plugin

Hai cách:

• Quản trị WordPress — Plugins → Add New, tìm CaptchaLa, nhấn Install rồi Activate.
• Tải lên thủ công — tải tệp zip bản phát hành mới nhất từ github.com/Captcha-La/captchala-wordpress/releases, tải lên qua Plugins → Add New → Upload Plugin và kích hoạt.

Plugin yêu cầu WordPress ≥ 6.0 và PHP ≥ 7.4.

2. Lấy khóa của bạn

Đăng ký tại dash.captcha.la, tạo một ứng dụng, sau đó sao chép:

• App Key — khóa công khai, được nhúng vào trang
• App Secret — chỉ dùng phía máy chủ, được WordPress sử dụng để gọi /v1/validate

3. Kết nối

Trong WP-Admin, mở CaptchaLa ở menu bên trái:

1. Dán App Key và App Secret.
2. Chọn chế độ xác minh (popup, bind, embed hoặc float — xem Web SDK).
3. Bật các biểu mẫu bạn muốn bảo vệ.
4. Nhấn Save changes.

Mở một trong các biểu mẫu được bảo vệ trong cửa sổ riêng tư để xác nhận thử thách hiển thị đúng.

Cấu hình

Mọi cài đặt nằm tại WP-Admin → CaptchaLa. Plugin lưu chúng dưới dạng một option WordPress duy nhất (captchala_settings).

Cài đặt	Kiểu	Mặc định	Mô tả
App Key	string	—	Khóa công khai (cl_pub_…) từ bảng điều khiển CaptchaLa. Bắt buộc.
App Secret	string	—	Bí mật máy chủ. Bắt buộc. Không bao giờ lộ ra trình duyệt.
Chế độ xác minh	enum	popup	Một trong popup, bind, embed, float. Ánh xạ tới tùy chọn product của Web SDK.
Toggle biểu mẫu	bool[]	tất cả tắt	Một toggle cho mỗi biểu mẫu được hỗ trợ (xem Phạm vi bảo vệ).
Tải trễ	bool	true	Khi bật, loader CaptchaLa chỉ được nạp trên các trang chứa biểu mẫu được bảo vệ.
Giao diện	enum	auto	light, dark, hoặc auto (theo cài đặt hệ thống của người dùng).
Nhãn action	string	tùy biểu mẫu	Chuỗi action gửi khi xác minh (login, register, comment, wc_checkout, v.v.). Plugin đặt giá trị mặc định hợp lý — chỉ ghi đè khi có lý do.
Gắn IP	bool	true	Gửi IP khách truy cập khi phát hành và xác minh. Tắt khi đứng sau reverse proxy không chuyển tiếp IP máy khách.
Chặn khi xác minh thất bại	bool	true	Khi tắt, xác minh thất bại chỉ được ghi log còn biểu mẫu vẫn được gửi. Dành cho rollout từng giai đoạn, không khuyến nghị cho production.

Cài đặt cũng có thể xuất / nhập dưới dạng JSON từ chân trang cài đặt.

Câu hỏi thường gặp

Plugin có miễn phí không?

Có. Bản thân plugin WordPress là miễn phí. Gói miễn phí của CaptchaLa bao gồm 1.000 lượt xác minh mỗi tháng — gói trả phí chỉ áp dụng khi bạn cần lưu lượng cao hơn.

Nó có làm chậm site của tôi không?

Loader được nạp trễ, chỉ trên các trang hiển thị biểu mẫu được bảo vệ. Lệnh xác minh trả về từ edge dưới 100ms ở hầu hết các khu vực. Không có script theo dõi trên trang chủ.

Có hoạt động với WooCommerce không?

Có. Thanh toán, tạo tài khoản và đăng nhập được hỗ trợ sẵn — mỗi mục là một toggle riêng. Plugin móc vào pipeline xác thực chuẩn của WooCommerce, vì vậy xác minh thất bại sẽ hiển thị dưới dạng lỗi biểu mẫu WooCommerce thông thường.

Tôi có cần viết mã không?

Không. Cài đặt, dán hai khóa, chọn biểu mẫu cần bảo vệ. Có sẵn các filter hook nếu bạn cần tùy biến, nhưng đều là tùy chọn.

Có tuân thủ GDPR không?

CaptchaLa đặt quyền riêng tư lên trước: không có pixel theo dõi bên thứ ba, không có tín hiệu quảng cáo, và plugin WordPress chỉ truyền dữ liệu cần thiết để xác minh một thử thách duy nhất. Xuất / xóa theo từng yêu cầu khả dụng trong bảng điều khiển CaptchaLa.

Mã nguồn

• Kho plugin: github.com/Captcha-La/captchala-wordpress
• Lỗi / yêu cầu tính năng: gửi vào kho ở trên
• Liên quan: Web SDK · PHP Máy chủ SDK · Tham chiếu API