云策 WordPress 开发者社区

函数文档

wp_delete_link()

查看官方原文 ↗
💡 云策文档标注

概述

wp_delete_link() 函数用于从数据库中删除指定的链接，执行删除操作并触发相关 Hook。

关键要点

  • 参数：$link_id（int，必需），指定要删除的链接 ID。
  • 返回值：始终返回 true。
  • 功能：删除链接前触发 delete_link Hook，删除链接后触发 deleted_link Hook，并清理缓存。

代码示例

function wp_delete_link( $link_id ) {
	global $wpdb;
	do_action( 'delete_link', $link_id );
	wp_delete_object_term_relationships( $link_id, 'link_category' );
	$wpdb->delete( $wpdb->links, array( 'link_id' => $link_id ) );
	do_action( 'deleted_link', $link_id );
	clean_bookmark_cache( $link_id );
	return true;
}

注意事项

  • 删除链接前会先解除与 link_category 的分类关系。
  • 使用 wpdb::delete() 从数据库表中删除行。
  • 清理缓存以确保数据一致性。
📄 原文内容

Deletes a specified link from the database.

Parameters

$link_idintrequired
ID of the link to delete.

Return

true Always true.

Source

function wp_delete_link( $link_id ) {
	global $wpdb;
	/**
	 * Fires before a link is deleted.
	 *
	 * @since 2.0.0
	 *
	 * @param int $link_id ID of the link to delete.
	 */
	do_action( 'delete_link', $link_id );

	wp_delete_object_term_relationships( $link_id, 'link_category' );

	$wpdb->delete( $wpdb->links, array( 'link_id' => $link_id ) );

	/**
	 * Fires after a link has been deleted.
	 *
	 * @since 2.2.0
	 *
	 * @param int $link_id ID of the deleted link.
	 */
	do_action( 'deleted_link', $link_id );

	clean_bookmark_cache( $link_id );

	return true;
}

View all references View on Trac View on GitHub

Hooks

do_action( ‘deleted_link’, int $link_id )

Fires after a link has been deleted.

do_action( ‘delete_link’, int $link_id )

Fires before a link is deleted.

Uses Description
wp_delete_object_term_relationships()wp-includes/taxonomy.php

Unlinks the object from the taxonomy or taxonomies.
clean_bookmark_cache()wp-includes/bookmark.php

Deletes the bookmark cache.
wpdb::delete()wp-includes/class-wpdb.php

Deletes a row in the table.
do_action()wp-includes/plugin.php

Calls the callback functions that have been added to an action hook.

Show 1 moreShow less

Used by Description
wpmu_delete_user()wp-admin/includes/ms.php

Deletes a user and all of their posts from the network.
wp_delete_user()wp-admin/includes/user.php

Delete user and optionally reassign posts and links to another user.
wp_ajax_delete_link()wp-admin/includes/ajax-actions.php

Handles deleting a link via AJAX.

Changelog

Version Description
2.0.0 Introduced.