get_bloginfo

函式
get_bloginfo ( $show = '', $filter = 'raw' )
引數
  • (string) $show Optional. Site info to retrieve. Default empty (site name).
    Required:
    Default: (empty)
  • (string) $filter Optional. How to filter what is retrieved. Default 'raw'.
    Required:
    Default: 'raw'
返回值
  • (string) Mostly string values, might be empty.
定義位置
相關方法
get_bloginfo_rssbloginfoget_blog_listget_blog_postget_link
引入
0.71
棄用
-

get_bloginfo: 這個函式檢索關於當前站點或多站點網路中當前站點的父站點的資訊: 該函式接收一個引數,指定要檢索的資訊型別,如網站標題、描述、URL等。

檢索關於當前網站的資訊。

`$show’的可能值包括:

– ‘name’ – 網站標題(在設定> General中設定)。
– ‘description’- 網站標語(在設定> General中設定)。
– ‘wpurl’ – WordPress的地址(URL)(在設定> 常規中設定)。
– ‘url’ – 網站地址(URL)(在設定> General中設定)。
– ‘admin_email’ – 管理員的電子郵件(在設定> General中設定)。
– ‘charset’ -“頁面和feeds的編碼”(在Settings > Reading中設定)。
– ‘版本’ – 當前WordPress的版本
– html_type’ – 內容型別(預設:”text/html”)。主題和外掛
可以使用{@see ‘pre_option_html_type’}過濾器覆蓋預設值。
– ‘text_direction’ – 由網站語言決定的文字方向。
應該被用來代替
– ‘language’ – 當前網站的語言程式碼
– ‘styleheet_url’ – 活動主題的樣式表的URL。一個活躍的子主題
將優先於這個值
– stylesheet_directory’ – 活動主題的目錄路徑。 一個活動的子主題
將會優先於這個值
– ‘template_url’ / ‘template_directory’ – 活動主題目錄的URL。一個活躍的
子主題不會優先考慮這個值。
– ‘pingback_url’ – 回傳的XML-RPC檔案的URL(xmlrpc.php)。
– ‘atom_url’ – Atom feed URL (/feed/atom)
– ‘rdf_url’ – RDF/RSS 1.0饋送URL(/feed/rdf)
– ‘rss_url’ – RSS 0.92 feed URL (/feed/rss)
– ‘rss2_url’ – RSS 2.0的URL(/feed)
– ‘comments_atom_url’ – 評論的Atom feed URL (/comments/feed)
– ‘comments_rss2_url’ – 評論RSS2.0的URL(/comments/feed)

一些`$show’值已被棄用,在未來的版本中會被刪除。這些選項將觸發_deprecated_argument()函式。

棄用的引數包括:

– ‘siteurl’ – 使用’url’代替
– ‘home’ – 使用’url’代替

function get_bloginfo( $show = '', $filter = 'raw' ) {
	switch ( $show ) {
		case 'home':    // Deprecated.
		case 'siteurl': // Deprecated.
			_deprecated_argument(
				__FUNCTION__,
				'2.2.0',
				sprintf(
					/* translators: 1: 'siteurl'/'home' argument, 2: bloginfo() function name, 3: 'url' argument. */
					__( 'The %1$s option is deprecated for the family of %2$s functions. Use the %3$s option instead.' ),
					'<code>' . $show . '</code>',
					'<code>bloginfo()</code>',
					'<code>url</code>'
				)
			);
			// Intentional fall-through to be handled by the 'url' case.
		case 'url':
			$output = home_url();
			break;
		case 'wpurl':
			$output = site_url();
			break;
		case 'description':
			$output = get_option( 'blogdescription' );
			break;
		case 'rdf_url':
			$output = get_feed_link( 'rdf' );
			break;
		case 'rss_url':
			$output = get_feed_link( 'rss' );
			break;
		case 'rss2_url':
			$output = get_feed_link( 'rss2' );
			break;
		case 'atom_url':
			$output = get_feed_link( 'atom' );
			break;
		case 'comments_atom_url':
			$output = get_feed_link( 'comments_atom' );
			break;
		case 'comments_rss2_url':
			$output = get_feed_link( 'comments_rss2' );
			break;
		case 'pingback_url':
			$output = site_url( 'xmlrpc.php' );
			break;
		case 'stylesheet_url':
			$output = get_stylesheet_uri();
			break;
		case 'stylesheet_directory':
			$output = get_stylesheet_directory_uri();
			break;
		case 'template_directory':
		case 'template_url':
			$output = get_template_directory_uri();
			break;
		case 'admin_email':
			$output = get_option( 'admin_email' );
			break;
		case 'charset':
			$output = get_option( 'blog_charset' );
			if ( '' === $output ) {
				$output = 'UTF-8';
			}
			break;
		case 'html_type':
			$output = get_option( 'html_type' );
			break;
		case 'version':
			global $wp_version;
			$output = $wp_version;
			break;
		case 'language':
			/*
			 * translators: Translate this to the correct language tag for your locale,
			 * see https://www.w3.org/International/articles/language-tags/ for reference.
			 * Do not translate into your own language.
			 */
			$output = __( 'html_lang_attribute' );
			if ( 'html_lang_attribute' === $output || preg_match( '/[^a-zA-Z0-9-]/', $output ) ) {
				$output = determine_locale();
				$output = str_replace( '_', '-', $output );
			}
			break;
		case 'text_direction':
			_deprecated_argument(
				__FUNCTION__,
				'2.2.0',
				sprintf(
					/* translators: 1: 'text_direction' argument, 2: bloginfo() function name, 3: is_rtl() function name. */
					__( 'The %1$s option is deprecated for the family of %2$s functions. Use the %3$s function instead.' ),
					'<code>' . $show . '</code>',
					'<code>bloginfo()</code>',
					'<code>is_rtl()</code>'
				)
			);
			if ( function_exists( 'is_rtl' ) ) {
				$output = is_rtl() ? 'rtl' : 'ltr';
			} else {
				$output = 'ltr';
			}
			break;
		case 'name':
		default:
			$output = get_option( 'blogname' );
			break;
	}

	$url = true;
	if ( strpos( $show, 'url' ) === false &&
		strpos( $show, 'directory' ) === false &&
		strpos( $show, 'home' ) === false ) {
		$url = false;
	}

	if ( 'display' === $filter ) {
		if ( $url ) {
			/**
			 * Filters the URL returned by get_bloginfo().
			 *
			 * @since 2.0.5
			 *
			 * @param string $output The URL returned by bloginfo().
			 * @param string $show   Type of information requested.
			 */
			$output = apply_filters( 'bloginfo_url', $output, $show );
		} else {
			/**
			 * Filters the site information returned by get_bloginfo().
			 *
			 * @since 0.71
			 *
			 * @param mixed  $output The requested non-URL site information.
			 * @param string $show   Type of information requested.
			 */
			$output = apply_filters( 'bloginfo', $output, $show );
		}
	}

	return $output;
}

常見問題

FAQs
檢視更多 >