*
* @since 4.2.0
*
- * @param bool false Whether to redirect in parent window or not. Default false.
+ * @param bool $redirect Whether to redirect in parent window or not. Default false.
*/
'redirInParent' => apply_filters( 'press_this_redirect_in_parent', false ),
);
}
}
- // Edxpected slashed
+ // Expected slashed
return wp_slash( $content );
}
wp_send_json_error( array( 'errorMessage' => __( 'Invalid post.' ) ) );
}
- $post = array(
+ $post_data = array(
'ID' => $post_id,
'post_title' => ( ! empty( $_POST['post_title'] ) ) ? sanitize_text_field( trim( $_POST['post_title'] ) ) : '',
'post_content' => ( ! empty( $_POST['post_content'] ) ) ? trim( $_POST['post_content'] ) : '',
if ( ! empty( $_POST['post_status'] ) && 'publish' === $_POST['post_status'] ) {
if ( current_user_can( 'publish_posts' ) ) {
- $post['post_status'] = 'publish';
+ $post_data['post_status'] = 'publish';
} else {
- $post['post_status'] = 'pending';
+ $post_data['post_status'] = 'pending';
}
}
- $post['post_content'] = $this->side_load_images( $post_id, $post['post_content'] );
+ $post_data['post_content'] = $this->side_load_images( $post_id, $post_data['post_content'] );
- $updated = wp_update_post( $post, true );
+ /**
+ * Filter the post data of a Press This post before saving/updating, after
+ * side_load_images action had run.
+ *
+ * @since 4.5.0
+ *
+ * @param array $post_data The post data.
+ */
+ $post_data = apply_filters( 'press_this_save_post', $post_data );
+
+ $updated = wp_update_post( $post_data, true );
if ( is_wp_error( $updated ) ) {
wp_send_json_error( array( 'errorMessage' => $updated->get_error_message() ) );
} else {
- if ( isset( $post['post_format'] ) ) {
- if ( current_theme_supports( 'post-formats', $post['post_format'] ) ) {
- set_post_format( $post_id, $post['post_format'] );
- } elseif ( $post['post_format'] ) {
+ if ( isset( $post_data['post_format'] ) ) {
+ if ( current_theme_supports( 'post-formats', $post_data['post_format'] ) ) {
+ set_post_format( $post_id, $post_data['post_format'] );
+ } elseif ( $post_data['post_format'] ) {
set_post_format( $post_id, false );
}
}
* @param int $post_id Post ID.
* @param string $status Post status.
*/
- $redirect = apply_filters( 'press_this_save_redirect', $redirect, $post_id, $post['post_status'] );
+ $redirect = apply_filters( 'press_this_save_redirect', $redirect, $post_id, $post_data['post_status'] );
if ( $redirect ) {
wp_send_json_success( array( 'redirect' => $redirect, 'force' => $forceRedirect ) );
return $remote_url;
}
- $useful_html_elements = array(
+ $allowed_elements = array(
'img' => array(
'src' => true,
'width' => true,
);
$source_content = wp_remote_retrieve_body( $remote_url );
- $source_content = wp_kses( $source_content, $useful_html_elements );
+ $source_content = wp_kses( $source_content, $allowed_elements );
return $source_content;
}
return ''; // Return empty rather than a truncated/invalid URL
}
- // Does not look like an URL.
+ // Does not look like a URL.
if ( ! preg_match( '/^([!#$&-;=?-\[\]_a-z~]|%[0-9a-fA-F]{2})+$/', $url ) ) {
return '';
}
}
/**
- * Filter the default HTML for the Press This editor.
+ * Filter the default HTML tags used in the suggested content for the editor.
+ *
+ * The HTML strings use printf format. After filtering the content is added at the specified places with `sprintf()`.
*
* @since 4.2.0
*
- * @param array $default_html Associative array with two keys: 'quote' where %1$s is replaced with the site description
- * or the selected content, and 'link' there %1$s is link href, %2$s is link text.
+ * @param array $default_html Associative array with three possible keys:
+ * - 'quote' where %1$s is replaced with the site description or the selected content.
+ * - 'link' where %1$s is link href, %2$s is link text, usually the source page title.
+ * - 'embed' which contains an [embed] shortcode when the source page offers embeddable content.
+ * @param array $data Associative array containing the data from the source page.
*/
$default_html = apply_filters( 'press_this_suggested_html', $default_html, $data );