# Cài đặt
# Yêu cầu
ThueAPI for WooCommerce được viết dựa trên các phiên bản mới nhất hiện nay:
- PHP 7.2+
- WordPress 5.7+
- WooCommerce 5.2+
# Trình duyệt
Hỗ trợ các trình duyệt mới nhất hiện nay:
- Google Chrome
- Apple Safari
- Microsoft Edge
- Mozilla Firefox
# Cài đặt ThueAPI for WooCommerce
ThueAPI for WooCommerce là plugins hỗ trợ việc tích hợp thanh toán trên hệ thống ThueAPI, chính vì thế bạn cần tạo tài khoản trên ThueAPI và tiếp tục việc cài đặt plugin ở phía bên dưới.
Bạn có thể tải plugins này tại mục Plugins hỗ trợ trên hệ thống hoặc trực tiếp từ ThueAPI - Github Issues và lựa chọn plugins ThueAPI for WooCommerce trong danh sách plugins tương ứng.
Sau khi đã tải file nén chứa plugins này về, bạn tiến hành giải nén vào thư mục /wp-content/plugins tương ứng với hệ thống WordPress của bạn.
Thư mục sau khi giải nén sẽ tương ứng với wp-content/plugins/thueapi-for-woocommerce trên hệ thống của bạn.
Sau đó bạn tiếp tục truy cập vào khu vực quản lý các Plugins (/wp-admin/plugins.php) của WordPress để tiến hành kích hoạt plugins này lên.
Nếu cài đặt chính xác theo hướng dẫn bạn sẽ thấy plugins được hiển thị như sau:
Tiếp tục nhấn Activate để kích hoạt modules này lên:
Tiếp tục nhấn Thiết lập để thiết lập các thông số cần thiết ban đầu cho plugins:
# Thiết lập cá nhân
Các tham số cơ bản cho plugins:
- Title
- Description
- Thông báo trước khi thanh toán
- Thông báo sau khi thanh toán
- Hướng dẫn thanh toán
- Tài khoản ngân hàng
- Token
- Ký tự định danh
- Trạng thái thanh toán đủ
- Trạng thái thanh toán dư
- Trạng thái thanh toán thiếu
Title
Đây là thiết lập hiển thị tên cổng thanh toán ra bên ngoài khi người dùng chọn cổng thanh toán
Description
Đây là thiết lập hiển thị mô tả nằm bên dưới tên cổng thanh toán khi người dùng chọn cổng thanh toán
Thông báo trước khi thanh toán
Đây là mục hiển thị dòng thông báo đầu tiên khi người dùng
Thông báo sau khi thanh toán
Đây là mục hiển thị dòng thông báo sau khi người dùng thanh toán thành công
Hướng dẫn thanh toán
Đây là mục hiển thị dòng hướng dẫn người dùng chuyển khoản thanh toán cho bạn
Lưu ý:
Trong nội dung phải chứa 03 ký tự %s bao gồm số tài khoản, ngân hàng và mã đơn hàng.
Các ký tự này sẽ được thay thế khi plugin hoạt động !
Tài khoản ngân hàng
Đây là mục giúp bạn điền các tài khoản ngân hàng mà bạn có và các tài khoản này phải được ThueAPI hỗ trợ trên hệ thống. Các tài khoản này sẽ được hiển thị theo dạng danh sách cuộn như hình bên dưới
Token
Đây là Token giúp xác minh dữ liệu giao dịch là chính xác được gửi từ ThueAPI qua hệ thống của bạn. Token này được sinh ra một lần duy nhất ở bước Tạo Hook trên ThueAPI.
Vui lòng tham khảo mục Hướng dẫn tạo Hook để cập nhật Token này.
Ký tự định danh
Đây là ký tự giúp phân biệt được loại giao dịch mà bạn muốn plugins xác minh và xử lý giao dịch cho bạn.
Trạng thái thanh toán đủ
Đây là trạng thái của đơn hàng sau khi được thanh toán thành công và "chính xác" số tiền cần thanh toán.
Trạng thái thanh toán dư
Đây là trạng thái của đơn hàng sau khi được thanh toán thành công và "lớn hơn" số tiền cần thanh toán.
Trạng thái thanh toán thiếu
Đây là trạng thái của đơn hàng sau khi được thanh toán thành công và "nhỏ hơn" số tiền cần thanh toán.
Bộ lọc trạng thái
Các trạng thái sẽ được phân mục lọc theo từng loại để bạn dễ dàng tra cứu trong phần quản lý đơn hàng
Trên đây là bước kích hoạt và thiết lập các tham số cần thiết cho plugins hoạt động.
# Nâng cấp
ThueAPI for WooCommerce hiện tại tương thích với phiên bản mới nhất của WooCommerce (5.2+). Bạn nên sử dụng phiên bản mới nhất của WooCommerce để có thể sử dụng hết tính năng của plugins đang hỗ trợ.
Thông thường việc nâng cấp plugins đơn giản chỉ là ghi đè bộ mã nguồn tải về. Nếu có bất kỳ lưu ý nào về việc nâng cấp, #CODETAY sẽ có hướng dẫn nâng cấp tương ứng với từng phiên bản phát hành.