SWELLの記事スライダーを、投稿・固定ページの本文にショートコードで表示する方法です。
標準スライダーの投稿選択やカードのデザイン設定を参照し、本文内で複数設置できるコードを掲載します。
この方法はPHPを追加できる方向けです。
コードを使わず投稿を並べたい場合や、記事IDを個別に指定したい場合は、投稿リスト・記事スライダーの選び方から方法を選んでください。
動く見本:2つのスライダーを別々に操作する
それぞれの矢印や丸いページ送りを操作してください。
一方を操作しても、もう一方は動きません。
自動再生は行いません。
見本1
見本2


適用範囲とSWELLの設定
対象は、ショートコードを本文へ直接置いた投稿・固定ページです。
ウィジェット、ブログパーツ経由、一覧ページ、ページ遷移をAjax化する構成はこのコードの対象外です。
記事の選び方・並び順・表示枚数・カードのデザイン・矢印とページ送りの表示は、SWELLの「記事スライダー」設定を参照します。
トップページ用スライダーの表示をOFFにする必要はありません。
本文側は別のIDと初期化対象を使います。
スライダーを置ける場所は投稿と固定ページですが、カードとして取得する対象は公開済みの通常投稿です。
固定ページやカスタム投稿タイプの記事は取得しません。
掲載コードの取得件数は posts_per_page で最大8件に指定しています。
SWELLの表示枚数は、そのうち一度に見えるカードの数であり、取得する総件数とは別です。
表示枚数を変えても、9件目以降の記事が追加で読み込まれるわけではありません。
複数設置したスライダーは別々に操作できますが、記事の抽出条件と表示設定は共通のSWELL設定を参照します。
このショートコードには、設置場所ごとにカテゴリーや取得件数を指定する属性はありません。
SWELLの内部テンプレートを使うため、テーマ更新後は再確認してください。
自動再生・ループは無効にし、少ない記事数でも複製カードが生じない構成にしています。
表示枚数はPCで1〜6、スマホ側で1〜3の範囲に補正します。
PHPコードを1か所に登録する
変更前のコードと設定を保存し、検証用サイトで試してください。
以下は子テーマのfunctions.phpのPHP領域、またはCode SnippetsのPHPスニペットに登録します。
同じコードを両方へ入れないでください。
先頭の<?phpは含めていません。
CSSとJavaScriptもこのPHPに含まれています。
追加CSSや記事のカスタムJS欄へ、同じコードを重ねて登録する必要はありません。
SWELL同梱のSwiperを読み込んだ後に、対象のスライダーだけを初期化します。
function waza_render_post_slider_v2() {
if (!class_exists('SWELL_Theme')) return '';
$SETTING = SWELL_Theme::get_setting();
$q_args = [
'post_type' => 'post',
'post_status' => 'publish',
'no_found_rows' => true,
'posts_per_page' => 8,
'ignore_sticky_posts' => true,
];
// 標準スライダーとは別のID・初期化処理を使います。
$slider_id = wp_unique_id('waza-post-slider-');
ob_start();
// 除外タグ
$exc_tag = explode( ',', $SETTING['exc_tag_id'] );
if ( ! empty( $exc_tag ) ) {
$q_args['tag__not_in'] = $exc_tag;
}
// 並び順
$the_orderby = $SETTING['ps_orderby'];
if ( 'meta_value_num' === $the_orderby ) {
$q_args['orderby'] = 'meta_value_num';
$q_args['meta_key'] = SWELL_CT_KEY;
$q_args['order'] = 'DESC';
} else {
$q_args['orderby'] = $the_orderby;
}
if ( 'tag' === $SETTING['ps_pickup_type'] ) {
// タグを指定
$pickup_tag = $SETTING['pickup_tag'];
if ( ! empty( $pickup_tag ) ) {
$q_args['tag'] = $pickup_tag;
}
} else {
// カテゴリーを指定
$pickup_cat = $SETTING['pickup_cat'];
if ( ! empty( $pickup_cat ) ) {
$q_args['cat'] = (int) $pickup_cat;
}
}
// ピックアップタイトル
$pickup_title = $SETTING['pickup_title'];
// スライダークラス
$slider_class = ( 'normal' === $SETTING['ps_style'] ) ? '-ps-style-normal' : '-ps-style-img';
// 表示枚数
$slide_num_pc = max(1, min(6, (float) $SETTING['ps_num']));
$slide_num_sp = max(1, min(3, (float) $SETTING['ps_num_sp']));
$slider_class .= ' -num-pc-' . str_replace( '.', '_', $slide_num_pc );
$slider_class .= ' -num-sp-' . str_replace( '.', '_', $slide_num_sp );
// floatにして計算
$slide_num_pc = max(1, min(6, (float) $slide_num_pc));
$slide_num_sp = max(1, min(3, (float) $slide_num_sp));
if ( $slide_num_pc <= 2 ) {
$slider_class .= ' -fz-pc-l';
};
if ( $slide_num_sp >= 2 ) {
$slider_class .= ' -fz-sp-s';
};
// スタイダーインナークラス
$inner_class = ( 'wide' === $SETTING['pickup_pad_lr'] ) ? ' l-container' : '';
// サムネイルサイズ
$pc_size = round( 100 / $slide_num_pc, 1 ) . 'vw';
$sp_size = round( 100 / $slide_num_sp, 1 ) . 'vw';
$thumb_sizes = '(min-width: 960px) ' . $pc_size . ', ' . $sp_size;
// 背景画像
$bgimg = '';
$bgimg_url = SWELL_Theme::get_setting( 'bg_pickup' );
$bgimg_id = SWELL_Theme::get_setting( 'ps_bgimg_id' );
$style = 'opacity: ' . $SETTING['ps_img_opacity'] . ';';
if ( $bgimg_id ) {
$bgimg = SWELL_Theme::get_image( $bgimg_id, [
'class' => 'p-postSlider__imgLayer c-filterLayer__img u-obf-cover',
'alt' => '',
'loading' => apply_filters( 'swell_post_slider_lazy_off', true ) ? 'none' : SWELL_Theme::$lazy_type,
'style' => $style,
'decoding' => 'async',
'aria-hidden' => 'true',
]);
} elseif ( $bgimg_url ) {
$bgimg = '<img alt="" aria-hidden="true" src="' . esc_url( $bgimg_url ) . '" class="p-postSlider__imgLayer c-filterLayer__img u-obf-cover" decoding="async" style="' . esc_attr( $style ) . '">';
}
?>
<div id="<?=esc_attr($slider_id)?>" data-waza-slider data-pc="<?=esc_attr($slide_num_pc)?>" data-sp="<?=esc_attr($slide_num_sp)?>" class="p-postSlider c-filterLayer <?=esc_attr( $slider_class )?>">
<?php echo $bgimg; //phpcs:ignore?>
<div class="p-postSlider__inner<?=esc_attr( $inner_class )?>">
<?php if ( $pickup_title ) : ?>
<div class="p-postSlider__title">
<?=wp_kses( $SETTING['pickup_title'], SWELL_Theme::$allowed_text_html )?>
</div>
<?php endif; ?>
<div class="waza-post-slider__viewport">
<?php
SWELL_Theme::get_parts( 'parts/post_list/loop_by_slider', [
'query_args' => $q_args,
'thumb_sizes' => $thumb_sizes,
] );
?>
<?php if ( $SETTING['ps_on_pagination'] ) : ?>
<div class="swiper-pagination"></div>
<?php endif; ?>
<?php if ( $SETTING['ps_on_nav'] ) : ?>
<button type="button" class="swiper-button-prev" aria-label="<?=esc_attr__( '前のスライド', 'swell' )?>"></button>
<button type="button" class="swiper-button-next" aria-label="<?=esc_attr__( '次のスライド', 'swell' )?>"></button>
<?php endif; ?>
</div>
</div>
</div>
<?php
return ob_get_clean();
}
add_shortcode('waza_post_slider', 'waza_render_post_slider_v2');
// 投稿・固定ページ本文のショートコードを検出し、head出力前に読み込みます。
add_action('wp_enqueue_scripts', function () {
if (!is_singular() || !class_exists('SWELL_Theme')) return;
$post = get_queried_object();
if (!$post instanceof WP_Post || !has_shortcode($post->post_content, 'waza_post_slider')) return;
wp_enqueue_style('swell_swiper');
wp_enqueue_script('swell_swiper');
wp_add_inline_style('swell_swiper', <<<'WAZA_CSS'
[data-waza-slider] {
--swiper-nav-size: 32px;
overflow: hidden;
padding-bottom: var(--swl-post_slide_padY,16px);
padding-top: var(--swl-post_slide_padY,16px);
position: relative
}
[data-waza-slider] .waza-post-slider__viewport {
position: relative;
z-index: 1
}
[data-waza-slider] .swiper-pagination {
bottom: 0;
line-height: 1
}
[data-waza-slider] .swiper-pagination-bullet {
background: currentcolor;
color: inherit
}
[data-waza-slider] .swiper-button-prev {
left: var(--ps_space)
}
[data-waza-slider] .swiper-button-next {
right: var(--ps_space)
}
[data-waza-slider] .swiper-button-next svg,[data-waza-slider] .swiper-button-prev svg {
display: none
}
[data-waza-slider] .p-postSlider__title {
font-size: 4.5vw;
font-weight: 700;
letter-spacing: var(--swl-letter_spacing,1px);
margin-bottom: .75em;
position: relative;
text-align: center;
z-index: 1
}
[data-waza-slider] .p-postSlider__postList {
align-items: stretch;
display: flex;
flex-wrap: nowrap
}
[data-waza-slider] .p-postList__item {
height: auto;
padding: 0 var(--ps_space);
position: static;
width: var(--swl-post_slide_width--pc,100%)
}
[data-waza-slider] .p-postList__link {
color: inherit;
height: 100%;
position: relative
}
[data-waza-slider] .p-postList__body {
color: inherit
}
[data-waza-slider] .p-postList__title {
font-size: 3.6vw;
overflow: hidden
}
[data-waza-slider].-ps-style-normal .p-postList__title {
line-height: 1.4;
max-height: 4.2em
}
[data-waza-slider].-ps-style-normal .p-postList__body {
margin-top: .75em
}
[data-waza-slider].-ps-style-img .p-postList__thumb {
z-index: 0
}
[data-waza-slider].-ps-style-img .p-postList__body {
bottom: 0;
color: #fff;
left: 0;
margin-top: 0;
padding: 2em .75em .5em;
position: absolute;
width: 100%;
z-index: 2
}
[data-waza-slider].-ps-style-img .p-postList__body:before {
background: linear-gradient(transparent,rgba(0,0,0,.4));
bottom: 0;
content: "";
display: block;
height: 100%;
left: 0;
position: absolute;
transition: none;
width: 100%;
z-index: -1
}
[data-waza-slider].-ps-style-img .p-postList__title {
line-height: 1.2;
max-height: 3.6em
}
@media not all and (min-width: 600px) {
[data-waza-slider] {
padding-bottom:var(--swl-post_slide_padY--mb,16px);
padding-top: var(--swl-post_slide_padY--mb,16px)
}
[data-waza-slider] .swiper-pagination-bullet {
height: 6px;
margin: 0 3px;
width: 6px
}
[data-waza-slider] {
--swiper-nav-border-width: 1px
}
[data-waza-slider].-fz-sp-s .p-postList__title {
font-size: 3vw
}
[data-waza-slider].-ps-style-img.-fz-sp-s .p-postList__body {
padding: 2em .5em .5em
}
}
@media not all and (min-width: 960px) {
[data-waza-slider] .p-postSlider__inner {
padding-left:0;
padding-right: 0
}
[data-waza-slider] .p-postList__item {
width: var(--swl-post_slide_width--sp,100%)
}
[data-waza-slider].-num-sp-1.-ps-style-normal .p-postList__body {
padding: .25em 1em 0
}
}
@media (min-width: 600px) {
[data-waza-slider] .p-postSlider__title {
font-size:24px
}
[data-waza-slider] .p-postList__title {
font-size: 15px
}
[data-waza-slider].-fz-pc-l .p-postList__title {
font-size: 18px
}
}
@media (min-width: 960px) {
[data-waza-slider].-num-pc-1.-ps-style-normal .p-postList__body {
padding:.25em 1em 0
}
}
[data-waza-slider] {--ps_space:0px; max-width:100%;}
[data-waza-slider] .waza-post-slider__viewport {overflow:hidden; padding:4px 4px 40px;}
[data-waza-slider] .p-postSlider__postList {margin:0!important; padding:0!important; list-style:none; flex-wrap:nowrap; align-items:stretch;}
[data-waza-slider] .p-postList__item {padding:0; margin:0; flex-shrink:0;}
[data-waza-slider] .p-postList__title {font-size:15px!important; padding:0!important; margin:0!important; border:0!important; background:none!important;}
[data-waza-slider] .p-postList__title:before,[data-waza-slider] .p-postList__title:after {display:none!important;}
[data-waza-slider] .swiper-button-prev,[data-waza-slider] .swiper-button-next {width:36px;height:36px; background:#fff; color:#222; border:1px solid #666; border-radius:50%; padding:0;}
[data-waza-slider] .swiper-button-prev {left:4px;}
[data-waza-slider] .swiper-button-next {right:4px;}
[data-waza-slider] :focus-visible {outline:3px solid #1769aa;outline-offset:1px;}
[data-waza-slider] .waza-post-slider__viewport:not(.swiper-initialized) .swiper-wrapper {display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:16px;}
[data-waza-slider] .waza-post-slider__viewport:not(.swiper-initialized) .swiper-slide {width:100%;}
[data-waza-slider] .waza-post-slider__viewport:not(.swiper-initialized) .swiper-button-prev,
[data-waza-slider] .waza-post-slider__viewport:not(.swiper-initialized) .swiper-button-next {display:none;}
WAZA_CSS
);
wp_add_inline_script('swell_swiper', <<<'WAZA_JS'
(() => {
const init = () => {
if (typeof Swiper === 'undefined') return;
document.querySelectorAll('[data-waza-slider]').forEach(root => {
const el = root.querySelector('.waza-post-slider__viewport');
if (!el || el.swiper) return;
const reduced = window.matchMedia('(prefers-reduced-motion: reduce)');
const slider = new Swiper(el, {
loop: false,
autoplay: false,
slidesPerView: Number(root.dataset.sp) || 1,
spaceBetween: 16,
speed: reduced.matches ? 0 : 300,
watchOverflow: true,
breakpoints: {960: {slidesPerView: Number(root.dataset.pc) || 3}},
navigation: {
prevEl: root.querySelector('.swiper-button-prev'),
nextEl: root.querySelector('.swiper-button-next')
},
pagination: {el: root.querySelector('.swiper-pagination'), clickable: true},
a11y: {prevSlideMessage: '前の記事へ', nextSlideMessage: '次の記事へ', paginationBulletMessage: '{{index}}番目の記事へ'}
});
el.addEventListener('focusin', event => {
const card = event.target.closest('.swiper-slide');
if (card) slider.slideTo(Array.from(slider.slides).indexOf(card), 0);
});
reduced.addEventListener('change', event => {slider.params.speed = event.matches ? 0 : 300;});
});
};
if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', init, {once:true});
else init();
})();
WAZA_JS
, 'after');
}, 20);
本文にショートコードを置く
ブロックエディターで「ショートコード」ブロックを追加し、次の1行を貼ります。
同じページに2回置く場合も、同じショートコードを使えます。
[waza_post_slider]プレビューまたは公開画面で確認してください。
表示用コード欄ではショートコードを実行させず、見本のブロックだけで実行しています。
旧版から移行するとき
旧版の[post_slider]とは登録名が異なります。
まず対象記事のショートコードを置き換え、旧版のPHP・追加CSS・記事のカスタムJSを保存してから外します。
他の記事でも旧版を使っている場合は、それらを移行するまで共通の旧PHPを削除しないでください。
特に、すべての.swiperを対象にする旧JavaScriptは新しいコードと併用しないでください。
新しい見本は専用の要素を使いますが、旧JavaScriptが残ると他のSwiperに影響する可能性があります。
表示されない・動かないときの確認
文字のまま表示される場合は、PHPの登録とショートコードの綴りを確認します。
記事が出ない場合は、SWELLの記事スライダーで指定したカテゴリー・タグ・除外タグに、公開済み記事があるか確認してください。
カードは表示されても送れない場合は、ブラウザーのエラー、キャッシュ、JavaScriptの遅延実行設定を確認してください。
記事数が表示枚数以下なら、ページ送りが不要なため矢印が無効または非表示になる場合があります。
JavaScriptが読み込めない場合も、記事リンクを2列の一覧として残すCSSを含めています。
通常時の操作はTabで移動し、矢印ボタンはEnterまたはSpace、記事リンクはEnterで開きます。
画面外の記事リンクへフォーカスしたときは、そのカードを表示します。
戻し方と検証範囲
戻すときは本文から[waza_post_slider]を外し、今回追加したPHPを無効化します。
旧版に戻す場合は保存したPHP・CSS・JSとショートコードをセットで復元し、キャッシュを削除してください。
検証記録:2026年9月30日。
WordPress 7.1.2・SWELL 2.19.0の隔離環境で、IDの重複防止、カード出力、標準スライダーON時の出力、表示枚数0の補正、表示用ショートコードの非実行を確認しています。
公開画面ではPC幅と390px幅で2つの見本を確認し、矢印の独立動作、Enter・Spaceでの記事送り、Tabで画面外の記事リンクへ移動した際の表示を確認しました。
実機のタッチ操作、全デザイン設定の組み合わせ、動きを減らすOS設定の切替は未検証です。
初期化と操作設定はSwiper公式APIを参照しています。
テーマ同梱版の仕様に依存するため、外部CDNから別のSwiperを追加しないでください。
旧JavaScriptと二重初期化の確認
このページでは、以前の追加JavaScriptに残っていた全.swiperを対象とする初期化を外しました。
移行時は記事ごとの追加JS欄も確認してください。
掲載PHPが各スライダーを初期化するため、別のnew Swiperで同じ要素を初期化しません。
動作中の見本は上の2つです。
片方の前後ボタンを操作した後、もう片方の表示位置が変わらないことを確認できます。
公開画面での確認
PCで1つ目の投稿スライダーを操作した画面です。
2つ目の表示位置は別に管理します。

よくある質問:SWELLの記事スライダーを本文で表示するとき
この方法では、どこに記事スライダーを表示できますか?
記事では、SWELLの記事スライダーを、投稿・固定ページの本文にショートコードで表示する方法です。
ショートコードを本文へ直接置いた投稿・固定ページが対象で、ウィジェット、ブログパーツ経由、一覧ページ、ページ遷移をAjax化する構成は対象外です。
誰向けの方法ですか?
記事では、PHPを追加できる方向けです。
コードを使わず投稿を並べたい場合や、記事IDを個別に指定したい場合は、投稿リスト・記事スライダーの選び方から方法を選びます。
記事の選び方やデザインは、どこで設定しますか?
記事では、記事の選び方・並び順・表示枚数・カードのデザイン・矢印とページ送りの表示は、SWELLの「記事スライダー」設定を参照します。
トップページ用スライダーの表示をOFFにする必要はありません。
コードは、どこに登録しますか?
記事では、子テーマのfunctions.phpのPHP領域、またはCode SnippetsのPHPスニペットに登録します。
同じコードを両方へ入れません。
CSSとJavaScriptもこのPHPに含まれているので、追加CSSや記事のカスタムJS欄へ重ねて登録する必要はありません。
変更前のコードと設定を保存し、検証用サイトで試します。
本文には、どう置きますか?
記事では、ブロックエディターで「ショートコード」ブロックを追加し、掲載されている1行を貼ります。
同じページに2回置く場合も、同じショートコードを使え、それぞれ別々に操作できます。
プレビューまたは公開画面で確認します。
旧版から移行するときの注意点は?
記事では、まず対象記事のショートコードを置き換え、旧版のPHP・追加CSS・記事のカスタムJSを保存してから外します。
他の記事でも旧版を使っている場合は、それらを移行するまで共通の旧PHPを削除しません。
すべての.swiperを対象にする旧JavaScriptは、新しいコードと併用しないでください。
表示されない、または動かないときは、何を確認しますか?
記事では、ショートコードが文字のまま表示される場合は、PHPの登録とショートコードの綴りを確認します。
記事が出ない場合は、SWELLの記事スライダーで指定したカテゴリー・タグ・除外タグに、公開済み記事があるか確認します。
カードは表示されても送れない場合は、ブラウザーのエラー、キャッシュ、JavaScriptの遅延実行設定を確認します。
記事数が表示枚数以下なら、矢印が無効または非表示になる場合があります。
どこまで検証されていますか?
記事では、2026年9月30日にWordPress 7.1.2・SWELL 2.19.0の隔離環境で、IDの重複防止、カード出力、標準スライダーON時の出力などを確認しています。
一方、実機のタッチ操作、全デザイン設定の組み合わせ、動きを減らすOS設定の切替は未検証です。
テーマ同梱のSwiperの仕様に依存するため、外部CDNから別のSwiperを追加しないでください。



