会員ログイン
テーマ開発

WordPressオリジナルテーマの構築。特定のページのみスライダー(swiper)を有効にする方法 #4/4

worpressでオリジナルテーマの構築
はじめに
概要
WordPressを使用して、特定のページにのみ〇〇を適用したい場合があります。今回は、ACFプラグインを使用して、特定のページにスライダーを適用する方法を実装します。この方法は、さまざまな用途に使えるため、クライアントが編集しやすいようにオリジナルのテーマをカスタマイズしていきましょう。
※本記事の情報は執筆時点のものであり、閲覧時点では変更されている可能性があります。また、ご利用の環境によっては、本記事の内容が正常に動作しないことがあります。最新の情報については、公式サイトなどでご確認ください。
疑問を持つ読者のイラスト読者

WordPressオリジナルテーマの構築。特定のページのみスライダー(swipe…は、最初にどこを理解するとよいですか?

著者・木村のプロフィール写真木村

WordPress標準機能、プラグインの機能、テーマ側の処理を分けて考えると、どこを変更すべきか判断しやすくなります。

話を聞く読者のイラスト読者

実際に試すときは、手順だけでなく確認方法も知っておいた方がよいでしょうか?

著者・木村のプロフィール写真木村

はい。この記事では、作業の目的から実装後の確認までを順番に整理します。自分の環境と照らし合わせながら読み進めてください。

ラジオボタンで実装を選択

ラジオボタンで実装を選択では、WordPressオリジナルテーマの構築。特定のページのみスライダー(swiper)を有効にする方法 #4/4を理解・実装するために必要な考え方と、作業時に確認したい点を整理します。最初に役割を把握してから、記事内の手順へ進みましょう。

スライダーの実装

固定ページにswiperを使ってスライダーを実装します。詳細はこちらのswiperの実装を参照ください。

ACFの設定

以下は実装の一例です。 フィールドタイプ -ラジオボタン フィールドラベル -スライダーの設定 フィールド名 -swiper-btn 選択枠 -有効にする・無効にする 返り値 -値

ACFの値を取得する

ACFの値を取得するにはget_field();関数を使用します。
<?php
$swiper = get_field("swiper-btn");
echo '<span>var_dumpの値: ';
print_r($swiper);
echo '</span>';
?>
値が取得できているか、print_rで確認しています。

条件分岐

条件分岐では、WordPressオリジナルテーマの構築。特定のページのみスライダー(swiper)を有効にする方法 #4/4を理解・実装するために必要な考え方と、作業時に確認したい点を整理します。最初に役割を把握してから、記事内の手順へ進みましょう。

値を取得できることの確認により、条件分岐を介して対応する表示または非表示を処理することが可能になります。

論理演算子

以下のコードで条件に当てはまらない場合は、本体ごと非表示にします。
<div class="hero" <?php if ($swiper !== '有効にする') echo 'style="display: none;"'; ?>>
!=で’有効にする’でない場合にechoが実装されます。

スライダーの実装

以下のようにコードを記述しています。 php
<div class="swiper">
    <?php if ($swiper === '有効にする') : ?>
        <div class="swiper-wrapper">
            <div class="swiper-slide">
                <img src="https://picsum.photos/1000/500?random=1" alt="" />
            </div>
            <div class="swiper-slide">
                <img src="https://picsum.photos/1000/500?random=2" alt="" />
            </div>
            <div class="swiper-slide">
                <img src="https://picsum.photos/1000/500?random=3" alt="" />
            </div>
            <div class="swiper-slide">
                <img src="https://picsum.photos/1000/500?random=4" alt="" />
            </div>
        </div>
        <div class="swiper-button-next fa-circle-right"></div>
        <div class="swiper-button-prev fa-circle-left"></div>
        <div class="swiper-pagination"></div>
    <?php endif; ?>

</div>
script
<?php if ($swiper === '有効にする') : ?>
    <script src="https://cdn.jsdelivr.net/npm/swiper@10/swiper-bundle.min.js"></script>
    <script type="module" src="<?php echo get_template_directory_uri(); ?>/js/index.js"></script>
<?php endif; ?>
上記のように条件分岐を設定することで、’有効にする’を選択している場合は表示され、それ以外は非表示となります。

実装前に確認しておきたいこと

ここでは、WordPressオリジナルテーマの構築。特定のページのみスライダー(swipe…を実際の制作へ取り入れる前に、準備しておきたい内容を整理します。先に作業範囲と確認方法を決めておくと、既存ページへの影響を抑えながら進められます。

作業の目的と変更範囲を決める

WordPress標準機能、プラグインの機能、テーマ側の処理を分けて考えると、どこを変更すべきか判断しやすくなります。 サンプルをそのまま貼り付ける前に、どのページ、どの要素、どの利用者へ影響するのかを書き出してください。目的が明確であれば、必要以上にコードや設定を増やさずに済みます。

元の状態へ戻せるようにする

テーマや設定を変更するときは、対象ファイルや設定値のコピーを残します。複数の変更を一度に行わず、一つ反映するたびに表示と動作を確認すると、問題が起きても原因を切り分けやすくなります。

よくあるつまずきと確認方法

WordPressオリジナルテーマの構築。特定のページのみスライダー(swipe…が期待どおりに動かない場合は、コードを追加し続ける前に、読み込み順、対象要素、設定値、キャッシュの順で確認します。小さな入力ミスや確認条件の違いが原因になることも少なくありません。

変更が反映されない場合

保存したファイルと表示中のページが対応しているかを確認し、キャッシュを消して再読み込みします。ブラウザーの開発者ツールやWordPressのエラーログを確認すると、読み込み失敗や記述ミスを見つけやすくなります。

公開前の最終確認

ローカル環境で変更し、未ログイン状態と管理者状態の両方で表示を確認します。PHPを変更した場合は、エラーログ、権限、エスケープ処理も合わせて確認してください。

実務で使うための進め方

WordPressオリジナルテーマの構築。特定のページのみスライダー(swipe…を実務で使うときは、完成形を一度に作ろうとせず、最小のサンプルで動作を確かめてから既存ページへ組み込みます。確認できた処理を少しずつ広げると、記事の例と自分の環境に差があっても調整しやすくなります。

小さなサンプルから試す

新しいコードや設定は、関係する要素だけを置いた小さなページで試します。期待する結果、実際の結果、変更した箇所を短く記録すると、途中で別の方法を試した場合にも比較できます。動作を確認できた後で、既存の命名規則やファイル構成へ合わせて移してください。

既存の実装と重複していないか確認する

同じ目的のCSS、JavaScript、プラグイン設定がすでに存在すると、指定の上書きや処理の二重実行が起きることがあります。検索機能や開発者ツールを使い、同じクラス名、関数名、フック、設定項目がないかを先に確認しましょう。

保守しやすい状態を保つ

実装時に動くだけでなく、数か月後に見直せる状態にしておくことも大切です。採用した理由と確認方法を短く残しておけば、仕様変更や担当者の交代があっても安全に更新できます。

変更理由を短く記録する

コメントや作業メモには、コードの内容をそのまま説明するのではなく、なぜその処理が必要なのかを書きます。参照した公式情報や動作確認日も残すと、仕様が変わったときに見直す判断材料になります。秘密情報や個人の環境だけで使えるパスは記録へ含めません。

定期的に動作を見直す

ローカル環境で変更し、未ログイン状態と管理者状態の両方で表示を確認します。PHPを変更した場合は、エラーログ、権限、エスケープ処理も合わせて確認してください。 ブラウザー、WordPress、プラグイン、外部サービスを更新した後にも同じ項目を確認すると、変更による影響を早めに見つけられます。

まとめ

  • ACFの選択ボタンを活用すれば、様々なことが実装できる
  • 値を取得し、それを条件分岐に当てはめる
  • 取得にはget_filed();関数を使用する

MEMBER COMMENTS

コメント(0件)

会員ログイン後にコメントできます

記事への質問や感想をコメントで共有できます。無料会員登録後もこの記事へ戻れます。