class-ld-settings-fields-multiselect.php
4.44 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
<?php
/**
* LearnDash Multiselect Settings Field.
*
* @since 3.0.0
* @package LearnDash\Settings\Field
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
if ( ( class_exists( 'LearnDash_Settings_Fields' ) ) && ( ! class_exists( 'LearnDash_Settings_Fields_Multiselect' ) ) ) {
/**
* Class LearnDash Multiselect Settings Field.
*
* @since 3.0.0
* @uses LearnDash_Settings_Fields
*/
class LearnDash_Settings_Fields_Multiselect extends LearnDash_Settings_Fields {
/**
* Public constructor for class
*
* @since 3.0.0
*/
public function __construct() {
$this->field_type = 'multiselect';
parent::__construct();
}
/**
* Function to crete the settings field.
*
* @since 3.0.0
*
* @param array $field_args An array of field arguments used to process the output.
* @return void
*/
public function create_section_field( $field_args = array() ) {
// Force multiple.
$field_args['multiple'] = true;
/** This filter is documented in includes/settings/settings-fields/class-ld-settings-fields-checkbox-switch.php */
$field_args = apply_filters( 'learndash_settings_field', $field_args );
/** This filter is documented in includes/settings/settings-fields/class-ld-settings-fields-checkbox-switch.php */
$html = apply_filters( 'learndash_settings_field_html_before', '', $field_args );
$html .= '<span class="ld-select ld-select-multiple">';
$html .= '<select multiple autocomplete="off" ';
$html .= $this->get_field_attribute_name( $field_args );
$html .= $this->get_field_attribute_id( $field_args );
$html .= $this->get_field_attribute_class( $field_args );
$html .= $this->get_field_attribute_placeholder( $field_args );
if ( learndash_use_select2_lib() ) {
if ( ! isset( $field_args['attrs']['data-ld-select2'] ) ) {
$html .= ' data-ld-select2="1" ';
}
}
$html .= $this->get_field_attribute_misc( $field_args );
$html .= $this->get_field_attribute_required( $field_args );
$html .= ' >';
if ( ( isset( $field_args['options'] ) ) && ( ! empty( $field_args['options'] ) ) ) {
foreach ( $field_args['options'] as $option_key => $option_label ) {
if ( ( '' === $option_key ) && ( learndash_use_select2_lib() ) ) {
continue;
}
$selected_item = '';
if ( is_string( $field_args['value'] ) ) {
$selected_item = selected( $option_key, $field_args['value'], false );
} elseif ( is_array( $field_args['value'] ) ) {
if ( in_array( $option_key, $field_args['value'], true ) ) {
$selected_item = ' selected="" ';
}
}
$html .= '<option value="' . esc_attr( $option_key ) . '" ' . $selected_item . '>' . wp_kses_post( $option_label ) . '</option>';
}
}
$html .= '</select>';
$html .= '</span>';
/** This filter is documented in includes/settings/settings-fields/class-ld-settings-fields-checkbox-switch.php */
$html = apply_filters( 'learndash_settings_field_html_after', $html, $field_args );
echo $html; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Need to output HTML
}
/**
* Validate field
*
* @since 3.0.0
*
* @param mixed $val Value to validate.
* @param string $key Key of value being validated.
* @param array $args Array of field args.
*
* @return integer value.
*/
public function validate_section_field( $val, $key = '', $args = array() ) {
if ( ( isset( $args['field']['type'] ) ) && ( $args['field']['type'] === $this->field_type ) ) {
if ( ( is_array( $val ) ) && ( ! empty( $val ) ) ) {
$val = array_map( $args['field']['value_type'], $val );
} elseif ( ! empty( $val ) ) {
$val = call_user_func( $args['field']['value_type'], $val );
} else {
$val = '';
}
return $val;
}
return false;
}
/**
* Convert Settings Field value to REST value.
*
* @since 3.3.0
*
* @param mixed $val Value from REST to be converted to internal value.
* @param string $key Key field for value.
* @param array $field_args Array of field args.
* @param WP_REST_Request $request Request object.
*/
public function field_value_to_rest_value( $val, $key, $field_args, WP_REST_Request $request ) {
if ( ! is_array( $val ) ) {
$val = array( $val );
}
return $val;
}
// end of functions.
}
}
add_action(
'learndash_settings_sections_fields_init',
function() {
LearnDash_Settings_Fields_Multiselect::add_field_instance( 'multiselect' );
}
);