';
self::render_field_inner( $type, $settings, $value, $module_id );
echo '
';
self::render_field_description( $settings, $value, $module_id );
echo '';
}
/**
* Resolve the default value for a field based on its type.
*
* Handles type-specific fallback logic for checkbox_multiple,
* text, and url field types.
*
* @since 1.9.3
*
* @param array';
}
/**
* Render the title bar for a field, including Pro upsell badge.
*
* @since 1.9.3
*
* @param array $settings The field configuration array.
* @param string $id The field ID.
* @param bool $is_upsell Whether to show the Pro upsell badge.
*
* @return void
*/
private static function render_field_title( $settings, $id, $is_upsell ) {
if ( empty( $settings['title'] ) ) {
return;
}
?>
$settings The field configuration array.
* @param mixed $value The field value.
* @param string $module_id The module ID.
*
* @return void
*/
private static function render_field_inner( $type, $settings, $value, $module_id ) {
$registry = Merchant_Field_Registry::instance();
if ( $registry->has( $type ) ) {
try {
$field_instance = $registry->create( $type, $settings, $value, $module_id );
if ( $field_instance !== null ) {
$field_instance->render();
}
} catch ( \Exception $e ) {
wp_trigger_error( __METHOD__, 'Merchant field render error (' . $type . '): ' . $e->getMessage() ); // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped
}
} else {
printf(
' $settings The field configuration array.
* @param mixed $value The field value.
* @param string $module_id The module ID.
*
* @return void
*/
private static function render_field_description( $settings, $value, $module_id ) {
$hidden_desc = $settings['hidden_desc'] ?? '';
/**
* Hook 'merchant_admin_module_field_hidden_description'
*
* @since 1.9.3
*/
$hidden_desc = apply_filters( 'merchant_admin_module_field_hidden_description', $hidden_desc, $settings, $value, $module_id );
$desc = $settings['desc'] ?? '';
/**
* Hook 'merchant_admin_module_field_description'
*
* @since 1.9.3
*/
$desc = apply_filters( 'merchant_admin_module_field_description', $desc, $settings, $value, $module_id );
if ( ! empty( $desc ) ) {
$hidden_desc_html = '';
if ( ! empty( $hidden_desc ) ) {
$hidden_desc_html = ' $settings Field settings.
* @param mixed $value Field value.
* @param string $module_id Module ID.
*
* @return void
*/
public static function disabled_field( $settings, $value, $module_id = '' ) {
ob_start();
self::field( $settings, $value, $module_id );
$field_html = (string) ob_get_clean();
$field_html = str_replace(
array( '
%s %s
',
esc_html__( 'Merchant field error:', 'merchant' ),
esc_html(
sprintf(
/* translators: %s: the unsupported field type slug */
__( 'Unknown field type "%s". Register it via the merchant_field_types filter.', 'merchant' ),
$type
)
)
);
_doing_it_wrong(
__METHOD__,
sprintf( 'Unknown field type "%s". Register it via the merchant_field_types filter.', esc_html( $type ) ),
'2.2.5'
);
}
}
/**
* Render the description and hidden description for a field.
*
* @since 1.9.3
*
* @param array' . esc_html__( 'Show more', 'merchant' ) . '';
$hidden_desc_html .= ' . ')
';
$hidden_desc_html .= '
';
}
$desc_class = 'merchant-module-page-setting-field-desc'
. ( $hidden_desc ? ' merchant-module-page-setting-field-desc-has-hidden-desc' : '' );
printf( '';
$hidden_desc_html .= '%s%s
', esc_attr( $desc_class ), wp_kses_post( $desc ), wp_kses_post( $hidden_desc_html ) );
}
if ( ! empty( $hidden_desc ) ) {
printf( '%s
', wp_kses_post( nl2br( $hidden_desc ) ) );
}
}
/**
* Render a disabled (pro-gated) field.
*
* Renders the field via the normal registry path, then disables all
* interactive elements so the user can see the control but not interact.
*
* @since 1.0
*
* @param array