_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. |