'',
'title' => '',
'screen' => array( 'post' ),
'context' => 'normal',
'priority' => 'default',
'classes' => array(),
'fields' => array(),
);
/**
* Array of custom metabox settings.
*
* @var array
* @since 1.0
*/
protected $metabox = array();
/**
* Field prefix.
*
* @var string
* @since 1.0
*/
protected $prefix = 'wpex_mf_';
/**
* Register this class with the WordPress API.
*
* @since 1.0
*
* @access public
* @param array $metabox Array of metabox settings|fields.
* @return void
*/
public function __construct( $metabox ) {
// Parse metabox args
$this->metabox = wp_parse_args( $metabox, $this->defaults );
// Fields are required
if ( empty( $this->metabox[ 'fields' ] ) ) {
return;
}
// Add metaboxes
add_action( 'add_meta_boxes', array( $this, 'add_meta_box' ) );
// Save meta
add_action( 'save_post', array( $this, 'save_meta_data' ) );
}
/**
* The function responsible for creating the actual meta boxes.
*
* @since 1.0
*
* @access public
* @return void
*/
public function add_meta_box() {
add_meta_box(
'wpex-mf-metabox--' . esc_attr( $this->metabox[ 'id' ] ),
$this->metabox[ 'title' ],
array( $this, 'display_meta_box' ),
$this->metabox[ 'screen' ],
$this->metabox[ 'context' ],
$this->metabox[ 'priority' ]
);
if ( ! empty( $this->metabox[ 'classes' ] ) && is_array( $this->metabox[ 'screen' ] ) ) {
foreach( $this->metabox[ 'screen' ] as $screen ) {
add_filter( 'postbox_classes_' . $screen . '_' . $this->metabox[ 'id' ], array( $this, 'postbox_classes' ) );
}
}
}
/**
* Add custom classes to the metabox.
*
* @since 1.0
* @var $classes array
* @access public
* @return $classes
*/
public function postbox_classes( $classes ) {
if ( is_array( $this->metabox[ 'classes' ] ) ) {
foreach( $this->metabox[ 'classes' ] as $class ) {
array_push( $classes, $class );
}
}
return $classes;
}
/**
* Enqueue scripts and styles needed for the metaboxes.
*
* @since 1.0
*
* @access public
* @return void
*/
public function load_scripts() {
$this->enqueue_metabox_scripts();
$this->enqueue_metabox_styles();
}
/**
* Renders the content of the meta box.
*
* @since 1.0
*
* @access public
* @param obj $post Current post being shown in the admin.
* @return void
*/
public function display_meta_box( $post ) {
// Add an nonce field so we can check for it later.
wp_nonce_field(
'wpex_metabox_factory_' . $this->metabox[ 'id' ],
'wpex_meta_factory_nonce_' . $this->metabox[ 'id' ]
);
// Load metabox scripts
$this->load_scripts();
// Get metabox fields
$fields = $this->metabox[ 'fields' ];
?>
|
|
$method( $field, $value ); ?>
' . wp_kses_post( $field[ 'after_hook' ] ) . '';
} ?>
|
field_group_set( $field, $value, 0 );
} elseif ( is_array( $value ) ) {
$groups = $value;
$groups_count = count( $groups );
$index = 0;
foreach( $groups as $group_k => $group_v ) {
$this->field_group_set( $field, $value, $index );
$index++;
}
} ?>
$field_v ) {
// Get group single field value from index
$field_value = isset( $value[ $index ][ $field_v[ 'id' ] ] ) ? $value[ $index ][ $field_v[ 'id' ] ] : '';
// Group fields need to be setup as arrays
$field_v[ 'id' ] = $field[ 'id' ] . '[' . $index_escaped . '][' . $field_v[ 'id' ] . ']';
// Important, it lets everyone know it's a group item.
$field_v[ 'index'] = $index_escaped;
// Render singular group item field
$this->render_field( $field_v, $field_value );
} ?>
>
>
';
>
>
>
metabox[ 'id' ] ] ) ) {
return;
}
// Verify that the nonce is valid.
if ( ! wp_verify_nonce(
$_POST[ 'wpex_meta_factory_nonce_' . $this->metabox[ 'id' ] ],
'wpex_metabox_factory_' . $this->metabox[ 'id' ] )
) {
return;
}
// If this is an autosave, our form has not been submitted, so we don't want to do anything.
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
// Check the user's permissions.
if ( isset( $_POST[ 'post_type' ] ) && 'page' == $_POST[ 'post_type' ] ) {
if ( ! current_user_can( 'edit_page', $post_id ) ) {
return;
}
} else {
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
}
/* OK, it's safe for us to save the data now. Now we can loop through fields */
// Get array of fields to save
$fields = $this->metabox[ 'fields' ];
// Return if fields are empty
if ( empty( $fields ) ) {
return;
}
// Loop through options and validate
foreach ( $fields as $field ) {
if ( isset( $field[ 'dont_save' ] ) || 'notice' == $field[ 'type' ] ) {
continue;
}
$value = '';
$field_id = $field[ 'id' ];
$prefixed_field_id = $this->prefix . $field_id;
$new_value = isset( $_POST[$prefixed_field_id] ) ? $_POST[$prefixed_field_id] : '';
if ( $field['type'] === 'group' ) {
$group_fields = $field['fields'];
if ( ! empty( $new_value ) && is_array( $new_value ) ) {
// Loop through each group
foreach ( $new_value as $new_value_k => $new_value_v ) {
if ( empty( $new_value_v ) || ! is_array( $new_value_v ) ) {
continue;
}
// Loop through each item in each group to sanitize the data
foreach( $new_value_v as $new_group_value_k => $new_group_value_v ) {
$new_value_field = array();
foreach ( $group_fields as $group_field ) {
if ( $new_group_value_k === $group_field['id'] ) {
$new_value_field = $group_field;
break;
}
}
$new_group_value_v_escaped = $this->sanitize_value_for_db( $new_group_value_v, $new_value_field );
$new_value[$new_value_k][$new_group_value_k] = $new_group_value_v_escaped;
}
}
update_post_meta( $post_id, $field_id, $new_value );
} else {
delete_post_meta( $post_id, $field_id );
}
} else {
// Make sure field exists and if so validate the data
if ( $new_value ) {
// Sanitize field before inserting into the database
$new_val_escaped = $this->sanitize_value_for_db( $new_value, $field );
// Update meta if value exists
if ( $new_val_escaped ) {
update_post_meta( $post_id, $field_id, $new_val_escaped );
}
// Delete if value is empty
else {
delete_post_meta( $post_id, $field_id );
}
} else {
if ( 'checkbox' == $field[ 'type' ] && ! empty( $field[ 'default'] ) ) {
update_post_meta( $post_id, $field_id, 0 );
} else {
delete_post_meta( $post_id, $field_id );
}
}
}
}
}
/**
* Sanitizes element ID.
*
* @since 1.0
*/
public function sanitize_field_attr_id( $id = '' ) {
$id = str_replace( '][', '-', $id );
$id = str_replace( '[', '-', $id );
$id = str_replace( ']', '', $id );
return 'wpex-mf-field--' . esc_attr( $id );
}
/**
* Sanitize input values before inserting into the database.
*
* @since 1.0
*/
public function sanitize_value_for_db( $input, $field ) {
$type = $field[ 'type' ];
switch ( $type ) {
case 'text':
return sanitize_text_field( $input );
break;
case 'url':
return esc_url_raw( $input );
break;
case 'number':
return absint( $input );
break;
case 'textarea':
return sanitize_textarea_field( $input );
break;
case 'checkbox':
return isset( $input ) ? 1 : 0;
break;
case 'select':
if ( in_array( $input, $field[ 'choices' ] ) || array_key_exists( $input, $field[ 'choices' ] ) ) {
return esc_attr( $input );
}
break;
case 'multi_select':
if ( ! is_array( $input ) ) {
return isset( $field[ 'default' ] ) ? $field[ 'default' ] : array();
}
$checks = true;
foreach( $input as $v ) {
if ( ! in_array( $v, $field[ 'choices' ] ) && ! array_key_exists( $v, $field[ 'choices' ] ) ) {
$checks = false;
break;
}
}
return $checks ? $input : array();
break;
case 'upload':
$return = ! empty( $field['return'] ) ? $field['return'] : 'url';
switch ( $return ) {
case 'url':
return esc_url_raw( $input );
break;
case 'id':
return absint( $input );
break;
default:
return sanitize_textarea_field( $input );
break;
}
break;
default:
return wp_strip_all_tags( $input );
break;
}
}
/**
* Enqueues metabox scripts.
*
* @since 1.0
*/
public function enqueue_metabox_scripts() {
wp_enqueue_script(
'wpex-meta-factory',
plugin_dir_url( __FILE__ ) . 'assets/wpex-meta-factory.min.js',
array( 'jquery' ),
$this->version,
true
);
wp_localize_script(
'wpex-meta-factory',
'wpexMetaFactoryL10n',
array(
'delete_group_confirm' => esc_html__( 'Please click ok to confirm.', 'total-theme-core' ),
)
);
if ( isset( $this->metabox[ 'scripts' ] ) ) {
foreach ( $this->metabox[ 'scripts' ] as $args ) {
call_user_func_array( 'wp_enqueue_script', $args );
}
}
}
/**
* Enqueues metabox styles.
*
* @since 1.0
*/
public function enqueue_metabox_styles() {
wp_enqueue_style(
'wpex-meta-factory',
plugin_dir_url( __FILE__ ) . 'assets/wpex-meta-factory.css',
array(),
$this->version
);
if ( isset( $this->metabox[ 'styles' ] ) ) {
foreach ( $this->metabox[ 'styles' ] as $args ) {
call_user_func_array( 'wp_enqueue_style', $args );
}
}
}
/**
* Adds prefix to string.
*
* @since 1.0
*/
public function add_prefix( $string = '' ) {
return $this->prefix . $string;
}
}
}