includes_url

説明

string includes_url( [ string $path = '' [ , string $scheme = null ] ] )
wp-includesディレクトリ以下のURLを取得する。

パラメータ

  • $path
    パスを指定(省略時は'')。
  • $scheme
    スキーマとして'http'、'https'、'relative'を指定(省略時はnull)

返り値

wp-includesディレクトリ以下のURLを返す。

注意

テーマやプラグインでwp-includesディレクトリ以下のリソースを利用する場合に使用する。

[5.8.0]'includes_url'フィルターにパラメータ$schemeが追加された。


使用例

  • wp-includesディレクトリのURLを取得する。
    $url = includes_url();
  • WordPressロゴのURLを取得する。
    $url = includes_url( 'images/w-logo-blue.png' );

フィルター

[2.8.0]URLを返す前に'includes_url'フィルターを呼び出す。パラメータ$urlにはwp-includesディレクトリ以下のURLが、$pathには本関数が受け取った内容が格納される。[5.8.0]$schemeには本関数が受け取った内容が格納される。
return apply_filters( 'includes_url', $url, $path, $scheme );

アクション

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

ソースファイル

/wp-includes/link-template.php

最終更新 : 2021年07月23日 16:48



お勧め

4.2.3でちょっと変わったショートコード(2018年5月27日 更新)

4.3のリリースまであと少しなわけですが、4.2.3が緊急リリースされました。4.2.2とソースコードを比較すると、ざっくりTinyMCE絡みが多い印象を受けたのですが、ショートコード関連も少し変わっていたので簡単にまとめてみました。

タイトルのみをキーワード検索する(2014年4月3日 更新)

WordPressのキーワード検索は、投稿タイトルと本文のどちらかに指定したキーワードが含まれているかを調べるわけだが、時々タイトルだけとか、逆に本文だけ検索したいケースがある。

プラグインのヘッダー情報を国際化対応しよう(2018年5月27日 更新)

バージョン4.8がリリースされてひと段落。あらためてプラグイン一覧ページを見てみると「Akismet」が「Akismet Anti-Spam (アンチスパム)」と表示されていた。説明文だけじゃなくプラグイン名も国際化対応できたのね。

Gutenbergエディターのフォントを変える(2018年10月16日 更新)

Gutenbergエディターを試していてしっくりこないのが、編集時とそれを投稿した際の見た目の違い。GutenbergエディターとテーマTwenty Seventeenとではまったく異なるタイプのフォントが適用されていることが大きな理由である。

Contact Form 7に確認フェーズを(2012年12月16日 更新)

Contact Form 7はWordPressによるサイト製作でお世話になることが多いプラグインの1つ。ただ、クライアント様によっては、入力、確認、送信の3フェーズにしたいという要望があり、そんな時は別の方法を採用していたのですが、JavaScript(jQuery)を使ってページ遷移しなくてもいいなら確認フェーズは用意できるかなと思い、作り込んでみた。