get_field_name( $tab_id, $menu_item, $field_key );
// Keep legacy ID contract for Images tab (admin-galleries.js relies on #rl-{tab}-{menu}-{field} selectors).
if ( $tab_id === 'images' ) {
$id = sanitize_html_class( 'rl-' . $tab_id . '-' . $menu_item . '-' . $field_key );
} else {
$id = sanitize_key( $name );
}
$disabled = ! empty( $field['disabled'] ) ? ' disabled="disabled"' : '';
// Handle field types
switch ( $field['type'] ) {
case 'text':
case 'color':
$input_html = sprintf(
'',
esc_attr( $field['type'] ),
esc_attr( $id ),
esc_attr( $name ),
esc_attr( $value ),
$disabled
);
// Add append text if specified
if ( isset( $field['append'] ) ) {
$input_html .= '' . esc_html( $field['append'] ) . '';
}
return $input_html;
case 'number':
$attrs = '';
if ( isset( $field['min'] ) ) {
$attrs .= ' min="' . esc_attr( $field['min'] ) . '"';
}
if ( isset( $field['max'] ) ) {
$attrs .= ' max="' . esc_attr( $field['max'] ) . '"';
}
if ( isset( $field['step'] ) ) {
$attrs .= ' step="' . esc_attr( $field['step'] ) . '"';
}
$input_html = sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
esc_attr( $value ),
$attrs,
$disabled
);
if ( isset( $field['append'] ) ) {
$input_html .= '' . esc_html( $field['append'] ) . '';
}
return $input_html;
case 'textarea':
$class = isset( $field['class'] ) ? $field['class'] : 'large-text';
return sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
esc_attr( $class ),
$disabled,
esc_textarea( $value )
);
case 'select':
$options = '';
if ( isset( $field['options'] ) && is_array( $field['options'] ) ) {
foreach ( $field['options'] as $option_value => $option_label ) {
$options .= sprintf(
'',
esc_attr( $option_value ),
selected( $value, $option_value, false ),
esc_html( $option_label )
);
}
}
return sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
$disabled,
$options
);
case 'checkbox':
$checked_value = false;
if ( is_array( $value ) ) {
$checked_value = in_array( 1, $value, true ) || in_array( '1', $value, true ) || in_array( true, $value, true );
} else {
$checked_value = ( $value === 1 || $value === '1' || $value === true );
}
return sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
checked( $checked_value, true, false ),
$disabled
);
case 'boolean':
$label = ! empty( $field['label'] ) ? wp_kses_post( $field['label'] ) : '';
$html = '';
if ( empty( $field['disabled'] ) ) {
$html .= '';
}
$html .= '';
return $html;
case 'color_picker':
$color_value = is_string( $value ) && $value !== '' ? $value : ( $field['default'] ?? '#000000' );
$color_value = esc_attr( $color_value );
$color_name = esc_attr( $name );
$input_id = esc_attr( $id );
$input_class = 'small-text rl-color-input';
$swatch_style = ' style="background-color: ' . $color_value . ';"';
return '';
case 'radio':
$radios = '';
if ( isset( $field['options'] ) && is_array( $field['options'] ) ) {
$display_type = ! empty( $field['display_type'] ) && in_array( $field['display_type'], [ 'horizontal', 'vertical' ], true )
? $field['display_type']
: 'horizontal';
$group_classes = 'rl-field-group rl-radio-group ' . $display_type;
$label_class = 'rl-' . sanitize_html_class( $tab_id . '-' . $menu_item . '-' . $field_key );
$radios .= '';
foreach ( $field['options'] as $option_value => $option_label ) {
$option_id = 'rl-' . $tab_id . '-' . $menu_item . '-' . $field_key . '-' . $option_value;
$option_id = sanitize_html_class( $option_id );
$radios .= sprintf(
' ',
esc_attr( $label_class ),
esc_attr( $option_id ),
esc_attr( $option_id ),
esc_attr( $name ),
esc_attr( $option_value ),
checked( $value, $option_value, false ),
$disabled,
esc_html( $option_label )
);
}
$radios .= '
';
}
return $radios;
case 'multiselect':
$options = '';
$selected_values = is_array( $value ) ? array_map( 'strval', $value ) : [];
if ( isset( $field['options'] ) && is_array( $field['options'] ) ) {
foreach ( $field['options'] as $option_value => $option_label ) {
// Support grouped options format used by Featured -> Post Term:
// [taxonomy] => [ 'label' => 'Taxonomy Name', 'terms' => [ term_id => term_name ] ].
if ( is_array( $option_label ) && isset( $option_label['terms'] ) && is_array( $option_label['terms'] ) ) {
$group_label = isset( $option_label['label'] ) && is_scalar( $option_label['label'] )
? (string) $option_label['label']
: (string) $option_value;
$group_options = '';
foreach ( $option_label['terms'] as $term_value => $term_label ) {
if ( ! is_scalar( $term_label ) )
continue;
$selected = in_array( (string) $term_value, $selected_values, true ) ? 'selected="selected"' : '';
$group_options .= sprintf(
'',
esc_attr( $term_value ),
$selected,
esc_html( (string) $term_label )
);
}
if ( $group_options !== '' ) {
$options .= sprintf(
'',
esc_attr( $group_label ),
$group_options
);
}
continue;
}
if ( ! is_scalar( $option_label ) ) {
if ( is_array( $option_label ) && isset( $option_label['label'] ) && is_scalar( $option_label['label'] ) )
$option_label = (string) $option_label['label'];
else
continue;
}
$selected = in_array( (string) $option_value, $selected_values, true ) ? 'selected="selected"' : '';
$options .= sprintf(
'',
esc_attr( $option_value ),
$selected,
esc_html( (string) $option_label )
);
}
}
return sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
$disabled,
$options
);
case 'taxonomy':
return $this->render_taxonomy_field( $field_key, $field, $value, $post_id, $tab_id, $menu_item, $name, $id, $disabled );
case 'media_preview':
return $this->render_media_preview_field( $field_key, $field, $value, $post_id, $tab_id, $menu_item );
case 'media_library':
return $this->render_media_library_field( $field_key, $field, $value, $post_id, $tab_id, $menu_item, $name );
case 'custom':
if ( ! empty( $field['callback'] ) && is_callable( $field['callback'] ) ) {
$callback_args = [
'name' => $name,
'html_id' => $id,
'value' => $value,
'field' => $field,
'field_id' => $field_key,
'tab_id' => $tab_id,
'menu_item' => $menu_item,
'post_id' => $post_id
];
if ( ! empty( $field['callback_args'] ) && is_array( $field['callback_args'] ) )
$callback_args = array_merge( $callback_args, $field['callback_args'] );
return call_user_func( $field['callback'], $callback_args );
}
return '';
case 'hidden':
$hidden_input = sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
esc_attr( $value )
);
if ( ! empty( $field['callback'] ) && is_callable( $field['callback'] ) ) {
$callback_args = [
'field' => $field_key,
'tab_id' => $tab_id,
'menu_item' => $menu_item,
'value' => $value,
'post_id' => $post_id
];
$callback_output = '';
try {
if ( is_array( $field['callback'] ) ) {
$reflection = new ReflectionMethod( $field['callback'][0], $field['callback'][1] );
} else {
$reflection = new ReflectionFunction( $field['callback'] );
}
$callback_output = $reflection->getNumberOfParameters() <= 1
? call_user_func( $field['callback'], $callback_args )
: call_user_func( $field['callback'], $field_key, $field, $value, $post_id, $tab_id, $menu_item );
} catch ( Exception $e ) {
$callback_output = call_user_func( $field['callback'], $field_key, $field, $value, $post_id, $tab_id, $menu_item );
}
$allowed_html = [
'span' => [
'id' => true,
'class' => true,
'data-provider' => true,
'data-name' => true,
'data-value' => true
]
];
return $hidden_input . wp_kses( (string) $callback_output, $allowed_html );
}
return $hidden_input;
case 'notice':
$content = ! empty( $field['content'] ) ? wp_kses_post( $field['content'] ) : '';
$class = ! empty( $field['class'] ) ? ' ' . esc_attr( $field['class'] ) : '';
return '' . $content . '
';
default:
// Allow add-ons to provide custom rendering for unrecognized field types.
// Returns empty string by default; non-empty return replaces text input fallback.
$custom_output = apply_filters( 'rl_gallery_render_field', '', $field_key, $field, $value, $post_id, $tab_id, $menu_item, $name, $id );
if ( $custom_output !== '' ) {
return $custom_output;
}
// Unknown field types: render as text input.
return sprintf(
'',
esc_attr( $id ),
esc_attr( $name ),
esc_attr( $value )
);
}
}
/**
* Render a taxonomy dropdown field.
*
* Used by the Images tab 'folders' menu item for media folder selection.
*
* @param string $field_key Field key.
* @param array $field Field configuration.
* @param mixed $value Current value (array with 'id' and 'children' keys).
* @param int $post_id Post ID.
* @param string $tab_id Tab ID.
* @param string $menu_item Menu item ID.
* @param string $name Input name.
* @param string $id Input id.
* @param string $disabled Disabled attribute string.
* @return string HTML output.
*/
private function render_taxonomy_field( $field_key, $field, $value, $post_id, $tab_id, $menu_item, $name, $id, $disabled ) {
$html = '';
$taxonomy = isset( $field['taxonomy'] ) ? $field['taxonomy'] : '';
$value_id = is_array( $value ) && isset( $value['id'] ) ? $value['id'] : 0;
$value_children = is_array( $value ) && isset( $value['children'] ) ? $value['children'] : false;
if ( $taxonomy && taxonomy_exists( $taxonomy ) ) {
$html = wp_dropdown_categories( [
'orderby' => 'name',
'order' => 'asc',
'show_option_none' => __( 'Root Folder', 'responsive-lightbox' ),
'show_option_all' => false,
'show_count' => false,
'hide_empty' => false,
'option_none_value' => 0,
'hierarchical' => true,
'selected' => $value_id,
'taxonomy' => $taxonomy,
'hide_if_empty' => false,
'echo' => false,
'id' => $id,
'name' => $name . '[id]'
] );
} else {
$html = ' ';
}
if ( $disabled ) {
$html = preg_replace( '/