函数文档

wp_ajax_get_permalink()

💡 云策文档标注

概述

wp_ajax_get_permalink() 是一个 WordPress AJAX 处理函数,用于通过 AJAX 请求安全地获取文章的预览链接。它通过验证 AJAX 引用和调用 get_preview_post_link() 来实现功能。

关键要点

  • 函数用途:处理 AJAX 请求以获取文章的预览链接(permalink)。
  • 安全机制:使用 check_ajax_referer() 验证 AJAX 请求,防止外部恶意请求。
  • 核心操作:从 POST 数据中提取 post_id,并调用 get_preview_post_link() 生成预览链接。
  • 输出方式:通过 wp_die() 返回预览链接,终止脚本执行。
  • 相关函数:涉及 get_preview_post_link()、check_ajax_referer() 和 wp_die() 等核心函数。
  • 版本历史:自 WordPress 3.1.0 版本引入。

📄 原文内容

Handles retrieving a permalink via AJAX.

Source

function wp_ajax_get_permalink() {
	check_ajax_referer( 'getpermalink', 'getpermalinknonce' );
	$post_id = isset( $_POST['post_id'] ) ? (int) $_POST['post_id'] : 0;
	wp_die( get_preview_post_link( $post_id ) );
}

Changelog

Version Description
3.1.0 Introduced.