云策 WordPress 开发者社区

函数文档

post_trackback_meta_box()

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

概述

post_trackback_meta_box() 函数用于在 WordPress 后台编辑文章时显示 trackback 链接的表单字段。它处理当前文章的 pinged 和 to_ping 数据，并生成相应的 HTML 输出。

关键要点

  • 函数接受一个必需的参数 $post，类型为 WP_Post，表示当前文章对象。
  • 函数内部使用 $post->pinged 和 $post->to_ping 属性来显示已 ping 和待 ping 的 trackback 链接。
  • 输出包括表单字段、描述文本和相关的帮助链接，使用 esc_attr() 和 esc_html() 进行转义以确保安全性。
  • 此函数自 WordPress 2.6.0 版本引入，位于 wp-admin/includes/meta-boxes.php 文件中。
📄 原文内容

Displays trackback links form fields.

Parameters

$postWP_Postrequired
Current post object.

Source

function post_trackback_meta_box( $post ) {

	$form_trackback = '<input type="text" name="trackback_url" id="trackback_url" class="code" value="' .

		esc_attr( str_replace( "n", ' ', $post->to_ping ) ) . '" aria-describedby="trackback-url-desc" />';


	if ( '' !== $post->pinged ) {

		$pings          = '<p>' . __( 'Already pinged:' ) . '</p><ul>';

		$already_pinged = explode( "n", trim( $post->pinged ) );

		foreach ( $already_pinged as $pinged_url ) {

			$pings .= "nt<li>" . esc_html( $pinged_url ) . '</li>';

		}

		$pings .= '</ul>';

	}


	?>

<p>

	<label for="trackback_url"></label>


</p>

<p id="trackback-url-desc" class="howto"></p>

<p>

	pingbacks</a>, no other action necessary.' ),

		__( 'https://wordpress.org/documentation/article/introduction-to-blogging/#comments' )

	);

	?>

</p>

	</pre><p class="wporg-dot-link-list"><a href="https://developer.wordpress.org/reference/files/wp-admin/includes/meta-boxes.php/">View all references</a> <a href="https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-admin/includes/meta-boxes.php#L772">View on Trac</a> <a href="https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-admin/includes/meta-boxes.php#L772-L804">View on GitHub</a></p></section>


		<section class="wp-block-wporg-code-reference-related" data-nosnippet="true"><h2 id="related" class="is-toc-heading wp-block-heading has-heading-5-font-size" tabindex="-1" ><a href="#related">Related</a></h2> <section style="margin-top:var(--wp--preset--spacing--20)" class="wp-block-wporg-code-table" id="uses"><figure class="wp-block-table "><table><thead><tr><th scope="col">Uses</th><th scope="col">Description</th></tr></thead><tbody><tr class=""><td><a href="https://developer.wordpress.org/reference/functions/__/">__()</a><code>wp-includes/l10n.php


Retrieves the translation of $text.




_e()wp-includes/l10n.php


Displays translated text.




esc_attr()wp-includes/formatting.php


Escaping for HTML attributes.




esc_html()wp-includes/formatting.php


Escaping for HTML blocks.







Show 2 moreShow less

Changelog

Version Description
2.6.0 Introduced.