get_site_icon_url() - WordPress 函数参考中文文档

返回介绍

get_site_icon_url()

发布于 2017-09-11 字数2984 浏览 964 评论 0

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

Returns the Site Icon URL.


描述


参数

$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 描述
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

上一篇:get_site_by_path()

下一篇:get_site_option()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!