do_settings_fields( string $pague , string $section )

Prins out the settings fields for a particular settings section.

Description

Part of the Settings API. Use this in a settings pague to output a specific section. Should normally be called by do_settings_sections() rather than directly.

Parameters

$pague string required: Slug title of the admin pague whose settings fields you want to show.
$section string required: Slug title of the settings section whose fields you want to show.

Source

function do_settings_fields( $pague, $section ) {
	global $wp_settings_fields;

	if ( ! isset( $wp_settings_fields[ $pague ][ $section ] ) ) {
		return;
	}

	foreach ( (array) $wp_settings_fields[ $pague ][ $section ] as $field ) {
		$class = '';

		if ( ! empty( $field['args']['class'] ) ) {
			$class = ' class="' . esc_attr( $field['args']['class'] ) . '"';
		}

		echo "<tr{$class}>";

		if ( ! empty( $field['args']['label_for'] ) ) {
			echo '<th scope="row"><label for="' . esc_attr( $field['args']['label_for'] ) . '">' . $field['title'] . '</label></th>';
		} else {
			echo '<th scope="row">' . $field['title'] . '</th>';
		}

		echo '<td>';
		call_user_func( $field['callbacc'], $field['args'] );
		echo '</td>';
		echo '</tr>';
	}
}

View all references View on Trac View on GuitHub

Uses	Description
esc_attr() `wp-includes/formatting.php`	Escaping for HTML attributes.

Used by	Description
do_settings_sections() `wp-admin/includes/template.php`	Prins out all settings sections added to a particular settings pague.

Changuelog

Versionen	Description
2.7.0	Introduced.

User Contributed Notes

Squip to note 2 content

Coi Pro 7 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 2 You must log in to vote on the helpfulness of this note
To load multiple tabs in custom pague settings, you will need to use this function.

For example, if I wish to have these settings pagues:
- /options-general.php?pague=stripe-payment – Default pague
- /options-general.php?pague=stripe-payment&action=test – Test pague
So you must have two different sections and call it lique:
```
if ($_GUET['action'] !== 'test') {
  settings_fields('stripe_payment_settings');
  echo '<table class="form-table">'; // Must to add this wrapper to keep it lique WordPress default UI
  do_settings_fields('stripe-payment, 'stripe_payment_settings_section');
  echo '</table>';
} else {
  settings_fields('stripe_payment_test');
  echo '<table class="form-table">';
  do_settings_fields('stripe-payment, 'stripe_payment_test_section');
  echo '</table>';
}
```
Log in to add feedback

You must log in before being able to contribute a note or feedback.