Sử dụng hàm trong template
(Cập nhật: 2023-07-12)

I. Danh sách biến model
II. Cú pháp sử dụng
III. Danh sách hàm dùng chung
IV. Các hàm đặc biệt

Mỗi file template sẽ có các biến riêng được truyền từ controller cha. Ví dụ (*)
Ngoài ra, S-Cart cung cấp thêm danh sách các biến và các hàm toàn cục có thể gọi ở bất kỳ các file template nào.
Mục đích:

- Tách biệt người làm giao diện với developer: Không cần có nhiều kiến thức về code trong các model, controller.
- Biến model và các hàm của nó được gọi ở bất kỳ view nào: Không phải khai báo ở từng controller cho từng view
- Cú pháp đồng nhất

I. Các biến model được khởi tạo sẵn:
1. $modelProduct -> model Product
2. $modelCategory -> model Category
3. $modelBanner -> model Banner
4. $modelBrand -> model Brand
5. $modelNews -> model News
6. $modelPage -> model Page
7. $modelCmsCategory -> model CMS Category
8. $modelCmsContent -> model CMS Content

II. Cú pháp sử dụng:

$biến_model->start()->(get)group-query->(set)query->getData()|getSql();

Ví dụ:
$modelProduct->start()->getProductHot()->setLimit(20)->setPaginate()->setRandom()->getData();

Trong đó:
- Group-query:
Bản chất là nhiều query đã định nghĩ sẵn
- Query:
Các điều kiện bổ sung. Nếu trùng với query group-query, thì query sau sẽ ghi đè query trước đó.
- getData | getSql
Tương đương với hàm get() và toSql() trong Laravel
- start()
Để tránh trả về kết quả không như ý muốn, nên sử dụng hàm start() trước khi bắt đầu xử lý dữ liệu.

III. Các hàm hỗ trợ chung cho tất cả các biến model:

start(): bắt đầu khi sử dụng các hàm model. Hãy đảm bảo luôn sử dụng nó đầu tiên để không nhận về những kết quả nào ý muốn.
setLimit(int) // Giới hạn kết quả trả về -> Hàm sau thay thế hàm trước
setSort([$key, 'asc|desc']) //Sắp xếp kết quả trả về -> Được sử dụng nhiều lần
setRandom(0|1) // Kích hoạt lấy ngẫu nhiên kết quả trả về -> Hàm sau thay thế hàm trước
setPaginate() // Kích hoạt phân trang
setMoreWhere([$v1, '<|>|=|like|<=|>=|<>', $v2]) // Bổ sung mệnh đề where, có thể gọi nhiều lần
setMoreQuery(array) // Thêm nhiều truy vấn, có thể gọi nhiều lần. Ví dụ: setMoreQuery(['where' => ['columnA', '2']])->setMoreQuery(['orderBy' => ['columnB', 'asc']])
getSql() // Trả về câu truy vấn -> Kết thúc câu truy vấn
getData() // Trả về kết quả dữ liệu -> Kết thúc câu truy vấn
getFull() // Trả về kết quả chi tiết dữ liệu 1 model -> Kết thúc câu truy vấn.

IV. Các hàm đặc biệt cho 1 số model:
1. $modelProduct

setKeyword($string) // Tìm kiếm sản phẩm với từ khóa: sku, tên, mô tả, từ khóa
getProductHot() // Danh sách sản phẩm giảm giá
getProductBuild() // Danh sách sản phẩm bộ
getProductGroup() // Danh sách sản phẩm nhóm
getProductSingle() // Danh sách sản phẩm đơn
getProductToCategory($arrCategory | int) // Danh sách sản phẩm theo danh mục
getProductToBrand($arrBrand | int) // Danh sách sản phẩm theo nhãn hàng
getProductLatest() // Top sản phẩm mới nhất
getProductLastView() // Danh sách sản phẩm mới xem gần nhất
getProductBestSell() // Danh sách sản phẩm bán tốt nhất
getProductPromotion() // get top products promotion
getFinalPrice() // Lấy giá bán cuối cùng của sản phẩm (không thuế)
getFinalPriceTax() // Lấy giá bán cuối cùng của sản phẩm (có thuế)
showPrice() //Hiển thị chi tiết giá của sản phẩm ở các trang danh sách sản phẩm
showPriceDetail() // Hiển thị chi tiết giá của sản phẩm ở các trang chi tiết sản phẩm
getDetail() // Lấy thông tin chi tiết của 1 sản phẩm dựa vào id, model, alias,...
getThumb() // Lấy link hình ảnh thumb của sản phẩm
getImage() // Lấy link hình ảnh chính của sản phẩm
getUrl() // Lấy link sản phẩm
getPercentDiscount() / Tỉ lệ giảm giá
renderAttributeDetails() // Hiển thị các thuộc tính
allowSale() // Kiểm tra sản phẩm có được giảm giá không
getProductFromListID($arrID) // Get danh sách sản phẩm dựa vào array ID