' . __( 'The Display Featured Image for Genesis plugin has just a few optional settings. Check the Help tab for more information. ', 'display-featured-image-genesis' ) . '
'; } /** * Setting for reduction amount * @return number of pixels to remove in backstretch-set.js * * @since 1.1.0 */ public function header_size() { echo ''; echo ''; echo '' . __( 'Changing this number will reduce the backstretch image height by this number of pixels. Default is zero.', 'display-featured-image-genesis' ) . '
'; } /** * Default image uploader * * @return image * * @since 1.2.1 */ public function set_default_image() { $item = Display_Featured_Image_Genesis_Common::get_image_variables(); if ( ! empty( $this->displaysetting['default'] ) ) { $preview = wp_get_attachment_image_src( $item->fallback_id, 'medium' ); echo '' . sprintf( __( 'If you would like to use a default image for the featured image, upload it here. Must be at least %1$s pixels wide.', 'display-featured-image-genesis' ), absint( $item->large + 1 ) ) . '
'; } /** * option to exclude featured image on front page * @return 0 1 checkbox * * @since 1.4.0 */ public function exclude_front() { echo ''; echo ''; } /** * option to move excerpts to leader image area * @return 0 1 checkbox * * @since 1.3.0 */ public function move_excerpts() { echo ''; echo ''; } /** * option to add images to feed * @return 0 1 checkbox * * @since x.y.z */ public function add_image_to_feed() { echo ''; echo ''; } /** * validate all inputs * @param string $new_value various settings * @return string number or URL * * @since 1.4.0 */ public function do_validation_things( $new_value ) { if ( empty( $_POST['displayfeaturedimagegenesis_nonce'] ) ) { wp_die( __( 'Something unexpected happened. Please try again.', 'display-featured-image-genesis' ) ); } check_admin_referer( 'displayfeaturedimagegenesis_save-settings', 'displayfeaturedimagegenesis_nonce' ); $new_value['less_header'] = absint( $new_value['less_header'] ); $new_value['default'] = $this->validate_image( $new_value['default'] ); $new_value['exclude_front'] = $this->one_zero( $new_value['exclude_front'] ); $new_value['move_excerpts'] = $this->one_zero( $new_value['move_excerpts'] ); $new_value['feed_image'] = $this->one_zero( $new_value['feed_image'] ); return $new_value; } /** * Returns previous value for image if not correct file type/size * @param string $new_value New value * @return string New or previous value, depending on allowed image size. * @since 1.2.2 */ protected function validate_image( $new_value ) { $new_value = esc_url( $new_value ); $valid = $this->is_valid_img_ext( $new_value ); $large = get_option( 'large_size_w' ); $id = Display_Featured_Image_Genesis_Common::get_image_id( $new_value ); $metadata = wp_get_attachment_metadata( $id ); $width = $metadata['width']; // ok for field to be empty if ( $new_value ) { if ( ! $valid ) { $message = __( 'Sorry, that is an invalid file type. The Default Featured Image has been reset to the last valid setting.', 'display-featured-image-genesis' ); $new_value = $this->displaysetting['default']; add_settings_error( $this->displaysetting['default'], esc_attr( 'invalid' ), $message, 'error' ); } // if file is an image, but is too small, throw it back elseif ( $width <= $large ) { $message = __( 'Sorry, your image is too small. The Default Featured Image has been reset to the last valid setting.', 'display-featured-image-genesis' ); $new_value = $this->displaysetting['default']; add_settings_error( $this->displaysetting['default'], esc_attr( 'weetiny' ), $message, 'error' ); } } return $new_value; } /** * returns file extension * @since 1.2.2 */ protected function get_file_ext( $file ) { $parsed = @parse_url( $file, PHP_URL_PATH ); return $parsed ? strtolower( pathinfo( $parsed, PATHINFO_EXTENSION ) ) : false; } /** * check if file type is image * @return file check file extension against list * @since 1.2.2 */ protected function is_valid_img_ext( $file ) { $file_ext = $this->get_file_ext( $file ); $this->valid = empty( $this->valid ) ? (array) apply_filters( 'displayfeaturedimage_valid_img_types', array( 'jpg', 'jpeg', 'png', 'gif' ) ) : $this->valid; return ( $file_ext && in_array( $file_ext, $this->valid ) ); } /** * Returns a 1 or 0, for all truthy / falsy values. * * Uses double casting. First, we cast to bool, then to integer. * * @since 1.3.0 * * @param mixed $new_value Should ideally be a 1 or 0 integer passed in * @return integer 1 or 0. */ protected function one_zero( $new_value ) { return (int) (bool) $new_value; } /** * Help tab for media screen * @return help tab with verbose information for plugin * * @since 1.1.0 */ public function help() { $screen = get_current_screen(); $large = get_option( 'large_size_w' ); $height_help = '' . __( 'Depending on how your header/nav are set up, or if you just do not want your backstretch image to extend to the bottom of the user screen, you may want to change this number. It will raise the bottom line of the backstretch image, making it shorter.', 'display-featured-image-genesis' ) . '
'; $default_help = '' . __( 'You may set a large image to be used sitewide if a featured image is not available. This image will show on posts, pages, and archives.', 'display-featured-image-genesis' ) . '
' . '' . sprintf( __( 'Supported file types are: jpg, jpeg, png, and gif. The image must be at least %1$s pixels wide.', 'display-featured-image-genesis' ), absint( $large + 1 ) ) . '
'; $skipfront_help = '' . __( 'If you set a Default Featured Image, it will show on every post/page of your site. This may not be desirable on child themes with a front page constructed with widgets, so you can select this option to prevent the Featured Image from showing on the front page. Checking this will prevent the Featured Image from showing on the Front Page, even if you have set an image for that page individually.', 'display-featured-image-genesis' ) . '
' . '' . sprintf( __( 'If you want to prevent entire groups of posts from not using the Featured Image, you will want to add a filter to your theme functions.php file.', 'display-featured-image-genesis' ), esc_url( 'https://github.com/robincornett/display-featured-image-genesis#how-do-i-stop-the-featured-image-action-from-showing-on-my-custom-post-types' ) ) . '
'; $excerpts_help = '' . __( 'By default, archive descriptions (set on the Genesis Archive Settings pages) show below the Default Featured Image, while the archive title displays on top of the image. If you check this box, all headlines, descriptions, and optional excerpts will display in a box overlaying the Featured Image.', 'display-featured-image-genesis' ) . '
'; $feed_help = '' . __( 'This plugin does not add the Featured Image to your content, so normally you will not see your Featured Image in the feed. If you select this option, however, the Featured Image (if it is set) will be added to each entry in your RSS feed.', 'display-featured-image-genesis' ) . '
' . '' . __( 'If your RSS feed is set to Full Text, the Featured Image will be added to the entry content. If it is set to Summary, the Featured Image will be added to the excerpt instead.', 'display-featured-image-genesis' ) . '
'; $screen->add_help_tab( array( 'id' => 'displayfeaturedimage_less_header-help', 'title' => __( 'Height', 'display-featured-image-genesis' ), 'content' => $height_help, ) ); $screen->add_help_tab( array( 'id' => 'displayfeaturedimage_default-help', 'title' => __( 'Default Featured Image', 'display-featured-image-genesis' ), 'content' => $default_help, ) ); $screen->add_help_tab( array( 'id' => 'displayfeaturedimage_exclude_front-help', 'title' => __( 'Show on Front Page', 'display-featured-image-genesis' ), 'content' => $skipfront_help, ) ); $screen->add_help_tab( array( 'id' => 'displayfeaturedimage_excerpts-help', 'title' => __( 'Move Excerpts', 'display-featured-image-genesis' ), 'content' => $excerpts_help, ) ); $screen->add_help_tab( array( 'id' => 'displayfeaturedimage_feed-help', 'title' => __( 'RSS Feed', 'display-featured-image-genesis' ), 'content' => $feed_help, ) ); } /** * enqueue admin scripts * @return scripts to use image uploader * * @since 1.2.1 */ public function enqueue_scripts() { $version = Display_Featured_Image_Genesis_Common::$version; wp_register_script( 'displayfeaturedimage-upload', plugins_url( '/includes/js/settings-upload.js', dirname( __FILE__ ) ), array( 'jquery', 'media-upload', 'thickbox' ), $version ); if ( 'appearance_page_displayfeaturedimagegenesis' === get_current_screen()->id ) { wp_enqueue_media(); wp_enqueue_script( 'displayfeaturedimage-upload' ); wp_localize_script( 'displayfeaturedimage-upload', 'objectL10n', array( 'text' => __( 'Choose Image', 'display-featured-image-genesis' ), ) ); } } }