Question

get_site_icon_url( int $size = 512,  string $url = '',  int $blog_id )

Returns the Site Icon URL.

---

description

---

参数

$size

(int) (Optional) Size of the site icon. Default 512 (pixels).

Default value: 512

$url

(string) (Optional) Fallback url if no site icon is found.

Default value: ''

$blog_id

(int) (Optional) ID of the blog to get the site icon for. Default current blog.

---

返回值

(string) Site Icon URL.

---

源代码

File: wp-includes/general-template.php

function get_site_icon_url( $size = 512, $url = '', $blog_id = 0 ) {
	$switched_blog = false;

	if ( is_multisite() && ! empty( $blog_id ) && (int) $blog_id !== get_current_blog_id() ) {
		switch_to_blog( $blog_id );
		$switched_blog = true;
	}

	$site_icon_id = get_option( 'site_icon' );

	if ( $site_icon_id ) {
		if ( $size >= 512 ) {
			$size_data = 'full';
		} else {
			$size_data = array( $size, $size );
		}
		$url = wp_get_attachment_image_url( $site_icon_id, $size_data );
	}

	if ( $switched_blog ) {
		restore_current_blog();
	}

	/**
	 * Filters the site icon URL.
	 *
	 * @since 4.4.0
	 *
	 * @param string $url     Site icon URL.
	 * @param int    $size    Size of the site icon.
	 * @param int    $blog_id ID of the blog to get the site icon for.
	 */
	return apply_filters( 'get_site_icon_url', $url, $size, $blog_id );
}

---

更新日志

Version	description
4.3.0	Introduced.

---

相关函数

Uses

• wp-includes/general-template.php: get_site_icon_url
• wp-includes/media.php: wp_get_attachment_image_url()
• wp-includes/load.php: is_multisite()
• wp-includes/load.php: get_current_blog_id()
• wp-includes/plugin.php: apply_filters()
• wp-includes/option.php: get_option()
• wp-includes/ms-blogs.php: switch_to_blog()
• wp-includes/ms-blogs.php: restore_current_blog()
Show 3 more uses Hide more uses

---

Used By

• wp-includes/embed.php: the_embed_site_title()
• wp-includes/general-template.php: wp_site_icon()
• wp-includes/general-template.php: site_icon_url()
• wp-includes/general-template.php: has_site_icon()
• wp-includes/feed.php: atom_site_icon()
• wp-includes/feed.php: rss2_site_icon()
Show 1 more used by Hide more used by

---

User Contributed Notes