* @license GPL-2.0+
* @link http://robincornett.com
* @copyright 2014-2015 Robin Cornett Creative, LLC
*/
class Display_Featured_Image_Genesis_Helper {
/**
* Generic function to add settings sections
*
* @since 2.4.0
*/
protected function add_sections( $sections ) {
foreach ( $sections as $section ) {
add_settings_section(
$section['id'],
$section['title'],
array( $this, $section['id'] . '_section_description' ),
$this->page
);
}
}
/**
* Generic function to add settings fields
* @param array $sections registered sections
* @return array all settings fields
*
* @since 2.4.0
*/
protected function add_fields( $fields, $sections ) {
foreach ( $fields as $field ) {
add_settings_field(
'[' . $field['id'] . ']',
sprintf( '', $field['id'], $field['title'] ),
array( $this, $field['callback'] ),
$this->page,
$sections[ $field['section'] ]['id'],
empty( $field['args'] ) ? array() : $field['args']
);
}
}
/**
* Echoes out the section description.
* @param string $description text string for description
* @return string as paragraph and escaped
*
* @since 2.3.0
*/
protected function print_section_description( $description ) {
echo wp_kses_post( wpautop( $description ) );
}
/**
* Generic callback to create a number field setting.
*
* @since 2.3.0
*/
public function do_number( $args ) {
printf( '', esc_attr( $this->page ),esc_attr( $args['setting'] ), esc_attr( $args['label'] ) );
printf( '',
(int) $args['min'],
(int) $args['max'],
esc_attr( $args['setting'] ),
esc_attr( $this->displaysetting[ $args['setting'] ] ),
esc_attr( $this->page )
);
$this->do_description( $args['setting'] );
}
/**
* generic checkbox function (for all checkbox settings)
* @return 0 1 checkbox
*
* @since 2.3.0
*/
public function do_checkbox( $args ) {
printf( '', esc_attr( $args['setting'] ) );
printf( '',
esc_attr( $args['setting'] ),
checked( 1, esc_attr( $this->displaysetting[ $args['setting'] ] ), false ),
esc_attr( $args['label'] )
);
$this->do_description( $args['setting'] );
}
/**
* Generic callback to display a field description.
* @param string $args setting name used to identify description callback
* @return string Description to explain a field.
*
* @since 2.3.0
*/
protected function do_description( $args ) {
$function = $args . '_description';
if ( ! method_exists( $this, $function ) ) {
return;
}
$description = $this->$function();
printf( '%s
', wp_kses_post( $description ) );
}
/**
* display image preview
* @param variable $id featured image ID
* @return $image image preview
*
* @since 2.3.0
*/
public function render_image_preview( $id ) {
if ( empty( $id ) ) {
return;
}
$id = displayfeaturedimagegenesis_check_image_id( $id );
$preview = wp_get_attachment_image_src( (int) $id, 'medium' );
$image = sprintf( '', $preview[0] );
return $image;
}
/**
* show image select/delete buttons
* @param variable $id image ID
* @param varable $name name for value/ID/class
* @return $buttons select/delete image buttons
*
* @since 2.3.0
*/
public function render_buttons( $id, $name ) {
$id = displayfeaturedimagegenesis_check_image_id( $id );
$id = $id ? (int) $id : '';
printf( '', esc_attr( $name ), esc_attr( $id ) );
printf( '',
esc_attr( $name ),
esc_attr__( 'Select Image', 'display-featured-image-genesis' )
);
if ( ! empty( $id ) ) {
printf( ' ',
esc_attr__( 'Delete Image', 'display-featured-image-genesis' )
);
}
}
/**
* Determines if the user has permission to save the information from the submenu
* page.
*
* @since 2.3.0
* @access protected
*
* @param string $action The name of the action specified on the submenu page
* @param string $nonce The nonce specified on the submenu page
*
* @return bool True if the user has permission to save; false, otherwise.
* @author Tom McFarlin (https://tommcfarlin.com/save-wordpress-submenu-page-options/)
*/
protected function user_can_save( $action, $nonce ) {
$is_nonce_set = isset( $_POST[ $nonce ] );
$is_valid_nonce = false;
if ( $is_nonce_set ) {
$is_valid_nonce = wp_verify_nonce( $_POST[ $nonce ], $action );
}
return ( $is_nonce_set && $is_valid_nonce );
}
/**
* 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, $old_value, $label, $size_to_check ) {
// ok for field to be empty
if ( ! $new_value ) {
return '';
}
$new_value = displayfeaturedimagegenesis_check_image_id( $new_value );
$old_value = displayfeaturedimagegenesis_check_image_id( $old_value );
$source = wp_get_attachment_image_src( $new_value, 'full' );
$valid = $this->is_valid_img_ext( $source[0] );
$width = $source[1];
$reset = sprintf( __( ' The %s Featured Image has been reset to the last valid setting.', 'display-featured-image-genesis' ), $label );
if ( $valid && $width > $size_to_check ) {
return (int) $new_value;
}
$new_value = $old_value;
if ( ! $valid ) {
$message = __( 'Sorry, that is an invalid file type.', 'display-featured-image-genesis' );
$class = 'invalid';
} elseif ( $width <= $size_to_check ) {
$message = __( 'Sorry, your image is too small.', 'display-featured-image-genesis' );
$class = 'weetiny';
}
add_settings_error(
$old_value,
esc_attr( $class ),
esc_attr( $message . $reset ),
'error'
);
return (int) $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 );
$is_valid_types = (array) apply_filters( 'displayfeaturedimage_valid_img_types', array( 'jpg', 'jpeg', 'png', 'gif' ) );
return ( $file_ext && in_array( $file_ext, $is_valid_types ) );
}
/**
* 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;
}
}