Changeset 62024

Timestamp:

03/13/2026 10:43:20 PM (11 hours ago)

Author:

SergeyBiryukov

Message:

Docs: Correct return type for add_link(), edit_link(), and wp_update_link().

Follow-up to [8758], [15564].

Props marian1.
Fixes #64764.

File:

• trunk/src/wp-admin/includes/bookmark.php (modified) (4 diffs)

trunk/src/wp-admin/includes/bookmark.php

@@ -12 +12 @@
  * @since 2.0.0
  *
- * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
+ * @return int The link ID on success. The value 0 on failure.
  */
 function add_link() {
@@ -24 +24 @@
  *
  * @param int $link_id Optional. ID of the link to edit. Default 0.
- * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
+ * @return int The link ID on success. The value 0 on failure.
  */
 function edit_link( $link_id = 0 ) {
@@ -170 +170 @@
  * }
  * @param bool  $wp_error Optional. Whether to return a WP_Error object on failure. Default false.
- * @return int|WP_Error Value 0 or WP_Error on failure. The link ID on success.
+ * @return int|WP_Error The link ID on success. The value 0 or WP_Error on failure.
  */
 function wp_insert_link( $linkdata, $wp_error = false ) {
@@ -296 +296 @@
  *
  * @param array $linkdata Link data to update. See wp_insert_link() for accepted arguments.
- * @return int|WP_Error Value 0 or WP_Error on failure. The updated link ID on success.
+ * @return int The updated link ID on success. The value 0 on failure.
  */
 function wp_update_link( $linkdata ) {