Supported Functions
Dưới đây là khái quát tất cả những hàm mà mô-đun WHMCS có thể chứa. Các hàm trong một mô-đun là tùy chọn và không cần phải có trong mô-đun nếu chúng không được áp dụng. Nhớ rằng, tất cả các hàm nên có tiền tố filename_ và sau đó là tên của hàm đó. Tên hàm là tiêu đề bên dưới.
CreateAccount
Hàm này chạy khi có một sản phẩm mới. Điều này có thể bởi WHMCS khi làm thủ tục thanh toán hoặc thanh toán một hóa đơn mới. Ngoài ra, bởi tài khoản admin từ tab Products/Services trong profile của khu vực admin.
SuspendAccount
Hàm này chạy khi có yêu cầu tạm ngưng. Được yêu cầu bởi WHMCS Cron khi sản phẩm trở nên quá hạn hoặc bởi admin trong Client Profile.
UnsuspendAccount
Hàm này chạy khi có yêu cầu bỏ tạm ngưng. Yêu cầu thanh toán hóa đơn quá hạn của một sản phẩm.
TerminateAccount
Hàm này chạy khi có yêu cầu chấm dứt. Được yêu cầu bởi WHMCS Cron cho các sản phẩm quá hạn khi được bật(Automation Settings). Cũng như được yêu cầu bởi tài khoản admin trong Client Profile.
Renew
Chức năng này sẽ được chạy mỗi khi hóa đơn gia hạn cho sản phẩm được thanh toán.
ChangePassword
Chức năng này sẽ chạy khi có yêu cầu thay đổi mật khẩu từ người dùng. Tùy chọn sẽ không hiển thị nếu hàm không được xác định trong mô-đun. Trạng thái của sản phẩm phải được kích hoạt. Admin cũng có thể gọi lệnh này trong khu vực admin.
ChangePackage
Hàm này chạy để nâng cấp và hạ cấp phiên bản của sản phẩm. Hàm sẽ chạy khi một lệnh nâng cấp hoặc hạ cấp được yêu cầu bởi người dùng. Admin cũng có thể làm điều này từ các trang quản lý sản phẩm. Hàm tương tự chạy để nâng cấp cũng như hạ cấp của cả 2 sản phẩm và tùy chọn cấu hình.
ClientArea
Hàm này có thể được sử dụng để xác định đầu ra của khu vực người dùng cụ thể của mô-đun. Nó chấp nhận trả lại HTML để hiển thị trên trang web chi tiết sản phẩm của khu vực người dùng. Cũng có thể xuất thông qua một tệp mẫu trong thư mục mô-đun có tên là "clientarea.tpl". Thảo luận chi tiết hơn về hàm này trong các tài liệu.
AdminArea
Được sử dụng để xác đinh mã HTML hiển thị trên trang cấu hình máy chủ(Setup > Products/Services > Servers). Được sử dụng để cung cấp một liên kết phím tắt/đăng nhập tự đông đến bảng điều khiển máy chủ.
LoginLink
Được sử dụng để xác định mã HTML để liên kết với tài khoản khách hàng trên bảng điều khiển máy chủ. Hiển thị trên trang quản lý sản phẩm của khu vực admin. Trả về phải là đầu ra HTML hoặc liên kết(không có mẫu).
ClientAreaCustomButtonArray
Được sử dụng để xác định các hàm tùy chỉnh mà mô-đun của bạn hỗ trợ. Người dùng có thể gọi và chạy chúng từ khu vực của người dùng. Các hàm có thể thực hiện các hành động hoặc các trang sản phẩm đầu ra trong khu vực của người dùng. Ví dụ sử dụng cho việc này là để cung cấp các trang quản lý sản phẩm, các trang báo cáo băng thông, v.v.
ClientAreaAllowedFunctions
Giống như trên, hàm này được sử dụng để xác định các hàm tùy chỉnh. Người dùng có thể gọi, nhưng không thể hiển thị dưới dạng các nút theo mặc định(nghĩa là đầu ra khu vực người dùng tùy chỉnh sẽ gọi chúng).
AdminCustomButtonArray
Được sử dụng để xác định các hàm tùy chỉnh trong mô-đun của bạn cho admin. Điều này có thể chứa nhiều hàm hơn khu vực người dùng tương đương.
UsageUpdate
Được sử dụng để thực hiện để nhập vào ổ cứng hàng ngày và sử dụng băng thông từ máy chủ. Dữ liệu được nhập sau đó được sử dụng để hiển thị số liệu thống kê sử dụng cả trong khu vực người dùng và quản trị viên của WHMCS. Dữ liệu cũng được sử dụng trong các tính toán thanh toán vượt quá dung lượng ổ cứng và băng thông nếu được bật cho một sản phẩm.
AdminServicesTabFields
Được sử dụng để xác định các trường hoặc đầu ra bổ sung để hiển thị trong các trang sản phẩm của quản trị viên.
AdminServicesTabFieldsSave
Được sử dụng để kết với hàm ở trên. Hàm này xử lí các giá trị được gửi trong bất kỳ trường tùy chỉnh nào khi lưu xảy ra.
Bài viết được tham khảo và lược dịch từ: https://developers.whmcs.com/provisioning-modules/supported-functions/
Tôi hi vọng bài viết đã giải đáp thắc mắc của bạn. Nếu chúng tôi có thể giúp đỡ gì thêm, xin vui lòng comment hoặc liên hệ email: [email protected]
[Series WHMCS] Modules: Provisioning Modules - Phần 7: Supported Functions 2019-10-29
WHM.vn cho ra mắt series tự học WHMCS giúp bạn thuận lợi hơn trong việc tìm hiểu và học tập về WHMCS