wp_site_icon

(4.3.0以降)
wp_site_icon - サイトアイコンを表示する

説明

void wp_site_icon()
サイトアイコンを表示する。

パラメータ

パラメータはありません。

返り値

返り値はありません。

注意

サイトアイコンの登録・変更は、管理画面の「外観」-「カスタマイズ」-「サイト基本情報」で行う。サイトアイコンの画像情報そのものは投稿タイプがメディア('attachment')として、その投稿IDがオプション情報('site_icon')として保存される(マルチサイトではブログ別に指定)。

標準ではwp_headアクションとして登録されており、テーマから直接呼び出すことはまずないだろう。表示されるサイトアイコンのメタ要素は、標準では次の4つである。

<link rel="icon" href="http://localhost/wp-content/uploads/2015/08/siteicon-32x32.jpg" sizes="32x32" />
<link rel="icon" href="http://localhost/wp-content/uploads/2015/08/siteicon-192x192.jpg" sizes="192x192" />
<link rel="apple-touch-icon-precomposed" href="http://localhost/wp-content/uploads/2015/08/siteicon-180x180.jpg">
<meta name="msapplication-TileImage" content="http://localhost/wp-content/uploads/2015/08/siteicon-270x270.jpg">

使用例

  • サイトアイコンを表示する。
    <?php wp_site_icon(); ?>

フィルター

[4.3.0]サイトアイコンのメタ要素を表示する前にsite_icon_meta_tagsフィルターを呼び出す。パラメータ$meta_tagsはサイトアイコンのメタ要素の配列が格納される。
$meta_tags = apply_filters( 'site_icon_meta_tags', $meta_tags );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/general-template.php

関連

  • esc_url - URL文字列をクリーニングする
  • get_site_icon_url - サイトアイコンのURLを取得する
  • has_site_icon - サイトアイコンが設定済みか調べる
  • wp_head - wp_headアクションを実行する

お勧めコンテンツ

サイドバーの初期化はwidgets_initアクションで(2011年7月14日 登録)

ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。

投稿情報を連想配列で参照する(2014年11月16日 登録)

投稿情報は、タイトルや本文、投稿日時といったいくつかのデータが含んでおり、多くの場合オブジェクトになっている。これを連想配列で扱いたい場合はキャストして型変換することが多かった。基本的にはキャストで問題ないのだが、ふと目に留まったto_arrayメソッドが興味深かったのでメモとして残しておく。

canvasタグを投稿したい(2013年12月27日 登録)

以前「投稿内容のid属性などを保存するための対策」で取り上げたように、WordPressでは投稿に記述できるHTMLタグが制限されている。同コラムでこの制限を調整する対策を紹介しているが、3.5以降ではフィルター関数を登録して対応できるようだ。

xmlrpc.phpへのアクセスについてちょっと考えた(2015年7月10日 登録)

少し前のことですが、こちらのサーバーを何度かダウンさせてしまったのですが、その原因はxmlrpc.phpへアクセスが集中したことによってサーバーが過負荷となってしまったというものでした。すぐにサーバー性能を上げることはできないため、xmlrpc.phpのアクセスを全部拒否するという暫定対応してしまいました。

各投稿記事で設定されているカスタムフィールドの値を取得するには(2011年9月16日 登録)

投稿記事ごとに設定されているカスタムフィールドの値はget_post_meta関数で取得できるが、すべての投稿記事で設定されているカスタムフィールドの値を一覧を取得する関数が見当たらない。カテゴリーや投稿タグのようにそれぞれの値と実際に使用されている投稿記事件数を取得したいのだが、探し方が悪いのか見つからないのだ。

最終更新日時 : 2015-08-20 17:44