Changeset 30091

Timestamp:

10/29/2014 07:01:15 PM (10 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;
+            }
         }
     }