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

Timestamp:

10/07/2013 02:18:20 AM (13 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 );