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. |