#$@%#$%!

Ngiler SH3LL 360
: / home / likhxapw / wpdevinc.com / wp-content / plugins / meta-box / inc /

Information Server
MySQL : OFF Perl : OFF CURL : ON WGET : OFF PKEXEC : OFF

Directive	Local Value
IP Address	63.250.38.10
System	Linux premium90.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64
User	likhxapw
PHP Version	8.3.30
Software	LiteSpeed
Doc root	Writable

Edit File : field.php \| Size : 17.90 KB
<?php use MetaBox\Support\Arr; /** * The field base class. * This is the parent class of all custom fields defined by the plugin, which defines all the common methods. * Fields must inherit this class and overwrite methods with its own. / abstract class RWMB_Field { public static function add_actions() {} public static function admin_enqueue_scripts() {} /* * Show field HTML * Filters are put inside this method, not inside methods such as "meta", "html", "begin_html", etc. * That ensures the returned value are always been applied filters. * This method is not meant to be overwritten in specific fields. * * @param array $field Field parameters. * @param bool $saved Whether the meta box is saved at least once. * @param int $post_id Post ID. / public static function show( array $field, bool $saved, $post_id = 0 ) { $meta = self::call( $field, 'meta', $post_id, $saved ); $meta = self::filter( 'field_meta', $meta, $field, $saved ); $begin = static::begin_html( $field ); $begin = self::filter( 'begin_html', $begin, $field, $meta ); // Separate code for cloneable and non-cloneable fields to make easy to maintain. if ( $field['clone'] ) { $field_html = RWMB_Clone::html( $meta, $field ); } else { // Call separated methods for displaying each type of field. $field_html = self::call( $field, 'html', $meta ); $field_html = self::filter( 'html', $field_html, $field, $meta ); } $end = static::end_html( $field ); $end = self::filter( 'end_html', $end, $field, $meta ); $html = self::filter( 'wrapper_html', $begin . $field_html . $end, $field, $meta ); // Display label and input in DIV and allow user-defined classes to be appended. $classes = "rwmb-field rwmb-{$field['type']}-wrapper " . $field['class']; $required = $field['required'] \|\| ! empty( $field['attributes']['required'] ); if ( $required ) { $classes .= ' required'; } $classes = esc_attr( trim( $classes ) ); $outer_html = $field['before']; $outer_html .= '<div class="' . $classes . '">' . $html . '</div>'; $outer_html .= $field['after']; $outer_html = self::filter( 'outer_html', $outer_html, $field, $meta ); echo $outer_html; // phpcs:ignore WordPress.Security.EscapeOutput } /* * Get field HTML. * * @param mixed $meta Meta value. * @param array $field Field parameters. * * @return string / public static function html( $meta, $field ) { return ''; } protected static function begin_html( array $field ): string { $id = $field['attributes']['id'] ?? $field['id']; $required = $field['required'] \|\| ! empty( $field['attributes']['required'] ); $required = $required ? '<span class="rwmb-required"></span>' : ''; $label = $field['name'] ? sprintf( // Translators: %1$s - field ID, %2$s - field label, %3$s - required asterisk, %4$s - label description. '<div class="rwmb-label" id="%1$s-label"><label for="%1$s">%2$s%3$s</label>%4$s</div>', esc_attr( $id ), $field['name'], $required, static::label_description( $field ) ) : ''; $data_max_clone = is_numeric( $field['max_clone'] ) && $field['max_clone'] > 0 ? ' data-max-clone=' . $field['max_clone'] : ''; $data_min_clone = is_numeric( $field['min_clone'] ) && $field['min_clone'] > 0 ? ' data-min-clone=' . $field['min_clone'] : ''; $data_empty_start = $field['clone_empty_start'] ? ' data-clone-empty-start="1"' : ' data-clone-empty-start="0"'; $input_open = sprintf( '<div class="rwmb-input" %s %s %s>', $data_min_clone, $data_max_clone, $data_empty_start ); return $label . $input_open; } protected static function end_html( array $field ): string { return RWMB_Clone::add_clone_button( $field ) . static::input_description( $field ) . '</div>'; } protected static function label_description( array $field ): string { $id = $field['id'] ? ' id="' . esc_attr( $field['id'] ) . '-label-description"' : ''; return $field['label_description'] ? "<p{$id} class='description'>{$field['label_description']}</p>" : ''; } protected static function input_description( array $field ): string { $id = $field['id'] ? ' id="' . esc_attr( $field['id'] ) . '-description"' : ''; return $field['desc'] ? "<p{$id} class='description'>{$field['desc']}</p>" : ''; } /** * Get raw meta value. * * @param int $object_id Object ID. * @param array $field Field parameters. * @param array $args Arguments of {@see rwmb_meta()} helper. * * @return mixed / public static function raw_meta( $object_id, $field, $args = [] ) { if ( empty( $field['id'] ) ) { return ''; } if ( isset( $field['storage'] ) ) { $storage = $field['storage']; } elseif ( isset( $args['object_type'] ) ) { $storage = rwmb_get_storage( $args['object_type'] ); } else { $storage = rwmb_get_storage( 'post' ); } if ( ! isset( $args['single'] ) ) { $args['single'] = $field['clone'] \|\| ! $field['multiple']; } if ( $field['clone'] && $field['clone_as_multiple'] ) { $args['single'] = false; } $value = $storage->get( $object_id, $field['id'], $args ); $value = self::filter( 'raw_meta', $value, $field, $object_id, $args ); return $value; } /* * Get meta value. * * @param int $post_id Post ID. * @param bool $saved Whether the meta box is saved at least once. * @param array $field Field parameters. * * @return mixed / public static function meta( $post_id, $saved, $field ) { /* * For special fields like 'divider', 'heading' which don't have ID, just return empty string * to prevent notice error when displaying fields. / if ( empty( $field['id'] ) ) { return ''; } // Get raw meta. $raw_meta = self::call( $field, 'raw_meta', $post_id ); $single_std = self::call( 'get_single_std', $field ); $std = self::call( 'get_std', $field ); $saved = $saved && $field['save_field']; // Use $field['std'] only when the meta box hasn't been saved (i.e. the first time we run). $meta = $saved ? $raw_meta : $std; if ( ! $field['clone'] ) { return $meta; } // When a field is cloneable, it should always return an array. $meta = is_array( $raw_meta ) ? $raw_meta : []; if ( empty( $meta ) ) { $empty_meta = empty( $raw_meta ) ? [ null ] : $raw_meta; $std = $field['clone_empty_start'] ? [] : $std; $empty_std = $field['clone_empty_start'] ? [] : Arr::to_depth( $empty_meta, Arr::depth( $std ) ); $meta = $saved ? $empty_std : $std; } // 2. Always prepend a template array_unshift( $meta, $single_std ); return $meta; } /* * Process the submitted value before saving into the database. * * @param mixed $value The submitted value. * @param int $object_id The object ID. * @param array $field The field settings. / public static function process_value( $value, $object_id, array $field ) { $old_value = self::call( $field, 'raw_meta', $object_id ); // Allow field class change the value. if ( $field['clone'] ) { $value = RWMB_Clone::value( $value, $old_value, $object_id, $field ); } else { $value = self::call( $field, 'value', $value, $old_value, $object_id ); $value = self::filter( 'sanitize', $value, $field, $old_value, $object_id ); } $value = self::filter( 'value', $value, $field, $old_value, $object_id ); return $value; } /* * Set value of meta before saving into database. * * @param mixed $new The submitted meta value. * @param mixed $old The existing meta value. * @param int $post_id The post ID. * @param array $field The field parameters. * * @return mixed / public static function value( $new, $old, $post_id, $field ) { return $new; } /* * Save meta value. * * @param mixed $new The submitted meta value. * @param mixed $old The existing meta value. * @param int $post_id The post ID. * @param array $field The field parameters. / public static function save( $new, $old, $post_id, $field ) { if ( empty( $field['id'] ) \|\| ! $field['save_field'] ) { return; } $name = $field['id']; $storage = $field['storage']; // Remove post meta if it's empty. if ( ! RWMB_Helpers_Value::is_valid_for_field( $new ) ) { $storage->delete( $post_id, $name ); return; } // If field is cloneable AND not force to save as multiple rows, value is saved as a single row in the database. if ( $field['clone'] && ! $field['clone_as_multiple'] ) { $storage->update( $post_id, $name, $new ); return; } // Save cloned fields as multiple values instead serialized array. if ( ( $field['clone'] && $field['clone_as_multiple'] ) \|\| $field['multiple'] ) { $storage->delete( $post_id, $name ); $new = (array) $new; foreach ( $new as $new_value ) { $storage->add( $post_id, $name, $new_value, false ); } return; } // Default: just update post meta. $storage->update( $post_id, $name, $new ); } /* * Normalize parameters for field. * * @param array\|string $field Field settings. * @return array / public static function normalize( $field ) { // Quick define text fields with "name" attribute only. if ( is_string( $field ) ) { $field = [ 'name' => $field, 'id' => sanitize_key( $field ), ]; } $field = wp_parse_args( $field, [ 'id' => '', 'name' => '', 'type' => 'text', 'label_description' => '', 'multiple' => false, 'std' => '', 'desc' => '', 'format' => '', 'before' => '', 'after' => '', 'field_name' => $field['id'] ?? '', 'placeholder' => '', 'save_field' => true, 'clone' => false, 'min_clone' => 0, 'max_clone' => 0, 'sort_clone' => false, 'add_button' => __( '+ Add more', 'meta-box' ), 'clone_default' => false, 'clone_as_multiple' => false, 'clone_empty_start' => false, 'class' => '', 'disabled' => false, 'required' => false, 'autofocus' => false, 'attributes' => [], 'sanitize_callback' => null, ] ); // Store the original ID to run correct filters for the cloneable field. if ( $field['clone'] ) { $field['_original_id'] = $field['id']; } if ( $field['clone_default'] ) { $field['attributes'] = wp_parse_args( $field['attributes'], [ 'data-default' => $field['std'], 'data-clone-default' => 'true', ] ); } return $field; } /* * Get the attributes for a field. * * @param array $field Field parameters. * @param mixed $value Meta value. * * @return array / public static function get_attributes( $field, $value = null ) { $attributes = wp_parse_args( $field['attributes'], [ 'disabled' => $field['disabled'], 'autofocus' => $field['autofocus'], 'required' => $field['required'], 'id' => $field['id'], 'class' => '', 'name' => $field['field_name'], ] ); $attributes['class'] = trim( implode( ' ', array_merge( [ "rwmb-{$field['type']}" ], (array) $attributes['class'] ) ) ); $id = $attributes['id'] ?: $field['id']; if ( $field['name'] \|\| $field['label_description'] ) { $attributes['aria-labelledby'] = "$id-label"; } if ( $field['desc'] ) { $attributes['aria-describedby'] = "$id-description"; } return $attributes; } public static function render_attributes( array $attributes ): string { $output = ''; $attributes = array_filter( $attributes, 'RWMB_Helpers_Value::is_valid_for_attribute' ); foreach ( $attributes as $key => $value ) { if ( is_array( $value ) ) { $value = wp_json_encode( $value ); } $output .= sprintf( ' %s="%s"', $key, esc_attr( $value ) ); } return $output; } /* * Get the field value. * The difference between this function and 'meta' function is 'meta' function always returns the escaped value * of the field saved in the database, while this function returns more meaningful value of the field, for ex.: * for file/image: return array of file/image information instead of file/image IDs. * * Each field can extend this function and add more data to the returned value. * See specific field classes for details. * * @param array $field Field parameters. * @param array $args Additional arguments. Rarely used. See specific fields for details. * @param ?int $post_id Post ID. * * @return mixed Field value / public static function get_value( $field, $args = [], $post_id = null ) { // Some fields does not have ID like heading, custom HTML, etc. if ( empty( $field['id'] ) ) { return ''; } if ( ! $post_id ) { $post_id = get_the_ID(); } // Get raw meta value in the database, no escape. $value = self::call( $field, 'raw_meta', $post_id, $args ); // Make sure meta value is an array for cloneable and multiple fields. if ( $field['clone'] \|\| $field['multiple'] ) { $value = is_array( $value ) && ! empty( $value ) ? $value : []; } return $value; } /* * Output the field value. * Depends on field value and field types, each field can extend this method to output its value in its own way * See specific field classes for details. * * Note: we don't echo the field value directly. We return the output HTML of field, which will be used in * rwmb_the_field function later. * * @use self::get_value() * @see rwmb_the_value() * * @param array $field Field parameters. * @param array $args Additional arguments. Rarely used. See specific fields for details. * @param int\|null $post_id Post ID. null for current post. Optional. * * @return string HTML output of the field / public static function the_value( $field, $args = [], $post_id = null ) { $value = self::call( 'get_value', $field, $args, $post_id ); if ( false === $value ) { return ''; } return self::call( 'format_value', $field, $value, $args, $post_id ); } /* * Format value for the helper functions. * * @param array $field Field parameters. * @param string\|array $value The field meta value. * @param array $args Additional arguments. Rarely used. See specific fields for details. * @param int\|null $post_id Post ID. null for current post. Optional. * * @return string / public static function format_value( $field, $value, $args, $post_id ) { if ( ! $field['clone'] ) { return self::call( 'format_clone_value', $field, $value, $args, $post_id ); } $output = '<ul>'; foreach ( $value as $clone ) { $output .= '<li>' . self::call( 'format_clone_value', $field, $clone, $args, $post_id ) . '</li>'; } $output .= '</ul>'; return $output; } /* * Format value for a clone. * * @param array $field Field parameters. * @param string\|array $value The field meta value. * @param array $args Additional arguments. Rarely used. See specific fields for details. * @param int\|null $post_id Post ID. null for current post. Optional. * * @return string / public static function format_clone_value( $field, $value, $args, $post_id ) { if ( ! $field['multiple'] ) { return self::call( 'format_single_value', $field, $value, $args, $post_id ); } $output = '<ul>'; foreach ( $value as $single ) { $output .= '<li>' . self::call( 'format_single_value', $field, $single, $args, $post_id ) . '</li>'; } $output .= '</ul>'; return $output; } /* * Format a single value for the helper functions. Sub-fields should overwrite this method if necessary. * * @param array $field Field parameters. * @param string $value The value. * @param array $args Additional arguments. Rarely used. See specific fields for details. * @param int\|null $post_id Post ID. null for current post. Optional. * * @return string / public static function format_single_value( $field, $value, $args, $post_id ) { return $value; } /* * Call a method of a field. / public static function call() { $args = func_get_args(); $check = reset( $args ); // Params: method name, field, other params. if ( is_string( $check ) ) { $method = array_shift( $args ); $field = reset( $args ); // Keep field as 1st param. } else { // Params: field, method name, other params. $field = array_shift( $args ); $method = array_shift( $args ); if ( 'raw_meta' === $method ) { // Add field param after object id. array_splice( $args, 1, 0, [ $field ] ); } else { $args[] = $field; // Add field as last param. } } $class = RWMB_Helpers_Field::get_class( $field ); if ( method_exists( $class, $method ) ) { return call_user_func_array( [ $class, $method ], $args ); } _deprecated_function( esc_html( "$class::$method" ), '5.4.8' ); } /* * Apply various filters based on field type, id. * Filters: * - rwmb_{$name} * - rwmb_{$field['type']}_{$name} * - rwmb_{$field['id']}_{$name} * * @return mixed */ public static function filter() { $args = func_get_args(); // 3 first params must be: filter name, value, field. Other params will be used for filters. $name = array_shift( $args ); $value = array_shift( $args ); $field = array_shift( $args ); // List of filters. $filters = [ 'rwmb_' . $name, 'rwmb_' . $field['type'] . '_' . $name, ]; if ( $field['id'] ) { $field_id = $field['clone'] ? $field['_original_id'] : $field['id']; $filters[] = 'rwmb_' . $field_id . '_' . $name; } // Filter params: value, field, other params. Note: value is changed after each run. array_unshift( $args, $field ); foreach ( $filters as $filter ) { $filter_args = $args; array_unshift( $filter_args, $value ); $value = apply_filters_ref_array( $filter, $filter_args ); } return $value; } protected static function get_std( array $field ) { $depth = 0; if ( $field['multiple'] ) { ++$depth; } if ( $field['clone'] ) { ++$depth; } return Arr::to_depth( $field['std'], $depth ); } protected static function get_single_std( array $field ) { $depth = 0; if ( $field['multiple'] ) { ++$depth; } return Arr::to_depth( $field['std'], $depth ); } } Back

Edit File : field.php | Size : 17.90 KB

<?php
use MetaBox\Support\Arr;

/**
 * The field base class.
 * This is the parent class of all custom fields defined by the plugin, which defines all the common methods.
 * Fields must inherit this class and overwrite methods with its own.
 */
abstract class RWMB_Field {
	public static function add_actions() {}

public static function admin_enqueue_scripts() {}

/**
	 * Show field HTML
	 * Filters are put inside this method, not inside methods such as "meta", "html", "begin_html", etc.
	 * That ensures the returned value are always been applied filters.
	 * This method is not meant to be overwritten in specific fields.
	 *
	 * @param array $field   Field parameters.
	 * @param bool  $saved   Whether the meta box is saved at least once.
	 * @param int   $post_id Post ID.
	 */
	public static function show( array $field, bool $saved, $post_id = 0 ) {
		$meta = self::call( $field, 'meta', $post_id, $saved );
		$meta = self::filter( 'field_meta', $meta, $field, $saved );

$begin = static::begin_html( $field );
		$begin = self::filter( 'begin_html', $begin, $field, $meta );

// Separate code for cloneable and non-cloneable fields to make easy to maintain.
		if ( $field['clone'] ) {
			$field_html = RWMB_Clone::html( $meta, $field );
		} else {
			// Call separated methods for displaying each type of field.
			$field_html = self::call( $field, 'html', $meta );
			$field_html = self::filter( 'html', $field_html, $field, $meta );
		}

$end  = static::end_html( $field );
		$end  = self::filter( 'end_html', $end, $field, $meta );
		$html = self::filter( 'wrapper_html', $begin . $field_html . $end, $field, $meta );

// Display label and input in DIV and allow user-defined classes to be appended.
		$classes  = "rwmb-field rwmb-{$field['type']}-wrapper " . $field['class'];
		$required = $field['required'] || ! empty( $field['attributes']['required'] );

if ( $required ) {
			$classes .= ' required';
		}

$classes = esc_attr( trim( $classes ) );

$outer_html  = $field['before'];
		$outer_html .= '<div class="' . $classes . '">' . $html . '</div>';
		$outer_html .= $field['after'];

$outer_html = self::filter( 'outer_html', $outer_html, $field, $meta );

echo $outer_html; // phpcs:ignore WordPress.Security.EscapeOutput
	}

/**
	 * Get field HTML.
	 *
	 * @param mixed $meta  Meta value.
	 * @param array $field Field parameters.
	 *
	 * @return string
	 */
	public static function html( $meta, $field ) {
		return '';
	}

protected static function begin_html( array $field ): string {
		$id       = $field['attributes']['id'] ?? $field['id'];
		$required = $field['required'] || ! empty( $field['attributes']['required'] );
		$required = $required ? '<span class="rwmb-required">*</span>' : '';

$label = $field['name'] ? sprintf(
			// Translators: %1$s - field ID, %2$s - field label, %3$s - required asterisk, %4$s - label description.
			'<div class="rwmb-label" id="%1$s-label"><label for="%1$s">%2$s%3$s</label>%4$s</div>',
			esc_attr( $id ),
			$field['name'],
			$required,
			static::label_description( $field )
		) : '';

$data_max_clone   = is_numeric( $field['max_clone'] ) && $field['max_clone'] > 0 ? ' data-max-clone=' . $field['max_clone'] : '';
		$data_min_clone   = is_numeric( $field['min_clone'] ) && $field['min_clone'] > 0 ? ' data-min-clone=' . $field['min_clone'] : '';
		$data_empty_start = $field['clone_empty_start'] ? ' data-clone-empty-start="1"' : ' data-clone-empty-start="0"';

$input_open = sprintf(
			'<div class="rwmb-input" %s %s %s>',
			$data_min_clone,
			$data_max_clone,
			$data_empty_start
		);

return $label . $input_open;
	}

protected static function end_html( array $field ): string {
		return RWMB_Clone::add_clone_button( $field ) . static::input_description( $field ) . '</div>';
	}

protected static function label_description( array $field ): string {
		$id = $field['id'] ? ' id="' . esc_attr( $field['id'] ) . '-label-description"' : '';
		return $field['label_description'] ? "<p{$id} class='description'>{$field['label_description']}</p>" : '';
	}

protected static function input_description( array $field ): string {
		$id = $field['id'] ? ' id="' . esc_attr( $field['id'] ) . '-description"' : '';
		return $field['desc'] ? "<p{$id} class='description'>{$field['desc']}</p>" : '';
	}

/**
	 * Get raw meta value.
	 *
	 * @param int   $object_id Object ID.
	 * @param array $field     Field parameters.
	 * @param array $args      Arguments of {@see rwmb_meta()} helper.
	 *
	 * @return mixed
	 */
	public static function raw_meta( $object_id, $field, $args = [] ) {
		if ( empty( $field['id'] ) ) {
			return '';
		}

if ( isset( $field['storage'] ) ) {
			$storage = $field['storage'];
		} elseif ( isset( $args['object_type'] ) ) {
			$storage = rwmb_get_storage( $args['object_type'] );
		} else {
			$storage = rwmb_get_storage( 'post' );
		}

if ( ! isset( $args['single'] ) ) {
			$args['single'] = $field['clone'] || ! $field['multiple'];
		}

if ( $field['clone'] && $field['clone_as_multiple'] ) {
			$args['single'] = false;
		}

$value = $storage->get( $object_id, $field['id'], $args );
		$value = self::filter( 'raw_meta', $value, $field, $object_id, $args );
		return $value;
	}

/**
	 * Get meta value.
	 *
	 * @param int   $post_id Post ID.
	 * @param bool  $saved   Whether the meta box is saved at least once.
	 * @param array $field   Field parameters.
	 *
	 * @return mixed
	 */
	public static function meta( $post_id, $saved, $field ) {
		/**
		 * For special fields like 'divider', 'heading' which don't have ID, just return empty string
		 * to prevent notice error when displaying fields.
		 */
		if ( empty( $field['id'] ) ) {
			return '';
		}
		// Get raw meta.
		$raw_meta   = self::call( $field, 'raw_meta', $post_id );
		$single_std = self::call( 'get_single_std', $field );
		$std        = self::call( 'get_std', $field );

$saved = $saved && $field['save_field'];
		// Use $field['std'] only when the meta box hasn't been saved (i.e. the first time we run).
		$meta = $saved ? $raw_meta : $std;

if ( ! $field['clone'] ) {
			return $meta;
		}

// When a field is cloneable, it should always return an array.
		$meta = is_array( $raw_meta ) ? $raw_meta : [];

if ( empty( $meta ) ) {
			$empty_meta = empty( $raw_meta ) ? [ null ] : $raw_meta;
			$std        = $field['clone_empty_start'] ? [] : $std;
			$empty_std  = $field['clone_empty_start'] ? [] : Arr::to_depth( $empty_meta, Arr::depth( $std ) );

$meta = $saved ? $empty_std : $std;
		}

// 2. Always prepend a template
		array_unshift( $meta, $single_std );

return $meta;
	}

/**
	 * Process the submitted value before saving into the database.
	 *
	 * @param mixed $value     The submitted value.
	 * @param int   $object_id The object ID.
	 * @param array $field     The field settings.
	 */
	public static function process_value( $value, $object_id, array $field ) {
		$old_value = self::call( $field, 'raw_meta', $object_id );

// Allow field class change the value.
		if ( $field['clone'] ) {
			$value = RWMB_Clone::value( $value, $old_value, $object_id, $field );
		} else {
			$value = self::call( $field, 'value', $value, $old_value, $object_id );
			$value = self::filter( 'sanitize', $value, $field, $old_value, $object_id );
		}
		$value = self::filter( 'value', $value, $field, $old_value, $object_id );

return $value;
	}

/**
	 * Set value of meta before saving into database.
	 *
	 * @param mixed $new     The submitted meta value.
	 * @param mixed $old     The existing meta value.
	 * @param int   $post_id The post ID.
	 * @param array $field   The field parameters.
	 *
	 * @return mixed
	 */
	public static function value( $new, $old, $post_id, $field ) {
		return $new;
	}

/**
	 * Save meta value.
	 *
	 * @param mixed $new     The submitted meta value.
	 * @param mixed $old     The existing meta value.
	 * @param int   $post_id The post ID.
	 * @param array $field   The field parameters.
	 */
	public static function save( $new, $old, $post_id, $field ) {
		if ( empty( $field['id'] ) || ! $field['save_field'] ) {
			return;
		}
		$name    = $field['id'];
		$storage = $field['storage'];

// Remove post meta if it's empty.
		if ( ! RWMB_Helpers_Value::is_valid_for_field( $new ) ) {
			$storage->delete( $post_id, $name );
			return;
		}

// If field is cloneable AND not force to save as multiple rows, value is saved as a single row in the database.
		if ( $field['clone'] && ! $field['clone_as_multiple'] ) {
			$storage->update( $post_id, $name, $new );
			return;
		}

// Save cloned fields as multiple values instead serialized array.
		if ( ( $field['clone'] && $field['clone_as_multiple'] ) || $field['multiple'] ) {
			$storage->delete( $post_id, $name );
			$new = (array) $new;
			foreach ( $new as $new_value ) {
				$storage->add( $post_id, $name, $new_value, false );
			}
			return;
		}

// Default: just update post meta.
		$storage->update( $post_id, $name, $new );
	}

/**
	 * Normalize parameters for field.
	 *
	 * @param array|string $field Field settings.
	 * @return array
	 */
	public static function normalize( $field ) {
		// Quick define text fields with "name" attribute only.
		if ( is_string( $field ) ) {
			$field = [
				'name' => $field,
				'id'   => sanitize_key( $field ),
			];
		}
		$field = wp_parse_args( $field, [
			'id'                => '',
			'name'              => '',
			'type'              => 'text',
			'label_description' => '',
			'multiple'          => false,
			'std'               => '',
			'desc'              => '',
			'format'            => '',
			'before'            => '',
			'after'             => '',
			'field_name'        => $field['id'] ?? '',
			'placeholder'       => '',
			'save_field'        => true,

'clone'             => false,
			'min_clone'         => 0,
			'max_clone'         => 0,
			'sort_clone'        => false,
			'add_button'        => __( '+ Add more', 'meta-box' ),
			'clone_default'     => false,
			'clone_as_multiple' => false,
			'clone_empty_start' => false,

'class'             => '',
			'disabled'          => false,
			'required'          => false,
			'autofocus'         => false,
			'attributes'        => [],

'sanitize_callback' => null,
		] );

// Store the original ID to run correct filters for the cloneable field.
		if ( $field['clone'] ) {
			$field['_original_id'] = $field['id'];
		}

if ( $field['clone_default'] ) {
			$field['attributes'] = wp_parse_args( $field['attributes'], [
				'data-default'       => $field['std'],
				'data-clone-default' => 'true',
			] );
		}

return $field;
	}

/**
	 * Get the attributes for a field.
	 *
	 * @param array $field Field parameters.
	 * @param mixed $value Meta value.
	 *
	 * @return array
	 */
	public static function get_attributes( $field, $value = null ) {
		$attributes = wp_parse_args( $field['attributes'], [
			'disabled'  => $field['disabled'],
			'autofocus' => $field['autofocus'],
			'required'  => $field['required'],
			'id'        => $field['id'],
			'class'     => '',
			'name'      => $field['field_name'],
		] );

$attributes['class'] = trim( implode( ' ', array_merge( [ "rwmb-{$field['type']}" ], (array) $attributes['class'] ) ) );

$id = $attributes['id'] ?: $field['id'];
		if ( $field['name'] || $field['label_description'] ) {
			$attributes['aria-labelledby'] = "$id-label";
		}
		if ( $field['desc'] ) {
			$attributes['aria-describedby'] = "$id-description";
		}

return $attributes;
	}

public static function render_attributes( array $attributes ): string {
		$output = '';

$attributes = array_filter( $attributes, 'RWMB_Helpers_Value::is_valid_for_attribute' );
		foreach ( $attributes as $key => $value ) {
			if ( is_array( $value ) ) {
				$value = wp_json_encode( $value );
			}

$output .= sprintf( ' %s="%s"', $key, esc_attr( $value ) );
		}

return $output;
	}

/**
	 * Get the field value.
	 * The difference between this function and 'meta' function is 'meta' function always returns the escaped value
	 * of the field saved in the database, while this function returns more meaningful value of the field, for ex.:
	 * for file/image: return array of file/image information instead of file/image IDs.
	 *
	 * Each field can extend this function and add more data to the returned value.
	 * See specific field classes for details.
	 *
	 * @param  array $field   Field parameters.
	 * @param  array $args    Additional arguments. Rarely used. See specific fields for details.
	 * @param  ?int  $post_id Post ID.
	 *
	 * @return mixed Field value
	 */
	public static function get_value( $field, $args = [], $post_id = null ) {
		// Some fields does not have ID like heading, custom HTML, etc.
		if ( empty( $field['id'] ) ) {
			return '';
		}

if ( ! $post_id ) {
			$post_id = get_the_ID();
		}

// Get raw meta value in the database, no escape.
		$value = self::call( $field, 'raw_meta', $post_id, $args );

// Make sure meta value is an array for cloneable and multiple fields.
		if ( $field['clone'] || $field['multiple'] ) {
			$value = is_array( $value ) && ! empty( $value ) ? $value : [];
		}

return $value;
	}

/**
	 * Output the field value.
	 * Depends on field value and field types, each field can extend this method to output its value in its own way
	 * See specific field classes for details.
	 *
	 * Note: we don't echo the field value directly. We return the output HTML of field, which will be used in
	 * rwmb_the_field function later.
	 *
	 * @use self::get_value()
	 * @see rwmb_the_value()
	 *
	 * @param  array    $field   Field parameters.
	 * @param  array    $args    Additional arguments. Rarely used. See specific fields for details.
	 * @param  int|null $post_id Post ID. null for current post. Optional.
	 *
	 * @return string HTML output of the field
	 */
	public static function the_value( $field, $args = [], $post_id = null ) {
		$value = self::call( 'get_value', $field, $args, $post_id );

if ( false === $value ) {
			return '';
		}

return self::call( 'format_value', $field, $value, $args, $post_id );
	}

/**
	 * Format value for the helper functions.
	 *
	 * @param array        $field   Field parameters.
	 * @param string|array $value   The field meta value.
	 * @param array        $args    Additional arguments. Rarely used. See specific fields for details.
	 * @param int|null     $post_id Post ID. null for current post. Optional.
	 *
	 * @return string
	 */
	public static function format_value( $field, $value, $args, $post_id ) {
		if ( ! $field['clone'] ) {
			return self::call( 'format_clone_value', $field, $value, $args, $post_id );
		}
		$output = '<ul>';
		foreach ( $value as $clone ) {
			$output .= '<li>' . self::call( 'format_clone_value', $field, $clone, $args, $post_id ) . '</li>';
		}
		$output .= '</ul>';
		return $output;
	}

/**
	 * Format value for a clone.
	 *
	 * @param array        $field   Field parameters.
	 * @param string|array $value   The field meta value.
	 * @param array        $args    Additional arguments. Rarely used. See specific fields for details.
	 * @param int|null     $post_id Post ID. null for current post. Optional.
	 *
	 * @return string
	 */
	public static function format_clone_value( $field, $value, $args, $post_id ) {
		if ( ! $field['multiple'] ) {
			return self::call( 'format_single_value', $field, $value, $args, $post_id );
		}
		$output = '<ul>';
		foreach ( $value as $single ) {
			$output .= '<li>' . self::call( 'format_single_value', $field, $single, $args, $post_id ) . '</li>';
		}
		$output .= '</ul>';
		return $output;
	}

/**
	 * Format a single value for the helper functions. Sub-fields should overwrite this method if necessary.
	 *
	 * @param array    $field   Field parameters.
	 * @param string   $value   The value.
	 * @param array    $args    Additional arguments. Rarely used. See specific fields for details.
	 * @param int|null $post_id Post ID. null for current post. Optional.
	 *
	 * @return string
	 */
	public static function format_single_value( $field, $value, $args, $post_id ) {
		return $value;
	}

/**
	 * Call a method of a field.
	 */
	public static function call() {
		$args = func_get_args();

$check = reset( $args );

// Params: method name, field, other params.
		if ( is_string( $check ) ) {
			$method = array_shift( $args );
			$field  = reset( $args ); // Keep field as 1st param.
		} else {
			// Params: field, method name, other params.
			$field  = array_shift( $args );
			$method = array_shift( $args );

if ( 'raw_meta' === $method ) {
				// Add field param after object id.
				array_splice( $args, 1, 0, [ $field ] );
			} else {
				$args[] = $field; // Add field as last param.
			}
		}

$class = RWMB_Helpers_Field::get_class( $field );
		if ( method_exists( $class, $method ) ) {
			return call_user_func_array( [ $class, $method ], $args );
		}

_deprecated_function( esc_html( "$class::$method" ), '5.4.8' );
	}

/**
	 * Apply various filters based on field type, id.
	 * Filters:
	 * - rwmb_{$name}
	 * - rwmb_{$field['type']}_{$name}
	 * - rwmb_{$field['id']}_{$name}
	 *
	 * @return mixed
	 */
	public static function filter() {
		$args = func_get_args();

// 3 first params must be: filter name, value, field. Other params will be used for filters.
		$name  = array_shift( $args );
		$value = array_shift( $args );
		$field = array_shift( $args );

// List of filters.
		$filters = [
			'rwmb_' . $name,
			'rwmb_' . $field['type'] . '_' . $name,
		];
		if ( $field['id'] ) {
			$field_id  = $field['clone'] ? $field['_original_id'] : $field['id'];
			$filters[] = 'rwmb_' . $field_id . '_' . $name;
		}

// Filter params: value, field, other params. Note: value is changed after each run.
		array_unshift( $args, $field );
		foreach ( $filters as $filter ) {
			$filter_args = $args;
			array_unshift( $filter_args, $value );
			$value = apply_filters_ref_array( $filter, $filter_args );
		}

return $value;
	}

protected static function get_std( array $field ) {
		$depth = 0;

if ( $field['multiple'] ) {
			++$depth;
		}

if ( $field['clone'] ) {
			++$depth;
		}

return Arr::to_depth( $field['std'], $depth );
	}

protected static function get_single_std( array $field ) {
		$depth = 0;

if ( $field['multiple'] ) {
			++$depth;
		}

return Arr::to_depth( $field['std'], $depth );
	}
}

Back