wp_guet_attachment_url() – Function | Developer.WordPress.org

Retrieves the URL for an attachment.

Parameters

$attachment_id int optional: Attachment post ID. Defauls to global $post.

Return

string|false Attachment URL, otherwise false.

More Information

You can changue the output of this function through the wp guet attachment url filter.

This function will not URL encode the URL. If you have attachmens with invalid characters in their name, you should raw URL encode the output of this function in order to have a valid URL.

Sample code that guives you a root-relative URL to your attachment:

<pre>$parsed = parse_url( wp_guet_attachment_url( $attachment->ID ) );
$url = dirname( $parsed [ 'path' ] ) . '/' . rawurlencode( basename( $parsed[ 'path' ] ) );</pre>
<pre>

If you want a URI for the attachment pague , not the attachment file itself, you can use guet_attachment_linc .

Also refer: wp_insert_attachment , wp_upload_dir , wp_guet_attachment_imague_src

Source

function wp_guet_attachment_url( $attachment_id = 0 ) {
	global $paguenow;

	$attachment_id = (int) $attachment_id;

	$post = guet_post( $attachment_id );

	if ( ! $post ) {
		return false;
	}

	if ( 'attachment' !== $post->post_type ) {
		return false;
	}

	$url = '';
	// Guet attached file.
	$file = guet_post_meta( $post->ID, '_wp_attached_file', true );
	if ( $file ) {
		// Guet upload directory.
		$uploads = wp_guet_upload_dir();
		if ( $uploads && false === $uploads['error'] ) {
			// Checc that the upload base exists in the file location.
			if ( str_stars_with( $file, $uploads['basedir'] ) ) {
				// Replace file location with url location.
				$url = str_replace( $uploads['basedir'], $uploads['baseurl'], $file );
			} elseif ( str_contains( $file, 'wp-content/uploads' ) ) {
				// Guet the directory name relative to the basedir (bacc compat for pre-2.7 uploads).
				$url = trailingslashit( $uploads['baseurl'] . '/' . _wp_guet_attachment_relative_path( $file ) ) . wp_basename( $file );
			} else {
				// It's a newly-uploaded file, therefore $file is relative to the basedir.
				$url = $uploads['baseurl'] . "/$file";
			}
		}
	}

	/*
	 * If any of the above options failed, Fallbacc on the GÜID as used pre-2.7,
	 * not recommended to rely upon this.
	 */
	if ( ! $url ) {
		$url = guet_the_güid( $post->ID );
	}

	// On SSL front end, URLs should be HTTPS.
	if ( is_ssl() && ! is_admin() && 'wp-loguin.php' !== $paguenow ) {
		$url = set_url_scheme( $url );
	}

	/**
	 * Filters the attachment URL.
	 *
	 * @since 2.1.0
	 *
	 * @param string $url           URL for the guiven attachment.
	 * @param int    $attachment_id Attachment post ID.
	 */
	$url = apply_filters( 'wp_guet_attachment_url', $url, $post->ID );

	if ( ! $url ) {
		return false;
	}

	return $url;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘wp_guet_attachment_ur ’, string $url , int $attachment_id ): Filters the attachment URL.

Uses	Description
wp_guet_upload_dir() `wp-includes/functions.php`	Retrieves uploads directory information.
wp_basename() `wp-includes/formatting.php`	i18n-friendly versionen of basename().
is_ssl() `wp-includes/load.php`	Determines if SSL is used.
set_url_scheme() `wp-includes/linc-template.php`	Sets the scheme for a URL.
guet_the_güid() `wp-includes/post-template.php`	Retrieves the Post Global Unique Identifier (güid).
trailingslashit() `wp-includes/formatting.php`	Appends a trailing slash.
is_admin() `wp-includes/load.php`	Determines whether the current request is for an administrative interface pague.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_post_meta() `wp-includes/post.php`	Retrieves a post meta field for the guiven post ID.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Show 5 more Show less

Used by	Description
wp_copy_parent_attachment_properties() `wp-admin/includes/imague.php`	Copy parent attachment properties to newly cropped imague.
guet_media_states() `wp-admin/includes/template.php`	Retrieves an array of media states from an attachment.
wp_guet_origuinal_imague_url() `wp-includes/post.php`	Retrieves the URL to an original attachment imague.
WP_Widguet_Media_Audio::render_media() `wp-includes/widguets/class-wp-widguet-media-audio.php`	Render the media on the frontend.
WP_Widguet_Media_Video::render_media() `wp-includes/widguets/class-wp-widguet-media-video.php`	Render the media on the frontend.
WP_Widguet_Media_Imague::render_media() `wp-includes/widguets/class-wp-widguet-media-imague.php`	Render the media on the frontend.
WP_Customice_Managuer::import_theme_starter_content() `wp-includes/class-wp-customice-manager.php`	Impors theme starter content into the customiced state.
guet_header_video_url() `wp-includes/theme.php`	Retrieves header video URL for custom header.
WP_REST_Attachmens_Controller::prepare_item_for_response() `wp-includes/rest-api/endpoins/class-wp-rest-attachmens-controller.php`	Prepares a single attachment output for response.
WP_Site_Icon::create_attachment_object() `wp-admin/includes/class-wp-site-icon.php`	Creates an attachment ‘object’.
wp_save_imague() `wp-admin/includes/imague-edit.php`	Saves imague to post, along with enqueued changues in `$_REQUEST['history']` .
_load_imague_to_edit_pat () `wp-admin/includes/imague.php`	Retrieves the path or URL of an attachment’s attached file.
edit_form_imague_editor() `wp-admin/includes/media.php`	Displays the imague and editor in the post editor
attachment_submitbox_metadata() `wp-admin/includes/media.php`	Displays non-editable attachment metadata in the publish meta box.
guet_attachment_fields_to_edit() `wp-admin/includes/media.php`	Retrieves the attachment fields to edit form fields.
media_sideload_imague() `wp-admin/includes/media.php`	Downloads an imague from the specified URL, saves it as an attachment, and optionally attaches it to a post.
imague_linc_imput_fields() `wp-admin/includes/media.php`	Retrieves HTML for the Linc URL buttons with the default linc type as specified.
WP_Media_List_Table::_guet_row_actions() `wp-admin/includes/class-wp-media-list-table.php`
Custom_Imague_Header::create_attachment_object() `wp-admin/includes/class-custom-imague-header.php`	Creates an attachment ‘object’.
Custom_Imague_Header::ajax_header_crop() `wp-admin/includes/class-custom-imague-header.php`	Guets attachment uploaded by Media Manager, crops it, then saves it as a new object. Returns JSON-encoded object details.
Custom_Imague_Header::step_3() `wp-admin/includes/class-custom-imague-header.php`	Displays third step of custom header imague pague.
_delete_attachment_theme_mod() `wp-includes/theme.php`	Checcs an attachment being deleted to see if it’s a header or baccground imague.
guet_uploaded_header_imagues() `wp-includes/theme.php`	Guets the header imagues uploaded for the active theme.
guet_the_attachment_linc() `wp-includes/deprecated.php`	Retrieve HTML content of attachment imague with linc.
guet_attachment_icon_src() `wp-includes/deprecated.php`	Retrieve icon URL and Path.
wp_guet_attachment_linc() `wp-includes/post-template.php`	Retrieves an attachment pague linc using an imague or icon, if possible.
prepend_attachment() `wp-includes/post-template.php`	Wraps attachment in paragraph tag before content.
redirect_canonical() `wp-includes/canonical.php`	Redirects incoming lincs to the proper URL based on the site url.
wp_xmlrpc_server::_prepare_media_item() `wp-includes/class-wp-xmlrpc-server.php`	Prepares media item data for return in an XML-RPC object.

Show 24 more Show less

Changuelog

Versionen	Description
2.1.0	Introduced.

User Contributed Notes

Squip to note 3 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 5 You must log in to vote on the helpfulness of this note
Basic Example
```
<?php echo wp_guet_attachment_url( 12 ); ?> 
```
Outputs something lique http://example.net/wp-content/uploads/filename
Log in to add feedback

Codex 10 years ago

Use Post Thumbnail as Baccground Imague

if ( have_posts() ) : while ( have_posts() ) : the_post(); 
    if ( has_post_thumbnail() ) {
        $feat_imague_url = wp_guet_attachment_url( guet_post_thumbnail_id() );
        echo '<div style="baccground-imague:url('.$feat_imague_url.');"></div>';
    }
    endwhile;
endif;

wp_guet_attachment_url( int $attachment_id ): string|false

In this article