SWELL│最新版！アクションフック・フィルターフック79個全まとめ

add_action( 'swell_after_copyright', function() {
    echo '<div>© 2024 MOTOKI LLC. All Rights Reserved. | <a href="https://example.com/privacy-policy">Privacy Policy</a></div>';
});

add_action( 'swell_inner_main_visual', function() {
    echo '<div class="custom-text">WordPress専門のWeb制作会社です！</div>';
});

add_action( 'swell_before_post_head', function( $post_id ) {
    echo '<div class="custom-text">これは投稿ヘッダーの前のカスタム テキストです。投稿ID: ' . esc_html( $post_id ) . '</div>';
});

add_action( 'swell_before_post_thumb', function( $post_id ) {
    echo '<div class="custom-text">これは投稿のサムネイルの前にあるカスタム テキストです。投稿ID: ' . esc_html( $post_id ) . '</div>';
});

add_filter( 'swell_json_ld', function( $json_lds ) {
    // カスタムデータを追加
    $json_lds['CustomData'] = [
        '@type' => 'Thing',
        'name'  => 'Custom Name',
        'description' => 'This is a custom description.',
    ];

    return $json_lds;
} );

add_filter( 'swell_json_ld__article', function( $data, $post_id ) {
    // カスタムフィールドから追加情報を取得
    $additional_info = get_field( 'additional_info', $post_id );

    // 追加情報があればデータに追加
    if ( $additional_info ) {
        $data['additionalProperty'] = [
            '@type' => 'PropertyValue',
            'name'  => 'Additional Information',
            'value' => $additional_info,
        ];
    }

    return $data;
}, 10, 2 );

add_filter( 'swell_json_ld__author', function( $data, $author_id ) {
    // カスタムフィールドから追加情報を取得
    $additional_info = get_field( 'additional_info', 'user_' . $author_id );

    // 追加情報があればデータに追加
    if ( $additional_info ) {
        $data['additionalProperty'] = [
            '@type' => 'PropertyValue',
            'name'  => 'Additional Information',
            'value' => $additional_info,
        ];
    }

    return $data;
}, 10, 2 );

add_filter( 'swell_json_ld__collectionpage', function( $data ) {
    // カスタムフィールドから追加情報を取得
    $additional_info = get_field( 'additional_info', get_queried_object_id() );

    // 追加情報があればデータに追加
    if ( $additional_info ) {
        $data['additionalProperty'] = [
            '@type' => 'PropertyValue',
            'name'  => 'Additional Information',
            'value' => $additional_info,
        ];
    }

    return $data;
} );

add_filter( 'swell_json_ld__organization', function( $data ) {
    // カスタムフィールドから追加情報を取得
    $additional_info = get_field( 'additional_info', 'option' );

    // 追加情報があればデータに追加
    if ( $additional_info ) {
        $data['additionalProperty'] = [
            '@type' => 'PropertyValue',
            'name'  => 'Additional Information',
            'value' => $additional_info,
        ];
    }

    return $data;
} );

add_filter( 'swell_json_ld__webpage', function( $data ) {
    // カスタムフィールドから追加情報を取得
    $additional_info = get_field( 'additional_info', get_the_ID() );

    // 追加情報があればデータに追加
    if ( $additional_info ) {
        $data['additionalProperty'] = [
            '@type' => 'PropertyValue',
            'name'  => 'Additional Information',
            'value' => $additional_info,
        ];
    }

    return $data;
} );

add_filter( 'swell_json_ld__website', function( $data ) {
    // カスタムフィールドから追加情報を取得
    $additional_info = get_field( 'additional_info', 'option' );

    // 追加情報があればデータに追加
    if ( $additional_info ) {
        $data['additionalProperty'] = [
            '@type' => 'PropertyValue',
            'name'  => 'Additional Information',
            'value' => $additional_info,
        ];
    }

    return $data;
} );

add_filter( 'swell_mv_single_lazy_off', function( $is_lazy_off ) {
    // メインビジュアルの画像の遅延読み込みをオフにする
    $is_lazy_off = true;
    
    return $is_lazy_off;
});

add_filter( 'swell_post_slider_lazy_off', function( $is_lazy_off ) {
    // ポストスライダーの背景画像の遅延読み込みをオフにする
    $is_lazy_off = true;
    
    return $is_lazy_off;
});

add_filter( 'swell_post_thumbnail_lazy_off', '__return_true' );

add_filter( 'swell_mv_single_lazy_off', function( $is_lazy_off ) {
    // 特定のタームIDの場合
    if ( is_tax( 'カスタムタクソノミー', '特定のタームスラッグ' ) ) {
        // 遅延読み込みをオフにする
        $is_lazy_off = true;
    }
    
    return $is_lazy_off;
});

add_filter( 'swell_top_area_lazy_off', function( $value ) {
    // トップエリアの背景画像の遅延読み込みを無効化
    return true;
});

add_filter( 'swell_parts_post_thumbnail', function( $html, $post_id, $is_youtube ) {
    // カスタム投稿タイプ「news」の場合、アイキャッチ画像を非表示にする
    if ( get_post_type( $post_id ) === 'news' ) {
        return '';
    }

    // それ以外の場合は通常通りアイキャッチ画像を表示
    return $html;
}, 10, 3 );

add_filter( 'swell_searchform_placeholder', function( $placeholder ) {
    // プレースホルダーテキストをカスタマイズ
    $placeholder = __( '記事を検索する', 'swell' );

    return $placeholder;
});

add_filter( 'swell_breadcrumb_list_data', function( $list_data ) {
    // 特定のカテゴリーのアーカイブページの場合
    if ( is_category( '特定のカテゴリースラッグ' ) ) {
        // パンくずリストのデータをカスタマイズ
        $list_data[] = [
            'url'  => home_url( '/特定のページ/' ),
            'name' => '特定のページ',
        ];
    }
    
    return $list_data;
});

add_filter( 'swell_post_list_404_text', function( $text ) {
    // カスタマイズした404メッセージ
    $custom_message = '申し訳ございません。お探しの記事は見つかりませんでした。';

    // フィルターを通してカスタマイズしたメッセージを返す
    return '<p>' . esc_html( $custom_message ) . '</p>';
});

add_filter( 'swell_posts_404_text', function( $text ) {
    return '<p>ご指定の条件に一致する記事はありませんでした。</p>';
});

add_filter( 'swell_related_post_404_text', function( $text ) {
    return '<p>関連記事はありません。</p>';
});

add_filter( 'swell_sns_cta_message', function( $cta_message ) {
    // カスタマイズしたメッセージを返す
    return '<br><i class="icon-thumb_up"></i> 記事を楽しんでいただけたら、シェアしてください！';
});

add_filter( 'swell_parts_catchphrase', function( $catchphrase ) {
    // 追加したいテキスト
    $additional_text = ' - Welcome to Our Site!';

    // キャッチフレーズにテキストを追加
    $catchphrase .= $additional_text;

    return $catchphrase;
} );

add_filter( 'swell_parts_page_title', function( $title_html, $page_id ) {
    // 追加したいテキスト
    $additional_text = ' - Custom Text';

    // タイトルにテキストを追加
    $title_html .= $additional_text;

    return $title_html;
}, 10, 2 );

add_filter( 'swell_parts_term_title', function( $title_html, $term_id ) {
    // 追加したいテキスト
    $additional_text = ' - Custom Text';

    // タイトルにテキストを追加
    $title_html .= $additional_text;

    return $title_html;
}, 10, 2 );

add_filter( 'swell_body_attrs', function( $attrs ) {
    return $attrs . ' data-custom-attr="value"'; // カスタム属性を追加
} );

add_filter( 'swell_content_attrs', function( $attrs ) {
    return $attrs . ' data-custom-attr="value"'; // カスタム属性を追加
} );

add_filter( 'swell_frame_class', function( $frame_class ) {
    // 追加したいクラス名を設定
    $additional_class = 'my-custom-frame-class';

    // クラス名を追加
    $frame_class .= ' ' . $additional_class;

    return $frame_class;
} );

add_filter( 'swell_head_logo', function( $logo_url ) {
    // カスタムロゴURLを指定する
    return 'https://example.com/path/to/custom-logo.png';
} );

add_filter( 'swell_head_logo_sizes', function( $sizes ) {
    // カスタム画像サイズを指定する
    return '(max-width: 600px) 50vw, 300px';
} );

add_filter( 'swell_head_logo_top', function( $logo_top_url ) {
    // カスタムロゴURLを指定する
    return 'https://example.com/path/to/custom-logo-top.png';
} );

add_filter( 'swell_get_sns_cta_data', function( $data ) {
    // Twitterのフォローボタンを非表示にする
    $data['tw_id'] = '';

    // FacebookのいいねボックスのURLを変更する
    $data['fb_url'] = 'https://www.facebook.com/yourpage';

    // InstagramのフォローボタンのIDを変更する
    $data['insta_id'] = 'yourinstagramid';

    return $data;
});

add_filter( 'swell_is_show_comments', '__return_false' );

add_filter( 'swell_is_show_index', function( $is_show ) {
    if ( is_single() && has_category( '特定のカテゴリー', get_the_ID() ) ) {
        return true; // 特定のカテゴリーの投稿ページで目次を表示
    }
    return $is_show; // それ以外のページはデフォルトの設定に従う
} );

add_filter( 'swell_is_show_page_links', '__return_true' );

add_filter( 'swell_is_show_pickup_banner', '__return_true' );

add_filter( 'swell_is_show_sidebar', function( $is_show ) {
    if ( is_archive() ) {
        return true; // アーカイブページでサイドバーを表示
    }
    return $is_show; // それ以外のページはデフォルトの設定に従う
} );

add_filter( 'swell_is_show_toc_ad', function( $is_show ) {
    if ( is_single() ) {
        return true; // 投稿ページで目次広告を表示
    }
    return $is_show; // それ以外のページはデフォルトの設定に従う
} );

add_filter( 'swell_is_show_ttltop', function( $is_show ) {
    if ( is_single() && has_category( '特定のカテゴリー', get_the_ID() ) ) {
        return true; // 特定のカテゴリーの投稿ページでページタイトルを上部に表示
    }
    return $is_show; // それ以外のページはデフォルトの設定に従う
} );

add_filter( 'swell_lp_content_attrs', function( $attrs ) {
    return $attrs . ' data-custom-attr="value"'; // カスタム属性を追加
} );

add_filter( 'swell_parts_head_logo', function( $logo_html, $is_fixbar ) {
    // 追加したいクラス
    $additional_class = 'custom-logo-class';

    // ロゴの HTML にクラスを追加
    $logo_html = str_replace( 'c-headLogo', 'c-headLogo ' . $additional_class, $logo_html );

    return $logo_html;
}, 10, 2 );

add_filter( 'swell_parts_scroll_arrow', function( $arrow_html ) {
    // 新しい色を設定
    $new_color = '#ff0000';

    // アローの色を変更
    $arrow_html = str_replace( 'currentColor', $new_color, $arrow_html );

    return $arrow_html;
} );

add_filter( 'swell_parts_toc_ad', function( $toc_adcode ) {
    if ( is_single() && has_category( '特定のカテゴリー', get_the_ID() ) ) {
        // カスタム広告コード
        $custom_adcode = '<div class="custom-ad">ここにカスタム広告コードを挿入</div>';
        return $custom_adcode;
    }
    return $toc_adcode;
} );

add_filter( 'swell_post_content_class', function( $class ) {
    // 追加したいクラスを指定
    $additional_class = 'custom-content-class';
    
    // 既存のクラスに追加クラスを追加
    $class .= ' ' . $additional_class;
    
    return $class;
});

add_filter( 'swell_root_attrs', function( $attrs ) {
    return $attrs . ' data-custom-attr="value"'; // カスタム属性を追加
} );

add_filter( 'swell_table_scroll_hint', function( $hint_src ) {
    return '<div class="c-scrollHint"><span>' . esc_html__( '右にスクロール', 'swell' ) . ' <i class="icon-arrow_right"></i></span></div>';
} );

add_filter( 'swell_get_svg', function( $svg, $icon_name, $attrs ) {
    // カスタマイズしたいアイコン名を指定
    if ( 'custom-icon' === $icon_name ) {
        // カスタム SVG パスを設定
        $custom_path = '<path d="..."></path>';
        // カスタム SVG を生成
        $svg = '<svg xmlns="http://www.w3.org/2000/svg" class="swl-svg-custom-icon" width="1em" height="1em" viewBox="0 0 48 48" role="img" aria-hidden="true" focusable="false">' . $custom_path . '</svg>';
    }
    return $svg;
}, 10, 3 );

add_filter( 'swell_do_blog_parts', function( $blog_parts ) {
    // カスタムブログパーツを追加
    $blog_parts['custom_part'] = '<div class="custom-blog-part">This is a custom blog part.</div>';

    return $blog_parts;
} );

add_filter( 'swell_show_term_navigation', function( $show_term_navigation, $taxonomy, $term_id ) {
    // 特定のカテゴリーIDを指定
    $specific_category_id = 123;

    if ( 'category' === $taxonomy && $specific_category_id === $term_id ) {
        return true; // 階層リストを表示
    }

    return false; // それ以外の場合は階層リストを非表示
}, 10, 3 );

add_filter( 'swell_blocks_rss_cache_time', function( $cache_time, $rss_url ) {
    return HOUR_IN_SECONDS; // キャッシュ時間を1時間に設定
}, 10, 2 );

add_filter( 'swell_delay_js_list', function( $delay_js_list ) {
    // 「example.js」というキーワードを追加
    $delay_js_list[] = 'example.js';
    // 「my-script」というキーワードを追加
    $delay_js_list[] = 'my-script';
    return $delay_js_list;
} );

add_filter( 'swell_delay_js_prevent_pages', function( $prevent_pages ) {
    // 「example-page」というURLの一部を持つページを追加
    $prevent_pages[] = 'example-page';
    // 「contact」というURLの一部を持つページを追加
    $prevent_pages[] = 'contact';
    return $prevent_pages;
} );

add_filter( 'swell_hide_fse_blocks', '__return_true' );

add_filter( 'swell_infobar_data', function( $info_data ) {
    // インフォメーションバーのテキストをカスタマイズ
    $info_data['text'] = '新しいお知らせがあります！';

    // インフォメーションバーのURLをカスタマイズ
    $info_data['url'] = 'https://example.com/news';

    return $info_data;
});

add_filter( 'swell_is_separate_css', '__return_false' );

add_filter( 'swell_remove_url_to_card', function( $remove_url_to_card ) {
    if ( is_single() && has_category( '特定のカテゴリー', get_the_ID() ) ) {
        return true; // 特定のカテゴリーの投稿ページでは URL をブログカードに変換しない
    }
    return $remove_url_to_card;
} );

add_filter( 'swell_update_json_name', function( $json_name ) {
    return 'my_update.json'; // JSON ファイルの名前を変更
} );

add_filter( 'swell_get_archive_data', function( $data ) {
    // カスタムタクソノミーアーカイブの場合、タイトルを変更する
    if ( 'tax' === $data['type'] ) {
        $data['title'] = 'カスタムタクソノミー: ' . $data['title'];
    }
    return $data;
} );

add_filter( 'swell_get_search_terms_status', function( $return_text ) {
    // 検索結果ページの絞り込み状況を取得
    $searched_status = SWELL_Theme\Utility\Get::get_searched_status();

    // 絞り込み条件があれば表示用テキストを追加
    if ( ! empty( $searched_status ) ) {
        $return_text .= '<div class="searched-status">' . esc_html( $searched_status ) . '</div>';
    }

    return $return_text;
} );

add_filter( 'swell_get_search_title', function( $s_title ) {
    // 検索結果ページのタイトルを変更する
    $s_title = 'カスタマイズされた検索結果: ' . $s_title;

    return $s_title;
});

add_filter( 'swell_get_tax_of_post_type', function( $the_tax, $the_post_type ) {
    // カスタム投稿タイプ 'my_custom_post_type' に紐付いたタクソノミー 'my_custom_taxonomy' を取得
    if ( 'my_custom_post_type' === $the_post_type ) {
        return 'my_custom_taxonomy';
    }
    return $the_tax; // それ以外の投稿タイプはデフォルトのタクソノミーを返す
}, 10, 2 );

add_filter( 'swell_get_the_term_links', function( $thelist, $post_id, $tax ) {
    // 追加したいクラス名
    $additional_class = 'custom-class';

    // リンクにクラスを追加
    $thelist = str_replace( 'c-categoryList__link', 'c-categoryList__link ' . $additional_class, $thelist );

    return $thelist;
}, 10, 3 );

add_filter( 'swell_get_the_terms_data', function( $terms_data ) {
    foreach ( $terms_data as &$term_data ) {
        // 例えば、特定のカテゴリー名を変更したい場合
        if ( '旧カテゴリー名' === $term_data['name'] ) {
            $term_data['name'] = '新カテゴリー名';
        }
    }
    return $terms_data;
});

add_filter( 'swell_pager_range', function( $range ) {
    // 左右に表示するページ数の範囲を3に設定
    return 3;
});

add_filter( 'swell_pickup_post_args', function( $query_args ) {
    // カスタム投稿タイプ「my_post_type」の投稿を表示
    $query_args['post_type'] = 'my_post_type';

    // タグID「123」を持つ投稿を除外
    $query_args['tag__not_in'] = [123];

    // 投稿日が過去7日以内の投稿のみ表示
    $query_args['date_query'] = [
        [
            'after' => '7 days ago',
        ],
    ];

    return $query_args;
});

add_filter( 'swell_post_list_cat_data', function( $cat_data, $post_id ) {
    // カスタマイズしたい条件に応じてカテゴリー情報を変更
    if ( 特定の条件 ) {
        $cat_data['id']   = 新しいカテゴリーID;
        $cat_data['name'] = '新しいカテゴリー名';
    }
    return $cat_data;
}, 10, 2 );

add_filter( 'swell_post_list_type_on_archive', function( $list_type, $archive_data ) {
    // 特定のカテゴリーのアーカイブページの場合
    if ( is_category( '特定のカテゴリー' ) ) {
        // リストタイプを 'card' に変更
        $list_type = 'card';
    }
    // 特定のタグのアーカイブページの場合
    elseif ( is_tag( '特定のタグ' ) && $archive_data['title'] === 'タグのタイトル' ) {
        // リストタイプを 'list' に変更
        $list_type = 'list';
    }

    // 変更されたリストタイプを返す
    return $list_type;
}, 10, 2 );

add_filter( 'swell_post_list_type_on_search', function( $list_type ) {
    return 'card';
});

add_filter( 'swell_post_list_type_on_term', function( $list_type, $term_id ) {
    // 特定のカテゴリーのアーカイブページの場合
    if ( 'category' === get_term( $term_id )->taxonomy && '特定のカテゴリースラッグ' === get_term( $term_id )->slug ) {
        // リストタイプを 'grid' に変更
        $list_type = 'grid';
    }
    
    return $list_type;
}, 10, 2 );

add_filter( 'swell_related_post_args', function( $args ) {
    $args['meta_query'] = [
        [
            'key'     => 'custom_field_key',
            'value'   => 'custom_value',
            'compare' => '=',
        ],
    ];
    return $args;
});

add_filter( 'swell_related_post_maxnum', function( $maxnum ) {
    return 5;
});

add_filter( 'swell_toc_target', function( $meta ) {
    return 'h3';
} );

add_filter( 'swell_twitter_to_x', function( $value ) {
    // Twitter アイコンを Twitter X アイコンに置き換える
    return true;
});

add_filter( 'swell_code_meta_screens', function( $screens ) {
    return ['post', 'custom_post_type']; // 'post' と 'custom_post_type' にのみメタボックスを表示
} );

add_filter( 'swell_custom_format_sets', function( $custom_format_sets ) {
    $custom_format_sets[] = [
        [
            'type'       => 'loos/bg-color',
            'attributes' => [ 'class' => 'swl-bg-color has-custom-background-color' ],
        ],
        [
            'type'       => 'loos/marker',
            'attributes' => [ 'class' => 'mark_custom' ],
        ],
        [
            'type'       => 'loos/text-color',
            'attributes' => [ 'class' => 'has-custom-color' ],
        ],
        [
            'type'       => 'loos/font-size',
            'attributes' => [ 'class' => 'u-fz-custom' ],
        ],
        [
            'type'      => 'core/bold',
        ],
        [
            'type'      => 'core/italic',
        ],
    ];

    return $custom_format_sets;
} );

add_filter( 'swell_custom_formats', function( $custom_formats ) {
    $custom_formats[] = [
        'name'      => 'loos/custom-format-example',
        'title'     => 'カスタム書式例',
        'tagName'   => 'span',
        'className' => 'custom-format-example',
    ];

    return $custom_formats;
} );

add_filter( 'swell_side_meta_screens', function( $screens ) {
    return ['post', 'custom_post_type']; // 'post' と 'custom_post_type' にのみメタボックスを表示
} );

add_filter( 'swell_term_meta_screens', function( $screens ) {
    $screens[] = 'custom_taxonomy';
    return $screens;
} );