云策 WordPress 开发者社区

钩子文档

the_privacy_policy_link

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

概述

the_privacy_policy_link 是一个 WordPress 过滤器钩子，用于修改隐私政策链接的显示。它允许开发者根据条件（如页面类型）调整或移除链接。

关键要点

  • 过滤器钩子：the_privacy_policy_link，用于过滤隐私政策链接。
  • 参数：$link（链接字符串，不存在时为空字符串）和 $privacy_policy_url（隐私政策 URL，不存在时为空字符串）。
  • 相关函数：get_the_privacy_policy_link() 返回格式化后的隐私政策链接。
  • 引入版本：WordPress 4.9.6。

代码示例

// 示例：在登录页面删除隐私政策链接
function wporg_delete_privacy_policy_link_on_loginpage( $link, $privacy_policy_url ) {
    if ( 'wp-login.php' === $GLOBALS['pagenow'] ) {
        return null;
    }
}
add_filter( 'the_privacy_policy_link', 'wporg_delete_privacy_policy_link_on_loginpage', 10, 2 );

注意事项

用户贡献笔记提供了两种方法：一种使用自定义函数返回 null 来删除链接，另一种直接使用 __return_false 来移除链接。注意参数传递和钩子优先级设置。

📄 原文内容

Filters the privacy policy link.

Parameters

$linkstring
The privacy policy link. Empty string if it doesn’t exist.
$privacy_policy_urlstring
The URL of the privacy policy. Empty string if it doesn’t exist.

Source

$link = apply_filters( 'the_privacy_policy_link', $link, $privacy_policy_url );

View all references View on Trac View on GitHub

Used by Description
get_the_privacy_policy_link()wp-includes/link-template.php

Returns the privacy policy link with formatting, when applicable.

Changelog

Version Description
4.9.6 Introduced.

User Contributed Notes

  1. Skip to note 3 content


    fpesseas


    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    This example shows how to delete the link of privacy policy in login page.

    function wporg_delete_privacy_policy_link_on_loginpage( $link, $privacy_policy_url ) {
    if ( 'wp-login.php' === $GLOBALS['pagenow'] ) {
        return null;
    }
}
add_filter( 'the_privacy_policy_link', 'wporg_delete_privacy_policy_link_on_loginpage', 10, 2 );