get_edit_post_link() – Function | Developer.WordPress.org

Retrieves the edit post link for post.

Description

Can be used within the WordPress loop or outside of it. Can be used with pages, posts, attachments, revisions, global styles, templates, and template parts.

Parameters

$postint|WP_Postoptional: Post ID or post object. Default is the global $post.
$contextstringoptional: How to output the '&' character. Default '&'.
Default:'display'

Return

string|null The edit post link for the given post. Null if the post type does not exist or does not allow an editing UI.

Source

function get_edit_post_link( $post = 0, $context = 'display' ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return;
	}

	if ( 'revision' === $post->post_type ) {
		$action = '';
	} elseif ( 'display' === $context ) {
		$action = '&amp;action=edit';
	} else {
		$action = '&action=edit';
	}

	$post_type_object = get_post_type_object( $post->post_type );

	if ( ! $post_type_object ) {
		return;
	}

	if ( ! current_user_can( 'edit_post', $post->ID ) ) {
		return;
	}

	$link = '';

	if ( 'wp_template' === $post->post_type || 'wp_template_part' === $post->post_type ) {
		$slug = urlencode( get_stylesheet() . '//' . $post->post_name );
		$link = admin_url( sprintf( $post_type_object->_edit_link, $post->post_type, $slug ) );
	} elseif ( 'wp_navigation' === $post->post_type ) {
		$link = admin_url( sprintf( $post_type_object->_edit_link, (string) $post->ID ) );
	} elseif ( $post_type_object->_edit_link ) {
		$link = admin_url( sprintf( $post_type_object->_edit_link . $action, $post->ID ) );
	}

	/**
	 * Filters the post edit link.
	 *
	 * @since 2.3.0
	 *
	 * @param string $link    The edit link.
	 * @param int    $post_id Post ID.
	 * @param string $context The link context. If set to 'display' then ampersands
	 *                        are encoded.
	 */
	return apply_filters( 'get_edit_post_link', $link, $post->ID, $context );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘get_edit_post_link’, string $link, int $post_id, string $context ): Filters the post edit link.

Uses	Description
get_stylesheet()`wp-includes/theme.php`	Retrieves name of the current stylesheet.
admin_url()`wp-includes/link-template.php`	Retrieves the URL to the admin area for the current site.
current_user_can()`wp-includes/capabilities.php`	Returns whether the current user has the specified capability.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 2 more Show less

Used by	Description
wp_render_empty_block_template_warning()`wp-includes/block-template.php`	Renders a warning screen for empty block templates.
WP_Media_List_Table::column_parent()`wp-admin/includes/class-wp-media-list-table.php`	Handles the parent column output.
WP_Media_List_Table::column_title()`wp-admin/includes/class-wp-media-list-table.php`	Handles the title column output.
post_submit_meta_box()`wp-admin/includes/meta-boxes.php`	Displays post submit form fields.
WP_Media_List_Table::_get_row_actions()`wp-admin/includes/class-wp-media-list-table.php`
WP_Comments_List_Table::column_response()`wp-admin/includes/class-wp-comments-list-table.php`
edit_post_link()`wp-includes/link-template.php`	Displays the edit post link for post.
wp_post_revision_title()`wp-includes/post-template.php`	Retrieves formatted date timestamp of a revision (linked to that revisions’s page).
wp_post_revision_title_expanded()`wp-includes/post-template.php`	Retrieves formatted date timestamp of a revision (linked to that revisions’s page).

Show 4 more Show less

Changelog

Version	Description
6.3.0	Adds custom link for wp_navigation post types. Adds custom links for wp_template_part and wp_template post types.
2.3.0	Introduced.

User Contributed Notes

Skip to note 3 content

jakeparis 9 months ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

These docs are confusing about the second parameter. $context defaults to “display”, which means the ampersand is encoded with &action=edit. If you pass any other value (doesn’t matter what), the ampersond is not encoded, so the return value is &action=edit

Log in to add feedback

Ahmed El-Atab 4 years ago

// Hide the Edit Post Link from Non Administrators Start.

function wpdocs_remove_get_edit_post_link( $link ) {
    if ( current_user_can( 'administrator' ) ) {
        return $link;
    }

    return null;
}

add_filter( 'get_edit_post_link', 'wpdocs_remove_get_edit_post_link' );

// Hide the Edit Post Link from Non Administrators End.

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

In this article