Hướng dẫn sử dụng hàm get_terms trong WordPress

Trước tiên, get_terms nó là một hàm (function), còn WP_Term_Query nó là một lớp (class), nên tùy mục đích sử dụng mà chúng ta có thể sử dụng function hay là class. Bài viết này Huy Hòa chỉ hướng dẫn các bạn sử dụng hàm. Nếu có thời gian rảnh, mình sẽ viết hướng dẫn sử dụng lớp (class) sau. Tuy nhiên, với lớp WP_Term_Query thì phạm vi áp dụng nó mở rộng hơn và nó hoàn toàn có thể thay thế get_terms được.

Hàm get_terms() nằm ở đâu?

Hàm này nằm ở trong core nguồn của WordPress.  Các bạn có thể tìm thấy hàm này tại file này: wp-includes/taxonomy.php. Đây là hàm nguyên bản của WordPress:

Đây cũng là hàm nằm trong core của WordPress nên ta chỉ việc sử dụng nó, còn phát triển và bảo mật là việc của …Wordpress lo.

Tham khảo cách dùng hàm get_posts() nhé.

Cách sử dụng hàm get_terms()

Kể từ phiên bản WordPress 4.5 cách sử dụng của hàm get_terms() có thay đổi chút.

Trong đó:

taxonomy: Giá trị truyền vào nhằm xác định tham số cần lấy thông tin.

hide_empty:  Mặc định thì nó không lấy các “terms” mà không được gán với bài viết cụ thể nào. Nếu bạn vẫn muốn nó trả về những terms không gắn với bài viết nào thì bạn có thể chuyển cái false kia thành true là được

Hướng dẫn sử dụng hàm get_terms trong WordPress

Hướng dẫn sử dụng hàm get_terms trong WordPress

Các tham số có thể truyền vào của hàm get_terms là:

Khi sử dụng hàm này cho các custom field thì có thể sử dụng  như ví dụ này:

Trong đó my_term là tên của taxonomy. Ví dụ như: Thể loại tour / Hạng tàu

terms ở đây là các giá trị ví dụ như tags, category trong bài viết, hoặc bất kỳ cái gì bạn định nghĩa nó là taxonomy khi bạn thêm post_type. 

Giá trị trả về

Hàm get_terms() trả về một đối tượng WP_Post (WP_Post object).  Các thông số trả về như danh sách bên dưới đây:

  • [“term_id”]=> //int
  • [“name”]=> //string
  • [“slug”]=> //string
  • [“term_group”]=> //int
  • [“term_taxonomy_id”]=> //int
  • [“taxonomy”]=> //string
  • [“description”]=> //string
  • [“parent”]=> //int
  • [“count”]=> // int
  • [“filter”]=> //string
  • [“meta”]=> array(0)

Từ danh sách trả về đó, chúng ta hoàn toàn có thẻ lấy riêng từng giá trị hoặc lấy tất cả. Dưới đây là một ví dụ việc hiện tất cả các category theo kiểu dropdown list:

get_terms() exclude

Tương tự như vậy, mình có thể giới hạn terms cần lấy bằng cách dùng exclude trong tham số $args truyền vào. Ví dụ dưới đây là mình list tất cả các category của HuyHoa.Net nhưng loại trừ (exclude) 2 category có ID là 30 và 1.

get_terms exclude by slug

Nếu bạn muốn exclude một số giá trị slug khi dùng get terms thì nó phức tạp hơn chút. Trước tiên bạn phải dùng chính get terms để lấy các giá trị id của slug cần loại, sau đó mới dùng get terms để lấy giá trị cần lấy. Đọc đoạn code dưới đây để hiểu rõ ý định của mình trong đoạn code nhé:

get_terms parent – depth

Nếu bạn truyền tham số ‘parent’ => 0 thì nó sẽ chỉ lấy các terms cha mẹ. Còn các terms con nó không lấy. Ví dụ :

get_terms depth – get only top-level terms in a custom taxonomy

Chọn parent thành 0 là nó chỉ lấy toàn bộ terms cha mẹ mà không hiện terms con như ví dụ bên trên ấy

List the child terms of a taxonomy and not their parents

Dựa vào cái parent này thì mình hoàn toàn có thể chỉ hiện nguyên các terms con, không hiện terms cha mẹ. Đây là ví dụ cụ thể:

 

Các bạn lưu ý là hàm này khác hoàn toàn với hàm get_the_term() nhé.

Hàm này các bạn có thể sử dụng thoải mái ở Plugin hoặc ở template và không cần phải defines bất kỳ thông số nào. Nó có thể hoạt động độc lập trong môi trường nội bộ của WordPress như ở Plugins hay ở trong Theme.

Các bạn có thể tham khảo thêm thông tin ở trang hỗ trợ chính thức của hàm này trên trang WordPress for Developer tại đây.

Đánh giá
Share.

About Author

Chào bạn, mình là Gia Hân. Mình học về dược sỹ nhưng hiện tại chỉ làm nội trợ và mỹ phẩm handmade. Mình cũng có chút ít kiến thức về tin học như wordpress, joomla, hay SEO nhưng cũng chỉ ở mức đủ dùng, chưa thể làm thầy được. Các bài mình viết dựa chính trên kinh nghiệm của bản thân và thực tế sử dụng. Sẽ không tránh khỏi sai sót, nếu các bạn phát hiện thấy sai sót nào thì nhắn giúp để mình sửa nhé. Mục liên hệ ở đây.

Leave A Reply