API de paramètres - création d'éléments de formulaire réutilisables?
J'ai un ensemble de champs de paramètres:
(...)
add_settings_field( 'Option1', 'Option 1', 'textarea', 'page1', 'plugin_options');
add_settings_field( 'Option2', 'Option 2', 'textarea', 'page1', 'plugin_options');
add_settings_field( 'Option3', 'Option 3', 'text_input', 'page1', 'plugin_options');
add_settings_field( 'Option4', 'Option 4', 'text_input', 'page1', 'plugin_options');
(...)
Tous les didacticiels et le Codex indiquent que je dois créer des fonctions de rendu distinctes pour chaque champ de paramètres, mais il ne serait pas beaucoup plus facile de créer uniquement des fonctions de base pour tous les champs de saisie tels que les cases à cocher, les boutons radio, les zones de texte, etc.
Je crois que cela fonctionnera sans problème si je pourrai transmettre des champs id à ces fonctions, mais je ne sais pas comment?
function textarea() {
$options = get_option('my_settings');
echo "<textarea id='[how to get ID?]' name='my_settings[[how to get ID?]'>{$options['how to get ID?']}</textarea>";
}
Vous avez absolument raison de pouvoir passer le balisage de champ de formulaire réutilisable à add_settings_field(). L'astuce consiste à définir le type de données pour chaque paramètre, puis à transmettre le même rappel à chaque appel de add_settings_field(). Dans ce rappel, vous ajoutez simplement un switch qui inclut des cas pour chaque type de données.
Voici comment je le fais en œnologie :
Premièrement, je renvoie dynamiquement tous les appels vers add_settings_field():
<?php
/**
* Call add_settings_field() for each Setting Field
*
* Loop through each Theme option, and add a new
* setting field to the Theme Settings page for each
* setting.
*
* @link http://codex.wordpress.org/Function_Reference/add_settings_field Codex Reference: add_settings_field()
*
* @param string $settingid Unique Settings API identifier; passed to the callback function
* @param string $title Title of the setting field
* @param callback $callback Name of the callback function in which setting field markup is output
* @param string $pageid Name of the Settings page to which to add the setting field; passed from add_settings_section()
* @param string $sectionid ID of the Settings page section to which to add the setting field; passed from add_settings_section()
* @param array $args Array of arguments to pass to the callback function
*/
foreach ( $option_parameters as $option ) {
$optionname = $option['name'];
$optiontitle = $option['title'];
$optiontab = $option['tab'];
$optionsection = $option['section'];
$optiontype = $option['type'];
if ( 'internal' != $optiontype && 'custom' != $optiontype ) {
add_settings_field(
// $settingid
'oenology_setting_' . $optionname,
// $title
$optiontitle,
// $callback
'oenology_setting_callback',
// $pageid
'oenology_' . $optiontab . '_tab',
// $sectionid
'oenology_' . $optionsection . '_section',
// $args
$option
);
} if ( 'custom' == $optiontype ) {
add_settings_field(
// $settingid
'oenology_setting_' . $optionname,
// $title
$optiontitle,
//$callback
'oenology_setting_' . $optionname,
// $pageid
'oenology_' . $optiontab . '_tab',
// $sectionid
'oenology_' . $optionsection . '_section'
);
}
}
?>
Et voici comment je définis oenology_setting_callback():
<?php
/**
* Callback for get_settings_field()
*/
function oenology_setting_callback( $option ) {
$oenology_options = oenology_get_options();
$option_parameters = oenology_get_option_parameters();
$optionname = $option['name'];
$optiontitle = $option['title'];
$optiondescription = $option['description'];
$fieldtype = $option['type'];
$fieldname = 'theme_oenology_options[' . $optionname . ']';
// Output checkbox form field markup
if ( 'checkbox' == $fieldtype ) {
?>
<input type="checkbox" name="<?php echo $fieldname; ?>" <?php checked( $oenology_options[$optionname] ); ?> />
<?php
}
// Output radio button form field markup
else if ( 'radio' == $fieldtype ) {
$valid_options = array();
$valid_options = $option['valid_options'];
foreach ( $valid_options as $valid_option ) {
?>
<input type="radio" name="<?php echo $fieldname; ?>" <?php checked( $valid_option['name'] == $oenology_options[$optionname] ); ?> value="<?php echo $valid_option['name']; ?>" />
<span>
<?php echo $valid_option['title']; ?>
<?php if ( $valid_option['description'] ) { ?>
<span style="padding-left:5px;"><em><?php echo $valid_option['description']; ?></em></span>
<?php } ?>
</span>
<br />
<?php
}
}
// Output select form field markup
else if ( 'select' == $fieldtype ) {
$valid_options = array();
$valid_options = $option['valid_options'];
?>
<select name="<?php echo $fieldname; ?>">
<?php
foreach ( $valid_options as $valid_option ) {
?>
<option <?php selected( $valid_option['name'] == $oenology_options[$optionname] ); ?> value="<?php echo $valid_option['name']; ?>"><?php echo $valid_option['title']; ?></option>
<?php
}
?>
</select>
<?php
}
// Output text input form field markup
else if ( 'text' == $fieldtype ) {
?>
<input type="text" name="<?php echo $fieldname; ?>" value="<?php echo wp_filter_nohtml_kses( $oenology_options[$optionname] ); ?>" />
<?php
}
// Output the setting description
?>
<span class="description"><?php echo $optiondescription; ?></span>
<?php
}
?>
Notez que je comptabilise un type "personnalisé" afin de pouvoir générer un balisage unique pour les paramètres qui peuvent en avoir besoin. Ceux-ci nécessitent des rappels individuels.
En outre, ce code représente une page de paramètres à onglets, qui peut s'avérer plus complexe que nécessaire. Il devrait être facile de rendre ce bit statique, cependant.