[Series WHMCS] Modules: Provisioning Modules - Phần 13: Client Area Output 2019-11-05

Client Area Output


​

Một chức năng chính khác của mô-đun là cung cấp cho khách hàng quyền truy cập vào các tùy chọn bổ sung và đầu ra trong khu vực máy khách. Thực hiện trên trang chi tiết sản phẩm (sử dụng chức năng ClientArea của mô-đun) hoặc dưới dạng function/action.

Chi tiết sản phẩm đầu ra

Tạo đầu ra để hiển thị trên cùng một trang với chi tiết sản phẩm trong khu vực máy khách thật dễ dàng. Tạo một tệp mẫu có tên là "clientarea.tpl" trong thư mục mô-đun. Tệp mẫu này sẽ xử lý như một tệp mẫu Smarty. Điều này có nghĩa là nó có thể sử dụng các biến Smarty. Các biến sẽ là các vars mô-đun giống như được truyền cho mọi chức năng mô-đun. Ngoài ra, các chức năng thông minh khác như chức năng logic là có sẵn.

Các hành động nâng cao hơn, chẳng hạn như thực hiện các lệnh gọi API hoặc xác định các biến cho đầu ra là khả dụng. Hàm ClientArea trong mô-đun chạy mọi mã và trả về một mảng với tệp mẫu để sử dụng và bất kỳ biến nào mong muốn bên cạnh các giá trị mặc định. Trả về các giá trị tệp mẫu khác nhau dựa trên dữ liệu trong dữ liệu mảng $ _GET hoặc $ _POST, cho phép nhiều trang có thể có liên kết trực tiếp.

function mymodule_ClientArea($vars) {

return array(

'templatefile' => 'clientarea',
'vars' => array(

'test1' => 'hello',
'test2' => 'world',​

),​

);​

}

Những trang tùy chỉnh

Có thể sẽ có các trường hợp cần tới một trang tùy chỉnh, thay vì đầu ra trên trang chi tiết sản phẩm hiện có. Thực hiện bằng cách sử dụng các chức năng tùy chỉnh như được mô tả trước đó, với hàm đó trả về một mảng như sau:

function mymodule_mycustomfunction($vars) {

return array(

'templatefile' => 'customfunc',​

'breadcrumb' => array(

'stepurl.php?action=this&var=that' => 'Custom Function',​

),​

'vars' => array(

'test1' => 'hello',​

'test2' => 'world',
),​

);​

}

Sau đó, khách hàng cần truy cập để sử dụng chức năng này và liên kết trong trang chi tiết sản phẩm. Thực hiện việc này bằng các phương pháp được mô tả trong phần trước ‘Custom Functions’


Bài viết được tham khảo và lược dịch từ: https://developers.whmcs.com/provisioning-modules/client-area-output/
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]