do_settings_fields
Print out the settings fields for a particular settings section.
Description
Part of the Settings API. Use this in a settings page to output a specific section. Should normally be called by do_settings_sections(…)
rather than directly.
Parameters (2)
- 0. $page (string)
- Slug title of the admin page who's settings fields you want to show.
- 1. $section (string)
- Slug title of the settings section who's fields you want to show.
Usage
if ( !function_exists( 'do_settings_fields' ) ) { require_once ABSPATH . '/wp-admin/includes/template.php'; } // Slug title of the admin page who's settings fields you want to show. $page = ''; // Slug title of the settings section who's fields you want to show. $section = ''; // NOTICE! Understand what this does before running. $result = do_settings_fields($page, $section);
Defined (1)
The function is defined in the following location(s).
- /wp-admin/includes/template.php
- function do_settings_fields($page, $section) {
- global $wp_settings_fields;
- if ( ! isset( $wp_settings_fields[$page][$section] ) )
- return;
- foreach ( (array) $wp_settings_fields[$page][$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['callback'], $field['args']);
- echo '</td>';
- echo '</tr>';
- }
- }