Changeset 30091

Timestamp:

10/29/2014 07:01:15 PM (12 years ago)

Author:

johnbillion

Message:

Introduce some actions and filters which aid plugins in revisioning post meta.

• wp_save_post_revision_post_has_changed filter which can be used to determine if a post has been changed, and therefore if a revision should be created for a post.
• wp_get_revision_ui_diff filter which can be used to filter the fields displayed in the post revision diff UI.
• wp_creating_autosave action which is fired just before an autosave is created.

See #20564.
Props mattheu, adamsilverstein.

Location:

trunk/src

Files:

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

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

@@ -1542 +1542 @@
                 }
 
+                /**
+                 * Fires before an autosave is stored.
+                 *
+                 * @since 4.1.0
+                 *
+                 * @param array $new_autosave Post array - the autosave that is about to be saved.
+                 */
+                do_action( 'wp_creating_autosave', $new_autosave );
+
                 return wp_update_post( $new_autosave );
         }

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

@@ -93 +93 @@
                 }
         }
-        return $return;
+
+        /**
+         * Filter the fields displayed in the post revision diff UI.
+         *
+         * @since 4.1.0
+         *
+         * @param array   $return       Revision UI fields. Each item is an array of id, name and diff.
+         * @param WP_Post $compare_from The revision post to compare from.
+         * @param WP_Post $compare_to   The revision post to compare to.
+         */
+        return apply_filters( 'wp_get_revision_ui_diff', $return, $compare_from, $compare_to );
+
 }
 

trunk/src/wp-includes/revision.php

@@ -134 +134 @@
                                 }
                         }
+
+                        /**
+                         * Filter whether a post has changed.
+                         *
+                         * By default a revision is saved only if one of the revisioned fields has changed.
+                         * This filter allows for additional checks to determine if there were changes.
+                         *
+                         * @since 4.1.0
+                         *
+                         * @param bool    $post_has_changed Whether the post has changed.
+                         * @param WP_Post $last_revision    The the last revision post object.
+                         * @param WP_Post $post             The post object.
+                         *
+                         */
+                        $post_has_changed = (bool) apply_filters( 'wp_save_post_revision_post_has_changed', $post_has_changed, $last_revision, $post );
+
                         //don't save revision if post unchanged
-                        if( ! $post_has_changed )
+                        if( ! $post_has_changed ) {
                                 return;
+                        }
                 }
         }