WooCommerceカテゴリーフィルターでサブカテゴリーを折りたたむ方法
すべてのサブカテゴリーを並べたカテゴリーフィルターは、チェックボックスの壁になってしまいます。多くのショップが求めるのはツリー表示です。親カテゴリーは表示したままサブカテゴリーはプラス記号の下に折りたたみ、場合によっては親をただの見出しとして表示します。HUSKYで作成したWooCommerceのカテゴリーフィルターでサブカテゴリーを折りたたむには、混同しやすい2つの別々の仕組みを扱います。子を持つカテゴリーの横にある小さな+/-のオープナーと、フィルターブロック全体を折りたたむブロックタイトル内のトグルです。この2つは設定も状態の保持方法も異なり、「勝手に開く」という戸惑いの大半はそこに由来します。
WooCommerceのカテゴリーフィルターでサブカテゴリーを折りたたむ
プラグインの オプション (Options) タブで、チェックボックスとラジオで子を非表示 (Hide childs in checkboxes and radio) を はい (Yes) に設定します(新規インストールではすでにオンです)。すると、すべてのサブカテゴリーのリストが非表示で出力され、子を持つ各用語には名前の後ろにオープナーが付きます。ブランチが開くとプラスがマイナスに変わる小さな記号です。これはどの階層でも機能し、自身の子を持つサブカテゴリーにも専用のオープナーが付きます。
- 適用されるのは チェックボックス (Checkbox) と ラジオ (Radio) のフィルタータイプだけです。ドロップダウンタイプではサブカテゴリーは折りたたまれません(最後の項を参照)。
- いいえ (No) の場合、すべてのサブカテゴリーが常に表示され、オープナーはありません。
- 最上位カテゴリーのリストが長い場合は、タクソノミーの 追加オプション (additional options)(構造 (Structure) タブにあるタクソノミーの横の歯車ボタン)を開き、折りたたまない用語の数 (Not toggled terms count) を入力します。その数の用語だけが表示され、残りは もっと見る (Show more) ボタンで表示されます。
一部の親カテゴリーについて、フィルターにサブカテゴリーをまったく表示したくない場合は、woof_terms_where_hidden_childs フックで除外できます。チェックボックス、ラジオボタン、ドロップダウンのいずれでも機能します。
/*
* Product filter: list these parent categories without their subcategories.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_terms_where_hidden_childs', function ($term_id) {
$parents = array(15, 27); // IDs of the parent categories
return in_array((int) $term_id, $parents, true) ? 1 : 0;
});
最上位のみを表示するには、すべての用語に対して 1 を返します。
開いたサブカテゴリーが再読み込み後も開いたままになる理由
訪問者がオープナーをクリックすると、プラグインはそのブランチの状態をブラウザーのローカルストレージに保存します。ページを読み込むたび、そしてフィルターがAJAXで再描画されるたびに、開いた状態で保存されたブランチは再び開きます。ローカルストレージには有効期限がないため、先週のテスト中に開いたブランチは今日もブラウザー上で開いたままですが、新しい訪問者にはすべて閉じた状態で表示されます。デフォルトの状態は、必ずプライベートウィンドウで確認してください。
この設計により、2つの副作用が生じます。
- どのブランチが開くかは、現在の選択ではなく保存された状態で決まります。フィルター済みのリンク、たとえばサブカテゴリーのフィルターを指すメニュー項目から訪れた訪問者は、選択されたサブカテゴリーが閉じたブランチの中に隠れているのを目にすることがあります。
- 状態は、親のリスト項目のクラスに紐づけて保存されます。最上位カテゴリーには固有のクラス(
woof_term_15など)がありますが、第1階層より下の項目にはないため、第1階層より下のすべてのブランチが1つの保存状態を共有します。第2階層のブランチを1つ開くと、次のページ読み込み後には第2階層のすべてのブランチが開きます。
記憶機能をオフにする設定はなく、これまでこの目的で勧められてきた js/front.js の編集は、更新のたびに失われます。代わりに、以下のスニペットをテーマ側から適用します。プラグインはフィルターを構築するたびに(ページの読み込み時とAJAXの再描画後に)woof_init_search_form イベントを発行します。このスニペットはそのイベントを待ち受け、すべてのブランチを設定し直します。選択済みの用語を含むブランチは開き、それ以外は閉じます。
/*
* Product filter: ignore remembered branches. A branch of subcategories is
* open only when it contains a selected term.
* Child theme functions.php or a code snippets plugin.
*/
add_action('wp_footer', function () {
?>
<script>
document.addEventListener('woof_init_search_form', function () {
jQuery('ul.woof_childs_list').each(function () {
var list = jQuery(this);
var sign = list.parent('li').children('.woof_childs_list_opener').find('span');
if (!sign.length) {
return; // this list has no +/- opener
}
var open = list.find('input:checked').length > 0;
list.toggle(open);
sign.toggleClass('woof_is_opened', open).toggleClass('woof_is_closed', !open);
});
});
</script>
<?php
}, 100);
オープナーを残したまま、すべてのブランチをデフォルトで開いた状態にするには、var open の行を var open = true; に変更します。
フィルターブロック全体をタイトルの下に折りたたむ
2つ目の仕組みは、タイトルを除いてブロック全体を非表示にします。構造 (Structure) タブでタクソノミーの追加オプションを開き、トグルのオプションを はい、閉じた状態で表示 (Yes, show as closed) または はい、開いた状態で表示 (Yes, show as opened) に設定します。3.4.6では、このオプションはタクソノミーのポップアップ内で ラジオ用のトグルボタンを表示 (Show toggle button for radio) というラベルですが、実際にはそのタクソノミーのブロックのトグルです。トグルはタイトルの中にあるため、タイトルを表示しておく必要があります(タイトルラベルを表示 (Show title label) = はい (Yes))。デザイン (Design) タブでは、トグルブロックタイプ (Toggle block type) でテキストか画像かを選び、その隣のフィールドでテキスト(デフォルトは + と -)または約20×20pxの2枚の画像を設定します。
ブロックの状態はブラウザーに記憶されません。サーバーがページごとに設定します。閉じた状態で表示に設定されたブロックは、その用語のいずれかが現在のフィルターに含まれている場合に開くため、訪問者は選択内容を確認できます。その場合でもブロックを閉じたままにしたい、または強制的に開きたい場合は、woof_block_toggle_state フックを使います。
/*
* Product filter: blocks with a toggle always start closed.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_block_toggle_state', function ($block_is_closed) {
return true; // true = closed, false = opened
});
このフックが受け取るのは状態だけでタクソノミーではないため、トグルをオンにしたすべてのブロックに適用されます。
タイトル全体をクリック可能にする
デフォルトでは、+/-だけがブロックを開閉します。FAQ「トグルにタイトルも含める」では、ページ読み込み時にクリックを割り当てています。以下のバージョンは委譲方式のため、AJAXフィルタリングでフォームが再描画された後も機能し、+/-自体へのクリックは無視します(そうしないとブロックが二重に切り替わってしまいます)。
/*
* Product filter: a click anywhere on a block title opens or closes the block.
* Child theme functions.php or a code snippets plugin.
*/
add_action('wp_footer', function () {
?>
<style>.woof_container_inner > h4:has(> .woof_front_toggle) { cursor: pointer; }</style>
<script>
jQuery(document).on('click', '.woof_container_inner > h4', function (e) {
if (jQuery(e.target).closest('.woof_front_toggle, .woof_tooltip_header').length) {
return; // the +/- or the tooltip icon was clicked
}
jQuery(this).children('.woof_front_toggle').trigger('click');
});
</script>
<?php
}, 100);
woof_title_tag フックでタイトルのタグを変更した場合は、h4 をそのタグに置き換えてください。テキストのトグルはリンクなので、色は .woof_container_inner h4 a.woof_front_toggle { color: #222; } のようなCSSで設定します。
複数のブロックを1つの見出し(たとえば「その他のフィルター」の下にすべての属性)の下に折りたたむには、セクション拡張機能を使います。拡張機能 (Extensions) タブで有効にすると、詳細設定 (Advanced) → セクション (Sections) の設定で、フィルター要素の範囲を開閉できるセクションにまとめられます。セクションの動作 (Sections behavior) を チェックボックスとして (As checkbox) にすると複数のセクションを同時に開け、ラジオとして (As radio) にすると1つだけが開いた状態になります。
親カテゴリーをチェックボックスなしの見出しとして表示する
商品がサブカテゴリーにのみ割り当てられている場合、親は見出しとして使うほうが適しています。デザイン (Design) タブで ラジオボタンとチェックボックスのスキン (Radio and checkboxes skin) を選択している場合、実際の入力要素は、スキン名をハイフンでつないだクラスを持つ div で包まれます。スキン square_blue では icheckbox_square-blue(ラジオボタンでは iradio_square-blue)になります。そのため、アンダースコアを使った icheckbox_square_grey のCSSは何にも一致しません。以下のルールは、どのスキンでも、通常の入力要素でも機能します。プラグインのスクリプトは、子を持つすべての項目に、どの階層でもクラス woof_childs_list_li を追加します。CSSは 詳細設定 (Advanced) → コード (Code) → カスタムCSSコード (Custom CSS code) かテーマに記述してください。
/* Product categories filter: parents become headings without a box */
.woof_container_product_cat li.woof_childs_list_li > input,
.woof_container_product_cat li.woof_childs_list_li > div[class*="icheckbox_"],
.woof_container_product_cat li.woof_childs_list_li > div[class*="iradio_"] {
display: none !important;
}
.woof_container_product_cat li.woof_childs_list_li > label {
font-weight: bold;
cursor: pointer;
}
特定の最上位カテゴリーだけに適用するには、その用語のクラスを使います。例:.woof_term_123 > div[class*="icheckbox_"]。第1階層より下の項目には用語のクラスがないため、親のリストを経由して指定します:ul.woof_childs_list_123 > li.woof_childs_list_li > div[class*="icheckbox_"]。
親の名前は依然として非表示の入力要素のラベルであるため、クリックすると親が選択されてしまいます。次のスニペットは、そのクリックをブランチの開閉に置き換えます。チェックボックスを残したまま、カテゴリー名のクリックでサブカテゴリーを展開したい場合の答えにもなります。
/*
* Product filter: a click on the name of a parent category opens or closes
* its subcategories instead of selecting it.
* Child theme functions.php or a code snippets plugin.
*/
add_action('wp_footer', function () {
?>
<script>
document.addEventListener('click', function (e) {
var label = e.target.closest ? e.target.closest('.woof_container_product_cat li.woof_childs_list_li > label') : null;
if (!label) {
return;
}
e.preventDefault(); // do not select the parent
e.stopPropagation();
jQuery(label).siblings('.woof_childs_list_opener').find('span').trigger('click');
}, true);
</script>
<?php
}, 100);
別のタクソノミーでは、product_cat をそのスラッグに置き換えてください。例:.woof_container_pa_brand。
サブカテゴリーがインデントされない、または1行に並ぶ
プラグインは、サブカテゴリーの各リストを17pxインデントします。サブカテゴリーが親と同じ位置に、まるで親であるかのように並ぶ場合は、ウィジェットやサイドバー内のリスト用のテーマのルールが、より強いセレクターでそのパディングを取り除いています。次のように復元してください。
.woof .woof_block_html_items .woof_childs_list {
padding: 0 0 0 17px !important;
}
サブカテゴリーが1行に横並びになるのは、通常、ブロックの 項目を横に並べて表示 (Display items in a row) オプションが原因です。このオプションは、サブカテゴリーを含め、子を持たないすべての用語をインラインで配置します。ツリー表示にするには いいえ (No) に設定してください。オプションがオフの場合は、リストに display: flex、またはリスト項目に display: inline-block を指定しているテーマのルールを探してください。
背景の上でオープナーのプラスとマイナスが見にくい場合は、デザイン (Design) タブの サブカテゴリーを開く画像 (Image for subcategories open)(プラス)と サブカテゴリーを閉じる画像 (Image for subcategories close)(マイナス)で置き換えます。13×13pxのボックスに表示されるため、シンプルでコントラストの高いアイコンを使ってください。
ドロップダウン形式のカテゴリーフィルター
ドロップダウン (Drop-down) と 複数選択ドロップダウン (Multi drop-down) のタイプでは、サブカテゴリーを折りたたむことはできません。単一のドロップダウンではスペースでサブカテゴリーをインデントし、複数選択ドロップダウンでは階層なしで一覧表示します。サブカテゴリーの各オプションには、深さを示すクラス woof-padding-1、woof-padding-2 などが付き、最上位のオプションにはありません。ブラウザーではネイティブのオプションにほとんどスタイルを適用できませんが、ドロップダウンのスキン (Drop-down skin) を Chosen に設定すると、そのクラスが表示されるリストに反映されるため、階層を区別できます。
/* Category drop-downs with the Chosen skin: bold top level */
.woof_container_product_cat .chosen-results li.active-result:not([class*="woof-padding-"]) {
font-weight: bold;
}
/* Multi drop-down: indent subcategories by level */
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-1 { padding-left: 20px; }
.woof_container_mselect.woof_container_product_cat .chosen-results li.woof-padding-2 { padding-left: 34px; }
訪問者に先に親を選ばせ、次に2つ目のドロップダウンでそのサブカテゴリーを選ばせたい場合は、階層ドロップダウン拡張機能を使ってください。設定方法は、年式・メーカー・モデルのフィルターの記事で紹介しています。
チェックリスト
- カテゴリーブロックが チェックボックス (Checkbox) または ラジオ (Radio) タイプを使用し、チェックボックスとラジオで子を非表示 (Hide childs in checkboxes and radio) が はい (Yes) になっている。
- デフォルトの状態を、開いたブランチを記憶するブラウザーではなく、プライベートウィンドウで確認した。
- ブランチを訪問者の過去のクリックではなく選択内容に従わせる必要がある場合は、ブランチ用のスニペットを導入している。
- ブロックのトグルはタクソノミーの追加オプションで設定し、タイトルを表示している。選択時に開くデフォルトの動作が不要な場合にのみ、
woof_block_toggle_stateを使用する。 - カスタムCSSは、ハイフン付きのスキンクラスか
[class*="icheckbox_"]の形式を使用し、変更のたびにページとブラウザーのキャッシュをクリアした。
説明した動作にならない場合は、フィルターページへのリンクとカテゴリーブロックの設定を添えて、HUSKYサポートフォーラムでトピックを作成してください。