Como passar argumentos de add_settings_field () para a função de retorno de chamada?

16

Eu tenho uma função como esta:

add_settings_field( 'contact_phone', 'Contact Phone', 'settings_callback', 'general');

Isso funciona. Ele chama settings_callback. Legal. O problema que tenho com isso é: não quero definir uma função de retorno de chamada para todas as configurações adicionadas, se tudo o que estou fazendo é ecoar um pouco de coisas.

function settings_callback()
{
    echo '<input id="contact_phone" type="text" class="regular-text" name="contact_phone" />';
}

Por que diabos eu deveria ter que fazer isso? O ID, a classe e o nome devem ser todos parâmetros.

Não há como passar parâmetros para a função settings_callback? Comecei a olhar para o núcleo, cheguei aqui: http://core.trac.wordpress.org/browser/tags/3.1.3/wp-admin/includes/template.php

..e encontrou este $ wp_settings_fields global. Onde isso é definido?

Calvin Froedge
fonte

Respostas:

24

Veja a declaração da função:

function add_settings_field(
    $id,
    $title,
    $callback,
    $page,
    $section = 'default',
    $args    = array()
) { }

O último parâmetro pega seus argumentos e os passa para a função de retorno de chamada.

Exemplo do meu plugin Dados de Contato Público

    foreach ( $this->fields as $type => $desc )
    {
        $handle   = $this->option_name . "_$type";
        $args     = array (
            'label_for' => $handle,
            'type'      => $type
        );
        $callback = array ( $this, 'print_input_field' );

        add_settings_field(
            $handle,
            $desc,
            $callback,
            'general',
            'default',
            $args
        );
    }

A função print_input_field()obtém esses argumentos como primeiro parâmetro:

/**
 * Input fields in 'wp-admin/options-general.php'
 *
 * @see    add_contact_fields()
 * @param  array $args Arguments send by add_contact_fields()
 * @return void
 */
public function print_input_field( array $args )
{
    $type   = $args['type'];
    $id     = $args['label_for'];
    $data   = get_option( $this->option_name, array() );
    $value  = $data[ $type ];

    'email' == $type and '' == $value and $value = $this->admin_mail;
    $value  = esc_attr( $value );
    $name   = $this->option_name . '[' . $type . ']';
    $desc   = $this->get_shortcode_help( $type );

    print "<input type='$type' value='$value' name='$name' id='$id'
        class='regular-text code' /> <span class='description'>$desc</span>";
}

Não há necessidade de tocar em uma variável global.

fuxia
fonte