is_multisite() の使い方|説明・引数・注意点

説明

is_multisite() は、マルチサイトが有効なWordPressかを判定する関数です。

基本構文

is_multisite(): bool

引数

引数はありません。

戻り値

条件に当てはまれば true、そうでなければ false。

使い方(サンプル)

if ( is_multisite() ) {
	// マルチサイト用の処理
}

注意点

  • サイトの種類を判定するだけで、現在のサイトがネットワークの親かどうかは分かりません。

実務での使いどころ

  • マルチサイトのときだけ動かす処理を、分岐するとき。
  • マルチサイト専用の関数を呼ぶ前に、環境を確認するとき。

よくあるミスと対処

  • is_multisite() が true のとき、現在のサイトがサブサイトだと思っている。メインサイトでも true になる。
  • プラグインの有効化処理で、マルチサイトの場合の処理を分けていない。

NG例

if ( is_multisite() ) {
	// 現在のサイトがサブサイトのつもり(メインサイトでも入る)
}

OK例

if ( is_multisite() && ! is_main_site() ) {
	// サブサイトだけの処理
}

使い分け早見表

やりたいこと 使うもの
マルチサイトか is_multisite()
メインサイトか is_main_site()
現在のサイトのID get_current_blog_id()

関連項目

is_main_site()、get_current_blog_id()

公式リファレンス:is_multisite() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました