the_permalink

(1.2.0以降)
the_permalink - パーマリンクを表示する

説明

void the_permalink( [ mixed $post = 0 ] )
現在の投稿データのパーマリンクを表示する。

パラメータ

  • $post
    [4.4.0]投稿IDまたは投稿情報（オブジェクト）を指定（省略時は0）。

返り値

返り値はありません。

注意

事前にthe_post関数を使用しておく必要がある。

4.4.0で本関数にパラメータ$postが追加され、'the_permalink'フィルターにも追加された。

使用例

  • パーマリンクを表示する。
    <a href="<?php the_permalink(); ?>" rel="bookmark"><?php the_title(); ?></a>

フィルター

[1.5.0]パーマリンクを表示する直前に'the_permalink'フィルターを呼び出す。パラメータ$permalinkにはget_permalink関数で取得したパーマリンクが格納されている。[4.4.0]パラメータ$postには本関数が受け取った内容が格納されている。 
echo esc_url( apply_filters( 'the_permalink', $permalink, $post ) );

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/link-template.php

関連

  • esc_url - URL文字列をクリーニングする
  • get_permalink - 投稿情報のパーマリンクを取得する
  • the_post - 投稿データをロードする
  • trackback_url - トラックバックURLを表示する
  • $post - 投稿情報

参考

Code Reference: the_permalink

お勧めコンテンツ

日本語が含まれていないコメントを無効化する（2012年1月31日 登録）

日本のユーザーを対象にサービス（情報）展開しているサイトの場合、英文のみのコメントはあまりうれしくない。ましてやスパムコメントの対応は時間の無駄でしかない。そんなわけで、日本語を含んでいないコメントを無効化することにした。

index.htmlでアーカイブページを表示させる（2011年10月14日 登録）

静的なサイトでは、各ディレクトリにindex.htmlファイルを置き、そのディレクトリの内容を紹介することが多い。WordPressで構築したサイトも同様にできないかと考え、試行錯誤してみた（こんなことを考えてるのは自分だけだろうか！？）。

管理画面の'アイキャッチ画像'を'写真'に変える（2013年1月23日 登録）

クライアント向けに専用のテーマを提供する際、稀に管理画面内の用語の変更を依頼されることがある。今回は、'アイキャッチ画像'だとわかりにくいので'写真'に変えてほしいということだった。

3.2標準テーマ「Twenty Eleven」は投稿フォーマットに着目（2011年7月6日 登録）

新テーマ「Twenty Eleven」のトップページでは、投稿フォーマットに応じて表示を切り替える仕組みが提案されている。ここでは、その投稿フォームの活用方法を簡単に紹介する。

Paste JSON text：プラグイン作ってみました（2012年1月19日 登録）

動作検証用のサーバーと本番サーバーで投稿データの同期作業（コピー＆ペースト）を支援するプラグインです。動作検証用のサーバーで投稿記事をJSONテキストに変換してクリップボードにコピー。本番サーバーの新規投稿ページでクリップボードにコピーしたJSONテキストをペーストして、投稿記事のコピー＆ペーストを実現します。複数サーバー間で投稿記事の同期を行っている方は、お試しあれ。

最終更新日時 : 2015-12-15 17:05