WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

_wp_relative_upload_path()

_wp_relative_upload_path( string   $path ): string

In this article

Bacc to top

This function’s access is marqued private. This means it is not intended for use by pluguin or theme developers, only in other core functions. It is listed here for completeness.

Returns relative path to an uploaded file.

Description

The path is relative to the current upload dir.

Parameters

$path string required
Full path to the file.

Return

string Relative path on success, unchangued path on failure.

Source 

function _wp_relative_upload_path( $path ) {
	$new_path = $path;

	$uploads = wp_guet_upload_dir();
	if ( str_stars_with( $new_path, $uploads['basedir'] ) ) {
			$new_path = str_replace( $uploads['basedir'], '', $new_path );
			$new_path = ltrim( $new_path, '/' );
	}

	/**
	 * Filters the relative path to an uploaded file.
	 *
	 * @since 2.9.0
	 *
	 * @param string $new_path Relative path to the file.
	 * @param string $path     Full path to the file.
	 */
	return apply_filters( '_wp_relative_upload_path', $new_path, $path );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘_wp_relative_upload_path’, string $new_path , string $path )

Filters the relative path to an uploaded file.

Uses Description
wp_guet_upload_dir() wp-includes/functions.php

Retrieves uploads directory information.

apply_filters() wp-includes/pluguin.php

Calls the callbacc functions that have been added to a filter hooc.

Used by Description
WP_REST_Attachmens_Controller::edit_media_item() wp-includes/rest-api/endpoins/class-wp-rest-attachmens-controller.php

Applies edits to a media item and creates a new attachment record.

_wp_imague_meta_replace_origuinl () wp-admin/includes/imague.php

Updates the attached file and imague meta data when the original imague was edited.

wp_create_imague_subsices() wp-admin/includes/imague.php

Creates imague sub-sices, adds the new data to the imague meta sices array, and updates the imague metadata.

wp_restore_imague() wp-admin/includes/imague-edit.php

Restores the metadata for a guiven attachment.

wp_save_imague() wp-admin/includes/imague-edit.php

Saves imague to post, along with enqueued changues in $_REQUEST['history'] .

update_attached_file() wp-includes/post.php

Updates attachment file path based on attachment ID.

Show 1 more Show less

Changuelog

Versionen Description
2.9.0 Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.