get_edit_post_link( int|WP_Post $id, string $context = 'display' )

Retrieves the edit post link for post.

Description

Can be used within the ClassicPress loop or outside of it. Can be used with pages, posts, attachments, and revisions.

Parameters

$id

(Optional) Post ID or post object. Default is the global $post.

$context

(Optional) How to output the '&' character. Default '&'.

Default value: 'display'

Return

(string|null) The edit post link for the given post. null if the post type is invalid or does not allow an editing UI.

Source

File: wp-includes/link-template.php 

function get_edit_post_link( $id = 0, $context = 'display' ) {
	if ( ! $post = get_post( $id ) )
		return;

	if ( 'revision' === $post->post_type )
		$action = '';
	elseif ( 'display' == $context )
		$action = '&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;

	if ( $post_type_object->_edit_link ) {
		$link = admin_url( sprintf( $post_type_object->_edit_link . $action, $post->ID ) );
	} else {
		$link = '';
	}

	/**
	 * Filters the post edit link.
	 *
	 * @since WP-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 );
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/link-template.php: admin_url()

Retrieves the URL to the admin area for the current site.
wp-includes/link-template.php: get_edit_post_link

Filters the post edit link.
wp-includes/capabilities.php: current_user_can()

Whether the current user has a specific capability.
wp-includes/plugin.php: apply_filters()

Call the functions added to a filter hook.
wp-includes/post.php: get_post_type_object()

Retrieves a post type object by name.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.
Show 1 more use Hide more uses

Used By

Used By
Used By Description
wp-includes/media.php: wp_prepare_attachment_for_js()

Prepares an attachment post object for JS, where it is expected to be JSON-encoded and fit into an Attachment model.
wp-includes/admin-bar.php: wp_admin_bar_edit_menu()

Provide an edit link for posts and terms.
wp-includes/link-template.php: edit_post_link()

Displays the edit post link for post.
wp-includes/post-template.php: wp_post_revision_title()

Retrieve formatted date timestamp of a revision (linked to that revisions’s page).
wp-includes/post-template.php: wp_post_revision_title_expanded()

Retrieve formatted date timestamp of a revision (linked to that revisions’s page).
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::_get_row_actions()
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::column_title()

Handles the title column output.
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::column_parent()

Handles the parent column output.
wp-admin/includes/class-wp-comments-list-table.php: WP_Comments_List_Table::column_response()
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::column_title()

Handles the title column output.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::handle_row_actions()

Generates and displays row action links.
wp-admin/includes/meta-boxes.php: post_submit_meta_box()

Displays post submit form fields.
wp-admin/includes/post.php: redirect_post()

Redirect to previous page.
wp-admin/includes/post.php: _admin_notice_post_locked()

Outputs the HTML for the notice to say that someone else is editing or has taken over editing of this post.
wp-admin/includes/dashboard.php: wp_dashboard_recent_posts()

Generates Publishing Soon and Recently Published sections.
wp-admin/includes/dashboard.php: wp_dashboard_recent_drafts()

Show recent drafts of the user on the dashboard.
Show 11 more used by Hide more used by

Changelog

Changelog
Version Description
WP-2.3.0 Introduced.