云策 WordPress 开发者社区

钩子文档

pingback_useragent

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

概述

pingback_useragent 是一个 WordPress 过滤器，用于修改在发送 pingback 请求时使用的用户代理字符串。它允许开发者自定义用户代理，以包含 WordPress 版本或其他信息。

关键要点

  • 过滤器名称：pingback_useragent
  • 主要用途：过滤 pingback 请求中的用户代理字符串
  • 参数：包括 $concat_useragent（拼接后的用户代理）、$useragent（原始用户代理）、$pingback_server_url（服务器 URL）、$pagelinkedto（链接到的页面 URL）和 $pagelinkedfrom（链接来源的页面 URL）
  • 应用场景：在 pingback() 函数中调用，用于 pinging back 文章中的链接
  • 引入版本：WordPress 2.9.0

代码示例

$client->useragent = apply_filters( 'pingback_useragent', $client->useragent . ' -- WordPress/' . get_bloginfo( 'version' ), $client->useragent, $pingback_server_url, $pagelinkedto, $pagelinkedfrom );
📄 原文内容

Filters the user agent sent when pinging-back a URL.

Parameters

$concat_useragentstring
The user agent concatenated with ‘ — WordPress/’ and the WordPress version.
$useragentstring
The useragent.
$pingback_server_urlstring
The server URL being linked to.
$pagelinkedtostring
URL of page linked to.
$pagelinkedfromstring
URL of page linked from.

Source

$client->useragent = apply_filters( 'pingback_useragent', $client->useragent . ' -- WordPress/' . get_bloginfo( 'version' ), $client->useragent, $pingback_server_url, $pagelinkedto, $pagelinkedfrom );

View all references View on Trac View on GitHub

Used by Description
pingback()wp-includes/comment.php

Pings back the links found in a post.

Changelog

Version Description
2.9.0 Introduced.