ワードプレスのthe_archive_titleフィルタの使用方法・解説

概要

the_archive_titleフィルタは、アーカイブページのタイトルを表示する際に使用されるフィルタです。このフィルタを使用することで、アーカイブページのタイトルをカスタマイズすることができ、ユーザーが見やすく、理解しやすいタイトルを提供することが可能です。このフィルタは主に以下のような機能を実装する際に利用されます。

1. カスタム投稿タイプのアーカイブタイトルの変更
2. カテゴリーやタグアーカイブのタイトルの修正
3. 日付アーカイブのタイトルのスタイル変更
4. ユーザーの役割に基づくカスタマイズされたタイトル表示
5. ウェブサイトのブランディングに合わせたタイトルの書き換え
6. SEOの最適化を目的としたメタデータ追加
7. 翻訳対応のための文言変更
8. 特定の条件に基づく動的なタイトルの生成

構文

add_filter('get_the_archive_title', 'your_custom_function');

パラメータ

• $title: アーカイブタイトルの文字列。

戻り値

• カスタマイズされたアーカイブタイトルの文字列。

関連する関数

the_archive_titleの関連関数はこちら

このフィルタを使用可能なバージョン

• WordPress 4.4以降

コアファイルのパス

• wp-includes/general-template.php

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

アクション	使用可能性
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('get_the_archive_title', function($title) {
    if (is_post_type_archive('custom_post_type')) {
        return 'カスタム投稿のアーカイブ';
    }
    return $title;
});

このコードは、カスタム投稿タイプのアーカイブページのタイトルを「カスタム投稿のアーカイブ」に変更します。

サンプルコード2: カテゴリータイトルの前にカスタムテキスト追加

add_filter('get_the_archive_title', function($title) {
    if (is_category()) {
        return 'カテゴリー: ' . $title;
    }
    return $title;
});

この例では、カテゴリーアーカイブページのタイトルの前に「カテゴリー: 」というテキストを追加します。

サンプルコード3: タグアーカイブタイトルのカスタマイズ

add_filter('get_the_archive_title', function($title) {
    if (is_tag()) {
        return 'タグ: ' . $title;
    }
    return $title;
});

このコードは、タグアーカイブページのタイトルに「タグ: 」というプレフィックスを追加します。

サンプルコード4: 月別アーカイブのカスタマイズ

add_filter('get_the_archive_title', function($title) {
    if (is_month()) {
        return '月別アーカイブ: ' . $title;
    }
    return $title;
});

この例では、月別アーカイブページのタイトルに「月別アーカイブ: 」というテキストを追加します。

サンプルコード5: 特定条件に基づくカスタムタイトル

add_filter('get_the_archive_title', function($title) {
    if (is_date() && !is_author()) {
        return '投稿日: ' . $title;
    }
    return $title;
});

このコードは、日付アーカイブページにおいて、特定の条件が満たされた場合に「投稿日: 」というテキストを追加します。