Skip to main content

Short Text

A narrow, compact-width text input — otherwise identical to Text.

Option type — Theme Settings example 
$options = [
	'demo_short_text' => [
		'label' => __( 'Short Text', 'unysonplus' ),
		'type' => 'short-text',
		'value' => '7',
		'desc' => __( 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.',
			'unysonplus' ),
		'help' => sprintf( "%s \n\n'\"<br/><br/>\n\n <b>%s</b>",
			__( 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.',
				'unysonplus' ),
			__( 'Sed ut perspiciatis, unde omnis iste natus error sit voluptatem accusantium doloremque laudantium',
				'unysonplus' )
		),
		// — Optional attributes you can add —
		// 'dynamic_content' => true,
	],
];

Reading the value​

short-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_short_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_short_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_short_text'] );

In Theme Settings — a global option​

Global options are read with fw_get_db_settings_option():

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

Saved value​

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

7

In Gutenberg blocks (the React control)​

short-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 short-text control does​

It is the text control. short-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.