คู่มือการใช้งาน Shortcode [s_loop]
คำสั่ง [s_loop]
คือ Shortcode สำหรับแสดง Content Item ในรูปแบบและเงื่อนไขต่างๆ ตามแนวทางของ Blocks Post Grid โดยธีม Plant 3 ได้เตรียม Parameters ต่างๆ ตาม wp_query ไว้ดังนี้
| Parameters | รายละเอียด |
|---|---|
| author | ระบุ ID ของผู้เขียน |
| author_name | ระบุชื่อผู้เขียน |
| cat | ระบุ ID ของหมวดหมู่ |
| category_name | ระบุชื่อของหมวดหมู่ |
| ignore_sticky_posts | กำหนดว่าจะแสดงโพสต์ที่ปักหมุดหรือไม่ (ค่าเริ่มต้น: false) |
| meta_key | ระบุ meta key สำหรับการค้นหา |
| meta_value | ระบุค่า meta value สำหรับการค้นหา |
| offset | จำนวนโพสต์ที่จะข้ามก่อนเริ่มแสดงผล |
| order | ลำดับการเรียง (DESC หรือ ASC, ค่าเริ่มต้น: DESC) |
| orderby | เรียงลำดับตามฟิลด์ (ค่าเริ่มต้น: date) |
| post_parent | ID ของโพสต์แม่ |
| post_parent__in | แสดงเฉพาะโพสต์ที่มี parent ID อยู่ในรายการที่กำหนด |
| post_parent__not_in | ไม่แสดงโพสต์ที่มี parent ID อยู่ในรายการที่กำหนด |
| post_status | สถานะของโพสต์ที่ต้องการแสดง (ค่าเริ่มต้น: publish) |
| post_type | ประเภทของโพสต์ที่ต้องการแสดง (ค่าเริ่มต้น: post) |
| post__in | แสดงเฉพาะโพสต์ที่มี ID อยู่ในรายการที่กำหนด |
| post__not_in | ไม่แสดงโพสต์ที่มี ID อยู่ในรายการที่กำหนด |
| posts_per_page | จำนวนโพสต์ที่แสดงต่อหน้า (ค่าเริ่มต้น: 9) |
| tag | แท็กของโพสต์ที่ต้องการแสดง |
| tax_operator | ตัวดำเนินการสำหรับ taxonomy (ค่าเริ่มต้น: IN) |
| tax_include_children | รวมหมวดหมู่ย่อยใน taxonomy หรือไม่ (ค่าเริ่มต้น: true) |
| tax_term | เทอมของ taxonomy ที่ต้องการใช้ |
| taxonomy | ชื่อของ taxonomy ที่ต้องการใช้ |
| exclude_current | ไม่แสดงโพสต์ปัจจุบัน (ค่าเริ่มต้น: false) |
| pagination | แสดงการแบ่งหน้าหรือไม่ (ค่าเริ่มต้น: false) |
| css | คลาส CSS ที่ใช้ (ค่าเริ่มต้น: s-grid -d3) |
| template | เทมเพลตที่ใช้แสดงผล (ค่าเริ่มต้น: card) |
ตัวอย่างการใช้งาน
[s_loop posts_per_page="8" css="s-grid" category_name="blog" template="list" pagination="true"]การแสดงผล แสดง 8 บทความ เพิ่มคลาส s-grid เลือกเฉพาะหมวดหมู่ blog แสดงเป็นรูปแบบ list และ แสดง pagination