<?php
defined( 'ABSPATH' ) || die;
/**
* The text list field which allows users to enter multiple texts.
*/
class RWMB_Text_List_Field extends RWMB_Multiple_Values_Field {
public static function admin_enqueue_scripts() {
wp_enqueue_style( 'rwmb-text-list', RWMB_CSS_URL . 'text-list.css', [], RWMB_VER );
wp_style_add_data( 'rwmb-text-list', 'path', RWMB_CSS_DIR . 'text-list.css' );
}
/**
* Get field HTML.
*
* @param mixed $meta Meta value.
* @param array $field Field parameters.
*
* @return string
*/
public static function html( $meta, $field ) {
if ( empty( $field['options'] ) ) {
return '';
}
$html = [];
$input = '<label><span class="rwmb-text-list-label">%s</span> <input %s></label>';
$attributes = self::get_attributes( $field, $meta );
$attributes['type'] = 'text';
$count = 0;
foreach ( $field['options'] as $placeholder => $label ) {
$attributes['value'] = $meta[ $count ] ?? '';
$attributes['placeholder'] = $placeholder;
$html[] = sprintf(
$input,
$label,
self::render_attributes( $attributes )
);
$count ++;
}
return implode( ' ', $html );
}
/**
* Normalize parameters for field.
*
* @param array $field Field parameters.
*
* @return array
*/
public static function normalize( $field ) {
$field = parent::normalize( $field );
if ( ! $field['clone'] ) {
$field['class'] .= ' rwmb-text_list-non-cloneable';
}
return $field;
}
/**
* Set value of meta before saving into database.
* Do not save if all inputs has no 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.
*
* @return mixed
*/
public static function value( $new, $old, $post_id, $field ) {
$filtered = array_filter( $new );
return count( $filtered ) ? $new : [];
}
/**
* 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 ) {
$output = '<table><thead><tr>';
foreach ( $field['options'] as $label ) {
$output .= "<th>$label</th>";
}
$output .= '</tr></thead><tbody>';
if ( ! $field['clone'] ) {
$output .= self::format_single_value( $field, $value, $args, $post_id );
} else {
foreach ( $value as $subvalue ) {
$output .= self::format_single_value( $field, $subvalue, $args, $post_id );
}
}
$output .= '</tbody></table>';
return $output;
}
/**
* Format a single value for the helper functions. Sub-fields should overwrite this method if necessary.
*
* @param array $field Field parameters.
* @param array $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 ) {
$output = '<tr>';
foreach ( $value as $subvalue ) {
$output .= "<td>$subvalue</td>";
}
$output .= '</tr>';
return $output;
}
}