Tài liệu Plugin Google reCAPTCHA v3

Giới thiệu

Plugin Google reCAPTCHA cho GP247 giúp bảo vệ website của bạn khỏi spam và lạm dụng bằng cách tích hợp Google reCAPTCHA v3. Plugin này sử dụng cơ chế reCAPTCHA v3 giúp phân tích hành vi người dùng mà không cần xác thực thông qua hình ảnh hoặc checkbox.

Yêu cầu

• GP247 phiên bản 1.1 trở lên
• Tài khoản Google reCAPTCHA v3

Cài đặt

1. Cài đặt plugin thông qua Admin Panel của GP247:

   • Vào Admin Panel > Extension > Plugins
   • Tìm và chọn GoogleCaptcha
   • Nhấn vào nút Install

2. Sau khi cài đặt, kích hoạt plugin:

   • Trong danh sách plugin, tìm GoogleCaptcha
   • Nhấn vào nút Enable

Cấu hình

Đăng ký Google reCAPTCHA v3

1. Truy cập Google reCAPTCHA Admin
2. Đăng nhập với tài khoản Google của bạn
3. Nhấn + Create để tạo một site mới
4. Nhập tên cho site
5. Chọn reCAPTCHA v3 trong mục reCAPTCHA type
6. Thêm domain của website vào mục Domains
7. Đồng ý với điều khoản dịch vụ và nhấn Submit
8. Sao chép Site Key và Secret Key được cung cấp

Cấu hình plugin trong GP247

1. Đăng nhập vào Admin Panel
2. Vào Extension > Plugins > GoogleCaptcha
3. Nhập:
   • Site Key: Dán Site Key từ Google reCAPTCHA
   • Secret Key: Dán Secret Key từ Google reCAPTCHA
4. Lưu cấu hình

Kích hoạt và cấu hình Captcha trong hệ thống

1. Sau khi đã nhập thông tin Site Key và Secret Key, vào Shop Setting > Shop Config
2. Chọn tab Captcha
3. Kích hoạt chức năng Captcha bằng cách chuyển trạng thái sang ON
4. Chọn loại captcha là Google reCaptcha
5. Tích chọn danh sách các trang sẽ áp dụng captcha (như đăng ký, đăng nhập, liên hệ, v.v.)
6. Nhấn Save để lưu cấu hình

Sử dụng

Plugin sẽ tự động kích hoạt reCAPTCHA v3 trên các form đăng ký và đăng nhập. Để thêm Google reCAPTCHA vào form tùy chỉnh, sử dụng mã sau:

@include($appPath.'::render', [
    'idForm' => 'your-form-id',
    'idButtonForm' => 'your-button-id',
    'titleButton' => 'Submit'
])

Trong đó:

• idForm: ID của form cần thêm captcha
• idButtonForm: ID của nút submit gốc (sẽ được ẩn)
• titleButton: Tiêu đề của nút submit mới

Kiểm tra hoạt động

1. Truy cập trang đăng ký hoặc đăng nhập
2. Điền thông tin và gửi form
3. Nếu cấu hình đúng, reCAPTCHA v3 sẽ tự động xác thực người dùng

Xử lý lỗi phổ biến

• Captcha không hiển thị: Kiểm tra Site Key đã được nhập chính xác
• Lỗi xác thực: Kiểm tra Secret Key đã được nhập chính xác
• Domain không được phép: Đảm bảo domain của bạn đã được thêm vào danh sách Domains trong bảng điều khiển Google reCAPTCHA

Gỡ cài đặt

1. Vào Admin Panel > Extension > Plugins
2. Tìm GoogleCaptcha
3. Nhấn vào nút Disable để vô hiệu hóa plugin
4. Nhấn vào nút Uninstall để gỡ cài đặt hoàn toàn

Hỗ trợ

Nếu bạn gặp vấn đề với plugin, vui lòng liên hệ:

• Website: https://GP247.net