Changeset 25587

Timestamp:

09/23/2013 10:44:26 PM (13 years ago)

Author:

DrewAPicture

Message:

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

Fixes #25283.

File:

• trunk/src/wp-admin/includes/revision.php (modified) (1 diff)

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

@@ -56 +56 @@
 
     foreach ( _wp_post_revision_fields() as $field => $name ) {
+        /**
+         * Contextually filter a post revision field.
+         *
+         * The dynamic portion of the hook name, $field, corresponds to each of the post
+         * fields of the revision object being iterated over in a foreach statement.
+         *
+         * @since 3.6.0
+         *
+         * @param string  $compare_from->$field The current revision field to compare to or from.
+         * @param string  $field                The current revision field.
+         * @param WP_Post $compare_from         The revision post object to compare to or from.
+         * @param string  null                  The context of whether the current revision is the old or the new one. Values are 'to' or 'from'.
+         */
         $content_from = $compare_from ? apply_filters( "_wp_post_revision_field_$field", $compare_from->$field, $field, $compare_from, 'from' ) : '';
+
+        //duplicate_hook
         $content_to = apply_filters( "_wp_post_revision_field_$field", $compare_to->$field, $field, $compare_to, 'to' );