get_post_permalink()


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

構文

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

引数の説明:

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

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

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

<?php echo get_post_permalink(); ?>

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

指定した投稿IDのパーマリンクを取得します。

<?php echo get_post_permalink( get_the_ID() ); ?>

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

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

<?php echo get_post_permalink( get_post( 123 ) ); ?>

例4: パーマリンクにスラッグを含める

パーマリンクに投稿スラッグを含めて取得します。

<?php echo get_post_permalink( get_the_ID(), true ); ?>

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

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

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

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

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

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

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

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

<?php echo wp_trim_words( get_post_permalink(), 5, '...' ); ?>

例8: パーマリンクをカスタムクエリで取得

カスタムクエリを使用してパーマリンクを取得します。

<?php $query = new WP_Query( array( 'post_type' => 'post' ) ); if ( $query->have_posts() ) { while ( $query->have_posts() ) { $query->the_post(); echo get_post_permalink(); } } wp_reset_postdata(); ?>

注意点

  • 投稿IDが存在しない場合、関数はfalseを返します。
  • パーマリンクが設定されていない場合、デフォルトのURLが返されます。
  • パーマリンクをカスタマイズする際は、パーマリンク設定が正しく構成されていることを確認してください。

関連機能：