5. Template Hooks: Product Collection (Bộ Sưu Tập)

Trang Bộ Sưu Tập (products_collection) liệt kê các sản phẩm được Admin gán vào một Collection thủ công. Hooks được đăng ký trong bootstrap/template-collection.php và chỉ được kích hoạt khi CMS phát hiện đây là trang products_collection.

---

Cách Hoạt Động

Collection hooks được đăng ký trong callback Theme::config()->booted('products-collection', ...):

Theme::config()->booted('products-collection', function() {
    if(Theme::isPage('products_collection')) {
        // Các hooks dưới đây được đăng ký
    }
});

---

Danh Sách Hook

Hooks SEO

Hook	Class::Method	Mô tả
seo_title (filter)	ProductCollectionSeo::title	Tiêu đề SEO của trang collection
seo_description (filter)	ProductCollectionSeo::description	Mô tả SEO
seo_keyword (filter)	ProductCollectionSeo::keyword	Từ khóa SEO

Hooks Nội Dung (page_products_collections_view)

Hook Name	Priority	Class::Method	Mô tả	Tham số
page_products_collections_view	10	ProductCollection::view	Render lưới sản phẩm chính	—
page_products_collections_view_before	20	ProductCollection::title	Tiêu đề collection (nếu layout không có banner)	—
page_products_collections_view_after	40	ProductCollection::pagination	Thanh phân trang	$collection, $objects, $pagination

---

Ví Dụ Mở Rộng

💡 Thêm Bộ Lọc Giá Cho Trang Collection

add_action('page_products_collections_view', function() {
    echo '<div class="price-filter">';
    echo '<label>Giá từ:</label>';
    echo '<input type="range" name="price_min" min="0" max="5000000" step="50000"/>';
    echo '</div>';
}, 5); // Trước khi render lưới (priority 10)

💡 Can Thiệp Dữ Liệu Trang Collection

Hook product_collection_query không tồn tại. Controller cung cấp ba filter sau:

Hook	Loại	Tham số	Mô tả
controllers_products_collections_count	filter	$total	Tổng số sản phẩm dùng cho phân trang
controllers_products_collections_paging	filter	$pagination	Đối tượng phân trang
controllers_product_index_objects	filter	$objects	Danh sách sản phẩm trả về (dùng chung với trang danh sách sản phẩm)

// Lọc bớt sản phẩm sau khi đã query
add_filter('controllers_product_index_objects', function($objects) {
    return $objects->filter(fn($product) => $product->in_stock == 1);
});

// Đổi tổng số dùng cho phân trang
add_filter('controllers_products_collections_count', function($total) {
    return $total;
});

💡 Thêm Tiêu Đề Tuỳ Chỉnh Trước Lưới Sản Phẩm

// Chỉ hoạt động khi trang collections đang active
add_action('page_products_collections_view_before', function() {
    $collection = Cms::getData('collection');
    if(!empty($collection->excerpt)) {
        echo '<div class="collection-description">' . $collection->excerpt . '</div>';
    }
}, 25);

---

Kiểm Tra Xem Có Đang Ở Trang Collection Không

use SkillDo\Cms\Support\Theme;

if(Theme::isPage('products_collection')) {
    // Code chỉ chạy trên trang collection
}

Lưu ý: Collection hooks được đăng ký lazy (chỉ khi vào đúng trang), không ảnh hưởng hiệu suất ở trang khác.