%s
', $the_query->request ); // just for debugging // The Loop if ( $the_query->have_posts() ) { // do task dependent on selected action switch ( $this->selected_action ) { case 'assign': while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // check if there is an existing featured image $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if post with featured images should be ignored, jump to next loop if ( $thumb_id and $is_option[ 'orphans_only' ] ) { continue; } $success = false; // if no existing featured image or if permission to overwrite it if ( ! $thumb_id or $is_option[ 'overwrite' ] ) { // set featured image id $thumb_id = $this->selected_image_id; // do the task $success = set_post_thumbnail( $post_id, $thumb_id ); } // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if existing featured image if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( get_edit_post_link(), get_the_title(), $current_featured_images[ $thumb_id ], $success ); } // while(have_posts) break; case 'assign_randomly': $last_index = count( $this->selected_multiple_image_ids ) - 1; while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // check if there is an existing featured image $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if post with featured images should be ignored, jump to next loop if ( $thumb_id and $is_option[ 'orphans_only' ] ) { continue; } $success = false; // if no existing featured image or if permission to overwrite it if ( ! $thumb_id or $is_option[ 'overwrite' ] ) { // set featured image id $thumb_id = $this->selected_multiple_image_ids[ rand( 0, $last_index ) ]; // do the task $success = set_post_thumbnail( $post_id, $thumb_id ); } // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if existing featured image if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( get_edit_post_link(), get_the_title(), $current_featured_images[ $thumb_id ], $success ); } // while(have_posts) break; case 'replace': while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // do the task $success = set_post_thumbnail( $post_id, $this->selected_image_id ); // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( get_edit_post_link(), get_the_title(), $current_featured_images[ $thumb_id ], $success ); } // while(have_posts) break; case 'remove': case 'remove_any_img': while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // do the task $success = delete_post_thumbnail( $post_id ); // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if existing featured image if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( get_edit_post_link(), get_the_title(), $current_featured_images[ $thumb_id ], $success ); } // while(have_posts) break; } // switch(selected_action) } // if( have_posts ) // Restore original post data after the query wp_reset_postdata(); } else { // else if there are cached results // do task dependent on selected action switch ( $this->selected_action ) { case 'assign': foreach ( $query_results as $post_id => $post_data ) { $thumb_id = $post_data[ 0 ]; // cast "false" value to boolean false if ( $thumb_id == $false_id ) { $thumb_id = false; } // check if there is an existing featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); $success = false; // if no existing featured image or if permission to overwrite it if ( ! $current_thumb_id or $is_option[ 'overwrite' ] ) { // do the task $success = set_post_thumbnail( $post_id, $thumb_id ); } // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if existing featured image if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( $post_data[ 1 ], // get_edit_post_link() $post_data[ 2 ], // get_the_title() $current_featured_images[ $thumb_id ], $success ); } // foreach() break; case 'assign_randomly': foreach ( $query_results as $post_id => $post_data ) { $thumb_id = $post_data[ 0 ]; // cast "false" value to boolean false if ( $thumb_id == $false_id ) { $thumb_id = false; } $success = false; // check if there is an existing featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if existing featured image if ( $current_thumb_id ) { // if new image if ( $thumb_id ) { // if permission to overwrite existing image if ( $is_option[ 'overwrite' ] ) { // do the task $success = set_post_thumbnail( $post_id, $thumb_id ); } else { // do nothing : keep existing image } // if ( overwrite ) } // if ( new image ) // if no existing featured image } else { // if new image if ( $thumb_id ) { // do the task $success = set_post_thumbnail( $post_id, $thumb_id ); } else { // do nothing : no image } // if ( new image ) } // if ( existing image ) // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if existing featured image if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( $post_data[ 1 ], // get_edit_post_link() $post_data[ 2 ], // get_the_title() $current_featured_images[ $thumb_id ], $success ); } // foreach() break; case 'replace': foreach ( $query_results as $post_id => $post_data ) { $thumb_id = $post_data[ 0 ]; // do the task $success = set_post_thumbnail( $post_id, $thumb_id ); // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( $post_data[ 1 ], // get_edit_post_link() $post_data[ 2 ], // get_the_title() $current_featured_images[ $thumb_id ], $success ); } // foreach() break; case 'remove': case 'remove_any_img': foreach ( $query_results as $post_id => $post_data ) { $thumb_id = $post_data[ 0 ]; // do the task $success = delete_post_thumbnail( $post_id ); // get html for featured image for check $thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); if ( $thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $thumb_id ] ) ) { $current_featured_images[ $thumb_id ] = wp_get_attachment_image( $thumb_id, $size, false, $attr ); } } else { // nothing changed $thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, image html, success of action (true or false) $results[] = array( $post_data[ 1 ], // get_edit_post_link() $post_data[ 2 ], // get_the_title() $current_featured_images[ $thumb_id ], $success ); } // foreach() break; } // switch(selected_action) // delete cached results manually delete_transient( $this->transient_name ); } // if transient } else { $query_results = array(); $the_query = new WP_Query( $this->get_query_args() ); //printf( '%s
', esc_html( $the_query->request ) ); // just for debugging // The Loop if ( $the_query->have_posts() ) { // do task dependent on selected action switch ( $this->selected_action ) { case 'assign': while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // check if there is an existing featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if post with featured images should be ignored, jump to next loop if ( $current_thumb_id and $is_option[ 'orphans_only' ] ) { continue; } if ( $current_thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $current_thumb_id ] ) ) { $current_featured_images[ $current_thumb_id ] = wp_get_attachment_image( $current_thumb_id, $size, false, $attr ); } // get html of future thumbnail if ( $is_option[ 'overwrite' ] ) { // preview old thumb + new thumb $future_thumb_id = $this->selected_image_id; // get thumbnail html if not yet got if ( ! isset( $future_featured_images[ $future_thumb_id ] ) ) { $future_featured_images[ $future_thumb_id ] = wp_get_attachment_image( $future_thumb_id, $size, false, $attr ); } } else { // preview old thumb + old thumb $future_thumb_id = $current_thumb_id; $future_featured_images[ $future_thumb_id ] = $current_featured_images[ $current_thumb_id ]; } } else { // preview no old thumb + new thumb $current_thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key // get html of future thumbnail $future_thumb_id = $this->selected_image_id; // get thumbnail html if not yet got if ( ! isset( $future_featured_images[ $future_thumb_id ] ) ) { $future_featured_images[ $future_thumb_id ] = wp_get_attachment_image( $future_thumb_id, $size, false, $attr ); } } // store edit link, post title, post date, post author, current image html, future image html $post_link = get_edit_post_link(); $post_title = get_the_title(); $results[] = array( $post_link, $post_title, get_the_date(), get_the_author(), $current_featured_images[ $current_thumb_id ], $future_featured_images[ $future_thumb_id ], get_post_status(), get_post_type(), ); // notice result for cache $query_results[ $post_id ] = array( $future_thumb_id, $post_link, $post_title ); } // while(have_posts) break; case 'assign_randomly': $last_index = count( $this->selected_multiple_image_ids ) - 1; /* * 1. use selected images multiple times randomly and * 2. overwrite existing featured images */ if ( $is_option[ 'overwrite' ] ) { while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // check if there is an existing featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if post with featured images should be ignored, jump to next loop if ( $current_thumb_id and $is_option[ 'orphans_only' ] ) { continue; } // if existing featured image if ( $current_thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $current_thumb_id ] ) ) { $current_featured_images[ $current_thumb_id ] = wp_get_attachment_image( $current_thumb_id, $size, false, $attr ); } } else { $current_thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // set image randomly : future image = new image $future_thumb_id = $this->selected_multiple_image_ids[ rand( 0, $last_index ) ]; // get thumb id randomly // get thumbnail html if not yet got if ( ! isset( $future_featured_images[ $future_thumb_id ] ) ) { $future_featured_images[ $future_thumb_id ] = wp_get_attachment_image( $future_thumb_id, $size, false, $attr ); } // store edit link, post title, post date, post author, current image html, future image html $post_link = get_edit_post_link(); $post_title = get_the_title(); $results[] = array( $post_link, $post_title, get_the_date(), get_the_author(), $current_featured_images[ $current_thumb_id ], $future_featured_images[ $future_thumb_id ], get_post_status(), get_post_type(), ); // notice result for cache $query_results[ $post_id ] = array( $future_thumb_id, $post_link, $post_title ); } // while(have_posts) /* else * 1. use selected images multiple times randomly and * 2. do not overwrite existing featured images */ } else { while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // check if there is an existing featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); // if post with featured images should be ignored, jump to next loop if ( $current_thumb_id and $is_option[ 'orphans_only' ] ) { continue; } // if existing featured image if ( $current_thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $current_thumb_id ] ) ) { $current_featured_images[ $current_thumb_id ] = wp_get_attachment_image( $current_thumb_id, $size, false, $attr ); } // do nothing : future image = current image $future_thumb_id = $current_thumb_id; $future_featured_images[ $future_thumb_id ] = $current_featured_images[ $current_thumb_id ]; } else { $current_thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key // set image randomly : future image = new image $future_thumb_id = $this->selected_multiple_image_ids[ rand( 0, $last_index ) ]; // get thumb id randomly // get thumbnail html if not yet got if ( ! isset( $future_featured_images[ $future_thumb_id ] ) ) { $future_featured_images[ $future_thumb_id ] = wp_get_attachment_image( $future_thumb_id, $size, false, $attr ); } } // store edit link, post title, post date, post author, current image html, future image html $post_link = get_edit_post_link(); $post_title = get_the_title(); $results[] = array( $post_link, $post_title, get_the_date(), get_the_author(), $current_featured_images[ $current_thumb_id ], $future_featured_images[ $future_thumb_id ], get_post_status(), get_post_type(), ); // notice result for cache $query_results[ $post_id ] = array( $future_thumb_id, $post_link, $post_title ); } // while(have_posts) } // if ( overwrite ) break; case 'replace': while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // check if there is an existing featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); if ( $current_thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $current_thumb_id ] ) ) { $current_featured_images[ $current_thumb_id ] = wp_get_attachment_image( $current_thumb_id, $size, false, $attr ); } } else { $current_thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // get html of future thumbnail $future_thumb_id = $this->selected_image_id; // get thumbnail html if not yet got if ( ! isset( $future_featured_images[ $future_thumb_id ] ) ) { $future_featured_images[ $future_thumb_id ] = wp_get_attachment_image( $future_thumb_id, $size, false, $attr ); } // store edit link, post title, post date, post author, current image html, future image html $post_link = get_edit_post_link(); $post_title = get_the_title(); $results[] = array( $post_link, $post_title, get_the_date(), get_the_author(), $current_featured_images[ $current_thumb_id ], $future_featured_images[ $future_thumb_id ], get_post_status(), get_post_type(), ); // notice result for cache $query_results[ $post_id ] = array( $future_thumb_id, $post_link, $post_title ); } // while(have_posts) break; case 'remove': case 'remove_any_img': $future_thumb_id = false; while ( $the_query->have_posts() ) { $the_query->the_post(); // get the post id once $post_id = get_the_ID(); // get html for featured image $current_thumb_id = $this->get_sanitized_post_thumbnail_id( $post_id ); if ( $current_thumb_id ) { // get thumbnail html if not yet got if ( ! isset( $current_featured_images[ $current_thumb_id ] ) ) { $current_featured_images[ $current_thumb_id ] = wp_get_attachment_image( $current_thumb_id, $size, false, $attr ); } } else { $current_thumb_id = $false_id; // cast from '' or 'false' to a value to use as an array key } // store edit link, post title, post date, post author, current image html, future image html $post_link = get_edit_post_link(); $post_title = get_the_title(); $results[] = array( $post_link, $post_title, get_the_date(), get_the_author(), $current_featured_images[ $current_thumb_id ], $future_thumb_id, get_post_status(), get_post_type(), ); // notice result for cache $query_results[ $post_id ] = array( $future_thumb_id, $post_link, $post_title ); } // while(have_posts) break; } // switch(selected_action) } // if( have_posts ) // Restore original post data after the query wp_reset_postdata(); // store results as transient for 1 day at the longest set_transient( $this->transient_name, $query_results, DAY_IN_SECONDS ); } // if perform // return results return $results; } /** * Check the arguments for WP_Query depended on users selection * * @access private * @since 1.0.0 * * @return array the args */ private function get_query_args() { // define default params $args[ 'posts_per_page' ] = -1; // do not use pagination, return whole result at once $args[ 'no_found_rows' ] = true; // since no pagination: tell WordPress not to run SQL_CALC_FOUND_ROWS on the SQL query; drastically speeding up the query $args[ 'orderby' ] = 'title'; $args[ 'order' ] = 'ASC'; $args[ 'ignore_sticky_posts' ] = true; $args[ 'post_type' ] = $this->selected_post_types; switch ( $this->selected_action ) { case 'replace': $this->selected_post_ids = $this->get_post_ids_of_old_thumbnails(); $args[ 'post__in' ] = $this->get_id_array_for_query( $this->selected_post_ids ); break; case 'remove': $this->selected_post_ids = $this->get_post_ids_of_thumbnail(); $args[ 'post__in' ] = $this->get_id_array_for_query( $this->selected_post_ids ); break; } // switch(selected_action) if ( $this->selected_filters ) { foreach ( $this->selected_filters as $filter ) { switch ( $filter ) { case 'filter_post_types': $this->selected_post_types = $this->get_sanitized_post_types(); if ( $this->selected_post_types ) { $args[ 'post_type' ] = $this->selected_post_types; } else { // add a fictitious post type to get no result (and not to get a list of all posts) $args[ 'post_type' ] = 'abcdefghi'; // assume there is not and will be never a post type with this name } break; case 'filter_category': $this->selected_category_id = $this->get_sanitized_category_id(); // if there is a selected category assign it to the query if ( 0 < $this->selected_category_id ) { $args[ 'cat' ] = $this->selected_category_id; // todo: user selects more than 1 category, 'category__in' } break; case 'filter_tag': $this->selected_tag_id = $this->get_sanitized_tag_id(); // if there is a selected tag assign it to the query if ( 0 < $this->selected_tag_id ) { $args[ 'tag_id' ] = $this->selected_tag_id; // todo: user selects more than 1 tag, 'tag__in' } break; } // switch(filter) } // foreach(selected_filters) } // if(selected_filters) #$this->dambedei($args); return $args; } /** * * Render options of HTML selection lists with strings as values * * @access private * @since 1.0.0 */ private function get_html_options_strings( $arr, $key, $options, $first_empty = true ) { $output = $first_empty ? $this->get_html_empty_option() : ''; $is_key = isset( $arr[ $key ] ); if ( $is_key ) { foreach ( $options as $key => $label ) { $output .= sprintf( '', $key, selected( $is_key , true, false ), esc_html( $label ) ); } } else { foreach ( $options as $key => $label ) { $output .= sprintf( '', $key, esc_html( $label ) ); } } return $output; } /** * * Return empty option for selection field * * @access private * @since 3.0 */ private function get_html_empty_option() { $text = '— Select —'; return sprintf( '', esc_html__( $text ) ); } /** * Returns the post ids which are assigned with the featured images which should be replaced * * @access private * @since 1.0.0 * * @return array the post ids assigned with the thumbnails */ private function get_post_ids_of_old_thumbnails() { $key = 'replacement_image_ids'; if ( isset( $_POST[ $key ] ) ) { if ( is_array( $_POST[ $key ] ) ) { $this->selected_old_image_ids = $this->get_sanitized_array( $key, $this->get_featured_image_ids() ); } else { $this->selected_old_image_ids = explode( ',', $_POST[ $key ] ); } return $this->get_post_ids_of_featured_image_ids( $this->selected_old_image_ids ); } else { return array(); } } /** * Returns the post ids which are assigned with the featured image which should be removed * * @access private * @since 1.0.0 * * @return array the post ids assigned with the thumbnail */ private function get_post_ids_of_thumbnail() { $post_ids = array(); global $wpdb; // get a normal array all names of meta keys except the WP builtins meta keys beginning with an underscore '_' $results = $wpdb->get_results( $wpdb->prepare( "SELECT `post_id` FROM $wpdb->postmeta WHERE `meta_key` = '_thumbnail_id' AND `meta_value` = %d", $this->selected_image_id ), ARRAY_N ); // flatten and sanitize results if ( $results ) { foreach ( $results as $r ) { $post_ids[] = absint( $r[ 0 ] ); } } if ( empty( $post_ids ) ) { $post_ids[] = 0; // enter at least one element with no sense to yield 0 results with WP_QUERY() } return $post_ids; } /** * Returns the posts ids which are assigned to given featured image ids * * @access private * @since 2.0 * * @return array the post ids assigned to given featured images */ private function get_post_ids_of_featured_image_ids( $image_ids = array() ) { $post_ids = array(); global $wpdb; // get a normal array with all IDs of posts assigned with the image ids foreach ( $image_ids as $id ) { $results = $wpdb->get_results( $wpdb->prepare( "SELECT `post_id` FROM $wpdb->postmeta WHERE `meta_key` = '_thumbnail_id' AND `meta_value` = %d", $id ), ARRAY_N ); // flatten and sanitize results if ( $results ) { foreach ( $results as $r ) { $post_ids[] = absint( $r[ 0 ] ); } } } // foreach() return $post_ids; } /** * Returns the thumbnails ids which are assigned with a post * * @access private * @since 1.0.0 * * @return array the image ids assigned to posts as featured images */ private function get_featured_image_ids() { $image_ids = array(); global $wpdb; // get a normal array all names of meta keys except the WP builtins meta keys beginning with an underscore '_' $results = $wpdb->get_results( $wpdb->prepare( "SELECT DISTINCT `meta_value` FROM $wpdb->postmeta WHERE `meta_key` = '_thumbnail_id' AND `meta_value` != %d", $this->selected_image_id ), ARRAY_N ); // flatten and sanitize results if ( $results ) { foreach ( $results as $r ) { $image_ids[] = absint( $r[ 0 ] ); } } return $image_ids; } /** * Check the step parameter and return safe values * * @access private * @since 1.0.0 * * @return string the name of the step the plugin should take */ private function get_sanitized_step() { return $this->get_sanitized_value( 'step', array_keys( $this->valid_steps ), 'start' ); } /** * Check the action parameter and return safe values * * @access private * @since 1.0.0 * * @return string the name of the action the plugin should perform, else empty string */ private function get_sanitized_action() { return $this->get_sanitized_value( 'action', array_keys( array_merge( $this->valid_actions, $this->valid_actions_without_image, $this->valid_actions_multiple_images ) ) ); } /** * Check the requested filters and return safe values * * @access private * @since 1.0.0 * * @return array the names of the filters */ private function get_sanitized_filter_names() { return $this->get_sanitized_array( 'filters', array_keys( $this->valid_filters ) ); } /** * Check the requested options and return safe values * * @access private * @since 5.1 * * @return array the names of the options */ private function get_sanitized_option_names() { return $this->get_sanitized_array( 'options', array_keys( $this->valid_options ) ); } /** * Check the requested post types and return safe values * * @access private * @since 1.0.0 * * @return array the names of the selected post types */ private function get_sanitized_post_types() { return $this->get_sanitized_array( 'post_types', array_keys( $this->valid_post_types ) ); } /** * Check the parameter defined by key and return safe value * Written to return a single value, e.g. for radio buttons * * @access private * @since 1.0.0 * * @return mixed the user selected valid value or the default value */ private function get_sanitized_value( $key, $valid_values, $default_value = null ) { $value = isset( $_REQUEST[ $key ] ) ? $_REQUEST[ $key ] : $default_value; if ( in_array( $value, $valid_values ) ) { return $value; } else { return $default_value; } } /** * Check the parameter and return safe values * Written to return multiple values, e.g. for checkboxes * * @access private * @since 1.0.0 * * @return array the user selected valid values or the default values */ private function get_sanitized_array( $key, $valid_array, $default_array = array() ) { if ( isset( $_POST[ $key ] ) and is_array( $_POST[ $key ] ) ) { return $this->get_array_intersect( $_POST[ $key ], $valid_array ); } else { return $default_array; } } /** * Check the parameters and return safe values * Written to return multiple values associated with key names, e.g. for WP Query * The function filters out empty strings * * @access private * @since 1.0.0 * * @return array the user selected valid values or the default values */ private function get_sanitized_associated_array( $key, $valid_array, $default_array = array() ) { $queries = array(); $arr = isset( $_POST[ $key ] ) ? $_POST[ $key ] : $default_array; if ( ! empty( $arr ) && is_array( $arr ) ) { foreach ( array_keys( $valid_array ) as $key ) { if ( array_key_exists( $key, $arr ) and isset( $arr[ $key ] ) ) { $queries[ $key ] = $arr[ $key ]; } } } return $queries; } /** * Return the intersection of two given arrays * Runs 5 times faster than PHP's array_intersect() * * @access private * @since 1.0.0 * * @return array the intersection of two arrays */ private function get_array_intersect( $a, $b ) { $m = array(); $intersection = array(); // copy first array to array $len = sizeof( $a ); for( $i = 0; $i < $len; $i++ ) { $m[] = $a[ $i ]; } // append second array to array $len = sizeof( $b ); for( $i = 0; $i < $len; $i++ ) { $m[] = $b[ $i ]; } // make values sorted sort( $m ); // compare value with the next one and append to intersection array if equal $len = sizeof( $m ) - 1; for( $i = 0; $i < $len; $i++ ) { if ( $m[ $i ] == $m[ $i + 1 ] ) $intersection[] = $m[ $i ]; } // return intersection return $intersection; } /** * Check the integer value of a user selected value else default value * * @access private * @since 1.0.0 * * @return integer the id or 0 */ private function get_sanitized_id( $key, $default = 0 ) { $given_id = absint( sanitize_text_field( $_REQUEST[ $key ] ) ); if ( ( ! isset( $_REQUEST[ $key ] ) ) or empty( $_REQUEST[ $key ] ) or 0 > $given_id ) { return $default; } else { return $given_id; } } /** * Check the id of selected featured image and return safe value * * @access private * @since 1.0.0 * * @return integer the id or 0 */ private function get_sanitized_image_id() { return $this->get_sanitized_id( 'image_id' ); } /** * Check the ids of selected featured images and return safe value * * @access private * @since 6.0 * * @return array the ids or empty */ private function get_sanitized_multiple_image_ids() { if ( ! isset( $_POST[ 'multiple_image_ids' ] ) or empty( $_POST[ 'multiple_image_ids' ] ) ) { return array(); } else { // read: sanatize string, make array out of string, convert each array value to integer, return result array return array_map( 'absint', explode( ',', sanitize_text_field( $_POST[ 'multiple_image_ids' ] ) ) ); } } /** * Check the id of selected tag and return safe value * * @access private * @since 1.0.0 * * @return integer the id or 0 */ private function get_sanitized_tag_id() { return $this->get_sanitized_id( 'tag_id' ); } /** * Check the id of selected category and return safe value * * @access private * @since 1.0.0 * * @return integer the id or 0 */ private function get_sanitized_category_id() { return $this->get_sanitized_id( 'category_id' ); } /** * Get the ID of a post's featured image, else 0 * * @access private * @since 11.2 * * @return integer the id or 0 */ private function get_sanitized_post_thumbnail_id( $post_id ) { // check if an image with the given ID exists in the media library, else set id to 0 $current_thumb_id = (int) get_post_thumbnail_id( $post_id ); if ( $current_thumb_id and wp_attachment_is_image( $current_thumb_id ) ) { return $current_thumb_id; } else { return 0; } } /** * If results in array, return them, else say query something like "no results in array" * * @access private * @since 2.0 * * @return array Array with content or 0 */ private function get_id_array_for_query( $arr ) { if ( empty( $arr ) ) { return array( 0 ); } else { return $arr; } } /** * Returns the url of the plugin's admin part * * @since 1.0.0 */ public function get_plugin_admin_url() { return plugin_dir_url( __FILE__ ); } /** * Returns the url of the plugin's images folder without an trailing slash * * @since 1.0.0 */ public function get_admin_images_url() { return sprintf( '%s/assets/images', $this->get_plugin_admin_url() ); } /** * Return an instance of this class. * * @since 1.0.0 * * @return object A single instance of this class. */ public static function get_instance() { /* * @TODO : * * - Uncomment following lines if the admin class should only be available for super admins */ /* if( ! is_super_admin() ) { return; } */ // If the single instance hasn't been set, set it now. if ( null == self::$instance ) { self::$instance = new self; } return self::$instance; } /** * Return the page headline. * * @since 7.0 * *@return page headline variable. */ public function get_page_headline() { //return __( 'Set, replace, remove', 'quick-featured-images' ); $text = 'Bulk Edit'; return __( $text ); // just for the translation editor to catch this string $text = __( 'Set, replace, remove', 'quick-featured-images' ); } /** * Return the page description. * * @since 8.0 * *@return page description variable. */ public function get_page_description() { return __( 'Bulk set, replace and remove featured images for existing posts', 'quick-featured-images' ); } /** * Return the page slug. * * @since 7.0 * *@return page slug variable. */ public function get_page_slug() { return $this->page_slug; } /** * Return the required user capability. * * @since 7.0 * *@return required user capability variable. */ public function get_required_user_cap() { return $this->required_user_cap; } /** * Register and enqueue admin-specific style sheet. * * @since 1.0.0 * * @return null Return early if no settings page is registered. */ public function enqueue_admin_styles() { if ( ! isset( $this->plugin_screen_hook_suffix ) ) { return; } // request css only if this plugin was called $screen = get_current_screen(); if ( $this->plugin_screen_hook_suffix == $screen->id ) { wp_enqueue_style( $this->plugin_slug .'-admin-styles', plugins_url( 'assets/css/admin.min.css', __FILE__ ), array(), $this->plugin_version ); } } /** * Register and enqueue admin-specific JavaScript. * * @since 1.0.0 * * @return null Return early if no settings page is registered. */ public function enqueue_admin_scripts() { if ( ! isset( $this->plugin_screen_hook_suffix ) ) { return; } $screen = get_current_screen(); if ( $this->plugin_screen_hook_suffix == $screen->id ) { // load script wp_enqueue_script( $this->plugin_slug . '-admin-script', plugins_url( 'assets/js/admin.js', __FILE__ ), array( 'jquery' ), $this->plugin_version ); // Enqueue all stuff to use media API, requires at least WP 3.5 wp_enqueue_media(); } } /** * Register the administration menu for this plugin into the WordPress Dashboard menu. * * @since 1.0.0 */ public function add_plugin_admin_menu() { // get translated string of the menu label and page headline $label = $this->get_page_headline(); /* * Add the top level menu page of this plugin * */ //$this->plugin_screen_hook_suffix = add_object_page(...); $this->plugin_screen_hook_suffix = add_submenu_page( $this->parent_page_slug, // parent_slug sprintf( '%s: %s', $this->plugin_name, $label ), // page_title $label, // menu_title $this->required_user_cap, // capability to use the following function $this->page_slug, // menu_slug array( $this, 'main' ) // function to execute when loading this page ); } /** * Add a "Bulk set" link to the media row actions * * @since 4.1 */ function add_media_row_action( $actions, $post ) { // if current media is not an image or user has not the right or thumbnails are not supported return without change if ( 'image/' != substr( $post->post_mime_type, 0, 6 ) || ! current_user_can( $this->required_user_cap ) || ! current_theme_supports( 'post-thumbnails' ) ) return $actions; // else build the link with nonce $url = wp_nonce_url( admin_url( sprintf( 'admin.php?page=%s&step=select&action=assign&image_id=%d', $this->page_slug, $post->ID ) ), 'bulk-assign' ); // add it $actions['quick-featured-images'] = sprintf( '%s', esc_url( $url ), esc_html__( 'Bulk set as featured image', 'quick-featured-images' ) ); // return extended action links list return $actions; } }