Changeset 36672

Timestamp:

02/24/16 03:55:21 (16 months ago)

Author:

jorbin

Message:

Add Additional filters to Press This

3 new filters that aim to improve the extensibility of Press This:
1) press_this_save_post_content - Applied right after the side_load_images in order to allow potential side loads of other types of media.
Example use case: side load non-image media, such as audio or video.

2) press_this_useful_html_elements
Allows filtering of currently hard coded array of HTML elements allowed in fetch_source_html step for special cases where additional HTML elements need to be kept.
Example use case: HTML5 elements, such as amp-img, that someone wants to pull in.

3) press_this_suggested_content
A filter for the content right before it's passed to the editor and presented to the user.
Example use case is when someone stored posts in a different, non-HTML format, such as Markdown, this is essential.

Fixes #34455.
Props cadeyrn, kraftbj

File:

• trunk/src/wp-admin/includes/class-wp-press-this.php (modified) (4 diffs)

trunk/src/wp-admin/includes/class-wp-press-this.php

@@ -92 +92 @@
         }
 
-        // Edxpected slashed
+        // Expected slashed
         return wp_slash( $content );
     }
@@ -133 +133 @@
 
         $post['post_content'] = $this->side_load_images( $post_id, $post['post_content'] );
+
+        /**
+         * Filter the post_content of a Press This post before saving/updating, after
+         * side_load_images action had run.
+         *
+         * @since 4.5.0
+         *
+         * @param string $content Content after side_load_images process.
+         * @param int    $post_id Post ID.
+         */
+        $post['post_content'] = apply_filters( 'press_this_save_post_content', $post['post_content'], $post_id );
 
         $updated = wp_update_post( $post, true );
@@ -293 +304 @@
             )
         );
+
+        /**
+         * Filter 'useful' HTML elements list for fetch source step.
+         *
+         * @since 4.5.0
+         *
+         * @param array $elements Default list of useful elements.
+         */
+        $useful_html_elements = apply_filter( 'press_this_useful_html_elements', $useful_html_elements );
 
         $source_content = wp_remote_retrieve_body( $remote_url );
@@ -1193 +1213 @@
             }
         }
+
+        /**
+         * Filter the assembled HTML for the Press This editor.
+         *
+         * @since 4.5.0
+         *
+         * @param string $content Assembled end output of suggested content for the Press This editor.
+         */
+        $content = apply_filters( 'press_this_suggested_content', $content );
 
         return $content;