HUSKY - WooCommerce Product Filter Professional

WooCommerce商品フィルターがスマホで表示されない原因と対処法

パソコンではフィルターが動くのに、スマホではサイドバーが消えている、フィルターを開く (Open filter)ボタンがいつまでも表示されない、あるいは表示されても何も起こらない。WooCommerceの商品フィルターがモバイルで表示されない場合、フィルター自体が壊れていることはまれです。HUSKYのモバイルモードは3つの要素で動きます。サーバーが訪問者のスマホ利用を判定し、スクリプトがボタンを所定の位置へ移動し、タップするとフォームが全画面パネルとして開きます。どの要素も、テーマ、ページビルダー、キャッシュ、最適化ツールによって止められる可能性があります。このガイドでは、どこで失敗しているのかを見分ける方法と、その直し方を説明します。

HUSKYのモバイルモードの仕組み

多くのテーマは、スマホ表示ではサイドバーそのものを表示しません。フィルターがサイドバーウィジェットで、ほかに何も設定していなければ、それだけでフィルターが見当たらない理由になります。モバイルモードは、スマホ向けにフィルターを開くボタンを用意するためのプラグインの機能です。設定に全体共通の「モバイル」スイッチはなく、モバイルモードはフィルターフォームごとに有効にします。

  • ウィジェット:HUSKYウィジェットでモバイルモード (Mobile mode)を「はい」に設定します。
  • ショートコード:[woof sid="mobile" mobile_mode=1]。sid属性は必須で、指定しないとmobile_modeは無視されます。
  • フロントビルダー:[woof_front_builder]フォームのオプションでモバイルモード (Mobile mode)をオンにします。

ページがスマホ向けに生成されると、プラグインはそのフォームを非表示で出力し、フィルターを開く (Open filter)とフィルターを閉じる (Close filter)の2つのボタンをフォームに追加します。デスクトップでは、同じフォームが通常どおり表示されます。スマホでページが読み込まれると、スクリプトがフィルターを開く (Open filter)ボタンを非表示のフォームから見える場所へ移動します。

  1. ページに[woof_mobile]ショートコードがあれば、そのショートコードが出力するコンテナ。
  2. なければ、.woocommerce-products-headerに一致する要素。WooCommerce標準のアーカイブテンプレートで、ショップまたはカテゴリーのタイトルを表示するブロックです。

ボタンをタップすると、フォームにクラスwoof_show_filter_for_mobileが追加され、フォームがページ全体に重なる固定の全画面パネルになります。AJAXモードでは、フィルタリングのたびにパネルが自動的に閉じ、訪問者は新しい商品を確認できます。

問題の大半は、2つの事実で説明できます。1つ目は、「スマホ」かどうかが画面幅ではなく、リクエストヘッダーをもとにWordPressのwp_is_mobile()によってサーバー側で判定されることです。2つ目は、[woof_mobile]は場所の目印にすぎないことです。同じページにモバイルモードを有効にしたフォームがなければ、何も表示されません。

「フィルターを開く」ボタンが表示されない

テンプレートにボタンを置く場所がない。ElementorやDiviのテーマビルダーテンプレート、Avadaのレイアウト、[products]ショートコードで商品を一覧表示しているカスタムページ、多くのカスタムテーマには、.woocommerce-products-headerブロックがないことがよくあります。その場合、ボタンは非表示のフォームの中に残ったままになります。[woof_mobile]を、ボタンを表示したい位置(通常は商品一覧の上)に、ショートコードウィジェットまたはブロックで配置してください。これが最もよく効く対処法です。デスクトップでは何も出力しないため、ページに置いたままで問題ありません。

そのテンプレートにショートコードを置けない場合は、woof_mobile_btn_place_containerフックで、ボタンの配置先を自分で用意した要素に指定します。その要素に一意のIDを付け(Elementorでは詳細設定 → CSS ID (Advanced → CSS ID))、次のように使います。

/*
 * HUSKY: where to put the mobile "Open filter" button.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_mobile_btn_place_container', function ($selector) {
    return '#filter-button-place';
});

セレクターは1つの要素だけに一致するものを使ってください。.elementor-widget-containerのような広いクラスを指定すると、ページ上の一致するすべての要素にボタンがコピーされます。ページに[woof_mobile]コンテナがある場合、このフックは使われません。

ボタンが表示されないほかの原因:

  • 配置先がテーマによってスマホで非表示にされている(デスクトップでのみ表示されるヘッダーやツールバーなど)。モバイルで見える場所を選んでください。
  • 最初はボタンが表示されるのに、フィルタリング後に消える。[woof_mobile]コンテナが、AJAXで置き換えられる商品リストの内側にあります。リストの上に移動してください。
  • JavaScriptの最適化により、最初のタップやスクロールまでスクリプトが遅延されている(WP Rocketなどの「JavaScriptの実行を遅延」機能)。ボタンはプラグインのスクリプトが実行されたときに初めて移動します。/wp-content/plugins/woocommerce-products-filter/を遅延、defer、結合の対象から除外し、キャッシュをクリアしてください。詳細はWP Rocketとキャッシュ使用時のフィルターを参照してください。
  • CSSの最適化(結合や「未使用CSSの削除」)でプラグインのスタイルが削除され、ボタンがページ内にはあっても非表示、またはスタイルなしになっている。プラグインのCSSも除外してください。
  • タブレットでテストしている。iPadのSafariや大きめのAndroidタブレットのChromeは、既定でサイトのデスクトップ版を要求するため、これらのタブレットにはデスクトップのレイアウトが表示されます。テーマがタブレット幅でサイドバーを非表示にする場合、フィルターはそこで消えてしまいます。CSSでサイドバーを表示するか、フォームをコンテンツエリアに配置してください。

ボタンはあるのに何も開かない

フォームが非表示の要素の中にある。ボタンは外に移動していますが、パネルになるのは元の場所にあるフォーム自体です。テーマがスマホでサイドバーをdisplay: noneで非表示にしていると、パネルは非表示のボックスの中で開き、見えないままになります。対処法は3つあります。

  • CSSでスマホでもサイドバーを表示する。サイドバー内のHUSKYフォームはボタンをタップするまで非表示のままですが、そのサイドバーにある他のウィジェットも見えるようになるため、フィルターだけを入れたサイドバーに向いています。
  • モバイルモードのフォームをサイドバーからコンテンツエリア(たとえば商品一覧の上)へ移動する。
  • ウィジェットはデスクトップ専用にしておき(そのモバイルモード (Mobile mode)を「いいえ」にします)、スマホでのみプラグインに商品一覧の上へフィルターを配置させる。オプション → フィルターを自動的に設定 → はい、ただしモバイルデバイスのみ (Options → Set filter automatically → Yes, but only for mobile devices)に加え、表示と非表示を切り替えるボタン用にデザイン → 自動フィルターをデフォルトで非表示 → はい (Design → Hide auto filter by default → Yes)を設定します。これには、WooCommerce標準の商品ループを実行するテンプレートが必要です。

1つ目の方法の典型的なルールです。セレクターはお使いのテーマに合わせて変更してください。

/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
    body.woocommerce-page #secondary {
        display: block;
    }
}

フィルターがテーマのオフキャンバスドロワーやElementorのポップアップの内側にある場合も同じことが起こります。ドロワーやポップアップには独自の表示制御とスクリプトがあり、その内側ではパネルを開けません。ドロワーとHUSKYのモバイルモードは、どちらか一方だけを使ってください。

sidにスペースが含まれている。sid="flat_grey woof_auto_3_columns"のようなスキンの記法は、フォームの見た目には使えますが、3.4.6では、sidが2語のフォームをモバイルボタンが見つけられません。モバイルモードのフォームには、1語のsidを使ってください。

フィルターが2つ存在している。ページビルダーでは、デスクトップ用のセクションと、レスポンシブ表示設定で隠したモバイル用の複製セクションが両方ある場合がよくあります。どちらもHTMLには存在し、CSSで隠されているだけなので、同じ識別子を持つ2つのフォームが干渉し合います。セクションが開かなくなる、フィルターアイコンが2つ表示される、ボタンが見えないほうのコピーを開く、といった症状が出ます。ページごとにフィルターは1つにして、スマホはモバイルモードに任せてください。

スクリプトエラー。スマホでページを開くか、デスクトップのデバイスエミュレーションでリロードしてから、ブラウザーのコンソールを確認してください。HUSKYより前に読み込まれるスクリプトでエラーが出ると、HUSKYも停止します。

デスクトップにモバイル表示、スマホにデスクトップ表示

判定はページが生成されるときに行われるため、全員に同じコピーを保存するページキャッシュは、最初にアクセスした端末向けのページを配信し続けます。その結果、デスクトップの訪問者にフィルターを開く (Open filter)ボタンと非表示のフォームが出たり、スマホの訪問者にサイドバー全体が出てボタンがなかったりし、キャッシュをクリアするたびに入れ替わります。直すのはフィルターではなく、キャッシュ側です。

  • WP Rocket:モバイルキャッシュを有効にし、モバイルデバイス用に別のキャッシュファイルを作成 (Separate cache files for mobile devices)を有効にします。
  • LiteSpeed Cache:モバイルをキャッシュ (Cache Mobile)をオンにします。
  • Cloudflareのページキャッシュ、Varnish、ホスティング側のキャッシュ:端末の種類ごとにキャッシュするか、ショップページとカテゴリーページを除外します。

変更後は、すべてのキャッシュをクリアしてください。同じことは、スライドアウト拡張機能のモバイル表示設定や、同じくwp_is_mobile()を使うフィルターを自動的に設定 (Set filter automatically)のはい、ただしモバイルデバイスのみ (Yes, but only for mobile devices)とはい、ただしデスクトップのみ (Yes, but only for desktop)にも当てはまります。

同じ理由で、デスクトップのブラウザーウィンドウをリサイズしても、フィルターがモバイルモードに切り替わることはありません。実際のスマホで、ログアウトした状態でテストするか、ブラウザーのデバイスエミュレーションでページをリロードして確認してください。

開いたパネル内の問題

ドロップダウンが折りたたまれている、空になっている、またはキーボードが開いてしまう。ChosenとSelectWooのドロップダウンは、フォームがまだ非表示のページ読み込み時に幅を計算します。さらに検索フィールドが付いているため、スマホのキーボードが表示されます。最もすっきりした解決策はデザイン → ドロップダウンスキン → ネイティブ (Design → Drop-down skin → Native)です。スマホ標準の選択リストが表示され、検索フィールドも幅の問題もなくなります。ChosenやSelectWooを使い続ける場合は、最小幅を指定してください。

/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
    min-width: 200px;
}

パネルが透けている、固定ヘッダーの下に隠れる、または文字が見えない。パネルは既定でわずかに透明で、z-index: 9999を使っていますが、固定ヘッダーによってはこれを上回る値が設定されています。カスタムCSSで調整してください。

/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
    opacity: 1;
    z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
    color: #333;
}

それでもパネルがヘッダーの下に開く場合(ヘッダーがパネルの上に出られないスタッキングコンテキストの中にある場合)は、最初のルールにpadding-top: 90px;を追加し、フィルターを閉じる (Close filter)ボタンがヘッダーの下から始まるようにします。

タップするたびにパネルが閉じる。オートサブミットとAJAXが有効だと、選択のたびにフィルターが実行され、結果を見せるためにパネルが閉じます。訪問者が複数の項目を組み合わせることが多いなら、このフォームのオートサブミットをオフにし、[woof sid="mobile" mobile_mode=1 autosubmit=0]とします。こうすると、訪問者は選択してからフィルターボタンをタップできます。

iPhoneでの細かな不具合。テキスト検索フィールドのプレースホルダーのずれは、.woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }で直ります。ラベル形式フィルターの商品数カウンターがラベルから離れてしまう問題は、.woof_container_label .woof_list_label li { position: relative; }で直ります。

ボタンの変更

ボタンの見た目はデザイン (Design)タブで設定します。モバイルフィルターボタンの画像 (Image for mobile filter button)、モバイルフィルターボタンのテキスト (Text for mobile filter button)、モバイルフィルターを閉じる画像 (Image to close mobile filter)、モバイルフィルターを閉じるテキスト (Text to close mobile filter)の4項目です。画像欄に-1を入力するとテキストのみ、テキスト欄に入力するとアイコンのみが表示されます。余白や色は.woof_show_mobile_filterに対する通常のCSSで指定します。たとえば.woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }のようにします。

基本的な設定手順はモバイルデバイスでフィルターを表示する方法を、メインのショートコードのすべての属性については[woof]リファレンスを参照してください。

チェックリスト

  • ページ上のフィルターフォームは1つで、モバイルモードが有効になっている(ウィジェットのオプション、1語のsidを使ったmobile_mode=1、またはフロントビルダーのオプション)。
  • [woof_mobile]が、ボタンを表示したい位置で、商品リストの外側の、スマホで見える場所に置かれている。
  • フォーム自体が、スマホで非表示になるサイドバー、ドロワー、ポップアップの中にない。
  • プラグインのJavaScriptとCSSが、遅延、defer、結合、未使用CSSの削除の対象から除外されている。
  • ページキャッシュがモバイルデバイス用に別のコピーを保持しており、すべてのキャッシュをクリアした。
  • 実際のスマホ、またはデバイスエミュレーションとリロードで、ログアウトした状態でテストした。

それでもスマホでフィルターが表示されない場合は、ページのリンク、使用しているショートコードまたはウィジェットの設定、ブラウザーコンソールのエラーを添えて、HUSKYサポートフォーラムでトピックを作成してください。