I'm using Settings API and wondering if there's any way of editing default output of add_settings_field() function?
add_settings_field('the_field', 'bar', 'foo', 'page', 'section');
function foo() {
echo 'foo';
}
Outputs:
<table class="form-table">
<tr valign="top">
<th scope="row">bar</th>
<td>foo</td>
</tr>
How to get rid of these table tags and replace them with something else?
If you look at do_settings_fields() (line 1125, /wp-admin/includes/template.php), you can see that the table information is hardcoded into the the settings API. If you wish to not use the table, you will need to develop your own settings functions.
do_settings_fields() is basically using the API to determine the output markup. Doing so has its advantages (UI consistency, forward-compatibility), but if you must output custom markup, then you'll have to omit the do_settings_fields() call, and add your own, custom markup.
My custom function for this:
/**
* Prints out one specified field from settings section.
*
* Based on:
* @see do_settings_sections
*
* @global array $wp_settings_sections Storage array of all settings sections added to admin pages
* @global array $wp_settings_fields Storage array of settings fields and info about their pages/sections
*
* @param string $page The slug name of the page whose settings sections you want to output
* @param string $field_id Field ID for output
*/
public static function do_settings_section_field($page, $field_id) {
global $wp_settings_sections, $wp_settings_fields;
if ( ! isset( $wp_settings_sections[$page] ) )
return;
foreach ( (array) $wp_settings_sections[$page] as $section ) {
if ( $section['callback'] )
call_user_func( $section['callback'], $section );
if ( ! isset( $wp_settings_fields[$page][$section['id']] ) )
continue;
foreach ( (array) $wp_settings_fields[$page][$section['id']] as $field ) {
if ( $field['id'] !== $field_id )
continue;
call_user_func($field['callback'], $field['args']);
}
}
}
You can use this function instead of do_settings_sections(), with the same first arguments and field ID for render as second argument.
