build_query_vars_from_query_block()


WordPressのbuild_query_vars_from_query_block()関数は、クエリブロックからクエリ変数を構築するために使用されます。この関数は、Gutenbergエディタのクエリブロックに基づいて、クエリパラメータを生成します。

構文

build_query_vars_from_query_block( WP_Block $block, array $context = array() );

引数の説明:

  • $block(WP_Block) — クエリブロックのオブジェクト。
  • $context(array) — クエリブロックのコンテキスト情報。

例1: 基本的なクエリブロックの使用

この例では、クエリブロックからクエリ変数を生成します。

$query_vars = build_query_vars_from_query_block( $block );

例2: カスタムコンテキストの追加

カスタムコンテキストを指定してクエリ変数を生成します。

$context = array( 'postType' => 'page' );
$query_vars = build_query_vars_from_query_block( $block, $context );

例3: カテゴリーベースのクエリ

特定のカテゴリーに基づいてクエリ変数を生成します。

$context = array( 'category' => get_category_by_slug( 'news' )->term_id );
$query_vars = build_query_vars_from_query_block( $block, $context );

例4: タグベースのクエリ

特定のタグに基づいてクエリ変数を生成します。

$context = array( 'tag' => get_term_by( 'slug', 'wordpress', 'post_tag' )->term_id );
$query_vars = build_query_vars_from_query_block( $block, $context );

例5: 投稿ステータスのフィルタリング

特定の投稿ステータスに基づいてクエリ変数を生成します。

$context = array( 'post_status' => 'publish' );
$query_vars = build_query_vars_from_query_block( $block, $context );

例6: 投稿数の制限

表示する投稿数を制限してクエリ変数を生成します。

$context = array( 'posts_per_page' => 5 );
$query_vars = build_query_vars_from_query_block( $block, $context );

例7: オーダーとオーダーバイの指定

クエリの順序と順序の基準を指定してクエリ変数を生成します。

$context = array( 'order' => 'DESC', 'orderby' => 'date' );
$query_vars = build_query_vars_from_query_block( $block, $context );

注意点

  • この関数は、Gutenbergエディタのクエリブロックに依存しています。クエリブロックが存在しない場合、正しく動作しません。
  • コンテキストの指定はオプションですが、特定の条件でクエリを制御する場合に有用です。

関連機能：