記事のパーマリンク(URL)を表示します。WordPressループの中で使います。
the_permalink();| 引数 | 必須/任意 | 引数に指定するもの |
|---|---|---|
| 第1引数 $post | 任意 | 判定したい記事のID (整数)/ オブジェクト初期値: 現在の記事オブジェクト |
【引数とは】
テンプレートタグ(=関数)を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。
【引数について】
【オブジェクトとは?】
オブジェクトとはデータの集合体です。例えば1つの記事には、記事の公開日、タイトル、本文など様々なデータがあります。それらを1つのデータにまとめたものがオブジェクトです。WordPressに関わらず、オブジェクトはプログラミングで一般的に使われるデータの集合体を示す言葉です。
【現在の投稿/記事オブジェクトとは?】
現在処理対象となっている投稿/記事オブジェクト(各投稿や各固定ページのオブジェクト)のことを指します。WordPressはリクエストされたページを表示するために、必要なデータをデータベースから取得した後、該当するデータを処理対象としてセットします。その現在セットされている投稿/記事オブジェクトのことを指しますが、詳しい理解には、「WordPressのループ」(+メインクエリ、サブクエリ)を理解する必要があります。
下記例ではタイトルにリンクを設定しています。(WordPressループの中で使います)
<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>WordPressループで記事の一覧を表示するコード例です。
<?php if (have_posts()) : ?>
<ul class="cards">
<?php while (have_posts()): ?>
<?php the_post(); ?>
<li class="cards__item card">
<a class="card__link" href="<?php the_permalink(); ?>">
<div class="card__data">
<div class="card__img">
<?php if (has_post_thumbnail()) : ?>
<?php the_post_thumbnail(); ?>
<?php else: ?>
<img src="<?php echo esc_url(get_theme_file_uri('/img/noimage.jpg')); ?>" alt="">
<?php endif; ?>
</div>
<div class="card__date"><?php echo get_the_date('') ?></div>
<div class="card__title"><?php the_title(); ?></div>
</div>
</a>
</li>
<?php endwhile; ?>
</ul>
<?php endif; ?>※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。