Changeset 25706 for trunk/src/wp-admin/includes/bookmark.php

Timestamp:

10/07/2013 02:18:20 AM (11 years ago)

Author:

DrewAPicture

Message:

Inline documentation for hooks in wp-admin/includes/bookmark.php.

Props johnafish, kpdesign.
Fixes #25494.

File:

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

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

@@ -71 +71 @@
 
 /**
- * Delete link specified from database
+ * Delete link specified from database.
  *
  * @since 2.0.0
@@ -80 +80 @@
 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 );
 
@@ -86 +92 @@
 
     $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 );
 
@@ -207 +219 @@
     wp_set_link_cats( $link_id, $link_category );
 
-    if ( $update )
+    if ( $update ) {
+        /**
+         * Fires after a link was updated in the database.
+         *
+         * @since 2.0.0
+         *
+         * @param int $link_id ID of the link that was updated.
+         */
         do_action( 'edit_link', $link_id );
-    else
+    } else {
+        /**
+         * Fires after a link was added to the database.
+         *
+         * @since 2.0.0
+         *
+         * @param int $link_id ID of the link that was added.
+         */
         do_action( 'add_link', $link_id );
-
+    }
     clean_bookmark_cache( $link_id );