do_settings_fields

Print out the settings fields for a particular settings section.

Description

do_settings_fields( (string) $page, (string) $section );

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>'; 
    } 
}