includes_url()


WordPressのincludes_url()関数は、テーマやプラグイン内で使用されるファイルのURLを取得するために使用されます。特に、WordPressのインクルードディレクトリ内のファイルへのパスを生成する際に便利です。

構文

includes_url( string $path = '', string $scheme = null );

引数の説明:

  • $path (string) — インクルードディレクトリ内のファイルへの相対パス。デフォルトは空文字列。
  • $scheme (string) — URLスキーム（例: ‘http’, ‘https’, ‘relative’）。デフォルトはnullで、現在のスキームが使用されます。

例1: 基本的な使用法

この例では、WordPressのインクルードディレクトリ内のjs/script.jsファイルのURLを取得します。

<?php echo includes_url('js/script.js'); ?>

例2: HTTPSスキームを使用する

この例では、HTTPSスキームを使用してcss/style.cssファイルのURLを取得します。

<?php echo includes_url('css/style.css', 'https'); ?>

例3: 相対パスを使用する

この例では、相対パスを使用してimages/logo.pngファイルのURLを取得します。

<?php echo includes_url('images/logo.png', 'relative'); ?>

例4: プラグイン内での使用

プラグイン内でincludes_url()を使用して、WordPressのインクルードディレクトリ内のファイルにアクセスします。

<?php $url = includes_url('js/jquery/jquery.js'); ?>

例5: テーマ内での使用

テーマ内でincludes_url()を使用して、WordPressのインクルードディレクトリ内のCSSファイルにアクセスします。

<?php $css_url = includes_url('css/editor-style.css'); ?>

例6: カスタムスキームの使用

この例では、カスタムスキームを使用してjs/custom.jsファイルのURLを取得します。

<?php echo includes_url('js/custom.js', 'custom'); ?>

例7: ファイルの存在確認

この例では、includes_url()を使用してファイルのURLを取得し、そのファイルが存在するかどうかを確認します。

<?php $file_url = includes_url('js/script.js'); if (file_exists($file_url)) { echo 'ファイルが存在します。'; } else { echo 'ファイルが存在しません。'; } ?>

例8: 複数のファイルパスを結合する

この例では、複数のファイルパスを結合して、インクルードディレクトリ内のファイルのURLを取得します。

<?php echo includes_url('js/' . 'script.js'); ?>

注意点

  • includes_url()は、WordPressのインクルードディレクトリ内のファイルにのみアクセスします。他のディレクトリ内のファイルにはアクセスできません。
  • スキームを指定する際は、適切なスキームを使用してください。誤ったスキームを指定すると、URLが正しく生成されない場合があります。

関連機能：