Changeset 30091 for trunk/src/wp-includes/revision.php

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.

File:

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

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;
+                        }
                 }
         }