函数文档

wp_ajax_sample_permalink()

💡 云策文档标注

概述

wp_ajax_sample_permalink() 是一个 WordPress AJAX 处理函数,用于通过 AJAX 请求获取示例固定链接的 HTML 内容。它验证请求并调用 get_sample_permalink_html() 返回结果。

关键要点

  • 函数用途:处理 AJAX 请求以获取示例固定链接,常用于文章编辑界面。
  • 安全验证:使用 check_ajax_referer() 验证 nonce 以防止跨站请求伪造。
  • 参数处理:接收 post_id、new_title 和 new_slug 参数,并传递给 get_sample_permalink_html()。
  • 输出方式:通过 wp_die() 输出 HTML 结果并终止执行。
  • 相关函数:依赖 get_sample_permalink_html()、check_ajax_referer() 和 wp_die()。
  • 版本历史:自 WordPress 3.1.0 版本引入。

代码示例

function wp_ajax_sample_permalink() {
    check_ajax_referer( 'samplepermalink', 'samplepermalinknonce' );
    $post_id = isset( $_POST['post_id'] ) ? (int) $_POST['post_id'] : 0;
    $title   = isset( $_POST['new_title'] ) ? $_POST['new_title'] : '';
    $slug    = isset( $_POST['new_slug'] ) ? $_POST['new_slug'] : null;
    wp_die( get_sample_permalink_html( $post_id, $title, $slug ) );
}

📄 原文内容

Handles retrieving a sample permalink via AJAX.

Source

function wp_ajax_sample_permalink() {
	check_ajax_referer( 'samplepermalink', 'samplepermalinknonce' );
	$post_id = isset( $_POST['post_id'] ) ? (int) $_POST['post_id'] : 0;
	$title   = isset( $_POST['new_title'] ) ? $_POST['new_title'] : '';
	$slug    = isset( $_POST['new_slug'] ) ? $_POST['new_slug'] : null;
	wp_die( get_sample_permalink_html( $post_id, $title, $slug ) );
}

Changelog

Version Description
3.1.0 Introduced.