描述
返回你博客的信息,這些信息可以用在任何地方的 PHP 代碼中。這個函數,和 bloginfo() 一樣,可以用來在模板文件的任何地方顯示你博客的信息。
用法
$bloginfo = get_bloginfo( $show, $filter );
參數
- $show
- (字符串 string) (可選) 關鍵字命名你想要的信息。
- 默認: name
-
'name' - 返回在 設置 > 常規 中設置的“博客標題”。此數據可以從 wp_options 這個表中的 “blogname”中檢索到。
'description' - 返回在 設置 > 常規 中設置的“副標題”。此數據可以從 wp_options 這個表中的 “blogdescription”中檢索到。
-
'wpurl' - 返回在 設置 > 常規 中設置的“WordPress 地址 (URL)”。此數據可以從 wp_options 這個表中的 “siteurl”中檢索到。 可以考慮使用site_url() 替代, 尤其是在使用 子目錄路徑方式,而不是使用 子域名 來配置多站點時(bloginfo將返回根網站的URL,而不是子站點的URL)。
'siteurl' / 'url' - 顯示在 設置 > 常規 中設置的 “站點地址(URL)”)”。該數據是從 wp_options 這個數據表中檢索到的 "home"記錄。 可以考慮使用 home_url() 代替。
'admin_email' - 顯示在 設置 > 常規 中設置的 “電子郵件地址”。該數據是從 wp_options 這個數據表中檢索到的 "admin_email"記錄。
'charset' - 顯示在 設置 > 常規 中設置的“頁面和feed的編碼”。該數據是從 wp_options 這個數據表中檢索到的"blog_charset" 記錄。(注:3.5.1+好像已經沒有這個選項了)
'version' - 顯示你當前使用的 WordPress 版本。該數據是在 wp-includes/version.php 檢索到的 $wp_version 這個字段的值。
'html_type' - 顯示WordPress HTML 頁面中的內容類型(默認: "text/html")。該數據可以從 wp_options 這個數據表中檢索到的 "html_type" 記錄。主題和插件可以通過使用pre_option_html_type 過濾器覆蓋默認值。
'text_direction' - 顯示 WordPress HTML 頁面的文本方向。可以考慮使用 is_rtl() 代替。
'language' - 顯示WordPress的語言。
'stylesheet_url' - 顯示當前使用的主題的 CSS文件(通常爲 style.css)路徑。可以考慮使用 get_stylesheet_uri() 代替。
'stylesheet_directory' - 顯示當前使用的主題的樣式表路徑。可以考慮使用 get_stylesheet_directory_uri() 代替。
'template_url' / 'template_directory' - 當前主題的 URL 路徑 。在子主題中, get_bloginfo('template_url') 和 get_template() 都將返回父主題的目錄。可以考慮使用get_template_directory_uri() (用於父主題目錄)或get_stylesheet_directory_uri()(用於子主題目錄)代替。
'pingback_url' - 顯示通告文件 XML-RPC 的URL (xmlrpc.php)
'atom_url' - 顯示 Atom feed URL (/feed/atom)
'rdf_url' - 顯示 RDF/RSS 1.0 feed URL (/feed/rfd).
'rss_url' - 顯示 RSS 0.92 feed URL (/feed/rss).
'rss2_url' - 顯示 RSS 2.0 feed URL (/feed).
'comments_atom_url' - 顯示評論的 Atom feed URL (/comments/feed).
'comments_rss2_url' - 顯示評論的 RSS 2.0 feed URL (/comments/feed).
- $filter
- (字符串 string) (可選)關鍵字指定如何過濾檢索到的數據。
- 默認: raw
-
'display' - 通過 wptexturize() 函數過濾 $show 的值,然後返回輸出給請求者。
'raw' - 直接返回 $show 的值。