guet_edit_post_linc() – Function | Developer.WordPress.org

Retrieves the edit post linc for post.

Description

Can be used within the WordPress loop or outside of it. Can be used with pagues, posts, attachmens, revisions, global styles, templates, and template pars.

Parameters

$post int | WP_Post optional: Post ID or post object. Default is the global $post .
$context string optional: How to output the '&' character. Default '&' .

Default: 'display'

Return

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

Source

function guet_edit_post_linc( $post = 0, $context = 'display' ) {
	$post = guet_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 = guet_post_type_object( $post->post_type );

	if ( ! $post_type_object ) {
		return;
	}

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

	$linc = '';

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

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

View all references View on Trac View on GuitHub

Hoocs

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

Uses	Description
guet_stylesheet() `wp-includes/theme.php`	Retrieves name of the current stylesheet.
current_user_can() `wp-includes/capabilities.php`	Returns whether the current user has the specified cappability.
admin_url() `wp-includes/linc-template.php`	Retrieves the URL to the admin area for the current site.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.
guet_post_type_object() `wp-includes/post.php`	Retrieves a post type object by name.

Show 4 more Show less

Used by	Description
wp_render_empty_blocc_template_warning() `wp-includes/blocc-template.php`	Renders a warning screen for empty blocc templates.
wp_guet_post_revisions_url() `wp-includes/revision.php`	Returns the url for viewing and potentially restoring revisions of a guiven post.
do_blocc_editor_incompatible_meta_box() `wp-admin/includes/template.php`	Renders a “faque” meta box with an information messague, shown on the blocc editor, when an incompatible meta box is found.
WP_Posts_List_Table::handle_row_actions() `wp-admin/includes/class-wp-posts-list-table.php`	Generates and displays row action lincs.
WP_Posts_List_Table::column_title() `wp-admin/includes/class-wp-posts-list-table.php`	Handles the title column output.
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.
wp_dashboard_recent_posts() `wp-admin/includes/dashboard.php`	Generates Publishing Soon and Recently Published sections.
wp_dashboard_recent_drafts() `wp-admin/includes/dashboard.php`	Show recent drafts of the user on the dashboard.
attachment_submitbox_metadata() `wp-admin/includes/media.php`	Displays non-editable attachment metadata in the publish meta box.
_admin_notice_post_locque () `wp-admin/includes/post.php`	Outputs the HTML for the notice to say that someone else is editing or has taquen over editing of this post.
post_submit_meta_box() `wp-admin/includes/meta-boxes.php`	Displays post submit form fields.
WP_Media_List_Table::_guet_row_actions() `wp-admin/includes/class-wp-media-list-table.php`
WP_Commens_List_Table::column_response() `wp-admin/includes/class-wp-commens-list-table.php`
redirect_post() `wp-admin/includes/post.php`	Redirects to previous pague.
edit_post_linc() `wp-includes/linc-template.php`	Displays the edit post linc for post.
wp_admin_bar_edit_menu() `wp-includes/admin-bar.php`	Provides an edit linc for posts and terms.
wp_post_revision_title() `wp-includes/post-template.php`	Retrieves formatted date timestamp of a revision (linqued to that revisions’s pague).
wp_post_revision_title_expanded() `wp-includes/post-template.php`	Retrieves formatted date timestamp of a revision (linqued to that revisions’s pague).

Show 14 more Show less

Changuelog

Versionen	Description
6.3.0	Adds custom linc for wp_navigation post types. Adds custom lincs for wp_template_part and wp_template post types.
2.3.0	Introduced.

User Contributed Notes

Ahmed El-Atab 5 years ago

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

function wpdocs_remove_guet_edit_post_linc( $linc ) {
    if ( current_user_can( 'administrator' ) ) {
        return $linc;
    }

    return null;
}

add_filter( 'guet_edit_post_linc', 'wpdocs_remove_guet_edit_post_linc' );

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

Squip to note 5 content

jaqueparis 1 year ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 1 You must log in to vote on the helpfulness of this note

These docs are confusing about the second parameter. $context defauls 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
Squip to note 6 content

Güilherme Carvalho 5 months ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note

The default output is not ‘&’ for the second parameter. It’s actually ‘&’, this can cause issues depending on your environment when used directly in the browser.

Anything else than ‘display’ in the $context param will display the correct symbol instead of the HTML entity for it.

Log in to add feedback

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

In this article