検索

このバーが表示されている場所ならどこでも、エレメントを検索できます。

検索バー

サポートする構文

Craft は次の検索構文をサポートしています。

この検索によってこちらのエレメントが見つかるでしょう
salty「salty」という単語を含んでいる
salty dog「salty」と「dog」の両方を含んでいる。
salty OR dog「salty」または「dog」のいずれか(または、両方)を含んでいる。
salty -dog「salty」を含むが「dog」を含んでいない。
"salty dog"正確なフレーズとして「salty dog」を含んでいる。
*ty「ty」で終わる単語を含んでいる。
*alt*「alt」を含む単語を含んでいる。
body:saltybody フィールドに「salty」を含む。
body:salty body:dogbody フィールドに「salty」と「dog」の両方を含む。
body:salty OR body:dogbody フィールドに「salty」または「dog」のいずれかを含む。
body:salty -body:dogbody フィールドに「salty」を含むが「dog」を含まない。
body:"salty dog"body フィールドに正確なフレーズとして「salty dog」を含む。
body:*tybody フィールドに「ty」で終わる単語を含む。
body:*alt*body フィールドに「alt」を含む単語を含む。
body::saltybody フィールドに「salty」がセットされ、それ以外のものがない。
body::"salty dog"body フィールドに「salty dog」がセットされ、それ以外のものがない。
body::salty*body フィールドが「salty」ではじまる。
body::*dogbody フィールドが「dog」で終わる。
body:*body フィールドになんらかの値を含む。
-body:*body フィールドが空である。

特定エレメントの属性を検索する

アセット、カテゴリ、エントリ、ユーザー、および、タグは、それぞれ独自の属性を追加して検索することができます。

  • アセット

    • filename
    • extension
    • kind
  • カテゴリ

    • title
    • slug
  • エントリ

    • title
    • slug
  • ユーザー

    • ユーザー名
    • firstName
    • lastName
    • fullName (firstName + lastName)
    • メール
  • タグ

    • title

テンプレート記法

craft.assets()craft.entries()craft.tags()、および、craft.users()は、検索クエリを指定したエレメントの絞り込みに利用できる search パラメータをサポートしています。

{# Get the user's search query from the 'q' query-string param #}
{% set searchQuery = craft.app.request.getParam('q') %}

{# Fetch entries that match the search query #}
{% set results = craft.entries()
    .search(searchQuery)
    .all() %}

スコアによる検索結果の順位付け

検索結果をベストマッチからワーストマッチの順に並び替えたい場合、orderBy パラメータに 'score' をセットすることもできます。

{% set results = craft.entries()
    .search(searchQuery)
    .orderBy('score')
    .all() %}

この場合、返されるすべてのエレメントに searchScore 属性がセットされ、それぞれの検索スコアを知ることができます。

動的な検索結果をリスト化する完全な例については、検索フォームチュートリアルを参照してください。

検索インデックスの再構築

Craft は検索インデックスを可能な限り最新に保つよう、最善を尽くしています。しかし、その一部を不正確にするかもしれない可能性がいくつかあります。検索インデックスが最新かつ最高データでないと疑われる場合、設定にある検索インデックスの再構築ツールで Craft に再構築させることができます。