get_edit_post_link() の使い方|説明・引数・注意点

説明

get_edit_post_link() は、投稿の編集画面へのURLを返す関数です。

基本構文

get_edit_post_link( int|WP_Post $post = 0, string $context = 'display' ): string|null

引数

  • $post:投稿IDまたはオブジェクト
  • $context:display または raw

戻り値

編集画面のURL。権限がなければ null。

使い方(サンプル)

$url = get_edit_post_link( 123 );

注意点

  • 編集権限のないユーザーには null が返ります。

実務での使いどころ

  • 投稿の編集画面へのリンクを、ログイン中のユーザーにだけ出すとき。
  • リンクのHTMLを自分で組み立てたいとき(デザインに合わせる場合)。

よくあるミスと対処

  • 編集の権限がないユーザーには、null が返る。確認せずに出力すると、空のリンクになる。
  • 出力時に、esc_url() を通していない。

NG例

echo '<a href="' . get_edit_post_link() . '">編集</a>'; // 権限がないと、空のリンクになる

OK例

$link = get_edit_post_link();
if ( $link ) {
	echo '<a href="' . esc_url( $link ) . '">編集</a>';
}

使い分け早見表

関数 返すもの
get_edit_post_link() 編集画面のURL(権限がなければ null)
edit_post_link() 編集リンクのHTMLを出力
admin_url() 管理画面のURL

関連項目

edit_post_link()、admin_url()、edit_post_link()

公式リファレンス:get_edit_post_link() | Function | WordPress Developer Resources

コメント

タイトルとURLをコピーしました