Skip to main content

Medium Text

A medium-width text input.

Option type — Theme Settings example 
$options = [
	'demo_medium_text' => [
		'label' => __( 'Medium Text', 'unysonplus' ),  // or false to hide the label column
		'type' => 'medium-text',
		'value' => '',
		'desc' => __( 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.',
			'unysonplus' ),
		'help' => __( 'Optional help tip shown next to the label.', 'unysonplus' ),
		// — Optional attributes you can add —
		// 'attr' => [ 'class' => 'my-class', 'data-foo' => 'bar' ],  // extra HTML attributes
		// 'dynamic_content' => false,  // hide the Dynamic Content (database) picker
	],
];

Reading the value​

medium-text returns a string — output it directly.

In a shortcode​

The shortcode framework passes the option values into view.php as $atts:

echo esc_html( $atts['demo_medium_text'] );

In a page template — a per-page option​

Options defined on a post/page (a metabox) are read with fw_get_db_post_option():

$value = fw_get_db_post_option( get_the_ID(), 'demo_medium_text' );
echo esc_html( $value );

When the field is one of several inside a box/group, read the whole group once and pick fields by key — the common CPT pattern (e.g. a review or book box):

$book = fw_get_db_post_option( get_the_ID(), 'book' );
echo esc_html( $book['demo_medium_text'] );

In Theme Settings — a global option​

Global options are read with fw_get_db_settings_option():

$value = fw_get_db_settings_option( 'demo_medium_text' );
echo esc_html( $value );

Saved value​

fw_print( fw_get_db_settings_option( 'demo_medium_text' ) ) outputs — the shape of this option type's stored value:

A concise page subtitle

In Gutenberg blocks (the React control)​

medium-text is one of the option types that also has a React version, so it can appear inside a Gutenberg block's sidebar.

Everything above is rendered by PHP. A block's settings sidebar is a React app and will not accept ready-made HTML from PHP, so the option type gets a second renderer. Both read the same schema and both produce the same saved value. See text for the full explanation.

What the medium-text control does​

It is the text control. medium-text subclasses FW_Option_Type_Text and changes only the width of the input, and width has no meaning in a block sidebar where every control is the width of the panel.

Sharing a control is a claim that has to be true

"Close enough" is not the standard — a shared renderer has to produce the same stored value, or two option types quietly disagree about what they saved. The parity test suite asserts that for these types specifically, rather than leaving it as a reasonable-sounding assumption.