Changeset 36672

Timestamp:

02/24/2016 03:55:21 AM (11 years 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;