SWELL フック一覧｜Action Hook・Filter Hookリファレンス

SWELLで利用できるAction Hook・Filter Hookをカテゴリ別にまとめました。フック名・関連ファイル・用途を一覧で確認できるリファレンスです。子テーマ開発やカスタマイズ時の参考としてご利用ください。

記事・コンテンツ（Single / Loop）

swell_before_post_head
記事ヘッダー（タイトルやアイキャッチ周辺）が表示される直前に処理を割り込みます。

swell_before_post_thumb
記事のサムネイル（アイキャッチ）が表示される直前に処理を割り込みます。

swell_post_content_class
記事本文を囲むコンテナ要素のCSSクラス名をカスタマイズします。

swell_remove_url_to_card
記事本文内の「URL貼付けによるブログカード自動変換」を除外する対象を設定します。

swell_parts_post_thumbnail
アイキャッチ画像のHTML出力構造を書き換えます。

swell_related_post_args
関連記事を取得するための WP_Query 引数をカスタマイズします。

swell_related_post_maxnum
関連記事の最大表示件数を変更します。

swell_related_post_404_text
関連記事が存在しない場合に表示されるテキストを変更します。

swell_posts_404_text
サブの投稿一覧（関連記事等）で記事が見つからない場合の表示文言を変更します。

swell_post_list_404_text
メインの投稿一覧で該当する記事がない場合の表示文言を変更します。

ヘッダー・フッター・パーツ出力

swell_after_copyright
フッターのコピーライト表示直後に独自のHTMLやテキストを追加します。

swell_head_logo
ヘッダーロゴの表示HTML（画像またはテキスト）を変更します。

swell_head_logo_sizes
ヘッダーロゴ画像に適用される sizes 属性を書き換えます。

swell_head_logo_top
トップページ専用のヘッダーロゴ表示HTMLを変更します。

swell_parts_head_logo
ロゴパーツ全体のHTML構造を変更します。

swell_parts_catchphrase
キャッチフレーズパーツの表示内容を変更します。

swell_parts_page_title
ページタイトルの出力HTMLを変更します。

swell_parts_term_title
ターム（カテゴリー・タグなど）タイトルの出力HTMLを変更します。

swell_parts_scroll_arrow
画面下部へ誘導するスクロール矢印の表示形式を変更します。

swell_parts_toc_ad
目次広告パーツの出力内容を変更します。

swell_infobar_data
ヘッダーお知らせバーの表示データ（テキスト・URL等）を変更します。

swell_inner_main_visual
メインビジュアルの内部構造に独自の要素を挿入します。

swell_searchform_placeholder
検索フォームの入力プレースホルダー文言を変更します。

条件判定・表示フラグ（Status）

swell_is_separate_css
CSSの個別読み込み（分離読み込み）のオン/オフ状態を制御します。

swell_is_show_comments
コメント欄を表示するかどうかの判定を変更します。

swell_is_show_index
目次を表示するかどうかの判定を変更します。

swell_is_show_page_links
ページ分割（）リンクを表示するか判定します。

swell_is_show_pickup_banner
ピックアップバナーを表示するか判定します。

swell_is_show_sidebar
サイドバーを表示するかどうかの判定（1カラム/2カラム切り替え等）を変更します。

swell_is_show_toc_ad
目次広告を表示するかどうかの判定を変更します。

swell_is_show_ttltop
ページ上部のタイトルエリア（タイトル・アイキャッチ等）を表示するか判定します。

データ取得・メタデータ・SEO

swell_breadcrumb_list_data
パンくずリスト生成用のデータ配列をカスタマイズします。

swell_get_archive_data
アーカイブページの表示用データ（タイトル・説明等）を取得・変更します。

swell_get_search_terms_status
検索結果ページでの検索条件（キーワード等）のステータスを取得・変更します。

swell_get_search_title
検索結果ページのタイトル文字列を変更します。

swell_get_sns_cta_data
記事末尾のSNS CTAエリアに渡すデータを書き換えます。

swell_get_svg
インライン表示するSVGアイコンの描画データを書き換えます。

swell_get_tax_of_post_type
投稿タイプに関連付けられたタクソノミー情報を取得・変更します。

swell_get_the_term_links
投稿に紐づくターム（カテゴリー・タグ）のリンク一覧HTMLを編集します。

swell_get_the_terms_data
投稿に設定されたターム（カテゴリー・タグ）のデータ配列をカスタマイズします。

swell_sns_cta_message
記事下SNS CTAボックス内に表示するメッセージ文章を変更します。

swell_twitter_to_x
SNSシェアボタン等での「Twitter」から「X」への名称・表示切り替えを制御します。

構造化データ（JSON-LD）

swell_json_ld
全体で出力されるJSON-LD構造化データ全体を書き換えます。

swell_json_ld__article
記事ページ用の構造化データ（Article）を変更します。

swell_json_ld__author
著者情報に関する構造化データ（Person）を変更します。

swell_json_ld__collectionpage
一覧・アーカイブ用の構造化データ（CollectionPage）を変更します。

swell_json_ld__organization
サイト運営者用の構造化データ（Organization）を変更します。

swell_json_ld__webpage
Webページ全般の構造化データ（WebPage）を変更します。

swell_json_ld__website
サイト全体の構造化データ（WebSite）を変更します。

一覧ページ・ナビゲーション（Archive / Navigation）

swell_pager_range
ページネーション（ページ送り）で表示する前後ページ番号の範囲数を変更します。

swell_pickup_post_args
ピックアップスライダー等で取得する記事の検索条件（WP_Query）を変更します。

swell_post_list_cat_data
記事一覧カード上に表示するカテゴリー表示のデータを変更します。

swell_post_list_type_on_archive
アーカイブページでの記事一覧表示形式（カード/リスト/サムネイル等）を変更します。

swell_post_list_type_on_author
著者ページでの記事一覧表示形式を変更します。

swell_post_list_type_on_search
検索結果ページでの記事一覧表示形式を変更します。

swell_post_list_type_on_term
カテゴリー・タグ・タクソノミーページでの記事一覧表示形式を変更します。

swell_show_term_navigation
タクソノミーアーカイブでのナビゲーション（前後のタームへのリンク等）表示を制御します。

パフォーマンス・遅延読み込み（Optimization）

swell_delay_js_list
遅延読み込み対象とするJavaScriptコードやファイルのキーワードリストを変更します。

swell_delay_js_prevent_pages
スクリプト遅延読み込みを除外・停止するページを指定します。

swell_mv_single_lazy_off
投稿ページ用メインビジュアルの画像遅延読み込み（Lazyload）を無効化します。

swell_post_slider_lazy_off
記事スライダーの画像遅延読み込みを無効化します。

swell_post_thumbnail_lazy_off
アイキャッチ画像の遅延読み込みを無効化します。

swell_term_thumbnail_lazy_off
ターム（カテゴリー等）のサムネイル画像の遅延読み込みを無効化します。

swell_top_area_lazy_off
トップページ上部エリア画像の遅延読み込みを無効化します。

ブロック・管理画面・設定（Admin / Editor / Utility）

swell_blocks_rss_cache_time
RSSブロックで取得したデータのキャッシュ保持期間（秒）を変更します。

swell_body_attrs
body タグに付与する属性（class や data- 属性）を追加・変更します。

swell_code_meta_screens
カスタムCSS/JSなどのコード入力用メタボックスを表示する投稿タイプを指定します。

swell_content_attrs
メインコンテンツ要素のHTML属性を編集します。

swell_custom_format_sets
Gutenbergエディターの「カスタム書式」セットを追加・変更します。

swell_custom_formats
エディター内で利用できる書式スタイル設定を変更します。

swell_do_blog_parts
ブログパーツを呼び出して描画する際の条件や出力を制御します。

swell_frame_class
サイト外枠（フレーム設定）用のCSSクラス名を変更します。

swell_hide_fse_blocks
エディター上で非表示にするFSE（フルサイト編集）関連ブロックを指定します。

swell_lp_content_attrs
LP（ランディングページ）用コンテンツエリアのHTML属性を変更します。

swell_root_attrs
html タグ等の最上位要素に付与される属性をカスタマイズします。

swell_side_meta_screens
サイドバー設定（1カラム切り替え等）のメタボックスを表示する投稿タイプを指定します。

swell_table_scroll_hint
テーブル（表）に表示されるスクロールヒントの挙動やテキストを変更します。

swell_term_meta_screens
メタフィールド（追加設定項目）を表示するターム/タクソノミーを指定します。

swell_toc_target
自動目次生成の対象とする見出しタグ（H2, H3など）や判定ルールを変更します。

swell_update_json_name
テーマの自動更新確認等で使用するJSONデータ名やファイル名を書き換えます。

掲載内容はSWELL 2.17.1をもとに確認しています。SWELLのアップデートによりフックの追加・変更・削除が行われる場合があるため、最新版をご利用の場合はあわせてテーマファイルもご確認ください。

※本記事はSWELL 2.17.1時点の内容です。