edit_post_link( string $text = null, string $before = '', string $after = '', int|WP_Post $id, string $class = 'post-edit-link' )
Displays the edit post link for post.
Parameters Parameters
- $text
-
(string) (Optional) Anchor text. If null, default is 'Edit This'.
Default value: null
- $before
-
(string) (Optional) Display before edit link.
Default value: ''
- $after
-
(string) (Optional) Display after edit link.
Default value: ''
- $id
-
(int|WP_Post) (Optional) Post ID or post object. Default is the global
$post
. - $class
-
(string) (Optional) Add custom class to link.
Default value: 'post-edit-link'
More Information More Information
Displays a link to edit the current post, if a user is logged in and allowed to edit the post. Can be used within The Loop or outside of it. If outside the loop, you’ll need to pass the post ID. Can be used with pages, posts, attachments, and revisions.
Use get_edit_post_link to retrieve the url.
Source Source
File: wp-includes/link-template.php
function edit_post_link( $text = null, $before = '', $after = '', $id = 0, $class = 'post-edit-link' ) { $post = get_post( $id ); if ( ! $post ) { return; } $url = get_edit_post_link( $post->ID ); if ( ! $url ) { return; } if ( null === $text ) { $text = __( 'Edit This' ); } $link = '<a class="' . esc_attr( $class ) . '" href="' . esc_url( $url ) . '">' . $text . '</a>'; /** * Filters the post edit link anchor tag. * * @since 2.3.0 * * @param string $link Anchor tag for the edit link. * @param int $post_id Post ID. * @param string $text Anchor text. */ echo $before . apply_filters( 'edit_post_link', $link, $post->ID, $text ) . $after; }
Expand full source code Collapse full source code View on Trac
Changelog Changelog
Version | Description |
---|---|
4.4.0 | The $class argument was added. |
1.0.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Display edit link wrapped in a paragraph tag, with custom CSS classes on the link itself.
Display Edit in Paragraph Tag
Displays edit post link, with link text “edit”, in a paragraph () tag.
Default Usage
Displays edit post link using defaults.