あちゃまWEB >

WordPressの設定情報を読み取る関数一覧

WordPress ダッシュボード設定を読み取る関数一覧（引数と使用例付き）

WordPressのダッシュボード（管理画面）で設定された情報を読み取るための主要な関数をアルファベット順にリストアップしています。
各関数の引数と具体的な使用例も併記しています。特に利用頻度の高い関数は太字で示しています。

関数名 引数 説明と使用例
bloginfo() $show = '' (string) サイトの様々な情報を取得・表示します。例えば、サイトタイトル、説明、WordPressのURL、テーマのURL、RSSフィードURLなど。引数によって取得する情報が変わります。 
<h1><?php bloginfo('name'); ?></h1>
<p><?php bloginfo('description'); ?></p>
get_bloginfo() $show = '' (string)
$filter = 'raw' (string)		 `bloginfo()` と同じ情報を取得しますが、こちらは値を出力するのではなく返します。プログラム内で値を利用する場合に便利です。 
<?php
$site_name = get_bloginfo('name');
echo "ようこそ、" . $site_name . "へ！";
?>
get_option() $option (string)
$default = false (mixed)		 WordPressのオプション設定テーブル（`wp_options`）から任意のオプションの値を取得します。プラグインやテーマが保存したカスタム設定を読み込む際によく使用されます。 
<?php
$admin_email = get_option('admin_email');
echo "管理者メールアドレス: " . $admin_email;
?>
get_permalink() $post = 0 (int|WP_Post)
$leavename = false (bool)		 投稿、ページ、カスタム投稿タイプなどの**パーマリンク（URL）を取得します。** 
<a href="<?php echo get_permalink(); ?>">投稿を読む</a>
get_post_format() $post = null (int|WP_Post) 投稿フォーマット（例: `aside`, `gallery`, `video` など）を取得します。 
<?php
if ( get_post_format() == 'video' ) {
    echo '<p>動画投稿です。</p>';
}
?>
get_query_var() $var (string)
$default = '' (string|int)		 WordPressのクエリ変数（URLパラメータなど）の値を取得します。 
<?php
$page_num = get_query_var('paged');
if ($page_num) {
    echo "<p>現在のページ番号: " . $page_num . "</p>";
}
?>
get_stylesheet_directory_uri() なし 現在のテーマのスタイルシートディレクトリの**URI（URL）を取得します。** CSSや画像、JSなどの読み込みパス指定に不可欠です。 
<img src="<?php echo get_stylesheet_directory_uri(); ?>/images/logo.png" alt="ロゴ">
get_stylesheet_uri() なし 現在のテーマの `style.css` ファイルのURI（URL）を取得します。 
<link rel="stylesheet" href="<?php echo get_stylesheet_uri(); ?>">
get_template_directory_uri() なし 現在の親テーマのディレクトリの**URI（URL）を取得します。**子テーマを使用している場合でも、親テーマのリソースを読み込む際に使用します。 
<!-- 親テーマのJSファイルを読み込む場合 -->
<script src="<?php echo get_template_directory_uri(); ?>/js/main.js"></script>
get_the_author() なし 現在の投稿の**著者名を取得します。** 
<p>著者: <?php the_author(); ?></p>
<!-- the_author() は get_the_author() を出力するラッパー関数 -->
get_the_author_meta() $field (string)
$user_id = false (int)		 著者のメタ情報（表示名、ウェブサイト、説明など）を取得します。 
<?php
$author_description = get_the_author_meta('description');
if ($author_description) {
    echo "<p>" . $author_description . "</p>";
}
?>
get_the_date() $d = '' (string)
$post = null (int|WP_Post)		 現在の投稿の**日付を取得します。**フォーマットを指定できます。 
<p>投稿日: <?php echo get_the_date('Y年m月d日'); ?></p>
get_the_ID() なし 現在の投稿やページの**IDを取得します。** 
<!-- 投稿IDをクラス名に利用する例 -->
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
<!-- the_ID() は get_the_ID() を出力するラッパー関数 -->
get_the_post_thumbnail_url() $post = null (int|WP_Post)
$size = 'post-thumbnail' (string|array)		 投稿のアイキャッチ画像（サムネイル）のURLを取得します。 
<?php
if ( has_post_thumbnail() ) {
    $thumbnail_url = get_the_post_thumbnail_url(null, 'medium');
    echo '<img src="' . $thumbnail_url . '" alt="アイキャッチ">';
}
?>
get_the_tag_list() $before = '' (string)
$sep = '' (string)
$after = '' (string)
$id = 0 (int)		 現在の投稿に関連付けられた**タグのリストをHTML形式で取得します。** 
<div class="post-tags">
    <?php echo get_the_tag_list('<ul><li>', '</li><li>', '</li></ul>'); ?>
</div>
get_the_time() $d = '' (string)
$post = null (int|WP_Post)		 現在の投稿の**時刻を取得します。**フォーマットを指定できます。 
<p>時刻: <?php echo get_the_time('H:i'); ?></p>
get_the_title() $post = 0 (int|WP_Post) 現在の投稿やページの**タイトルを取得します。** 
<h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
<!-- the_title() は get_the_title() を出力するラッパー関数 -->
get_theme_mod() $name (string)
$default = false (mixed)		 カスタマイザーで設定されたテーマモディファイアの値を取得します。テーマオプションをカスタマイザーで提供している場合に使用します。 
<?php
$footer_text = get_theme_mod('custom_footer_text', 'Copyright © ' . date('Y'));
echo "<p>" . $footer_text . "</p>";
?>
home_url() $path = '' (string)
$scheme = null (string|null)		 サイトの**ホームURLを取得します。**WordPressアドレス（URL）の設定値に基づきます。 
<a href="<?php echo home_url('/'); ?>">トップページへ</a>
is_front_page() なし 現在のページが**フロントページ（トップページ）であるかを判定します。** 
<?php
if ( is_front_page() ) {
    echo '<p>これはサイトのトップページです。</p>';
}
?>
is_home() なし 現在のページがブログの投稿一覧ページであるかを判定します。 
<?php
if ( is_home() && ! is_front_page() ) {
    echo '<p>これはブログ投稿一覧ページです。</p>';
}
?>
is_page() $page = '' (int|string|array) 現在のページが単一の固定ページであるかを判定します。特定のIDやスラッグのページを指定することもできます。 
<?php
if ( is_page('about-us') ) {
    echo '<p>会社概要ページです。</p>';
}
?>
is_single() $post = '' (int|string|array) 現在のページが単一の投稿ページであるかを判定します。特定のIDやスラッグの投稿を指定することもできます。 
<?php
if ( is_single() ) {
    echo '<p>単一のブログ投稿ページです。</p>';
}
?>
language_attributes() なし HTMLタグの `lang` 属性や `dir` 属性を生成します。国際化のために重要です。 
<html <?php language_attributes(); ?>>
wp_title() $sep = '»' (string)
$display = true (bool)
$seplocation = '' (string)		 ページのタイトルを出力します。主にHTMLの`<title>`タグ内で使用されていましたが、WordPress 5.4以降では**非推奨**であり、`add_theme_support(‘title-tag’)` を使用することが推奨されています。 
<title><?php wp_title('|', true, 'right'); ?></title>

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です

WordPress情報

WEB開発

その他