云策 WordPress 开发者社区

函数文档

get_linkrating()

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

概述

get_linkrating() 是一个已弃用的 WordPress 函数，用于获取链接对象的 link_rating 字段值。自 2.1.0 版本起，建议使用 sanitize_bookmark_field() 替代。

关键要点

  • 函数已弃用，自 WordPress 2.1.0 起推荐使用 sanitize_bookmark_field()
  • 参数 $link 为必需的链接对象
  • 返回 link_rating 字段值，失败时返回 false
  • 内部调用 _deprecated_function() 标记弃用状态

代码示例

function get_linkrating( $link ) {
    _deprecated_function( __FUNCTION__, '2.1.0', 'sanitize_bookmark_field()' );
    return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
}

注意事项

  • 此函数为遗留代码，新开发中应避免使用
  • 相关函数包括 sanitize_bookmark_field() 和 get_links()
📄 原文内容

Legacy function that retrieved the value of a link’s link_rating field.

Description

See also

Parameters

$linkobjectrequired
Link object.

Return

mixed Value of the 'link_rating' field, false otherwise.

Source

function get_linkrating( $link ) {
	_deprecated_function( __FUNCTION__, '2.1.0', 'sanitize_bookmark_field()' );
	return sanitize_bookmark_field('link_rating', $link->link_rating, $link->link_id, 'display');
}

View all references View on Trac View on GitHub

Uses Description
sanitize_bookmark_field()wp-includes/bookmark.php

Sanitizes a bookmark field.
_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.
Used by Description
get_links()wp-includes/deprecated.php

Gets the links associated with category by ID.

Changelog

Version Description
2.1.0 Deprecated. Use sanitize_bookmark_field()
1.0.1 Introduced.