Hướng dẫn sử dụng shortcode trong Init View Count – Hiển thị lượt xem linh hoạt

Shortcode [init_view_count]

Lưu ý: Shortcode này chỉ hoạt động trong trang chi tiết bài viết (single), nơi có $post hiện hành.

Cú pháp cơ bản

[init_view_count]

Các thuộc tính hỗ trợ

• format: kiểu hiển thị số view. Giá trị: formatted (mặc định), raw, short (ví dụ: 1.2k)
• field: chọn mốc view. Giá trị: total, day, week, month
• time: nếu là true, hiển thị thời gian từ ngày đăng (ví dụ: “3 ngày trước”)

Ví dụ

[init_view_count format="short" field="week" time="true"]

→ Hiển thị lượt xem trong tuần dưới dạng rút gọn + thời gian từ ngày đăng.

Shortcode [init_view_list]

Dùng để hiển thị danh sách các bài viết có lượt xem cao nhất. Có thể dùng ở sidebar, footer, trong bài viết hoặc widget.

Cú pháp cơ bản

[init_view_list]

Các thuộc tính hỗ trợ

• number: số bài viết hiển thị (mặc định: 10)
• page: hiển thị trang tiếp theo khi phân trang thủ công (ví dụ: page="2"). Hiện chưa hỗ trợ phân trang tự động.
• post_type: loại post cần hiển thị (mặc định: post)
• range: chọn theo thời gian: total, day, week, month
• template: giao diện hiển thị. Mặc định: sidebar. Có thể ghi đè bằng file tương ứng trong theme (xem phần bên dưới)
• category: lọc theo slug của category
• tag: lọc theo slug của tag
• title: tiêu đề hiển thị trên danh sách (có thể để title="" để ẩn)
• class: thêm class CSS tùy ý
• orderby và order: sắp xếp theo meta key view (ví dụ: orderby="meta_value_num", order="DESC")
• empty: nội dung hiển thị khi không có kết quả

Ví dụ hiển thị danh sách bài viết trong tuần thuộc category “tin-tuc”

[init_view_list range="week" category="tin-tuc" number="6" template="grid" title="Tin được xem nhiều"]

→ Hiển thị 6 bài viết của category tin-tuc, được xem nhiều nhất trong tuần, với layout dạng grid và tiêu đề “Tin được xem nhiều”.

Ghi đè template hiển thị

Các template hiển thị của shortcode có thể ghi đè giống như cách WooCommerce hoạt động.

Cấu trúc ghi đè

your-theme/init-view-count/view-list-[template].php

Ví dụ muốn tùy biến template dạng grid, bạn tạo file:

your-theme/init-view-count/view-list-grid.php

Plugin sẽ tự động dùng file này thay vì template mặc định trong plugin. Nếu không tìm thấy, plugin sẽ dùng view-list-sidebar.php mặc định.

Shortcode [init_view_ranking]

Hiển thị bảng xếp hạng bài viết theo ngày, tuần, tháng hoặc tất cả, dưới dạng tab. Phù hợp dùng ở sidebar hoặc trang chuyên mục nổi bật.

Cú pháp cơ bản

[init_view_ranking]

Các thuộc tính hỗ trợ

• tabs: danh sách tab muốn hiển thị. Mặc định: total,day,week,month
• number: số bài viết hiển thị trong mỗi tab (mặc định: 5)
• class: thêm class CSS tùy ý vào wrapper
• post_type: lọc kết quả theo loại bài viết (ví dụ: post, page…)

Ví dụ

[init_view_ranking tabs="day,week" number="4" class="uk-margin"]

→ Hiển thị 2 tab: lượt xem hôm nay và tuần này, mỗi tab có 4 bài viết.

Giao diện được tích hợp sẵn skeleton loader, chỉ load khi hiển thị – rất phù hợp cho SPA hoặc site dùng cache mạnh.

Một số tips nâng cao

• Dùng filter init_plugin_suite_view_count_meta_key để thay đổi meta key động theo context
• Dùng init_plugin_suite_view_count_query_args để can thiệp sâu vào WP_Query của shortcode
• Dùng init_plugin_suite_view_count_empty_output để điều chỉnh output khi không có kết quả
• Có thể hiển thị shortcode qua widget bằng block HTML hoặc plugin hỗ trợ shortcode