{$field_no_prefix}_save_pre
云策文档标注
概述
该文档介绍了 {$field_no_prefix}_save_pre 过滤器，用于在保存特定文章字段前过滤其值。此过滤器仅适用于以 post_ 为前缀的字段，动态部分 $field_no_prefix 指字段名去除前缀后的部分。
关键要点
- 过滤器名称基于字段名，如 author_save_pre、content_save_pre 等。
- 参数 $value 为文章字段的原始值，回调函数必须返回处理后的值，否则内容将为空。
- 主要用于 sanitize_post_field() 函数中，用于根据上下文清理文章字段。
- 自 WordPress 2.3.0 版本引入。
代码示例
add_filter( 'content_save_pre' , 'my_sanitize_content' , 10, 1);
function my_sanitize_content( $content ) {
return str_replace( "r", "", $content );
}注意事项
过滤器回调函数必须返回处理后的值，否则可能导致字段内容为空。
原文内容
Filters the value of a specific field before saving.
Description
Only applied to post fields with a name which is prefixed with post_.
The dynamic portion of the hook name, $field_no_prefix, refers to the post field name minus the post_ prefix. Possible filter names include:
author_save_predate_save_predate_gmt_save_precontent_save_pretitle_save_preexcerpt_save_prestatus_save_prepassword_save_prename_save_premodified_save_premodified_gmt_save_precontent_filtered_save_preparent_save_pretype_save_premime_type_save_pre
Parameters
$valuemixed-
Value of the post field.
Source
$value = apply_filters( "{$field_no_prefix}_save_pre", $value );
Changelog
| Version | Description |
|---|---|
| 2.3.0 | Introduced. |
Skip to note 2 content
Steven Lin
Example migrated from Codex:
The example below uses the hook
content_save_preto remove undesirable carriage return character.add_filter( 'content_save_pre' , 'my_sanitize_content' , 10, 1); function my_sanitize_content( $content ) { return str_replace( "r<figcaption>", "<figcaption>", $content ); }