WordPressの関数・定数まとめ。
get_stylesheet_directory_uri()
のようなよく使うやつ、ちょっと忘れがちな関数、ついでにあんまり使わないけど存在は覚えておきたいもの。
カテゴリごとに分けて、引数やPHPコード例も一緒にメモ。
🔧 テンプレート関連
ヘッダー部分の読み込み – get_header()
引数:get_header($name)
使用例:<?php get_header(); ?>
テーマのヘッダーファイル (header.php) を読み込みます。
フッター部分の読み込み – get_footer()
引数:get_footer($name)
使用例:<?php get_footer(); ?>
テーマのフッターファイル (footer.php) を読み込みます。
サイドバーの読み込み – get_sidebar()
引数:get_sidebar($name)
使用例:<?php get_sidebar(); ?>
テーマのサイドバーファイル (sidebar.php) を読み込みます。
テンプレートパーツの読み込み – get_template_part()
引数:get_template_part($slug, $name)
使用例:<?php get_template_part('content', 'single'); ?>
テンプレートの一部(例:投稿コンテンツ、カスタム投稿)を再利用可能な形で読み込みます。
テンプレートファイルのパス取得 – locate_template()
引数:locate_template($template_names, $load = false, $require_once = true)
使用例:<?php locate_template(['custom.php'], true); ?>
指定したテンプレートファイルのパスを検索し、必要に応じて読み込みます。子テーマ/親テーマの順で優先的に探します。
現在のページが特定のテンプレートか判定 – is_page_template()
引数:is_page_template($template = '')
使用例:<?php if ( is_page_template('about.php') ) : ?>
現在のページが、指定したページテンプレートを使用しているか判定します。
親テーマディレクトリのURL取得 – get_template_directory_uri()
引数:なし
使用例:<link rel="stylesheet" href="<?php echo get_template_directory_uri(); ?>/style.css">
親テーマディレクトリのURLを返します。子テーマを使用している場合でも親テーマのURLを取得したいときに使います。
親テーマディレクトリのパス取得 – get_template_directory()
引数:なし
使用例:<?php require_once get_template_directory() . '/inc/custom-functions.php'; ?>
親テーマディレクトリのサーバー上の絶対パスを返します。サーバー上のファイルを読み込む際に使います。
子テーマディレクトリのURL取得 – get_stylesheet_directory_uri()
引数:なし
使用例:<link rel="stylesheet" href="<?php echo get_stylesheet_directory_uri(); ?>/css/style.css">
有効化されているテーマ(子テーマの場合は子テーマ)のディレクトリURLを返します。
子テーマディレクトリのパス取得 – get_stylesheet_directory()
引数:なし
使用例:<?php require_once get_stylesheet_directory() . '/inc/custom-functions.php'; ?>
有効化されているテーマ(子テーマの場合は子テーマ)のディレクトリパスを返します。
子テーマのスタイルシートURL取得 – get_stylesheet_uri()
引数:なし
使用例:<link rel="stylesheet" href="<?php echo get_stylesheet_uri(); ?>">
有効化されているテーマのスタイルシート(style.css)のURLを返します。
📁 メニュー関連
ナビゲーションメニューを表示 – wp_nav_menu()
引数:wp_nav_menu(array $args = array())
使用例:<?php wp_nav_menu(array('theme_location' => 'header-menu')); ?>
WordPressの管理画面で作成したナビゲーションメニューを表示します。
メニューの項目を取得 – wp_get_nav_menu_items()
引数:wp_get_nav_menu_items($menu, $args = array())
使用例:<?php $items = wp_get_nav_menu_items('header-menu'); ?>
指定したメニューの項目を配列で取得します。独自にメニューを操作したい場合に便利です。
メニュー名からオブジェクトを取得 – wp_get_nav_menu_object()
引数:wp_get_nav_menu_object($menu)
使用例:<?php $menu_obj = wp_get_nav_menu_object('footer-menu'); ?>
メニュー名からメニューのオブジェクトを取得します。
指定の位置にメニューが登録されているか – has_nav_menu()
引数:has_nav_menu($location)
使用例:<?php if (has_nav_menu('global')) { /* 表示処理 */ } ?>
指定したテーマロケーションにメニューが登録されているかを真偽値で判定します。
登録されているメニュー位置一覧を取得 – get_nav_menu_locations()
引数:なし
使用例:<?php $locations = get_nav_menu_locations(); ?>
テーマに登録されたすべてのメニューロケーションを取得します。
📄 投稿・ループ関連
ループ内で投稿があるかの判定 – have_posts()
引数:なし
使用例:<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
WordPressのメインループで、表示すべき投稿があるか判定します。
投稿データの取得と内部設定 – the_post()
引数:なし
使用例:ループ内で使用(while
の中)
ループ内で次の投稿データを利用できるように設定します。
投稿タイトルの出力 – the_title()
引数:the_title($before = '', $after = '', $echo = true)
使用例:<?php the_title(); ?>
投稿タイトルをそのまま出力します。
投稿本文の出力 – the_content()
引数:the_content($more_link_text = null, $strip_teaser = false)
使用例:<?php the_content(); ?>
投稿本文をそのまま出力します。
投稿の抜粋の出力 – the_excerpt()
引数:なし
使用例:<?php the_excerpt(); ?>
投稿の抜粋を出力します。
投稿のパーマリンクの出力 – the_permalink()
引数:なし
使用例:<a href="<?php the_permalink(); ?>">記事を読む</a>
投稿のパーマリンクを直接出力します。
投稿のパーマリンクURLの取得 – get_the_permalink()
引数:get_the_permalink($post = 0)
使用例:<?php echo get_the_permalink(); ?>
投稿のパーマリンクURLを取得し、他の変数と組み合わせたりして使います。
投稿タイトルの取得 – get_the_title()
引数:get_the_title($post = 0)
使用例:<?php echo get_the_title(); ?>
投稿タイトルを取得し、PHPの変数として扱います。
投稿の抜粋の取得 – get_the_excerpt()
引数:get_the_excerpt($post = null)
使用例:<p><?php echo get_the_excerpt(); ?></p>
投稿の抜粋を取得します。
ループ後にグローバル投稿情報をリセット – wp_reset_postdata()
引数:なし
使用例:<?php wp_reset_postdata(); ?>
メインループ外で`WP_Query`や`get_posts()`を使った後に、グローバル変数`$post`を元の状態に戻します。
メインクエリの上書き – query_posts()
引数:query_posts($query)
使用例:<?php query_posts('posts_per_page=5'); ?>
メインクエリを上書きして、表示する投稿を変更します。**非推奨**。`WP_Query`の使用が推奨されています。
🖋 投稿情報取得
現在の投稿IDの取得 – get_the_ID()
引数:なし
使用例:<?php echo get_the_ID(); ?>
現在の投稿IDを取得します。
投稿の任意のフィールド値の取得 – get_post_field()
引数:get_post_field($field, $post_id, $context = 'display')
使用例:<?php echo get_post_field('post_name', get_the_ID()); ?>
投稿IDから任意のデータベースフィールド(スラッグ、投稿日など)の値を取得します。
カスタムフィールド(メタ情報)の取得 – get_post_meta()
引数:get_post_meta($post_id, $key = '', $single = false)
使用例:<?php echo get_post_meta(get_the_ID(), 'custom_key', true); ?>
指定した投稿のカスタムフィールドの値を取得します。
投稿のカテゴリ情報の取得 – get_the_category()
引数:get_the_category($post_id)
使用例:<?php $cat = get_the_category(); echo $cat[0]->name; ?>
投稿が属するカテゴリの情報を取得します。
投稿に付与されたタグ情報の取得 – get_the_tags()
引数:get_the_tags($post_id)
使用例:<?php $tags = get_the_tags(); if($tags) foreach($tags as $tag) echo $tag->name; ?>
投稿に付与されたタグの情報を取得します。
投稿者名の取得 – get_the_author()
引数:なし
使用例:<?php echo get_the_author(); ?>
投稿者名を取得します。
投稿者の詳細情報の取得 – get_the_author_meta()
引数:get_the_author_meta($field, $user_id = false)
使用例:<?php echo get_the_author_meta('description'); ?>
投稿者のメタ情報(プロフィールなど)を取得します。
投稿日の取得 – get_the_date()
引数:get_the_date($format = '', $post = null)
使用例:<?php echo get_the_date('Y.m.d'); ?>
投稿日を取得します。
最終更新日の取得 – get_the_modified_date()
引数:get_the_modified_date($format = '', $post = null)
使用例:<?php echo get_the_modified_date('Y.m.d'); ?>
投稿の最終更新日を取得します。
アイキャッチ画像の有無の判定 – has_post_thumbnail()
引数:has_post_thumbnail($post = null)
使用例:<?php if ( has_post_thumbnail() ) : the_post_thumbnail(); endif; ?>
投稿にアイキャッチ画像が設定されているかを判定します。
📁 ファイル・ディレクトリ取得
親テーマのディレクトリパスの取得 – get_template_directory()
引数:なし
使用例:<?php echo get_template_directory(); ?>
サーバー上の親テーマの絶対パスを返します。ファイルのインクルードなどに使います。
子テーマのディレクトリパスの取得 – get_stylesheet_directory()
引数:なし
使用例:<?php echo get_stylesheet_directory(); ?>
サーバー上の有効化されたテーマの絶対パスを返します。
親テーマのURLパスの取得 – get_template_directory_uri()
引数:なし
使用例:<?php echo get_template_directory_uri(); ?>
ブラウザでアクセス可能な親テーマのURLを返します。
子テーマのURLパスの取得 – get_stylesheet_directory_uri()
引数:なし
使用例:<?php echo get_stylesheet_directory_uri(); ?>
ブラウザでアクセス可能な有効化されたテーマのURLを返します。
WordPressインストールディレクトリのパスを取得 – get_home_path()
引数:なし
使用例:<?php echo get_home_path(); ?>
WordPressがインストールされているサーバー上の絶対パスを返します。
アップロードディレクトリの情報を取得 – wp_upload_dir()
(get_upload_dir()は非推奨)
引数:なし
説明:アップロードディレクトリのパスやURLを配列で返します。単体でechoすると「Array」と表示されるため、キーを指定して使います。
使用例:
<?php
$upload_dir = wp_upload_dir();
echo '<p>URL: ' . $upload_dir['url'] . '</p>'; // URLを取得
echo '<p>パス: ' . $upload_dir['path'] . '</p>'; // パスを取得
?>
テーマURLの取得(get_template_directory_uri()
と同様) – get_bloginfo('template_url')
引数:なし
使用例:<?php echo get_bloginfo('template_url'); ?>
テーマのURLを取得します。
スタイルシートURLの取得(get_stylesheet_directory_uri()
と同様) – get_bloginfo('stylesheet_url')
引数:なし
使用例:<?php echo get_bloginfo('stylesheet_url'); ?>
スタイルシートのURLを取得します。
テンプレートパートの読み込み – get_template_part()
引数:get_template_part($slug, $name = null)
使用例:<?php get_template_part('content', 'page'); ?>
再利用可能なテンプレートファイル(テンプレートパーツ)を読み込みます。
🔗 サイトURL関連
<?php echo home_url(); ?>
→ サイトトップページのURL(例:`https://example.com`)<?php echo home_url('/contact/'); ?>
→ サイト内の指定したパスのURLを生成(例:`https://example.com/contact/`)<?php echo site_url(); ?>
→ WordPress本体のインストール先URL(例:`https://example.com/wp`)
🖼️ 画像・メディア関連
<img src="<?php echo get_stylesheet_directory_uri(); ?>/images/main.jpg" alt="">
→ テーマ内の画像ファイルを読み込む基本的な方法<?php echo wp_get_attachment_url($id); ?>
→ 添付ファイル(メディアライブラリの画像など)のURLをIDから取得<?php echo wp_get_attachment_image($id, 'full'); ?>
→ 添付画像(メディアライブラリの画像など)を`<img>`タグごと出力
📄 投稿・固定ページ関連
<?php the_permalink(); ?>
→ ループ内の投稿のパーマリンクを直接出力<?php the_title(); ?>
→ ループ内の投稿のタイトルを直接出力<?php the_content(); ?>
→ ループ内の投稿の本文を直接出力<?php echo get_the_excerpt(); ?>
→ ループ内の投稿の抜粋を取得
🔧 設定・オプション管理
WordPressのオプション設定値の取得 – get_option()
引数:get_option($option, $default = false)
使用例:<?php echo get_option('blogname'); ?>
WordPressの一般設定やプラグイン設定などのオプション値を取得します。
WordPressのオプション設定値の更新 – update_option()
引数:update_option($option, $value)
使用例:<?php update_option('blogname', '新しいサイト名'); ?>
指定したオプション値を更新します。
WordPressのオプション設定値の追加 – add_option()
引数:add_option($option, $value, $deprecated = '', $autoload = 'yes')
使用例:<?php add_option('custom_option', 'value'); ?>
新しいオプションを追加します。
WordPressのオプション設定値の削除 – delete_option()
引数:delete_option($option)
使用例:<?php delete_option('custom_option'); ?>
指定したオプションを削除します。
マルチサイトでネットワーク全体のオプション設定値の取得 – get_site_option()
引数:get_site_option($option, $default = false)
使用例:<?php echo get_site_option('site_admins'); ?>
マルチサイト環境で、ネットワーク全体のオプションを取得します。
マルチサイトでネットワーク全体のオプション設定値の更新 – update_site_option()
引数:update_site_option($option, $value)
使用例:<?php update_site_option('site_admins', 'new_admin'); ?>
ネットワーク全体のオプションを更新します。
マルチサイトでネットワーク全体のオプション設定値の追加 – add_site_option()
引数:add_site_option($option, $value, $deprecated = '', $autoload = 'yes')
使用例:<?php add_site_option('network_option', 'value'); ?>
ネットワーク全体の新しいオプションを追加します。
マルチサイトでネットワーク全体のオプション設定値の削除 – delete_site_option()
引数:delete_site_option($option)
使用例:<?php delete_site_option('network_option'); ?>
ネットワーク全体のオプションを削除します。
テーマカスタマイザーで設定されたオプションの取得 – get_theme_mod()
引数:get_theme_mod($name, $default = false)
使用例:<?php echo get_theme_mod('background_color', '#ffffff'); ?>
テーマカスタマイザーで設定された値を取得します。
テーマカスタマイザーで設定されたオプションの更新 – set_theme_mod()
引数:set_theme_mod($name, $value)
使用例:<?php set_theme_mod('background_color', '#000000'); ?>
テーマカスタマイザーの値をプログラムから更新します。
🔗 リンク管理
投稿やページのパーマリンクURLを取得 – get_permalink()
引数:get_permalink($post_id = null)
使用例:<?php echo get_permalink(1); ?>
投稿IDからその投稿のパーマリンクURLを取得します。
サイトのURLを取得 – get_site_url()
引数:get_site_url($blog_id = null, $path = '', $scheme = null)
使用例:<?php echo get_site_url(); ?>
WordPressのサイトURLを取得します。
WordPressサイトのホームURLを取得 – home_url()
引数:home_url($path = '', $scheme = null)
使用例:<?php echo home_url(); ?>
サイトのホームURLを取得します。サイトURLと同じ場合が多いですが、WordPressアドレスとサイトアドレスが異なる場合に使い分けます。
カテゴリのアーカイブページURLを取得 – get_category_link()
引数:get_category_link($category_id)
使用例:<?php echo get_category_link(3); ?>
カテゴリIDからそのカテゴリのアーカイブページURLを取得します。
タグのアーカイブページURLを取得 – get_tag_link()
引数:get_tag_link($tag_id)
使用例:<?php echo get_tag_link(5); ?>
タグIDからそのタグのアーカイブページURLを取得します。
ユーザーの投稿一覧ページURLを取得 – get_author_posts_url()
引数:get_author_posts_url($author_id)
使用例:<?php echo get_author_posts_url(1); ?>
投稿者IDからその投稿者の一覧ページURLを取得します。
添付ファイル(画像など)のURLを取得 – wp_get_attachment_url()
引数:wp_get_attachment_url($attachment_id)
使用例:<?php echo wp_get_attachment_url(10); ?>
添付ファイルIDからURLを取得します。
添付ファイル(画像)の特定サイズのURLを取得 – wp_get_attachment_image_url()
引数:wp_get_attachment_image_url($attachment_id, $size)
使用例:<?php echo wp_get_attachment_image_url(10, 'medium'); ?>
添付ファイルIDと画像サイズを指定してURLを取得します。
投稿のサムネイル画像IDを取得 – get_post_thumbnail_id()
引数:get_post_thumbnail_id($post_id)
使用例:<?php echo get_post_thumbnail_id(1); ?>
投稿IDから設定されたアイキャッチ画像のIDを取得します。
親ページのIDを取得(階層構造の親を取得) – get_ancestors()
引数:get_ancestors($post_id, $post_type)
使用例:<?php print_r(get_ancestors(15, 'page')); ?>
指定した投稿やページの階層構造の親ページのIDを配列で取得します。
🌍 地域設定・国際化
現在のサイトのロケール(言語設定)を取得 – get_locale()
引数:get_locale()
使用例:<?php echo get_locale(); ?>
サイトの言語設定(例: ja)を取得します。
ロケール設定を変更 – setlocale()
引数:setlocale($category, $locale = null)
使用例:<?php setlocale(LC_TIME, 'ja_JP'); ?>
サーバー環境のロケールを変更します。
サイトの言語情報を取得 – get_bloginfo('language')
引数:get_bloginfo('language')
使用例:<?php echo get_bloginfo('language'); ?>
サイトの言語情報を取得します。
Polylangプラグイン使用時、現在の言語コードを取得 – pll_current_language()
引数:pll_current_language($full = false)
使用例:<?php echo pll_current_language(); ?>
Polylangプラグインがインストールされている場合に、現在の言語コードを取得します。
qTranslateプラグイン使用時、現在の言語コードを取得 – qtrans_getLanguage()
引数:qtrans_getLanguage()
使用例:<?php echo qtrans_getLanguage(); ?>
qTranslateプラグインがインストールされている場合に、現在の言語コードを取得します。
現在のページが指定された言語かどうかを確認 – is_language()
引数:is_language($lang)
使用例:<?php if(is_language('ja')): ?>
現在のページが指定した言語であるか判定します。
複数言語の翻訳を取得(WPMLなどで利用可能) – get_translations()
引数:get_translations($id)
使用例:<?php echo get_translations(5); ?>
翻訳された文字列を取得します。
国際化対応の日付を取得(ロケールに合わせた日付表示) – date_i18n()
引数:date_i18n($format, $timestamp = null, $translate = true)
使用例:<?php echo date_i18n('Y年n月j日'); ?>
ロケール設定に基づいて日付をフォーマットして出力します。
WordPressのタイムゾーン設定を取得 – get_option('timezone_string')
引数:get_option('timezone_string')
使用例:<?php echo get_option('timezone_string'); ?>
WordPressのタイムゾーン設定を取得します。
指定されたロケールに一時的に切り替え – switch_to_locale()
引数:switch_to_locale($locale)
使用例:<?php switch_to_locale('ja_JP'); ?>
一時的にロケールを切り替えます。
💻 ユーザー管理
現在ログインしているユーザーのIDを取得 – get_current_user_id()
引数:get_current_user_id()
使用例:<?php echo get_current_user_id(); ?>
現在ログインしているユーザーのIDを返します。
現在ログインしているユーザーの情報を取得 – wp_get_current_user()
引数:wp_get_current_user()
使用例:<?php $user = wp_get_current_user(); echo $user->user_login; ?>
現在ログインしているユーザーのオブジェクトを返します。
ユーザーがログインしているかの判定 – is_user_logged_in()
引数:なし
使用例:<?php if ( is_user_logged_in() ) { echo '<p>ログイン中</p>'; } ?>
ユーザーがログインしているか判定します。
ユーザーのメタデータを取得 – get_user_meta()
引数:get_user_meta($user_id, $key, $single = false)
使用例:<?php echo get_user_meta(1, 'nickname', true); ?>
指定したユーザーのカスタムフィールド値を取得します。
指定されたユーザーが特定の権限を持っているか確認 – user_can()
引数:user_can($user_id, $capability)
使用例:<?php if (user_can(1, 'edit_posts')): ?>
指定したユーザーが特定の権限を持っているか判定します。
指定した条件でユーザー情報を取得 – get_user_by()
引数:get_user_by($field, $value)
使用例:<?php $user = get_user_by('email', 'user@example.com'); echo $user->user_login; ?>
メールアドレス、ID、ログイン名などからユーザーオブジェクトを取得します。
新しいユーザーを作成 – wp_create_user()
引数:wp_create_user($username, $password, $email)
使用例:<?php wp_create_user('newuser', 'password123', 'newuser@example.com'); ?>
新しいユーザーをプログラムから作成します。
既存のユーザー情報を更新 – wp_update_user()
引数:wp_update_user($user_data)
使用例:<?php $user = get_user_by('id', 1); $user->first_name = 'John'; wp_update_user($user); ?>
ユーザー情報を更新します。
指定した条件でユーザー一覧を取得 – get_users()
引数:get_users($args = array())
使用例:<?php $users = get_users(); foreach ($users as $user) { echo $user->user_login; } ?>
条件に一致するユーザーを配列で取得します。
現在のユーザーをログアウトさせる – wp_logout()
引数:wp_logout()
使用例:<?php wp_logout(); ?>
現在のユーザーをログアウトさせます。
指定したユーザーを現在のユーザーとして設定 – wp_set_current_user()
引数:wp_set_current_user($user_id, $user_login = '')
使用例:<?php wp_set_current_user(1); ?>
グローバル変数`$current_user`を指定したユーザーに設定します。
⚙️ 設定・オプション管理
指定したオプション値を取得 – get_option()
引数:get_option($option, $default = false)
使用例:<?php echo get_option('blogname'); ?>
サイトのオプション値を取得します。
指定したオプション値を更新 – update_option()
引数:update_option($option, $value)
使用例:<?php update_option('blogname', 'New Site Name'); ?>
サイトのオプション値を更新します。
指定したオプション値を削除 – delete_option()
引数:delete_option($option)
使用例:<?php delete_option('custom_option'); ?>
サイトのオプション値を削除します。
サイト全体のオプション値を取得(ネットワークインストールの場合) – get_site_option()
引数:get_site_option($option, $default = false)
使用例:<?php echo get_site_option('site_name'); ?>
マルチサイト環境で、サイト全体のオプション値を取得します。
サイト全体のオプション値を更新(ネットワークインストールの場合) – update_site_option()
引数:update_site_option($option, $value)
使用例:<?php update_site_option('site_name', 'New Site Name'); ?>
サイト全体のオプション値を更新します。
新しいオプションを追加 – add_option()
引数:add_option($option, $value, $deprecated = '', $autoload = 'yes')
使用例:<?php add_option('my_custom_option', 'value'); ?>
新しいオプションを追加します。
個々のサイトに対するオプション値を取得(マルチサイト環境の場合) – get_blog_option()
引数:get_blog_option($blog_id, $option, $default = false)
使用例:<?php echo get_blog_option(1, 'blogname'); ?>
マルチサイト環境で、指定したサイトのオプション値を取得します。
個々のサイトに対するオプション値を更新(マルチサイト環境の場合) – update_blog_option()
引数:update_blog_option($blog_id, $option, $value)
使用例:<?php update_blog_option(1, 'blogname', 'New Blog Name'); ?>
指定したサイトのオプション値を更新します。
テーマのカスタマイザー設定を取得 – get_theme_mod()
引数:get_theme_mod($name, $default = false)
使用例:<?php echo get_theme_mod('background_color', '#ffffff'); ?>
テーマカスタマイザーで設定された値を取得します。
テーマのカスタマイザー設定を保存 – set_theme_mod()
引数:set_theme_mod($name, $value)
使用例:<?php set_theme_mod('background_color', '#000000'); ?>
テーマカスタマイザーの値をプログラムから保存します。
🔧 プラグイン・テーマ管理
インストールされている全プラグインの情報を取得 – get_plugins()
引数:get_plugins()
使用例:<?php $plugins = get_plugins(); foreach ($plugins as $plugin) { echo $plugin['Name']; } ?>
インストールされているすべてのプラグイン情報を配列で取得します。
プラグインがアクティブかどうかを確認 – is_plugin_active()
引数:is_plugin_active($plugin)
使用例:<?php if (is_plugin_active('plugin-name/plugin-name.php')): ?>
指定したプラグインが有効化されているか判定します。
プラグインをアクティブにする – activate_plugin()
引数:activate_plugin($plugin)
使用例:<?php activate_plugin('plugin-name/plugin-name.php'); ?>
指定したプラグインを有効化します。
プラグインを非アクティブにする – deactivate_plugins()
引数:deactivate_plugins($plugin, $redirect = true, $networkwide = false)
使用例:<?php deactivate_plugins('plugin-name/plugin-name.php'); ?>
指定したプラグインを無効化します。
テーマがアクティブかどうかを確認 – is_theme_active()
引数:is_theme_active($theme)
使用例:<?php if (is_theme_active('twentytwenty')): ?>
指定したテーマが有効化されているか判定します。
現在使用中のテーマを取得 – get_current_theme()
引数:get_current_theme()
使用例:<?php echo get_current_theme(); ?>
有効化されているテーマ名を取得します。
テーマディレクトリのパスを取得 – get_theme_root()
引数:get_theme_root()
使用例:<?php echo get_theme_root(); ?>
テーマが保存されているディレクトリの絶対パスを取得します。
現在のテーマの詳細情報を取得 – wp_get_theme()
引数:wp_get_theme()
使用例:<?php $theme = wp_get_theme(); echo $theme->get('Name'); ?>
有効化されているテーマのオブジェクトを取得し、テーマのバージョンや名前などを取得します。
テーマを切り替える – switch_theme()
引数:switch_theme($new_theme)
使用例:<?php switch_theme('twentytwenty'); ?>
プログラムからテーマを切り替えます。
プラグインが非アクティブかどうかを確認 – is_plugin_inactive()
引数:is_plugin_inactive($plugin)
使用例:<?php if (is_plugin_inactive('plugin-name/plugin-name.php')): ?>
指定したプラグインが無効化されているか判定します。
🔍 コンテンツ管理
指定したIDの投稿を取得 – get_post()
引数:get_post($post_id, $output = OBJECT, $filter = 'raw')
使用例:<?php $post = get_post(42); echo $post->post_title; ?>
投稿IDから投稿オブジェクトを取得します。
条件に一致する複数の投稿を取得 – get_posts()
引数:get_posts($args)
使用例:<?php $recent_posts = get_posts(array('numberposts' => 5)); foreach ($recent_posts as $post) { echo $post->post_title; } ?>
複数の投稿を配列として取得します。
新しい投稿をデータベースに挿入 – wp_insert_post()
引数:wp_insert_post($postarr, $wp_error = false)
使用例:<?php wp_insert_post(array('post_title' => 'New Post', 'post_content' => 'Post content', 'post_status' => 'publish')); ?>
データベースに新しい投稿を追加します。
既存の投稿を更新 – wp_update_post()
引数:wp_update_post($postarr)
使用例:<?php wp_update_post(array('ID' => 42, 'post_title' => 'Updated Title')); ?>
既存の投稿を更新します。
投稿を削除 – wp_delete_post()
引数:wp_delete_post($post_id, $force_delete = false)
使用例:<?php wp_delete_post(42, true); ?>
投稿を削除します。
投稿の本文を取得 – get_the_content()
引数:get_the_content($more_link_text = null)
使用例:<?php echo get_the_content(); ?>
投稿の本文を取得します。
投稿のタイトルを表示 – the_title()
引数:the_title($before = '', $after = '')
使用例:<?php the_title(); ?>
投稿のタイトルを出力します。
投稿の抜粋を取得 – get_the_excerpt()
引数:get_the_excerpt($post = null)
使用例:<?php echo get_the_excerpt(); ?>
投稿の抜粋を取得します。
投稿の抜粋を表示 – the_excerpt()
引数:the_excerpt()
使用例:<?php the_excerpt(); ?>
投稿の抜粋を出力します。
投稿のパーマリンクを取得 – get_the_permalink()
引数:get_the_permalink($post = null)
使用例:<?php echo get_the_permalink(); ?>
投稿のパーマリンクを取得します。
📊 メタデータ管理
指定した投稿のメタデータを取得 – get_post_meta()
引数:get_post_meta($post_id, $key = '', $single = false)
使用例:<?php echo get_post_meta(42, 'custom_field_key', true); ?>
投稿に紐づいたカスタムフィールドの値を取得します。
投稿のメタデータを更新 – update_post_meta()
引数:update_post_meta($post_id, $key, $value, $previous_value = '')
使用例:<?php update_post_meta(42, 'custom_field_key', 'new_value'); ?>
投稿のカスタムフィールドを更新します。
投稿のメタデータを削除 – delete_post_meta()
引数:delete_post_meta($post_id, $key, $value = '')
使用例:<?php delete_post_meta(42, 'custom_field_key'); ?>
投稿のカスタムフィールドを削除します。
指定した投稿のカスタムフィールドを取得 – get_post_custom()
引数:get_post_custom($post_id)
使用例:<?php $custom_fields = get_post_custom(42); print_r($custom_fields); ?>
指定した投稿のすべてのカスタムフィールドを配列で取得します。
投稿に新しいメタデータを追加 – add_post_meta()
引数:add_post_meta($post_id, $key, $value, $unique = false)
使用例:<?php add_post_meta(42, 'new_custom_field', 'value'); ?>
新しいカスタムフィールドを追加します。
投稿に関連付けられた全メタデータキーを取得 – get_post_meta_keys()
引数:get_post_meta_keys($post_id)
使用例:<?php $meta_keys = get_post_meta_keys(42); print_r($meta_keys); ?>
投稿に紐づいたすべてのカスタムフィールドのキーを配列で取得します。
指定したユーザーのメタデータを取得 – get_user_meta()
引数:get_user_meta($user_id, $key = '', $single = false)
使用例:<?php echo get_user_meta(1, 'user_custom_field', true); ?>
指定したユーザーのカスタムフィールドの値を取得します。
ユーザーのメタデータを更新 – update_user_meta()
引数:update_user_meta($user_id, $key, $value, $previous_value = '')
使用例:<?php update_user_meta(1, 'user_custom_field', 'new_value'); ?>
ユーザーのカスタムフィールドを更新します。
ユーザーのメタデータを削除 – delete_user_meta()
引数:delete_user_meta($user_id, $key, $value = '')
使用例:<?php delete_user_meta(1, 'user_custom_field'); ?>
ユーザーのカスタムフィールドを削除します。
🛡️ セキュリティ・エスケープ関連
URLをエスケープ – esc_url()
引数:esc_url($url, $protocols = null, $_context = 'display')
使用例:<a href="<?php echo esc_url(get_permalink()); ?>">記事を読む</a>
URL内の不正な文字などをエスケープします。特に外部URLやユーザー入力値を含むリンクに必須です。
HTMLをエスケープ – esc_html()
引数:esc_html($text)
使用例:<p><?php echo esc_html($variable); ?></p>
HTMLタグを安全な文字に変換します。ユーザー入力などを表示する際に必須です。
🔧 その他の管理
定期的なイベントをスケジュール – wp_schedule_event()
引数:wp_schedule_event($timestamp, $recurrence, $hook, $args = array())
使用例:<?php wp_schedule_event(time(), 'hourly', 'my_cron_hook'); ?>
WordPressのクロン(スケジュールされたタスク)を設定します。
スケジュールされたイベントをクリア – wp_clear_scheduled_hook()
引数:wp_clear_scheduled_hook($hook, $args = array())
使用例:<?php wp_clear_scheduled_hook('my_cron_hook'); ?>
スケジュールされたタスクをクリアします。
現在のユーザーIDを取得 – get_current_user_id()
引数:get_current_user_id()
使用例:<?php $user_id = get_current_user_id(); echo $user_id; ?>
現在ログインしているユーザーのIDを返します。
フォームのセキュリティ用トークンを作成 – wp_nonce_field()
引数:wp_nonce_field($action = -1, $name = '_wpnonce', $referer = true, $echo = true)
使用例:<?php wp_nonce_field('my_action', 'my_nonce'); ?>
フォームの不正送信を防ぐためのセキュリティトークン(nonce)を生成します。
セキュリティトークンをチェック – check_admin_referer()
引数:check_admin_referer($action = -1, $query_arg = '_wpnonce')
使用例:<?php check_admin_referer('my_action', 'my_nonce'); ?>
フォームから送信されたセキュリティトークンをチェックします。
オプション設定の値を取得 – get_option()
引数:get_option($option, $default = false)
使用例:<?php echo get_option('site_name'); ?>
サイトのオプション設定値を取得します。
オプション設定の値を更新 – update_option()
引数:update_option($option, $value)
使用例:<?php update_option('site_name', 'My New Site'); ?>
サイトのオプション設定値を更新します。
オプション設定を削除 – delete_option()
引数:delete_option($option)
使用例:<?php delete_option('site_name'); ?>
サイトのオプション設定を削除します。
サイト情報を取得 – get_bloginfo()
引数:get_bloginfo($show = 'name', $filter = 'raw')
使用例:<?php echo get_bloginfo('name'); ?>
サイト名、説明、テーマURLなど、サイトに関するさまざまな情報を取得します。
リダイレクトを実行 – wp_redirect()
引数:wp_redirect($location, $status = 302)
使用例:<?php wp_redirect('https://example.com'); exit; ?>
指定したURLへリダイレクトします。実行後には`exit`を記述するのが通例です。
コメント