Sobre la setting API de wordpress

[rogertm]

Tal vez la Setting API no sea la manera más sencilla, pero si es la mejor, y cuando le coges la vuelta, te darás cuenta que no es complicado, de hecho te simplifica muchas cosas. Así que mi recomendación es usar esta API para este tipo de cosas.

En cuanto a la manera de implementar el código, pues eso depende mucho de tus conocimientos, que crecerán a medida que trabajes en ello, y las necesidades que tengas. Trataré aquí de mostrarte algo basándome en un proyecto en el que uso esta API.

Estoy creando un theme/framework donde tengo varias opciones, Generales, Cabecera, Layout, Social Networks Links, etc... Te mostraré a modo ejemplo cómo hago para las opciones de la cabecera, que son tres:

1. No mostrar imagen de cabecera
2. Mostrar imagen de cabecera
2.1. Mostrar o no imagen destacada en single.php si existe
3. Mostrar un slider con noticias de una categoría determinada
3.n El slider tiene varias opciones, como alinear el thumbnail (izq o der), tamaño del thumbnail, etc...

Entonces lo hago mediante arrays, para la opción 1. es simple, pero para las otras dos, que tienen sub-opciones lo que hago es llamar, en uno de los elementos del array, una función aparte. Vemos algo de código para entrar en materia;

Primero registramos las opciones:

Código PHP:

/**
 * Register setting options
 */
add_action( 'admin_init', 't_em_register_setting_options_init' );
function t_em_register_setting_options_init(){
    // Based on Twentyeleven WordPress Theme
    register_setting( 't_em_options', 't_em_theme_options', 't_em_theme_options_validate' );
 
    // Register our settings field group
    add_settings_section( 'general', '', '__return_false', 'theme-options' );
 
    // Register our individual settings fields
    add_settings_field( 't_em_general_set',    __( 'General Options', 't_em' ),        't_em_settings_field_general_options_set',    'theme-options',    'general' );
    add_settings_field( 't_em_header_set',    __( 'Header Options', 't_em' ),            't_em_settings_field_header_set',            'theme-options',    'general' );
    /** otras opciones */
}
 

Luego la función:

Código PHP:

/**
 * Return an array of header options for Twenty'em
 */
function t_em_header_options(){
    $header_options = array (
        'no-header-image' => array (
            'value' => 'no-header-image',
            'label' => __( 'No header image', 't_em' ),
            'extend' => '',
        ),
        'header-image' => array (
            'value' => 'header-image',
            'label' => __( 'Header image', 't_em' ),
            'extend' => t_em_header_image_callback(),
        ),
        'slider' => array (
            'value' => 'slider',
            'label' => __( 'Slider', 't_em' ),
            'extend' => t_em_slider_callback(),
        ),
    );
 
    return apply_filters( 't_em_header_options', $header_options );
}
 

Seguimos con las funciones tipo callback, en este caso las de la imagen de cabecera y el slider:

Código PHP:

/**
 * Extend setting for header image option
 */
function t_em_header_image_callback(){
    /** Tu código aquí... */
}
 
/**
 * Extend setting for slider option
 */
function t_em_slider_callback(){
    /** Tu código aquí... */
}
 

Al final muestro el formulario:

Código PHP:

/**
 * Render the Header setting field
 */
function t_em_settings_field_header_set(){
    global $t_em_theme_options;
?>
    <div id="header-options">
<?php
    foreach ( t_em_header_options() as $header ) :
?>
        <div class="layout radio-option header">
            <label class="description">
                <input type="radio" name="t_em_theme_options[header-set]" class="head-radio-option" value="<?php echo esc_attr( $header['value'] ); ?>" <?php checked( $t_em_theme_options['header-set'], $header['value'] ); ?> />
                <span><?php echo $header['label']; ?></span>
            </label>
        </div>
<?php
    endforeach;
 
    foreach ( t_em_header_options() as $sub_header ) :
        if ( $sub_header['extend'] != '' ) :
            $selected_option = ( $t_em_theme_options['header-set'] == $sub_header['value'] ) ? 'selected-option' : '';
?>
        <div id="<?php echo $sub_header['value']; ?>" class="sub-layout header-extend <?php echo $selected_option; ?>">
            <?php echo $sub_header['extend']; ?>
        </div>
<?php
        endif;
    endforeach;
?>
    </div><!-- #header-options -->
<?php
}
 

Me limité a no poner las funciones callback para ahorrar espacio en el post, pero aquí puedes ver algo más de este mismo código.

Espero te sirva de ejemplo lo que te doy aquí. A veces por querer ahorrar código terminamos enredando el trabajo y tal ves tengamos un scrip mas corto, pero que demora más.

En este ejemplo tengo un archivo de 827 lineas, con todas las opciones, validaciones, valores por defecto y algo de comentarios

También te recomiendo mires en el theme Twentyeleven que trae buenos ejemplos de esto mismo...

Saludos.