AFFINGERカスタムフィールド検索

AFFINGERの機能で作成したカスタムフィールド専用です。カスタムフィールド機能はver20250601より実装されています

AFFINGERカスタムフィールド絞り込み検索&並べ替えUI

「AFFINGERカスタムフィールド検索」プラグインはAFFINGERのカスタムフィールド機能で登録した値で絞り込み検索や並べ替えを実装できるようになるプラグインです。

選択した項目で絞り込み検索をしたあとにおすすめ順などで並べ替えもできます。

サンプルをみる

※サンプルサイトはAFFINGER EX版です

利用方法について

インストール

ダウンロードした st-custom-search-file.zip を一度だけ解凍（展開）して中に含まれる st-custom-search.zip を「プラグインを追加」＞”ファイルを選択”にて選択後、インストールして有効化してください。

検索フォームの設置方法

カテゴリーの編集ページに以下の「検索用ショートコード」が表示されます。

ショートコードをコピーして投稿・固定記事またはカテゴリー、フロントページ内に記述してください。

[af_custom_field_search category_id="（カテゴリーID）" enable_sorting="true"]

ショートコードのオプション

• submit_text="検索": 検索ボタンのテキスト
• reset_text="リセット": リセットボタンのテキスト
• enable_sorting="true": 並び替え機能の有効化
• enable_sorting="false": 並び替え機能の無効化
• exclude="あらすじ,上映時間" : 特定のフィールドを除外する（並べ替えUI連動）

例：
[af_custom_field_search category_id="15" enable_sorting="true" exclude="あらすじ,上映時間"]

検索ロジックについて

• デフォルトでは、検索条件はAND条件（すべての条件を満たす）で結合されます。つまり、指定したすべての条件に一致する投稿のみが検索結果に表示されます。
• 検索条件の比較は大文字小文字を区別せずに行われます（LIKE演算子を使用）。
• 入力タイプが「テキスト」「テキストエリア」のカスタムフィールドが検索対象の場合はあいまい (部分一致) 検索
• 検索結果の表示数はWordPress管理画面「設定」＞「表示設定」＞”1ページに表示する最大投稿数” に連動しています。

チェックボックスの検索ルール

チェックボックスフィールドの検索は以下のルールで動作します：

1. 同じフィールド内の複数選択: OR検索（いずれかに一致）
   • 例：「評価」フィールドで「5」「4」「3」を選択した場合、「評価」が「5」または「4」または「3」のいずれかに一致する投稿が検索されます。
2. 異なるフィールド間: AND検索（すべてに一致）
   • 例：「評価」フィールドで「5」「4」を選択し、「価格」フィールドで「1000」「500」を選択した場合、「評価」が「5」または「4」のいずれかに一致し、かつ「価格」が「1000」または「500」のいずれかに一致する投稿が検索されます。

この仕組みにより、複数の条件を柔軟に組み合わせた検索が可能になります。

並び替えUI

「並べ替えUI」とは絞り込み検索結果で表示される一覧を「昇順 | 降順」で並べ替えられる機能です。

「感動」する映画で絞り込んだ後に、「おすすめ順」で並べ替えたりできます。

並び替えルール

並び替え機能を使用するには、ショートコードにenable_sorting="true"を指定します（デフォルトで有効）。 特定のフィールドでの並び替えを初期状態にするには、default_sort_field="フィールド名"とdefault_sort_order="asc"または"desc"を指定します。

検索結果は、カスタムフィールドの値に基づいて並び替えることができます。並び替えには以下のルールが適用されます：

1. 並び替えの方向:
   • 昇順（asc）: 小さい値から大きい値へ（A→Z、1→9）
   • 降順（desc）: 大きい値から小さい値へ（Z→A、9→1）
2. データ型による並び替え:
   • 数値フィールド: 数値として比較されます（1, 2, 10, 100の順）
   • テキストフィールド: 文字列として比較されます（データベースの照合順序）
   • 複数値（チェックボックス等）: カンマ区切りの文字列として扱われます（例：「5,4,3」は「5,4,3」という1つの文字列として並び替え）
3. 空の値の扱い:
   • 空の値は常に最後に表示されます（昇順・降順どちらの場合も）
4. デフォルト設定:
   • デフォルトでは並び替えは有効で、投稿日時の降順で表示されます

※小数の検索時は四捨五入・桁数の切り詰めが発生する場合がございます

少数の仕様について詳しく見る

小数の検索時は、検索値と保存値によって検索結果や表示が変わる場合があります。

 [af_custom_field] 等の 表示用ショートコードでは保存されている値 (文字列) がそのまま表示 されます。

以下は例です。

検索値: フォームの入力値やクエリの値
保存値: カスタムフィールドとして保存されている値
比較イメージ: 検索時に行われる比較のイメージ
結果: 検索値が一致するかどうか
表示: 検索条件 の表示

検索値: '1.0' (文字列)
保存値: '1' (文字列)
比較イメージ: 1.0 === 1.0 (小数同士の比較)
結果: 一致する
表示:  1

検索値: '1.0' (文字列)
保存値: '1.04' (文字列)
比較イメージ: 1.0 === 1.0 (小数同士の比較)
結果: 一致する
表示:  1

検索値: '1.4' (文字列)
保存値: '1.45' (文字列)
比較イメージ: 1.4 === 1.5 (小数同士の比較)
結果: 一致しない
表示: 1.4

検索値: '1.5' (文字列)
保存値: '1.45' (文字列)
比較イメージ: 1.5 === 1.5 (小数同士の比較)
結果: 一致する
表示: 1.5

上記すべての例のように、 検索値 に小数点 (.) がある場合は小数として比較される。
また、 検索値 の小数部の桁数と同じ桁数で四捨五入されて比較される。

検索値: '1.400' (文字列)
保存値: '1.45' (文字列)
比較イメージ: 1.4 === 1.5 (小数同士の比較)
結果: 一致する
表示:  1.4

ただし、上記のように、 検索値 の小数部末尾の連続する 0 はないものとして扱われる。
(検索値 が '1.4' の場合と同じ扱い)

検索値: '1' (文字列)
保存値: '1.0' (文字列)
表示値: '1' (文字列)
比較イメージ: 1 === 1 (整数同士の比較)
結果: 一致する
表示: 1

検索値: '1' (文字列)
保存値: '1.4' (文字列)
表示値: '1' (文字列)
比較イメージ: 1 === 1 (整数同士の比較)
結果: 一致する
表示: 1

検索値: '1' (文字列)
保存値: '1.5' (文字列)
表示値: '1' (文字列)
比較イメージ: 1 === 2 (整数同士の比較)
結果: 一致しない
表示: 1

上記すべての例のように、 検索値 に小数点 (.) がない場合は整数として比較される。
また、整数として四捨五入されて比較される。

ご注意事項

• AFFINGERで作成したカスタムフィールドのみ利用できます

ご購入前の確認・ご承諾事項

当商品はデジタル商品のため、原則として如何なる事由でも返品及びキャンセルはできません。WordPressはオープンソースということもあり様々な状況や環境が想定されます。以下の注意事項を必ずお読みいただき、ご承諾いただける方のみご購入いただきますようお願い致します。（※通信販売のためクーリングオフ対象外です）

【動作環境】

WordPressバージョン	6.7-6.8
PHPバージョン	7.4-8.2
対象ブラウザ	Chrome 135 / Firefox 137.0 / safari 18.0
その他 必要な環境など	WordPressが使用できる環境及び知識 ZIPファイルのダウンロード及び解凍 PDFファイルの閲覧（PDFマニュアル付属の場合） ※動作確認の対象は日本のみとなります（言語/日本語） ※WordPress.org（独立インストール型）向けの商品です。（WordPress.comでの動作保証はしておりません。）

※対応バージョン以外のご利用は不具合が起こる場合がございます。検証バージョン以外のアップデートは自己責任にて、ご利用下さいませ。

AMP対応に関する開発の終了について

旧AFFINGER5に実装されていたAMPに関する機能は現時点の環境では同様の条件の元、そのままご利用頂けます。しかし、AMPとGutenbergの併用が仕様上難しい点が多く、また5Gなど通信環境の高速化、GoogleのAMPに関する優先度の変化を踏まえ、今後の対応は未定となり、環境の変化により使用できなくなる可能性もございます。（ACTIONに関してはAMP対応を明記致しましせん。）

その他の事項

※利用方法に関するマニュアルは付属しておりません。公式マニュアルサイト（テーマ）及び各参照リンクをご参考下さい
※対応するテーマやプラグインはバージョンにより異なる場合がございます。原則として動作環境に応じた最新のバージョンをご利用ください。
※当ページ紹介で使用しているキャプチャ画像などはバージョンにより変更又は異なる場合がございます
※SEO施工は弊社独自の視点によるものです。上位表示を保証するものではございませんので御了承下さい
※商品フォルダ内のテキストには商品に関する注意事項及び専用パスワードが記載されている場合がございます。再発行はございませんので大切に保管してください。
※サンプルはテーマで作成できるカスタマイズの一例です（画像素材などは含まれておりません）
※動作環境と異なるPHP及びWordPressバージョンでのご利用やサーバーの仕様（WAF等）や設定（キャッシュ・ファイル圧縮等）、環境（HHVM等）によっては正常に動かない場合がございます
※VPS、EC2（AWS等）やクラウドサービス等の設定に関するご案内及び調査は行っておりません。ご利用の際は自己責任にてお願い致します。
※Gutenberg利用時はクイックタグはクラッシックブロックのみ使用可能です
※一般的なインストールや利用方法、WordPress管理画面による操作のみを想定しております（マルチサイトやターミナル、XMLRPC や REST API などのAPIによる操作などは動作確認対象外）。
※WordPressテーマでは無限に近い多様な組み合わせが可能なため、各種機能及びデザイン等は組み合わせ状態によっては反映されない場合もございます。
※他社製のプラグインやサービス等と干渉する場合や正常に動作しない可能性もございます（その場合は併用頂かないようお願い致します※各動作チェックは行っておりません）
※独立インストール型ではないブログサービス（及び外部サービス ※https://ja.wordpress.com/含む）を使用している場合、サービス独自の仕様が干渉することで不具合や使用できない可能性がございます。
※ショートコード同士の入れ子（ショートコードの中にさらにショートコードが含まれる状態）状況によっては正常に動作しないケースもございます
※閲覧にはjavascriptが有効になっている必要がございます
※ブラウザやブラウザのバージョンによってはサポートしていない場合がございます。（反映されない、表示が異なる、崩れるなど）
※WordPressの「設定」＞「一般」＞「タイムゾーン」は「東京」でご利用ください
※機種、端末（タブレット等）、バージョンなどによって表示の有無や差異が生じる場合がございます。
※機能によっては他社サービス（各種SNSやプラグイン、Googleなど）のAPI等を使用しており、仕様変更などにより利用ができなくなる場合がございます。
※機能や各種設定及び仕様などは変更又は削除される場合もございます。
※機能、設定は意図した状態が正常に反映されているか必ずご確認下さい。
※商品は購入ユーザー（個人単位）の所有するWebサイトに限り複数でもご利用頂けます（ご家族や親戚、会社関係を含めご関係性によらず「ユーザー様（個人）単位」となります）。
※第三者への商品の配布、譲渡は固く禁止しております。
※無料特典は商品料金に含まれておりません。（一切の対象外となります）
※原則としてパソコン（Windows・Mac）での操作を想定しております。
※商品の管理画面内にはライセンスに関する注意書き等がございます。
※利用による不具合、損害など如何なるトラブルに関して責任は負いかねますので予めご了承下さいませ

※当サイトの商品（WordPressテーマ及びプラグイン）を正規の方法で購入せずに使用した場合は10,000円/日の使用料を請求いたします。