WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

edit_link()

edit_link( int $link_id ): int|WP_Error

In this article

Back to top

Updates or inserts a link using values provided in $_POST.

Parameters

$link_idintoptional
ID of the link to edit. Default 0.

Return

int|WP_Error Value 0 or WP_Error on failure. The link ID on success.

Source

function edit_link( $link_id = 0 ) {	if ( ! current_user_can( 'manage_links' ) ) {	wp_die(	'<h1>' . __( 'You need a higher level of permission.' ) . '</h1>' .	'<p>' . __( 'Sorry, you are not allowed to edit the links for this site.' ) . '</p>',	403	);	}	$_POST['link_url'] = esc_url( $_POST['link_url'] );	$_POST['link_name'] = esc_html( $_POST['link_name'] );	$_POST['link_image'] = esc_html( $_POST['link_image'] );	$_POST['link_rss'] = esc_url( $_POST['link_rss'] );	if ( ! isset( $_POST['link_visible'] ) || 'N' !== $_POST['link_visible'] ) {	$_POST['link_visible'] = 'Y';	}	if ( ! empty( $link_id ) ) {	$_POST['link_id'] = $link_id;	return wp_update_link( $_POST );	} else {	return wp_insert_link( $_POST );	} }

View all references View on Trac View on GitHub

UsesDescription
wp_update_link()wp-admin/includes/bookmark.php

Updates a link in the database.

wp_insert_link()wp-admin/includes/bookmark.php

Inserts a link into the database, or updates an existing link.

current_user_can()wp-includes/capabilities.php

Returns whether the current user has the specified capability.

esc_url()wp-includes/formatting.php

Checks and cleans a URL.

esc_html()wp-includes/formatting.php

Escaping for HTML blocks.

wp_die()wp-includes/functions.php

Kills WordPress execution and displays HTML page with an error message.

Show 4 moreShow less
Used byDescription
add_link()wp-admin/includes/bookmark.php

Adds a link using values provided in $_POST.

Changelog

VersionDescription
2.0.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.