Select.
*/
final class Select {
/**
* Returns true or false if the current select value exists as an option.
*/
protected static $value_exists;
/**
* Renders the custom param field.
*/
public static function output( $settings = [], $value = '' ) {
self::$value_exists = false; // must reset every time
$param_name = $settings['param_name'];
$type = $settings['choices'] ?? $param_name ?? []; // get the select choice type
$value = self::parse_value( $value, $type ); // !! must go before TotalThemeCore\Vcex\Setting_Choices !!
$refresh_choices = ! empty( $settings['refresh_choices'] ) || in_array( $type, [ 'template', 'card_style' ], true );
if ( ( '' === $value || null === $value ) && isset( $settings['std'] ) ) {
$value = $settings['std'];
}
if ( ! empty( $settings['choices_callback'] ) ) {
$choices = is_callable( $settings['choices_callback'] ) ? call_user_func( $settings['choices_callback'] ) : [];
} elseif ( class_exists( 'TotalThemeCore\Vcex\Setting_Choices' ) ) {
$choices = (new \TotalThemeCore\Vcex\Setting_Choices( $type, $settings ))->get_choices();
}
// If we don't have any choices return a text field with the value
// This is important to prevent issues where the choices is empty but we had a value saved.
if ( empty( $choices ) ) {
return '';
}
$select_class = "wpb_vc_param_value wpb-input wpb-select {$param_name} {$settings['type']}";
if ( 'card_style' === $type || ( isset( $settings['chosen_select'] ) && true === $settings['chosen_select'] ) ) {
$select_class .= ' vcex-chosen';
}
// Render select field
$select = '';
if ( $refresh_choices ) {
$output = '
' . $select . '
';
} else {
$output = $select;
}
// Show a create template/card link
if ( in_array( $type, [ 'acf_repeater_templates', 'template', 'card_style' ], true ) ) {
$template_post_type = 'card_style' === $type ? 'wpex_card' : 'wpex_templates';
if ( current_user_can( "publish_{$template_post_type}" ) && post_type_exists( $template_post_type ) ) {
$new_template_text = 'card_style' === $type
/* translators: link to create new card, close link */
? esc_html__( '%sCreate new custom card%s', 'total' )
/* translators: link to create new template, close link */
: esc_html__( '%sCreate new template%s', 'total' );
$new_template_url_params = [
'post_type' => $template_post_type,
'wpb-backend-editor' => 1,
];
if ( 'wpex_templates' == $template_post_type ) {
if ( 'modal_template' === $param_name ) {
$new_template_url_params['wpex_template_type'] = 'modal';
} else {
$new_template_url_params['wpex_template_type'] = 'acf_repeater_templates' === $type ? 'acf_repeater' : 'part';
}
}
$description = sprintf(
$new_template_text,
'',
'',
);
}
}
// Display notice
if ( ! empty( $settings['notice'] ) ) {
$description = $settings['notice'];
}
// Display inline description
if ( ! empty( $description ) ) {
$allowed_html = [
'span' => [
'class' => [],
],
'a' => [
'href' => [],
'rel' => [],
'target' => [],
'data-vcex-refresh-choices' => [],
'data-vcex-nonce' => [],
'class' => [],
],
];
$output .= '
' . wp_kses( $description, $allowed_html ) . '
';
}
// Return param HTML
return $output;
}
/**
* Render select options.
*/
protected static function render_options( $choices = [], $selected = '' ): string {
$html = '';
foreach ( $choices as $choice_k => $choice_v ) {
if ( is_array( $choice_v ) ) {
$sub_choices = $choice_v['choices'] ?? $choice_v['options'] ?? [];
if ( $sub_choices ) {
$html .= '';
}
} else {
// @note we use a loose check to support numbers
if ( $selected && ! self::$value_exists && $choice_k == $selected ) {
self::$value_exists = true;
}
$html .= '';
}
}
return $html;
}
/**
* Parses the field value.
*/
protected static function parse_value( $value, $choices ) {
if ( $value ) {
switch ( $choices ) {
case 'visibility':
$value = str_replace( '-portrait', '', $value );
$value = str_replace( '-landscape', '', $value );
break;
case 'font_weight':
if ( function_exists( 'vcex_parse_font_weight' ) ) {
$value = vcex_parse_font_weight( $value );
}
break;
}
}
return $value;
}
}