函数文档

_wp_credits_build_object_link()

💡 云策文档标注

概述

_wp_credits_build_object_link() 是一个 WordPress 内部函数,用于生成外部库链接的 HTML 输出。它通过引用参数处理外部库数据,并应用 HTML 转义以确保安全性。

关键要点

  • 函数接受一个引用参数 $data,用于传递外部库数据。
  • 在函数内部,使用 esc_html() 对数据进行 HTML 转义,然后包装在 <a> 标签中生成链接。
  • 此函数自 WordPress 3.2.0 版本引入,主要用于构建 WordPress 致谢页面中的外部库链接。

代码示例

function _wp_credits_build_object_link( &$data ) {
    $data = '<a href="' . esc_url( $data[1] ) . '">' . esc_html( $data[0] ) . '</a>';
}

注意事项

  • 此函数是内部函数,通常不建议在插件或主题中直接调用,除非有特定需求。
  • 使用引用参数意味着函数会直接修改传入的 $data 变量,调用时需注意数据的变化。
  • 相关函数包括 esc_url() 和 esc_html(),用于 URL 清理和 HTML 转义,确保输出安全。

📄 原文内容

Retrieves the link to an external library used in WordPress.

Parameters

$datastringrequired
External library data (passed by reference).

Source

function _wp_credits_build_object_link( &$data ) {
	$data = '<a href="' . esc_url( $data[1] ) . '">' . esc_html( $data[0] ) . '</a>';
}

Changelog

Version Description
3.2.0 Introduced.