wordpress 編集用リンクを出力する edit_post_link

2013年4月23日

現在の記事の管理画面へのリンク(編集用リンク)を出力するには、edit_post_link() を使用する。

ユーザが管理ページにログイン済みで編集権限がある場合のみ編集用リンクが表示され、ログインしていない場合や、編集権限がない場合は表示されない。

Codex にはループ内で使用しなければならない( It must be within The Loop. )とあるが、ループ外でも使えるみたいで、header.php など共通のテンプレートに記述する場合は、is_single() を使えば、個別ページの場合のみ表示することができる。但し、原則はループ内ということ。

Displays a link to edit the current post, if a user is logged in and allowed to edit the post. It must be within The Loop.

<?php if(is_single()) edit_post_link('この記事を編集','<p class="editlink">','</p>'); ?>
edit_post_link( $link, $before, $after, $id)
パラメータ(すべてオプション)
 $link (文字列): 記事編集画面リンクのラベルテキスト。デフォルトは __('Edit This')。
 $before (文字列): リンクの直前に出力するコードやテキスト。デフォルトは ''(空)。
 $after (文字列): リンクの直後に出力するコードやテキスト。デフォルトは ''(空)。
 $id(整数):投稿ID。デフォルトはなし。
戻り値:なし