the_title()

the_title()

the_title() 関数は、WordPressのテンプレートタグの一つで、現在の投稿やページのタイトルを表示するために使用されます。この関数は、主にループ内で使用され、タイトルをHTML出力する役割を担います。

目次

基本的な記述方法

<?php the_title(); ?>

基本的な記述では、現在の投稿やページのタイトルがそのまま出力されます。

パラメータ

the_title( string $before = '', string $after = '', bool $echo = true )

$before

タイトルの前に追加される文字列を指定します。
<h1><a href="#">などのHTMLタグを指定できます。

$after

タイトルの後に追加される文字列を指定します。
</h1></a>などのHTMLタグを指定できます。

$echo

デフォルト値true
タイトルを出力するか、関数がタイトルを返すかを指定します。
trueの場合はタイトルを直接出力し、falseの場合はタイトルを返します。

記述方法

基本的な使用例

<?php the_title(); ?>

この例では、現在の投稿やページのタイトルがそのまま表示されます。

HTMLタグを含めた使用例

<?php the_title( '<h1>', '</h1>' ); ?>

この例では、タイトルが<h1>タグで囲まれて表示されます。

リンク付きタイトルの表示

<?php the_title( '<a href="' . get_permalink() . '">', '</a>' ); ?>

この例では、タイトルが投稿やページへのリンクとして表示されます。

タイトルを変数に格納する

$title = the_title( '', '', false );
echo '<h1>' . $title . '</h1>';

この例では、$echoパラメータをfalseに設定し、タイトルを変数に格納してから表示しています。

タイトルのカスタマイズ

<?php
if ( is_single() ) {
    the_title( '<h1>', '</h1>' );
} else {
    the_title( '<h2>', '</h2>' );
}
?>

このコードでは、シングル投稿ページではタイトルを <h1> タグで、それ以外のページでは <h2> タグで表示します。

投稿リストの表示

<?php if ( have_posts() ) : ?>
    <ul>
        <?php while ( have_posts() ) : the_post(); ?>
            <li>
                <?php the_title( '<h3><a href="' . esc_url( get_permalink() ) . '">', '</a></h3>' ); ?>
            </li>
        <?php endwhile; ?>
    </ul>
<?php else : ?>
    <p>投稿が見つかりませんでした。</p>
<?php endif; ?>

テーマのアーカイブページやカテゴリーページで投稿のリストを表示する例です。この例では、the_title() を使って各投稿のタイトルを <h3> タグで囲み、リンク付きで表示しています。while ループ内でタイトルを出力し、投稿がない場合はメッセージを表示します。

サイドバーのウィジェットでの使用例

<?php
$args = array(
    'numberposts' => 5,
    'post_status' => 'publish',
);

$recent_posts = wp_get_recent_posts( $args );
foreach( $recent_posts as $post ) : ?>
    <div class="recent-post">
        <h4><a href="<?php echo get_permalink($post['ID']) ?>">
            <?php echo esc_html($post['post_title']); ?>
        </a></h4>
    </div>
<?php endforeach; wp_reset_query(); ?>

サイドバーウィジェットで最新の投稿タイトルを表示する例です。この例では、wp_get_recent_posts() 関数を使って最新の投稿を取得し、各投稿のタイトルをリンク付きで表示しています。the_title() の代わりに、$post['post_title'] を使用してタイトルを表示していますが、基本的な考え方は同じです。

get_the_title()

the_title()の代わりにget_the_title()関数を使用することもできます。get_the_title()はタイトルを返すだけで出力しないため、カスタム処理を行いたい場合に便利です。

<?php
$title = get_the_title();
echo '<h1>' . $title . '</h1>';
?>

利用ポイント

SEO対策

タイトルはSEOにおいて重要な要素です。適切なタグ(例: <h1>, <h2>)を使用してタイトルを囲むことで、検索エンジンにとって重要な情報として認識されます。

アクセシビリティ

タイトルはユーザーにとっても重要な情報です。適切なタグと構造を使用することで、画面リーダーなどの支援技術を利用するユーザーにも理解しやすいページを提供できます。

テーマ開発

テーマを開発する際には、the_title() を適切に使用して各投稿やページのタイトルを表示することが求められます。特にループ内での使用が一般的です。

the_title() は、WordPressテーマ開発において非常に重要な関数です。簡単に現在の投稿やページのタイトルを表示することができ、オプションのパラメータを使って柔軟にカスタマイズすることも可能です。適切に使用することで、SEOやアクセシビリティの向上に寄与し、ユーザーにとって使いやすいサイトを作成することができます。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

初めてホームページを作成したのは1996年。
2000年よりフリーランスで主に中小企業、学校、各種公的団体、個人事業主のWordPressを活用したホームページ制作を行っています。WordPressテーマはそれぞれのクライアントに合わせて作成しています。
WordPressを活用したサイト運営のための情報発信をしていきます。

目次