プラグインElementorのelementor/frontend/google_font_subsetsフィルタの使用方法・解説

概要

elementor/frontend/google_font_subsets フィルタは、ElementorプラグインにおいてGoogleフォントのサブセットを操作するために使用されます。このフィルタを使用することで、特定のフォントセットを追加したり、削除したりすることができます。多言語対応のウェブサイトや特定の文化圏向けのデザインを考慮して、フォントのサブセットを変更する際によく利用されるフィルタです。

よく使われる機能

特定の言語や文字セットに基づくフォントの選択
フォントの読み込み時間の短縮
タイポグラフィの一貫性を保つ
アクセシビリティ向上のために必要なフォントを指定
多言語サイトでのフォントの適切な管理
クライアントの要望に基づく特定のスタイルの強化

構文

add_filter('elementor/frontend/google_font_subsets', 'custom_google_font_subsets');

パラメータ

$subsets (配列)：Googleフォントのサブセットを含む配列。

戻り値

変更後のサブセットを含む配列。

使用可能なバージョン

Elementor: 2.0.0以上
WordPress: 4.0以上

この関数のアクションでの使用可能性

アクション名	使用例
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init
register_sidebar
wp_loaded
send_headers
parse_query
pre_get_posts
wp
template_redirect
get_header
wp_head

サンプルコード

サンプルコード1

add_filter('elementor/frontend/google_font_subsets', function($subsets) {
    $subsets[] = 'latin-ext';
    return $subsets;
});

このコードは、Googleフォントのサブセットに「latin-ext」を追加します。これにより、ラテン文字以外の特定の文字が表示できるフォントセットを提供します。

サンプルコード2

add_filter('elementor/frontend/google_font_subsets', function($subsets) {
    if (!in_array('cyrillic', $subsets)) {
        $subsets[] = 'cyrillic';
    }
    return $subsets;
});

このコードは、Googleフォントのサブセットに「cyrillic」を追加するものです。これにより、キリル文字に対応したフォントが使用できるようになります。

サンプルコード3

add_filter('elementor/frontend/google_font_subsets', function($subsets) {
    return array_unique(array_merge($subsets, ['greek']));
});

この例では、既存のサブセットに「greek」を追加し、重複を排除しています。ギリシャ語のサポートが必要な場合に使用されます。

サンプルコード4

add_filter('elementor/frontend/google_font_subsets', function($subsets) {
     return ['latin', 'cyrillic', 'greek', 'latin-ext'];
});

このコードは、Googleフォントのサブセットを指定の配列に固定します。特定の言語サポートを必要とするデザイン時に便利です。

サンプルコード5

add_filter('elementor/frontend/google_font_subsets', function($subsets) {
    if (apply_filters('enable_arabic_support', false)) {
        $subsets[] = 'arabic';
    }
    return $subsets;
});

このコードは、カスタムフィルタを用いてアラビア語サポートが有効な場合に「arabic」をサブセットに追加します。条件付きでフォントサブセットを適用する方法を示しています。

概要