wp_update_link() WordPress Function

The wp_update_link() function is used to update the link cache. This function will update the cached links for a specified URL.

wp_update_link( array $linkdata ) #

Updates a link in the database.


Parameters

$linkdata

(array)(Required)Link data to update. See wp_insert_link() for accepted arguments.


Top ↑

Return

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


Top ↑

Source

File: wp-admin/includes/bookmark.php

function wp_update_link( $linkdata ) {
	$link_id = (int) $linkdata['link_id'];

	$link = get_bookmark( $link_id, ARRAY_A );

	// Escape data pulled from DB.
	$link = wp_slash( $link );

	// Passed link category list overwrites existing category list if not empty.
	if ( isset( $linkdata['link_category'] ) && is_array( $linkdata['link_category'] )
		&& count( $linkdata['link_category'] ) > 0
	) {
		$link_cats = $linkdata['link_category'];
	} else {
		$link_cats = $link['link_category'];
	}

	// Merge old and new fields with new fields overwriting old ones.
	$linkdata                  = array_merge( $link, $linkdata );
	$linkdata['link_category'] = $link_cats;

	return wp_insert_link( $linkdata );
}


Top ↑

Changelog

Changelog
VersionDescription
2.0.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.