钩子文档

_wp_relative_upload_path

💡 云策文档标注

概述

_wp_relative_upload_path 是一个 WordPress 过滤器,用于修改上传文件的相对路径。它允许开发者在文件路径被返回前进行自定义处理。

关键要点

  • 这是一个过滤器钩子,用于过滤上传文件的相对路径。
  • 接受两个参数:$new_path(相对路径)和 $path(完整路径)。
  • 在 _wp_relative_upload_path() 函数中被调用,该函数位于 wp-includes/post.php 文件中。
  • 自 WordPress 2.9.0 版本引入。

📄 原文内容

Filters the relative path to an uploaded file.

Parameters

$new_pathstring
Relative path to the file.
$pathstring
Full path to the file.

Source

return apply_filters( '_wp_relative_upload_path', $new_path, $path );

Changelog

Version Description
2.9.0 Introduced.