云策 WordPress 开发者社区

函数文档

wp_get_link_cats()

查看官方原文 ↗
💡 云策文档标注

概述

wp_get_link_cats() 函数用于获取指定链接关联的链接分类ID。它基于 wp_get_object_terms() 实现，返回去重后的分类ID数组。

关键要点

  • 参数 $link_id 为必需整数，指定要查询的链接ID
  • 返回值为整数数组，包含链接所属的分类ID
  • 内部调用 wp_get_object_terms() 并设置 'fields' => 'ids' 以获取分类ID
  • 使用 array_unique() 确保返回的ID数组去重

代码示例

function wp_get_link_cats( $link_id = 0 ) {
    $cats = wp_get_object_terms( $link_id, 'link_category', array( 'fields' => 'ids' ) );
    return array_unique( $cats );
}

注意事项

  • 该函数自 WordPress 2.1.0 版本引入
  • 相关函数包括 wp_get_object_terms()、WP_Links_List_Table::display_rows() 等
  • 适用于链接管理场景，如生成链接列表或分类检查表
📄 原文内容

Retrieves the link category IDs associated with the link specified.

Parameters

$link_idintrequired
Link ID to look up.

Return

int[] The IDs of the requested link’s categories.

Source

function wp_get_link_cats( $link_id = 0 ) {
	$cats = wp_get_object_terms( $link_id, 'link_category', array( 'fields' => 'ids' ) );
	return array_unique( $cats );
}

View all references View on Trac View on GitHub

Uses Description
wp_get_object_terms()wp-includes/taxonomy.php

Retrieves the terms associated with the given object(s), in the supplied taxonomies.
Used by Description
WP_Links_List_Table::display_rows()wp-admin/includes/class-wp-links-list-table.php

Generates the list table rows.
wp_link_category_checklist()wp-admin/includes/template.php

Outputs a link category checklist element.
get_linkcatname()wp-includes/deprecated.php

Gets the name of category by ID.

Changelog

Version Description
2.1.0 Introduced.