get_the_permalink()


WordPressのget_the_permalink()関数は、特定の投稿やページのパーマリンク（URL）を取得するために使用されます。

構文

get_the_permalink( int|WP_Post $post = 0, bool $leavename = false );

引数の説明:

  • $post(int|WP_Post) — パーマリンクを取得したい投稿のIDまたはWP_Postオブジェクト。デフォルトは0で、現在の投稿を指します。
  • $leavename(bool) — パーマリンクに投稿スラッグを含めるかどうかを指定します。デフォルトはfalseで、スラッグを含めます。

例1: 現在の投稿のパーマリンクを取得

現在表示されている投稿のパーマリンクを取得します。

<?php echo get_the_permalink(); ?>

例2: 特定の投稿のパーマリンクを取得

IDが5の投稿のパーマリンクを取得します。

<?php echo get_the_permalink(5); ?>

例3: カスタム投稿タイプのパーマリンクを取得

カスタム投稿タイプの投稿のパーマリンクを取得します。

<?php echo get_the_permalink(get_post(7)); ?>

例4: パーマリンクをリンクとして表示

パーマリンクをHTMLのリンクとして表示します。

<a href="<?php echo get_the_permalink(); ?>">この投稿へのリンク</a>

例5: パーマリンクを新しいタブで開く

パーマリンクを新しいタブで開くリンクを作成します。

<a href="<?php echo get_the_permalink(); ?>" target="_blank">新しいタブで開く</a>

例6: パーマリンクにクエリパラメータを追加

パーマリンクにクエリパラメータを追加します。

<?php echo add_query_arg('ref', 'example', get_the_permalink()); ?>

例7: パーマリンクをボタンとして表示

パーマリンクをボタンとして表示します。

<button onclick="window.location.href='<?php echo get_the_permalink(); ?>'">投稿を見る</button>

例8: パーマリンクを短縮URLとして表示

パーマリンクを短縮URLとして表示します。

<?php echo wp_shortlink(get_the_permalink()); ?>

注意点:

  • パーマリンクを取得する際に、投稿が存在しない場合やパーマリンクが設定されていない場合、空の文字列が返されることがあります。
  • パーマリンクを直接出力する場合、エスケープ処理を忘れずに行いましょう。

関連機能：